Compartilhar via

Limitação

  • Artigo

Os repositórios de configuração têm limites para as solicitações que podem atender. Todas as solicitações que excederem uma cota alocada para um repositório de configuração receberão uma resposta HTTP 429 (Muitas Solicitações).

A limitação é dividida em diferentes políticas de cota:

  • Total de Solicitações – número total de solicitações
  • Largura de Banda Total – dados de saída em bytes
  • Armazenamento – tamanho total de armazenamento dos dados do usuário em bytes

Tratamento de respostas limitadas

Quando o limite de taxa para uma determinada cota for atingido, o servidor responderá a solicitações posteriores desse tipo com um código de status 429. A resposta 429 conterá um header retry-after-ms, fornecendo ao cliente um tempo de espera sugerido (em milissegundos) para permitir que a cota de solicitação seja reabastecida.

HTTP/1.1 429 (Too Many Requests)
retry-after-ms: 10
Content-Type: application/problem+json; charset=utf-8

{
  "type": "https://azconfig.io/errors/too-many-requests",
  "title": "Resource utilization has surpassed the assigned quota",
  "policy": "Total Requests",
  "status": 429
}

No exemplo acima, o cliente excedeu sua cota permitida, e é aconselhável reduzir e aguardar 10 milissegundos antes de tentar outras solicitações. Os clientes também devem considerar o backoff progressivo.

Outra tentativa

O serviço pode identificar situações diferentes da limitação que precisam de uma nova tentativa do cliente (p. ex.: 503 Serviço Indisponível). Em todos esses casos, o cabeçalho de resposta retry-after-ms será fornecido. Para aumentar a robustez, é aconselhável que o cliente siga o intervalo sugerido e execute uma nova tentativa.

HTTP/1.1 503 Service Unavailable
retry-after-ms: 787

Monitoramento

Para exibir o uso da cota de Total de Solicitações, a Configuração de Aplicativos fornece uma métrica chamada Uso de Cota de Solicitação. A métrica de uso de cota de solicitação mostra o uso atual da cota como uma porcentagem.

Para obter mais informações sobre a métrica de uso de cota de solicitação e outras métricas de Configuração de Aplicativos, consulte Referência de dados de Configuração de Aplicativos de monitoramento.