Partilhar via

Limitação orientações | Conceitos da Graph API

  • Artigo

Importante

Recomendamos vivamente que utilize Microsoft Graph em vez do AD Graph API do Azure para aceder aos recursos do Azure Active Directory. A nossa esforços de desenvolvimento são agora concentrated no Microsoft Graph e estão a ser planeados sem melhoramentos adicionais para AD Graph API do Azure. Existem um número muito limitado de cenários para o qual AD Graph API do Azure ainda poderá ser apropriado; Para obter mais informações, consulte o Microsoft Graph ou o Azure AD Graph blogue no Dev Center do Office.

O que é a limitação?

Limitação limita o número de chamadas simultâneas para um serviço para evitar overuse de recursos. Gráfico do Azure Active Directory (AD) foi concebido para processar um volume muito elevado de pedidos. Em caso de um número muito confuso de pedidos, a limitação ajuda a manter o desempenho ideal e fiabilidade do serviço Azure AD Graph.

Os limites de limitação variam com base no cenário. Por exemplo, se estiver a executar um grande volume de escritas para o seu inquilino, a possibilidade de limitação é superior ao se estiver a efetuar apenas operações de leitura.

O que acontece quando limitação ocorre?

Quando um limitação limiar for excedido, o Azure AD Graph limita quaisquer pedidos de mais do que o cliente enquanto a limitação está em vigor. Quando limitado, Azure AD Graph devolve o código de estado HTTP 429 ("demasiados muitos pedidos"), e falharem os pedidos. Comportamento de limitação pode ser dependente no tipo e número de pedidos. Por exemplo, se tiver um grande volume de pedidos, todos os tipos de pedidos são limitados. Limites de limiar variam com base no tipo pedido. Por conseguinte, foi possível encontrar um cenário onde escritas limitadas mas leituras ainda são permitidas.

Cenários comuns de limitação

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

  • Um grande número de pedidos em todas as aplicações de um inquilino.
  • Um grande número de pedidos de uma determinada aplicação em todos os inquilinos.

Melhores práticas para processar a limitação

  • Reduza o número de operações por pedido.
  • Reduza a frequência de chamadas.
  • Quando pedidos falharam com um código de erro HTTP 429, aguarde que o número de segundos especificado para o campo de cabeçalho depois de repetir resposta e repita o pedido.

Quando implementa o processamento de erros, utilize o código de erro HTTP 429 para detetar a limitação. A resposta de falha irá incluir o depois de repetir campo no cabeçalho de resposta.

  1. Aguarde que o número de segundos especificado no depois de repetir campo.
  2. Repita o pedido.
  3. Se o pedido novamente falhar com um código de 429 erro, ainda está a ser limitada, continuar a utilizar o atraso de repetição após recomendado e repita o pedido até ter êxito.

Cópia de pedidos utilizando o depois de repetir atraso é a forma mais rápida para recuperar de otimização porque o AAD gráfico continua a utilização de recursos de registo enquanto um cliente está a ser limitado. Deve evitar repetições imediatas, uma vez que todos os pedidos acumular contra os limites de utilização.

Para ver um debate mais amplo de limitação no Microsoft Cloud, consulte limitação padrão.