Compartilhar via

API de Cota do Azure

  • Artigo

A API de Cota é uma API REST que você pode usar para exibir e gerenciar cotas para serviços do Azure.

Importante

Disponibilidade geral da API de Cota

A API de Cota do Azure agora está em disponibilidade geral. Atualmente, ele dá suporte a máquinas virtuais do Azure (núcleos/vCPU) e serviços do Azure Machine Learning (vCPUs/dedicados).

Nota: Uma nova versão da API REST de Cota está em versão prévia pública, na API Rest do Serviço de Cota do Azure. Ele usa o provedor de recursos Microsoft.Quota e dá suporte a máquinas virtuais do Azure (núcleos/vCPU), Azure Machine Learning, rede do Azure, serviços do Azure HPC Cache e Azure Purview.

As cotas são os valores máximos para recursos, ações e itens em sua assinatura do Azure. Cada serviço do Azure define suas cotas e determina seus valores padrão. Dependendo das necessidades da sua empresa, talvez seja necessário aumentar seus valores de cota.

Para obter mais informações sobre os limites mais comuns do Microsoft Azure, consulte Limites, cotas e restrições de assinatura e serviço do Azure.

Usando a API de Cota

Com a API de Cota, você pode:

  • Obtenha as cotas e os usos atuais de um recurso.
  • Obtenha uma lista de cotas e usos atuais de todos os recursos.
  • Criar ou atualizar cotas de um recurso.
  • Obtenha o status de solicitações de cota para um recurso.
  • Obtenha a lista de todas as solicitações de cota de um recurso por um ano.

Operações REST

A API de Cota do Azure facilita a pesquisa de suas cotas e a solicitação de aumentos usando estas operações REST:

Pré-requisitos

Importante

Antes de usar a API de Cota, você deve:

Registrando o provedor de recursos de capacidade da Microsoft

Para registrar o provedor de recursos de capacidade da Microsoft, use este comando do PowerShell:

Register-AzResourceProvider -ProviderNamespace Microsoft.Capacity

Ele retorna resultados semelhantes a esta saída:

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

Depois que o provedor de recursos Microsoft.Capacity for registrado, o RegistrationState será definido como Registered. Para obter mais informações sobre como gerenciar provedores de recursos do Azure, consulte Provedores de recursos do Azure.

Função operador de solicitação de cota

A função Operador de Solicitação de Cota é uma função interna do Azure personalizada para operações de cota. Ele concede permissões para ler e criar solicitações de cota, obter status de solicitação de cota e criar tíquetes de suporte. Atribua essa função a usuários, grupos, entidades de serviço, identidades gerenciadas e aplicativos que fazem operações de cota. Para referência, a ID da função operador de solicitação de cota é 0e5f05e5-9ab9-446b-b98d-1e2157c94125.

Cotas do vCPU

Você pode usar a API de Cota para gerenciar cotas para esses dois tipos de cotas de vCPU:

  • Cota de vCPU padrão para VMs pagas conforme o uso e instâncias de VM reservadas .
  • Cota de vCPU spot para VMs Spot .

Para saber mais sobre limites e cotas do Azure, confira Limites, cotas e restrições de assinatura e serviço do Azure.

Cotas do Azure Machine Learning

Você pode usar a API de Cota para gerenciar cotas para workspaces e computação do Azure Machine Learning. Leia o artigo Gerenciar e aumentar cotas de recursos com o Azure Machine Learning para saber mais sobre:

  • Limites padrão de recursos do Azure relacionados ao Azure Machine Learning.
  • Criação de cotas de nível de workspace.
  • Exibição de cotas e limites.
  • Solicitação de aumento de cota.
  • Ponto de extremidade privado e cotas de DNS.

Regiões

A maioria das cotas é específica para uma carga de trabalho em qualquer região. Solicite cotas separadas para cada região em que você deseja implantar um serviço. Para listar todas as regiões do Azure nas quais o serviço existe, use a operação Listar por Regiões de Serviço .

Limitação

Todas as chamadas à API no nível da assinatura e do locatário podem ser limitadas se você enviar muitas solicitações de API. Se a chamada à API for limitada, você receberá uma mensagem de erro informando que o servidor rejeitou a solicitação de API. Você pode repetir a chamada à API após algum tempo ter decorrido.

Para obter detalhes sobre a limitação da API, como solucionar problemas de limitação e como evitar a limitação, consulte Solução de problemas de limitação no Azure.

Solução de problemas de erros de API de Cota

Use as tabelas a seguir para solucionar erros que você pode obter ao usar a API de Cota.

Código do erro Como resolvê-lo
ContactSupport Abra uma nova solicitação de suporte no portal do Azure. Em Selecionar um tipo de problema, escolha Limites de serviço e assinatura (cotas). Você também pode abri-lo programaticamente usando a API REST de Suporte do Azure.
InternalServerError Erro interno do servidor. Tente novamente a chamada à API mais tarde.
MissingRegistration Registre o provedor de recursos Microsoft.Capacity para cada uma de suas assinaturas. Para obter diretrizes de solução de problemas, consulte Resolver erros para o registro do provedor de recursos.
QuotaNotAvailableForResource No momento, a cota está indisponível no local do recurso solicitado. Abra uma nova solicitação de suporte no portal do Azure. Em Selecionar um tipo de problema, escolha Limites de serviço e assinatura (cotas). Você também pode abri-lo programaticamente usando a API REST de Suporte do Azure.
QuotaReductionNotSupported O limite de cota atual é maior que a cota solicitada ou o uso atual é maior que a cota solicitada. Não há suporte para a redução de cotas. A cota não pode ser reduzida.
RequestThrottled Todas as solicitações de API no nível da assinatura e do locatário podem ser limitadas para ajudar no desempenho geral do serviço. O número de solicitações excedeu a taxa máxima de solicitação de API permitida. Tente novamente depois.
ResourceNotAvailableForOffer No momento, o recurso não está disponível no local para o tipo de oferta. Para obter a lista de ofertas atuais e desativadas, consulte a página Detalhes da Oferta do Microsoft Azure . Para alterar o tipo de oferta, consulte a página Alterar sua assinatura do Azure para uma oferta diferente . Você também pode abrir uma nova solicitação de suporte no portal do Azure. Em Selecionar um tipo de problema, escolha Limites de serviço e assinatura (cotas). Você também pode abri-lo programaticamente usando a API REST de Suporte do Azure.
ResourceNotAvailableForSubscription No momento, o recurso está indisponível no local da assinatura solicitada. Abra uma nova solicitação de suporte no portal do Azure. Em Selecionar um tipo de problema, escolha Limites de serviço e assinatura (cotas). Você também pode abri-lo programaticamente usando a API REST de Suporte do Azure.
UnableToIncreaseQuota Não é possível aumentar as cotas para as assinaturas solicitadas. Abra uma nova solicitação de suporte no portal do Azure. Em Selecionar um tipo de problema, escolha Limites de serviço e assinatura (cotas).

Suporte em outras linguagens e interfaces

A API REST de Cota 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
  • SDK do Microsoft Azure para Go: pacote Go

Usando portal do Azure e a API de suporte para gerenciar cotas

O Azure permite que você crie e gerencie solicitações de suporte, também conhecidas como tíquetes de suporte. Você pode: