[Doc Gap] EventHubs namespace update --sku-tier valid values not documented after breaking change

[github-actions]

Documentation Gap

Server: Azure.Mcp.Server
Tool directory: tools/Azure.Mcp.Tools.EventHubs
Triggered by: commit 28350ea (PR #2678) by @g2vinay
Changed files:

• tools/Azure.Mcp.Tools.EventHubs/src/Services/EventHubsService.cs
• tools/Azure.Mcp.Tools.EventHubs/src/Commands/Namespace/NamespaceDeleteCommand.cs
• tools/Azure.Mcp.Tools.EventHubs/src/Commands/EventHub/EventHubGetCommand.cs
• tools/Azure.Mcp.Tools.EventHubs/src/Commands/EventHub/EventHubUpdateCommand.cs
• servers/Azure.Mcp.Server/changelog-entries/1779241651300.yaml

What Changed

PR #2678 introduced a breaking change in the EventHubs toolset: azmcp eventhubs namespace update (and create) now rejects invalid --sku-tier values with an ArgumentException instead of silently defaulting to Standard. Valid values are Basic, Standard, and Premium (case-insensitive).

Additionally, two bugs were fixed:

• Namespace delete now reports "not found" instead of "deleted successfully" when the namespace does not exist.
• --status is now correctly applied when updating an Event Hub (previously silently discarded).

Gaps Found

• azmcp-commands.md: The azmcp eventhubs namespace update command documents [--sku-tier <sku-tier>] but does not list the valid values (Basic, Standard, Premium). Since invalid values now cause a hard validation error (breaking change), users need to know the accepted values. The existing pattern in the file uses <Value1|Value2> inline notation for enum parameters (e.g., [--policy-sub-type <Standard|Enhanced>]).

Files to Update

• servers/Azure.Mcp.Server/docs/azmcp-commands.md

Context

Breaking change from changelog entry (servers/Azure.Mcp.Server/changelog-entries/1779241651300.yaml):

changes:
  - section: "Breaking Changes"
    description: |
      Event Hubs namespace create/update now rejects invalid `--sku-tier` values with a validation error instead of silently defaulting to Standard.

Service code enforcing valid values (EventHubsService.cs):

Tier = skuTier?.ToUpperInvariant() switch
{
    "BASIC" => EventHubsSkuTier.Basic,
    "STANDARD" => EventHubsSkuTier.Standard,
    "PREMIUM" => EventHubsSkuTier.Premium,
    null or "" => EventHubsSkuTier.Standard,
    _ => throw new ArgumentException(
        $"Invalid SKU tier '{skuTier}'. Valid values: Basic, Standard, Premium.",
        nameof(skuTier))
},

Current doc (around line 2465 of azmcp-commands.md):

azmcp eventhubs namespace update --subscription <subscription> \
                                 --resource-group <resource-group> \
                                 --namespace <namespace> \
                                 [--location <location>] \
                                 [--sku-name <sku-name>] \
                                 [--sku-tier <sku-tier>] \
                                 ...

📐 Implementation Guide

This section contains step-by-step instructions for a coding agent to implement the changes described above.

Step 1: Modify files

File: servers/Azure.Mcp.Server/docs/azmcp-commands.md
Action: Edit — find the azmcp eventhubs namespace update code block (around line 2460) and update the --sku-tier placeholder to show valid values.

Change:

                                 [--sku-tier <sku-tier>] \

To:

                                 [--sku-tier <Basic|Standard|Premium>] \

Step 2: Verify documentation structure

servers/Azure.Mcp.Server/docs/azmcp-commands.md — must include:

• A global options table at the top (subscription, resource-group, tenant, retry-max-retries, retry-delay)
• One ## azmcp <service> <resource> <operation> section per command, containing a description, parameters table, and example usage block

Confirm that the ### Azure Event Hubs section now shows [--sku-tier <Basic|Standard|Premium>] to match the established pattern for enum parameters (as seen for [--policy-sub-type <Standard|Enhanced>] elsewhere in the file).

Step 3: Validate

Run these commands in order. Each must succeed before proceeding to the next:

1. dotnet build servers/Azure.Mcp.Server/ — confirms the server project compiles cleanly
2. dotnet build tools/Azure.Mcp.Tools.EventHubs/src/ — confirms the affected toolset compiles
3. dotnet test tools/Azure.Mcp.Tools.EventHubs/tests/Azure.Mcp.Tools.EventHubs.Tests/ --filter "TestType!=Live" — runs unit tests for the affected toolset
4. .\eng\common\spelling\Invoke-Cspell.ps1 — checks spelling in new or modified documentation

Next Steps

Tip

Ready for automated implementation? Assign this issue to @copilot to have Copilot coding agent implement the changes described in the Implementation Guide above

Generated by Documentation Updater · ● 7.2M · ◷