Diretrizes de limitação do Microsoft Graph

Os limites de controle limitam número de chamadas simultâneas para um serviço para evitar a utilização exagerada dos recursos. O serviço Microsoft Graph implementa limites de limitação para garantir a disponibilidade e a confiabilidade do serviço.

Os limites de controle variam de acordo com o cenário. Por exemplo, se você estiver executando um grande volume de gravações, a possibilidade de limitação será maior do que se você estiver apenas executando leituras.

O que acontece quando a limitação ocorre?

Quando um limite de limitação é excedido, o Microsoft Graph:

• Limita quaisquer solicitações adicionais desse aplicativo cliente por algum tempo.
• Retorna o código de status HTTP 429 Muitas solicitações e as solicitações falham.
• Retorna um tempo de espera sugerido no cabeçalho de resposta da solicitação com falha.

O comportamento da limitação pode depender do tipo e do número de solicitações. Por exemplo, se você tiver um grande volume de solicitações, todos os tipos de solicitações serão limitados. Os limites variam de acordo com o tipo de solicitação. Portanto, você pode encontrar um cenário em que as gravações são limitadas, mas as leituras ainda são permitidas.

Cenários comuns de limitação

As causas mais comuns de limitação dos clientes incluem:

• Um grande número de solicitações em todos os aplicativos em um locatário.
• Um grande número de solicitações de um aplicativo específico entre todos os locatários.

Resposta de amostra

Sempre que o limite de estrangulamento é excedido, o Microsoft Graph responde com uma resposta semelhante a esta.

HTTP/1.1 429 Too Many Requests
Content-Length: 312
Content-Type: application/json
Retry-After: 10

{
  "error": {
    "code": "TooManyRequests",
    "innerError": {
      "code": "429",
      "date": "2020-08-18T12:51:51",
      "message": "Please retry after",
      "request-id": "94fb3b52-452a-4535-a601-69e0a90e3aa2",
      "status": "429"
    },
    "message": "Please retry again later."
  }
}

Práticas recomendadas para lidar com a limitação

Estas são as práticas recomendadas para lidar com a limitação:

• Reduza o número de operações por solicitação.
• Reduza a frequência de chamadas.
• Evite novas tentativas imediatas, pois todas as solicitações se acumulam em relação aos seus limites de uso.

Ao implementar o tratamento de erros, use o código de erro HTTP 429 para detectar limitação. A resposta com falha inclui o cabeçalho de Retry-After resposta. Recuar em solicitações usando o Retry-After atraso é a maneira mais rápida de se recuperar da limitação porque o Microsoft Graph continua a registrar o uso de recursos enquanto um cliente está sendo limitado.

1. Aguarde o número de segundos especificado no cabeçalho Retry-After.
2. Repita a solicitação.
3. Se a solicitação falhar novamente com um código de erro 429, você ainda está sendo limitado. Continue a usar o atraso recomendado Retry-After e repita a solicitação até que ela seja bem-sucedida.

Todos os recursos e APIs descritos nos limites específicos do serviço fornecem um Retry-After cabeçalho, exceto quando indicado.

Para uma discussão mais ampla sobre a limitação no Microsoft Cloud, veja Padrão de Limitação.

Práticas recomendadas para evitar a limitação

Padrões de programação como pesquisando continuamente um recurso para verificar se há atualizações e a verificação regular das coleções de recursos para verificar se há recursos novos ou excluídos, possuem maior propensão de levar aplicativos a serem regulados e prejudicam o desempenho geral. Em vez disso, você deve usar o controle de alterações e as notificações de alterações , quando disponíveis.

Limitação e dosagem

O lote JSON permite que você otimize seu aplicativo combinando várias solicitações em um único objeto JSON. As solicitações em um lote são avaliadas individualmente em relação aos limites de limitação e, se alguma solicitação exceder os limites, ela falhará com um código de status e 429 um erro semelhante à resposta de exemplo anterior. O lote em si é bem-sucedido com um código de status de 200 (OK). Várias solicitações podem ser limitadas em um único lote. Você deve tentar novamente a cada solicitação com falha no lote utilizando o valor fornecido no cabeçalho de resposta retry-after do conteúdo JSON. Você pode repetir todas as solicitações com falha em um novo lote após o valor mais longo retry-after .

Se os SDKs repetirem as solicitações limitadas automaticamente quando não estiverem agrupadas, as solicitações limitadas que faziam parte de um lote não serão repetidas automaticamente.

Próxima etapa