Share via

APIM named value stuck in "InProgress" provisioning state — all management plane operations blocked

Brandon Berisford 0 Reputation points
2026-02-28T23:24:58.39+00:00

APIM named value stuck in "InProgress" provisioning state — all management plane operations blocked

Description

A named value (maintenance-mode) on our API Management instance is stuck in InProgress provisioning state. This is blocking all management plane operations on the service, including policy updates, API imports, and named value modifications — both via Azure CLI/REST API and the Azure Portal.

What we've tried

  1. Re-PUTting the named value via az rest — returns InProgress, does not resolve
  2. Deleting the named value — fails with ValidationError because it is referenced by an API policy (/apis/preflightapi;rev=1/policies/policy)
  3. Updating the API policy to remove the reference — fails with 502 Bad Gateway because the management plane is locked by the stuck provisioning operation
  4. Editing the policy via Azure Portal — same 502 error
  5. The overall APIM service provisioningState is Succeeded — only the named value is stuck

Impact

We cannot deploy any policy updates or OpenAPI spec imports to this APIM instance, which blocks our CI/CD production deployment pipeline.

Request

Please force-clear the stuck provisioning state on the maintenance-mode named value so management plane operations are unblocked. Ideally we would like to delete this named value entirely once the policy can be updated to remove its reference.

Azure API Management
Azure API Management

An Azure service that provides a hybrid, multi-cloud management platform for APIs.

0 comments No comments

1 answer

Sort by: Most helpful
  1. Q&A Assist
    2026-02-28T23:25:12.5666667+00:00
    AI generated content. This question contains an answer created with AI from Q&A Assist. Learn more

    The stuck InProgress provisioning state on the named value is a control-plane issue that cannot be fixed from the client side when all management operations (update policy, delete named value, etc.) are blocked.

    The available documentation and tooling only support normal CRUD flows for named values:

    • Creating, updating, listing, and deleting named values via Azure CLI (az apim nv create, az apim nv update, az apim nv list, az apim nv show, az apim nv delete, az apim nv show-secret).
    • Using named values in policies, with the constraint that a named value cannot be deleted while it is referenced by any policy.

    There is no supported command or API to force-clear or override the provisioningState of an individual named value. The provisioningState field on the NamedValueContract is explicitly documented as server-populated and not client-serializable:

    provisioningState?: string // NOTE: This property will not be serialized. It can only be populated by the server.
    

    Given that:

    1. The APIM service itself is in Succeeded state.
    2. The named value is stuck in InProgress and is referenced by a policy.
    3. Any attempt to change the policy or the named value fails with 5xx/validation errors because the management plane is effectively locked.

    This is a backend/platform issue that requires intervention from Azure Support. Client-side retries, re-PUTs, or delete attempts cannot override the server-managed provisioning state.

    The only viable resolution path is:

    1. Open an Azure Support ticket for the APIM resource.
    2. Provide the APIM service name, resource group, region, named value ID (maintenance-mode), and timestamps of failed operations.
    3. Request backend remediation to:
      • Either complete or roll back the stuck provisioning operation on the named value, or
      • Remove the named value and/or its references at the control-plane level.

    Similar stuck-provisioning situations in other Azure services (for example, Redis Cache or AI deployments) have been resolved only after the resource transitioned to a failed state or after deletion/recreation, sometimes with support assistance. In this case, because the named value cannot be independently deleted and the management plane is blocked, support escalation is required to unblock the APIM instance.

    Until support clears the stuck state, there is no documented or supported way to force-reset the provisioningState of the named value from CLI, REST, or Portal.


    References:

    0 comments No comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.