Partilhar via


Quota - Create Or Update

Crie ou atualize o limite de cota para o recurso especificado com o valor solicitado. Para atualizar a quota, siga estes passos:

  1. Use a operação GET para cotas e usos para determinar a quantidade de cota restante para o recurso específico e para calcular o novo limite de cota. Essas etapas são detalhadas em este exemplo.
  2. Use esta operação PUT para atualizar o limite de cota. Verifique o URI no cabeçalho do local para obter o status detalhado da solicitação.
PUT https://management.azure.com/{scope}/providers/Microsoft.Quota/quotas/{resourceName}?api-version=2025-03-01

Parâmetros do URI

Name Em Necessário Tipo Description
resourceName
path True

string

Nome do recurso para um determinado provedor de recursos. Por exemplo:

  • Nome da SKU para Microsoft.Compute
  • SKU ou TotalLowPriorityCores para Microsoft.MachineLearningServices

Para Microsoft.Network PublicIPAddresses.

scope
path True

string

O URI do recurso do Azure de destino. Por exemplo, /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/qms-test/providers/Microsoft.Batch/batchAccounts/testAccount/. Este é o URI de recurso do Azure de destino para a operação List GET. Se um {resourceName} for adicionado após /quotas, ele será o URI de recurso do Azure de destino na operação GET para o recurso específico.

api-version
query True

string

minLength: 1

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

Corpo do Pedido

Name Tipo Description
properties

QuotaProperties

Propriedades de cota para o recurso especificado, com base na API chamada, Cotas ou Usos.

Respostas

Name Tipo Description
200 OK

CurrentQuotaLimitBase

OK. Retorna os detalhes da solicitação de cota.

202 Accepted

O pedido é aceite e está a ser processado. Para verificar o status dessa solicitação, use o valor para a ID da solicitação de cota id obtida na resposta de uma operação GET Status da Solicitação de Cota.

Other Status Codes

ExceptionResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Autorização do Azure Ative Directory OAuth 2.0

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

Âmbitos

Name Description
user_impersonation Personifique sua conta de usuário.

Exemplos

Quotas_Put_Request_ForCompute
Quotas_PutRequest_ForNetwork
Quotas_PutRequest_ForNetwork_StandardSkuPublicIpAddressesResource
Quotas_Request_ForMachineLearningServices_LowPriorityResource

Quotas_Put_Request_ForCompute

Pedido de amostra

PUT https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotas/standardFSv2Family?api-version=2025-03-01

{
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "standardFSv2Family"
    }
  }
}

Resposta da amostra

Retry-After: 30
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/operationsStatus/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
{
  "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotas/standardFSv2Family",
  "type": "Microsoft.Quota/quotas",
  "name": "standardFSv2Family",
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "standardFSv2Family"
    }
  }
}

Quotas_PutRequest_ForNetwork

Pedido de amostra

PUT https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/quotas/MinPublicIpInterNetworkPrefixLength?api-version=2025-03-01

{
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "MinPublicIpInterNetworkPrefixLength"
    },
    "resourceType": "MinPublicIpInterNetworkPrefixLength"
  }
}

Resposta da amostra

Retry-After: 30
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/operationsStatus/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
{
  "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "type": "Microsoft.Quota/quotas",
  "name": "2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "MinPublicIpInterNetworkPrefixLength"
    },
    "resourceType": "MinPublicIpInterNetworkPrefixLength"
  }
}

Quotas_PutRequest_ForNetwork_StandardSkuPublicIpAddressesResource

Pedido de amostra

PUT https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/quotas/StandardSkuPublicIpAddresses?api-version=2025-03-01

{
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "StandardSkuPublicIpAddresses"
    },
    "resourceType": "PublicIpAddresses"
  }
}

Resposta da amostra

Retry-After: 30
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/operationsStatus/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/quotaRequest/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
{
  "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Network/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "type": "Microsoft.Quota/quotas",
  "name": "2B5C8515-37D8-4B6A-879B-CD641A2CF605",
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "StandardSkuPublicIpAddresses"
    },
    "resourceType": "PublicIpAddresses"
  }
}

Quotas_Request_ForMachineLearningServices_LowPriorityResource

Pedido de amostra

PUT https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/quotas/TotalLowPriorityCores?api-version=2025-03-01

{
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "TotalLowPriorityCores"
    },
    "resourceType": "lowPriority"
  }
}

Resposta da amostra

Retry-After: 30
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/operationsStatus/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
location: https://management.azure.com/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.Compute/locations/eastus/providers/Microsoft.Quota/quotaRequests/2B5C8515-37D8-4B6A-879B-CD641A2CF605?api-version=2023-02-01
{
  "id": "/subscriptions/D7EC67B3-7657-4966-BFFC-41EFD36BAAB3/providers/Microsoft.MachineLearningServices/locations/eastus/providers/Microsoft.Quota/quotas/TotalLowPriorityCores",
  "type": "Microsoft.Quota/quotas",
  "name": "TotalLowPriorityCores",
  "properties": {
    "limit": {
      "limitObjectType": "LimitValue",
      "value": 10
    },
    "name": {
      "value": "TotalLowPriorityCores"
    },
    "resourceType": "lowPriority"
  }
}

Definições

Name Description
CurrentQuotaLimitBase

Limite de quotas.

ExceptionResponse

Erro.

LimitObject

O valor limite da cota de recursos.

quotaLimitTypes

Os tipos de limite de cota ou usos.

QuotaProperties

Propriedades de cota para o recurso especificado.

ResourceName

Nome do recurso fornecido pelo provedor de recursos. Ao solicitar a cota, use esse nome de propriedade.

ServiceError

Detalhes do erro da API.

ServiceErrorDetail

Detalhes do erro.

CurrentQuotaLimitBase

Limite de quotas.

Name Tipo Description
id

string

A ID do recurso.

name

string

O nome do recurso.

properties

QuotaProperties

Propriedades de cota para o recurso especificado, com base na API chamada, Cotas ou Usos.

type

string

O tipo do recurso.

ExceptionResponse

Erro.

Name Tipo Description
error

ServiceError

Detalhes do erro da API.

LimitObject

O valor limite da cota de recursos.

Name Tipo Description
limitObjectType string:

LimitValue

O tipo de objeto limite.

limitType

quotaLimitTypes

Os tipos de limite de cota ou usos.

value

integer (int32)

Quota/valor-limite

quotaLimitTypes

Os tipos de limite de cota ou usos.

Valor Description
Independent
Shared

QuotaProperties

Propriedades de cota para o recurso especificado.

Name Tipo Description
isQuotaApplicable

boolean

Indica se a quota pode ser solicitada para este recurso.

limit LimitJsonObject:

LimitObject

Propriedades de limite de cota de recursos.

name

ResourceName

Nome do recurso fornecido pelo provedor de recursos. Use esse nome de propriedade ao solicitar a cota.

properties

object

Propriedades adicionais para o provedor de recursos específico.

quotaPeriod

string

O período de tempo durante o qual os valores de uso da cota são resumidos. Por exemplo: *P1D (por um dia) *PT1M (por um minuto) *PT1S (por um segundo). Este parâmetro é opcional porque, para alguns recursos como computação, o período é irrelevante.

resourceType

string

O nome do tipo de recurso. Campo opcional.

unit

string

As unidades de cota, como Count e Bytes. Ao solicitar a cota, use o valor da unidade de retornado na resposta GET no corpo da solicitação da sua operação PUT.

ResourceName

Nome do recurso fornecido pelo provedor de recursos. Ao solicitar a cota, use esse nome de propriedade.

Name Tipo Description
localizedValue

string

Nome para exibição do recurso.

value

string

Nome do recurso.

ServiceError

Detalhes do erro da API.

Name Tipo Description
code

string

Código de erro.

details

ServiceErrorDetail[]

Lista de detalhes do erro.

message

string

Mensagem de erro.

ServiceErrorDetail

Detalhes do erro.

Name Tipo Description
code

string

Código de erro.

message

string

Mensagem de erro.