Partilhar via

API do Serviço de Quotas do Azure

  • Artigo

A API REST do Serviço de Quotas do Azure foi concebida para ver e gerir quotas para fornecedores de recursos do Azure.

Importante

A API do Serviço de Quotas do Azure é Pré-visualização Pública

Uma nova versão da API de Quota do Azure é a pré-visualização pública. Esta API utiliza o Fornecedor de Recursos Microsoft.Quota, suporta máquinas virtuais do Azure (núcleos/vCPU), Azure Machine Learning (dedicado/vCPUs), Redes, HPC Cache do Azure, Armazenamento e serviços do Azure Purview.

Uma quota é o limite de serviços ou o abono definido num recurso na sua subscrição do Azure. Cada serviço do Azure define as quotas e determina os respetivos valores predefinidos. Para obter mais informações sobre as quotas mais comuns do Microsoft Azure, veja Subscrição do Azure e limites de serviço, quotas e restrições.

Utilizar APIs de Quota

Com a API de Quota, pode:

  1. Obtenha as quotas e utilizações atuais de um recurso.
  2. Obtenha uma lista de quotas e utilizações atuais de todos os recursos.
  3. Criar ou atualizar quotas de um recurso.
  4. Obtenha o estado dos pedidos de quota de um recurso.
  5. Obter a lista de todos os pedidos de quota de um recurso durante um ano

Âmbito e chamada PUT da API de Quota

O pedido PUT da API de Quota inclui um parâmetro de "âmbito" que pode ser personalizado para se alinhar com os requisitos dos fornecedores de recursos que procuram um aumento de quota, garantindo que a chamada à API permanece uniforme.

https://management.azure.com/<scope>/Microsoft.Quota/quotas/<resourceName>?api-version=2021-03-15-preview
Fornecedor de Recursos Âmbito
Microsoft.Compute subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/{azure location}
Microsoft.HDInsight subscriptions/{subscriptionId}/providers/Microsoft.HDInsight/locations/{azure location}
Microsoft.MachineLearningService subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningService/locations/{azure location}
Microsoft.Network subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{azure location}
Microsoft.Purview subscriptions/{subscriptionId}/providers/Microsoft.Purview/locations/{azure location}

Nota: pode encontrar aqui um exemplo de chamada PUT para computação.

Pré-requisitos

Importante

Antes de poder utilizar a API de Quota, tem de:

Registar o fornecedor de recursos de Quota da Microsoft

Para registar o fornecedor de recursos de Quota da Microsoft, utilize o comando do PowerShell abaixo:

Register-AzResourceProvider -ProviderNamespace Microsoft.Quota

Devolve resultados semelhantes ao resultado abaixo:

ProviderNamespace : Microsoft.Quota
RegistrationState : Registering
ResourceTypes     : {usages, quotas, quotaRequests, operationsStatus...}
Locations         : {West Europe, East US, South Central US...}

Assim que o fornecedor de recursos Microsoft.Quota estiver registado, o RegistrationState será definido como Registered. Para obter mais informações sobre a gestão de fornecedores de recursos do Azure, veja Fornecedores de recursos do Azure.

Limitação

Todas as chamadas à API ao nível da subscrição e ao nível do inquilino podem ser limitadas se enviar demasiados pedidos de API. Se a chamada à API estiver limitada, receberá uma mensagem de erro a indicar que o servidor rejeitou o pedido da API. Pode repetir a chamada à API depois de decorrido algum tempo.

Para obter detalhes sobre a limitação da API, como resolver problemas de limitação e como evitar a limitação, veja Resolver erros de limitação no Azure.

Função de Operador de Pedido de Quota

O Operador de Pedido de Quota é uma função incorporada do Azure personalizada para operações de quota. Concede permissões para ler e criar pedidos de quota, obter o estado do pedido de quota e criar pedidos de suporte. Atribua esta função a utilizadores, grupos, principais de serviço, identidades geridas e aplicações que efetuem operações de quota. Para referência, o ID da função Operador de Pedido de Quota é 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

A função Operador de Pedido de Quota é expandida para incluir Permissões do Fornecedor de Recursos de Quota.

Melhores práticas das APIs de Quota

  1. Monitorização da utilização de quotas: Utilize a API de quota do Azure para controlar eficazmente a utilização da quota. Esta API fornece informações em tempo real sobre a utilização atual e a quota disponível para uma combinação específica de subscrição, família de VMs e região. É fundamental verificar regularmente a utilização das quotas antes de considerar qualquer aumento de quota.

  2. Pedir aumento de quota: Se a utilização da quota exceder o destino predefinido, inicie um pedido de aumento de quota com a API de quota do Azure para que a sua utilização volte a estar em conformidade com os seus objetivos. O processo é simples: basta submeter um pedido de API que delineia o aumento de quota pretendido. Por exemplo, se a utilização de destino da quota da família de VMs Dv2 na Europa Norte, em "subscription1", estiver definida como 80%, e a monitorização da API de quota do Azure indicar uma utilização real de 85%, submeta um aumento de quota de 10% a 20%.

Dica

É aconselhável pedir um aumento de quota de 10% a 20% da utlização de recursos, uma vez que fornece uma memória intermédia ressonável para picos inesperados na utilização de recursos, garantindo que não atingirá imediatamente o novo limite de quota após um aumento. Esta abordagem minimiza a necessidade de chamadas frequentes à API para pedir quota adicional, melhorando as suas hipóteses de aprovação.

  1. Respnose do aumento da quota: Após submeter um pedido de aumento de quota, receberá uma resposta a indicar se o pedido foi aprovado ou rejeitado. Em caso de rejeição, pode iniciar um seguimento ao registar um pedido de suporte com a API REST do Suporte do Azure ou ao utilizar um novo pedido de suporte no portal do Azure, incluindo as especificidades do pedido de aumento de quota negado e o motivo da sua consulta.

Resolver erros da API de Quota

Utilize as tabelas seguintes para resolver erros que poderá obter ao utilizar a API de Quota.

Código de erro Como resolvê-lo
ContactSupport Abra um novo pedido de suporte no portal do Azure. Em Selecionar um tipo de problema, selecioneLimites de serviço e subscrição (quotas). Também pode abri-lo programaticamente com a API REST do Suporte do Azure.
InternalServerError Erro de servidor interno. Repita a chamada à API mais tarde.
MissingRegistration Registe o fornecedor de recursos Microsoft.Quota para cada uma das suas subscrições. Para obter orientações sobre a resolução de problemas, veja Resolver erros do registo do fornecedor de recursos.
QuotaNotAvailableForResource A quota está atualmente indisponível na localização do recurso pedido. Abra um novo pedido de suporte no portal do Azure. Em Selecionar um tipo de problema, selecioneLimites de serviço e subscrição (quotas). Também pode abri-lo programaticamente com a API REST do Suporte do Azure.
QuotaReductionNotSupported O limite de quota atual é superior à quota pedida ou a utilização atual é superior à quota pedida. A redução de quotas não é suportada. Não é possível reduzir a quota.
RequestThrottled Todos os pedidos de API ao nível da subscrição e ao nível do inquilino podem ser limitados para ajudar no desempenho geral do serviço. O número de pedidos excedeu a taxa máxima de pedidos de API permitida. Tente novamente mais tarde.
ResourceNotAvailableForOffer O recurso está atualmente indisponível na localização do tipo de oferta. Para obter a lista de ofertas atuais e descontinuadas, veja a página Detalhes da Oferta do Microsoft Azure . Para alterar o tipo de oferta, veja a página Alterar a subscrição do Azure para uma oferta diferente . Também pode abrir um novo pedido de suporte no portal do Azure. Em Selecionar um tipo de problema, selecioneLimites de serviço e subscrição (quotas). Também pode abri-lo programaticamente com a API REST do Suporte do Azure.
ResourceNotAvailableForSubscription O recurso está atualmente indisponível na localização da subscrição pedida. Abra um novo pedido de suporte no portal do Azure. Em Selecionar um tipo de problema, selecioneLimites de serviço e subscrição (quotas). Também pode abri-lo programaticamente com a API REST do Suporte do Azure.
UnableToIncreaseQuota Não é possível aumentar as quotas para as subscrições pedidas. Abra um novo pedido de suporte no portal do Azure. Em Selecionar um tipo de problema, selecioneLimites de serviço e subscrição (quotas).
MFA necessária Os pedidos de quota precisam de Multi-Factor Authentication. Ative a Multi-Factor Authentication para o seu inquilino/conta ao seguir as instruções em ativar a MFA e tente novamente
RequestPartiallyFulfilled O pedido de quota é parcialmente cumprido. Para quaisquer perguntas, abra um novo pedido de suporte no portal do Azure. Em Selecionar um tipo de problema, selecioneLimites de serviços e subscrições (quotas)

Suporte noutras linguagens e interfaces

A API REST de Quota está disponível nos seguintes SDKs do Microsoft Azure específicos do idioma:

Utilizar portal do Azure e a API de Suporte para gerir quotas

O Azure permite-lhe criar e gerir pedidos de suporte, também conhecidos como pedidos de suporte. Pode: