Quota Request Status - Get

For the specified Azure region (location), get the details and status of the quota request by the quota request ID for the resources of the resource provider. The PUT request for the quota (service limit) returns a response with the requestId parameter.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/resourceProviders/{providerId}/locations/{location}/serviceLimitsRequests/{id}?api-version=2020-10-25

URI Parameters

Name In Required Type Description
id
path True

string

Quota Request ID.

location
path True

string

Azure region.

providerId
path True

string

Azure resource provider ID.

subscriptionId
path True

string

minLength: 1

The ID of the target subscription.

api-version
query True

string

minLength: 1

The API version to use for this operation.

Responses

Name Type Description
200 OK

QuotaRequestDetails

Azure operation completed successfully.

Other Status Codes

ExceptionResponse

An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

QuotaRequestFailed
QuotaRequestInProgress
QuotaRequestStatus

QuotaRequestFailed

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Capacity/resourceProviders/Microsoft.Compute/locations/eastus/serviceLimitsRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2020-10-25

Sample response

{
  "name": "00000000-0000-0000-0000-000000000000/2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "type": "Microsoft.Capacity/serviceLimitsRequests",
  "id": "2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "properties": {
    "message": "Request failed, please contatct support.",
    "provisioningState": "Failed",
    "requestSubmitTime": "2019-08-19T19:23:17.904Z",
    "value": [
      {
        "name": {
          "localizedValue": "Standard HCS Family vCPUs",
          "value": "standardHCSFamily"
        },
        "limit": 200,
        "message": "Request completed",
        "provisioningState": "Succeeded",
        "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C"
      },
      {
        "name": {
          "localizedValue": "Standard NC Promo Family vCPUs",
          "value": "standardNCPromoFamily"
        },
        "limit": 50,
        "message": "RRequest failed, please contatct support.",
        "provisioningState": "Failed",
        "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C"
      }
    ]
  }
}

QuotaRequestInProgress

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Capacity/resourceProviders/Microsoft.Compute/locations/westus/serviceLimitsRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2020-10-25

Sample response

{
  "name": "00000000-0000-0000-0000-000000000000/2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "type": "Microsoft.Capacity/serviceLimitsRequests",
  "id": "2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "properties": {
    "message": "Request processing",
    "provisioningState": "InProgress",
    "requestSubmitTime": "2019-08-19T19:23:17.904Z",
    "value": [
      {
        "name": {
          "localizedValue": "Standard NC Promo Family vCPUs",
          "value": "standardNCPromoFamily"
        },
        "limit": 50,
        "message": "Request processing",
        "provisioningState": "InProgress",
        "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C"
      }
    ]
  }
}

QuotaRequestStatus

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Capacity/resourceProviders/Microsoft.Compute/locations/eastus/serviceLimitsRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2020-10-25

Sample response

{
  "name": "00000000-0000-0000-0000-000000000000/2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "type": "Microsoft.Capacity/serviceLimitsRequests",
  "id": "2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "properties": {
    "message": "Request completed",
    "provisioningState": "Succeeded",
    "requestSubmitTime": "2019-08-19T19:23:17.904Z",
    "value": [
      {
        "name": {
          "localizedValue": "Standard HCS Family vCPUs",
          "value": "standardHCSFamily"
        },
        "limit": 200,
        "message": "Request completed",
        "provisioningState": "Succeeded",
        "subRequestId": "AD07450A-DE86-4FD3-859B-107BEF218C4C"
      },
      {
        "name": {
          "localizedValue": "Standard NC Promo Family vCPUs",
          "value": "standardNCPromoFamily"
        },
        "limit": 50,
        "message": "Request completed",
        "provisioningState": "Succeeded"
      }
    ]
  }
}

Definitions

Name Description
createdByType

The type of identity that created the resource.

ExceptionResponse

The API error.

QuotaRequestDetails

Quota request details.

QuotaRequestState

The quota request status.

ResourceName

Resource name provided by the resource provider. Use this property for quotaRequest parameter.

ServiceError

The API error details.

ServiceErrorDetail

The error details.

SubRequest

The sub-request submitted with the quota request.

systemData

Metadata pertaining to creation and last modification of the resource.

createdByType

The type of identity that created the resource.

Value Description
User
Application
ManagedIdentity
Key

ExceptionResponse

The API error.

Name Type Description
error

ServiceError

The API error details.

QuotaRequestDetails

Quota request details.

Name Type Description
id

string

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

The name of the resource

properties.message

string

User friendly status message.

properties.provisioningState

QuotaRequestState

The quota request status.

properties.requestSubmitTime

string (date-time)

The time when the quota request was submitted using format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard.

properties.value

SubRequest[]

The quotaRequests.

systemData

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

type

string

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

QuotaRequestState

The quota request status.

Value Description
Accepted

Accepted

Invalid

Invalid

Succeeded

Succeeded

Failed

Failed

InProgress

InProgress

ResourceName

Resource name provided by the resource provider. Use this property for quotaRequest parameter.

Name Type Description
localizedValue

string

Resource display localized name.

value

string

Resource name.

ServiceError

The API error details.

Name Type Description
code

string

The error code.

details

ServiceErrorDetail[]

The list of error details.

message

string

The error message text.

ServiceErrorDetail

The error details.

Name Type Description
code

string

The error code.

message

string

The error message.

SubRequest

The sub-request submitted with the quota request.

Name Type Description
limit

integer (int32)

Quota (resource limit).

message

string

User-friendly status message.

name

ResourceName

The resource name.

provisioningState

QuotaRequestState

The quota request status.

resourceType

string

Resource type for which the quota check was made.

subRequestId

string

Sub request ID for individual request.

unit

string

The limit units, such as count and bytes. Use the unit field provided in the response of the GET quota operation.

systemData

Metadata pertaining to creation and last modification of the resource.

Name Type Description
createdAt

string (date-time)

The timestamp of resource creation (UTC).

createdBy

string

The identity that created the resource.

createdByType

createdByType

The type of identity that created the resource.

lastModifiedAt

string (date-time)

The timestamp of resource last modification (UTC)

lastModifiedBy

string

The identity that last modified the resource.

lastModifiedByType

createdByType

The type of identity that last modified the resource.