Compartilhar via

Group Quota Limits Request - Update

  • Referência
Serviço:
Quota
Versão da API:
2025-03-01

Crie as solicitações GroupQuota para um ResourceProvider/Location/Resource específico. As propriedades resourceName são especificadas no corpo da solicitação. Somente uma cota de recurso pode ser solicitada. Observe que a solicitação de patch cria uma nova solicitação groupQuota. Use a API de sondagem – URI operationsStatus especificado no campo de cabeçalho Azure-AsyncOperation, com duração de repetição após em segundos para verificar o status intermediário. Essa API fornece o status das finais com os detalhes e o status da solicitação.

PATCH https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Quota/groupQuotas/{groupQuotaName}/resourceProviders/{resourceProviderName}/groupQuotaLimits/{location}?api-version=2025-03-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
groupQuotaName
 path True

string

minLength: 3
maxLength: 63
pattern: ^[a-z][a-z0-9]*$

O nome GroupQuota. O nome deve ser exclusivo para o tenantId/MgId de contexto fornecido.
location
 path True

string

minLength: 1

O nome da região do Azure.
managementGroupId
 path True

string

minLength: 3
maxLength: 63

ID do Grupo de Gerenciamento.
resourceProviderName
 path True

string

pattern: ^((?!-)[a-zA-Z0-9-]{1,63}(?

O nome do provedor de recursos, como – Microsoft.Compute. Atualmente, apenas o provedor de recursos Microsoft.Compute dá suporte a essa API.
api-version
 query True

string

minLength: 1

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
properties

Properties

Respostas

Nome Tipo Description
200 OK

GroupQuotaLimitList

Sucesso, com os detalhes da solicitação de cota de grupo.
202 Accepted

Solicitação aceita, criar ou atualizar

Cabeçalhos

  • Retry-After: integer
  • Location: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Erro

Segurança

azure_auth

Autorização do Azure Active Directory OAuth 2.0

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

GroupQuotaLimitsRequests_Update

Solicitação de exemplo

PATCH https://management.azure.com/providers/Microsoft.Management/managementGroups/E7EC67B3-7657-4966-BFFC-41EFD36BAA09/providers/Microsoft.Quota/groupQuotas/groupquota1/resourceProviders/Microsoft.Compute/groupQuotaLimits/westus?api-version=2025-03-01

{
  "properties": {
    "value": [
      {
        "properties": {
          "limit": 110,
          "resourceName": "standardddv4family",
          "comment": "Contoso requires more quota."
        }
      },
      {
        "properties": {
          "limit": 110,
          "resourceName": "standardav2family",
          "comment": "Contoso requires more quota."
        }
      }
    ]
  }
}

Resposta de exemplo

Código de status:
200 
{
  "id": "/providers/Microsoft.Management/managementGroups/E7EC67B3-7657-4966-BFFC-41EFD36BAA09/providers/Microsoft.Quota/groupQuotas/groupquota1/resourceProviders/Microsoft.Compute/groupQuotaLimits/westus",
  "name": "westus",
  "type": "Microsoft.Quota/groupQuotas/groupQuotaLimits",
  "properties": {
    "provisioningState": "Succeeded",
    "value": [
      {
        "properties": {
          "limit": 100,
          "resourceName": "standardddv4family",
          "name": {
            "value": "standardddv4family",
            "localizedValue": "standard DDv4 Family vCPUs"
          },
          "unit": "count",
          "availableLimit": 50,
          "allocatedToSubscriptions": {
            "value": [
              {
                "subscriptionId": "00000000-0000-0000-0000-000000000000",
                "quotaAllocated": 20
              },
              {
                "subscriptionId": "A000000-0000-0000-0000-000000000000",
                "quotaAllocated": 30
              }
            ]
          }
        }
      },
      {
        "properties": {
          "limit": 100,
          "resourceName": "standardav2family",
          "name": {
            "value": "standardav2family",
            "localizedValue": "Standard AV2 Family vCPUs"
          },
          "unit": "count",
          "availableLimit": 80,
          "allocatedToSubscriptions": {
            "value": [
              {
                "subscriptionId": "00000000-0000-0000-0000-000000000000",
                "quotaAllocated": 20
              }
            ]
          }
        }
      }
    ],
    "nextLink": "https://yourLinkHere.com"
  }
}
Código de status:
202 
location: https://contoso.com/operationstatus
Azure-AsyncOperation: https://contoso.com/operationstatus
Operation-Location: https://contoso.com/operationstatus
retry-after: 30

Definições

Nome Description
createdByType

O tipo de identidade que criou o recurso.
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta de erro
GroupQuotaLimit

Limite de Cota de Grupo.
GroupQuotaLimitList

Lista de detalhes do Limite de Cota de Grupo.
Properties
RequestState

Status da solicitação.
systemData

Metadados relativos à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

GroupQuotaLimit

Objeto

Limite de Cota de Grupo.

Nome Tipo Description
properties

Properties

Propriedades de Cota de Grupo para o recurso especificado.

GroupQuotaLimitList

Objeto

Lista de detalhes do Limite de Cota de Grupo.

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

O nome do recurso
properties

Properties

systemData

systemData

Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

Properties

Objeto
Nome Tipo Description
provisioningState

RequestState

Status da solicitação.

RequestState

Enumeração

Status da solicitação.

Valor Description
Accepted
Canceled
Created
Failed
InProgress
Invalid
Succeeded

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.