Partilhar via


Limitação

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

O estrangulamento divide-se em diferentes políticas de quotas:

  • Total de Pedidos - número total de pedidos
  • Largura de banda total - dados de saída em bytes
  • Armazenamento - tamanho total de armazenamento dos dados do usuário em bytes

Manipulação de respostas limitadas

Quando o limite de taxa para uma determinada cota for atingido, o servidor responderá a outras solicitações desse tipo com um código de status 429 . A resposta 429 conterá um cabeçalho 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 é aconselhado a diminuir a velocidade e esperar 10 milissegundos antes de tentar quaisquer outras solicitações. Os clientes também devem considerar o recuo progressivo.

Outras tentativas

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

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

Monitorização

Para exibir o uso da cota Total de Solicitações, a Configuração do Aplicativo fornece uma métrica chamada Uso da Cota de Solicitação. A métrica de uso da 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 Aplicativo, consulte Referência de dados de Configuração de Aplicativo.