From bc7a8312194c694509797d04992d50fde79dfb5d Mon Sep 17 00:00:00 2001 From: Victor Colin Amador Date: Thu, 11 Jun 2026 18:39:04 -0700 Subject: [PATCH 1/2] Clarify async provisioning in Redis create tool description (#459) Azure Cache for Redis provisioning is asynchronous; the create command returns immediately while the resource is still being created. Update the command description, XML summary, and docs to instruct callers to poll provisioningState until 'Succeeded' before connecting. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../vcolin7-redis-create-async-description.yaml | 3 +++ servers/Azure.Mcp.Server/docs/azmcp-commands.md | 2 +- .../src/Commands/ResourceCreateCommand.cs | 5 +++-- 3 files changed, 7 insertions(+), 3 deletions(-) create mode 100644 servers/Azure.Mcp.Server/changelog-entries/vcolin7-redis-create-async-description.yaml diff --git a/servers/Azure.Mcp.Server/changelog-entries/vcolin7-redis-create-async-description.yaml b/servers/Azure.Mcp.Server/changelog-entries/vcolin7-redis-create-async-description.yaml new file mode 100644 index 0000000000..9f9ee6d8a1 --- /dev/null +++ b/servers/Azure.Mcp.Server/changelog-entries/vcolin7-redis-create-async-description.yaml @@ -0,0 +1,3 @@ +changes: + - section: "Other Changes" + description: "Clarified the `azmcp redis create` tool description to convey that provisioning is asynchronous and callers should poll `provisioningState` until it shows 'Succeeded' before connecting." diff --git a/servers/Azure.Mcp.Server/docs/azmcp-commands.md b/servers/Azure.Mcp.Server/docs/azmcp-commands.md index c5c204ce33..ac2385c938 100644 --- a/servers/Azure.Mcp.Server/docs/azmcp-commands.md +++ b/servers/Azure.Mcp.Server/docs/azmcp-commands.md @@ -3554,7 +3554,7 @@ azmcp role assignment list --subscription \ ### Azure Redis Operations ```bash -# Creates a new Azure Managed Redis resource +# Creates a new Azure Managed Redis resource (asynchronous; poll provisioningState until 'Succeeded') # ✅ Destructive | ❌ Idempotent | ❌ OpenWorld | ❌ ReadOnly | ❌ Secret | ❌ LocalRequired azmcp redis create --subscription \ --resource-group \ diff --git a/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs b/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs index 97dab90665..ada38eab9f 100644 --- a/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs +++ b/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs @@ -14,13 +14,14 @@ namespace Azure.Mcp.Tools.Redis.Commands; /// -/// Creates a new Azure Managed Redis resource. +/// Creates a new Azure Managed Redis resource. Provisioning is asynchronous and the +/// command returns immediately while the resource is still being created. /// [CommandMetadata( Id = "750133dd-d57f-4ed4-9488-c1d406ad4a83", Name = "create", Title = "Create Redis Resource", - Description = "Create a new Azure Managed Redis resource in Azure. Use this command to provision a new Redis resource in your subscription.", + Description = "Create a new Azure Managed Redis resource in Azure. Use this command to provision a new Redis resource in your subscription. Provisioning is asynchronous and typically takes several minutes; the command returns immediately while the resource is still being created. Poll the resource's provisioningState field until it shows 'Succeeded' before attempting connections.", Destructive = true, Idempotent = false, OpenWorld = false, From 47b1fb72975251ef42c0aeb01ec342a413fcdb3a Mon Sep 17 00:00:00 2001 From: Victor Colin Amador Date: Mon, 15 Jun 2026 11:51:02 -0600 Subject: [PATCH 2/2] Updated description based on PR feedback --- .../Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs b/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs index ada38eab9f..1e0468ca54 100644 --- a/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs +++ b/tools/Azure.Mcp.Tools.Redis/src/Commands/ResourceCreateCommand.cs @@ -21,7 +21,7 @@ namespace Azure.Mcp.Tools.Redis.Commands; Id = "750133dd-d57f-4ed4-9488-c1d406ad4a83", Name = "create", Title = "Create Redis Resource", - Description = "Create a new Azure Managed Redis resource in Azure. Use this command to provision a new Redis resource in your subscription. Provisioning is asynchronous and typically takes several minutes; the command returns immediately while the resource is still being created. Poll the resource's provisioningState field until it shows 'Succeeded' before attempting connections.", + Description = "Create a new Azure Managed Redis resource in Azure. Use this command to provision a new Redis resource in your subscription. Provisioning is asynchronous and typically takes several minutes; the command returns immediately with status \"Creating\" while the resource is still being created.", Destructive = true, Idempotent = false, OpenWorld = false,