Azure Quota API

  • Artigo

A API de Quota é uma API REST que pode utilizar para ver e gerir quotas para serviços do Azure.

Importante

Disponibilidade geral da API de Quota

A API de Quota do Azure está agora disponível globalmente. Atualmente, suporta máquinas virtuais do Azure (núcleos/vCPU) e serviços do Azure Machine Learning (dedicados/vCPUs).

Nota: Uma nova versão da API REST de Quota está em pré-visualização pública, na API Rest do Serviço de Quotas do Azure. Utiliza o fornecedor de recursos Microsoft.Quota e suporta máquinas virtuais do Azure (núcleos/vCPU), Azure Machine Learning, redes do Azure, HPC Cache do Azure e serviços do Azure Purview.

As quotas são os valores máximos para recursos, ação e itens na sua subscrição do Azure. Cada serviço do Azure define as quotas e determina os respetivos valores predefinidos. Consoante as suas necessidades empresariais, poderá ter de aumentar os valores de quota.

Para obter mais informações sobre os limites mais comuns do Microsoft Azure, veja Subscrição do Azure e limites de serviço, quotas e restrições.

Utilizar a API de Quota

Com a API de Quota, pode:

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

Operações REST

A API de Quota do Azure torna mais fácil procurar as quotas e pedir aumentos com estas operações REST:

Pré-requisitos

Importante

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

Registar o fornecedor de recursos da Capacidade da Microsoft

Para registar o fornecedor de recursos de Capacidade da Microsoft, utilize este comando do PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Devolve resultados semelhantes a este resultado:

ProviderNamespace : Microsoft.Capacity
RegistrationState : Registering
ResourceTypes     : {resources, reservationOrders, reservationOrders/reservations, listbenefits...}
Locations         : {West Europe, East US, South Central US...}

Assim que o fornecedor de recursos Microsoft.Capacity 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.

Função operador de pedido de quota

A funçã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.

Quotas de vCPU

Pode utilizar a API de Quota para gerir quotas para estes dois tipos de quotas de vCPU:

  • Quota de vCPU standard para VMs Pay as you go e instâncias de VM reservadas .
  • Quota de vCPU spot para VMs Spot .

Para saber mais sobre os limites e quotas do Azure, veja Subscrição do Azure e limites de serviço, quotas e restrições.

Quotas do Azure Machine Learning

Pode utilizar a API de Quota para gerir quotas para áreas de trabalho e computação do Azure Machine Learning. Leia o artigo Gerir e aumentar quotas de recursos com o Azure Machine Learning para saber mais sobre:

  • Limites predefinidos nos recursos do Azure relacionados com o Azure Machine Learning.
  • A criar quotas ao nível da área de trabalho.
  • Ver as quotas e os limites.
  • Pedir aumentos de quota.
  • Pontos finais privados e quotas de DNS.

Regiões

A maioria das quotas é específica para uma carga de trabalho em qualquer região. Peça quotas separadas para cada região onde pretende implementar um serviço. Para listar todas as regiões do Azure nas quais o serviço existe, utilize a operação Listar Por Regiões de Serviço.

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.

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.Capacity 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).

Suporte noutras linguagens e interfaces

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

  • SDK do Microsoft Azure para .NET: pacote NuGet
  • SDK do Microsoft Azure para Python: pacote Py
  • SDK do Microsoft Azure para JavaScript (NodeJS & Browser): pacote js
  • Microsoft Azure SDK for Go: Pacote Go

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: