Limites da plataforma

A plataforma não fornece um valor infinito de recursos e os limites são impostos sobre o número de chamadas de API que podem ser feitas.

Um arquiteto de soluções precisa garantir que a solução não exceda os limites impostos pela plataforma, projetando de forma adequada e garantindo que o código personalizado possa lidar com a violação de limites.

Solicitações de API

As solicitações no Microsoft Power Platform consistem em várias ações de um usuário em vários produtos. A seguinte lista descreve o que constitui uma solicitação de API, em alto nível:

• Power Apps: todas as solicitações de API a conectores e ao Microsoft Dataverse.
• Power Automate: todas as solicitações de API a conectores, ações HTTP e ações internas da inicialização de variáveis para uma ação de composição simples. Contagem de ações com êxito e com falha para esses limites. Além disso, novas tentativas e outras solicitações de paginação também contam como implementações de ações. Como regra geral, cada etapa em um fluxo da nuvem do Power Automate é uma solicitação de API.
• Dataverse: todas as operações CRUD (criar, ler, atualizar e excluir) atribuem e compartilham operações, incluindo solicitações do sistema internas e orientadas pelo usuário necessárias para concluir transações CRUD, bem como operações especiais como compartilhar ou atribuir. Essas solicitações podem ser de qualquer cliente ou aplicativo e podem usar qualquer ponto de extremidade. Essas solicitações incluem, mas não se limitam a, plug-ins, fluxos de trabalho clássicos e controles personalizados que realizam as operações previamente mencionadas.

Limites de direito

Os limites de direito representam o número de solicitações de API que os usuários têm direito a fazer a cada dia. O limite alocado depende do tipo de licença atribuído a cada usuário. Os limites de direito de API se baseiam em um período de 24 horas, conforme mostrado na tabela a seguir.

O Dataverse permite ter identidades que não exigem uma licença de usuário para interagir com o serviço. Os quatro tipos de usuários são:

• Usuários do aplicativo
• Usuários não interativos
• Usuários administrativos
• Usuário do SISTEMA

Cada locatário tem uma capacidade de solicitação básica para cada locatário que só pode ser usado por esses usuários e não por usuários com licenças padrão. Essa capacidade de solicitação básica se baseia no tipo de assinatura, da seguinte maneira:

• Se um locatário tiver pelo menos uma assinatura do Dynamics 365 Enterprise, ele receberá 100.000 solicitações a cada 24 horas.
• Se um locatário tiver pelo menos uma assinatura do Dynamics 365 Professional, ele receberá 50.000 solicitações a cada 24 horas.
• Se um locatário tiver pelo menos uma assinatura do Microsoft Power Apps ou do Power Automate, ele receberá 25.000 solicitações a cada 24 horas.

O complemento de capacidade do Power Apps e do Power Automate permite que os clientes aumentem os limites de determinado usuário. Cada complemento de capacidade eleva os limites da solicitação por mais 10.000 a cada 24 horas.

Limites de serviço

Além do limite diário de solicitações de API, estão disponíveis limites de proteção de serviço que são específicos de cada serviço. Como ocorre com os limites diários, os limites de serviço ajudam a manter a qualidade do serviço, protegendo o serviço de um comportamento mal-intencionado ou indevido que poderia dificultar o serviço para todos os clientes.

Os limites da API de proteção de serviço ajudam a garantir que os usuários que executam aplicativos não possam interferir entre si com base em restrições de recursos. Os limites não afetarão os usuários normais da plataforma. Somente os aplicativos que executam várias solicitações de API podem ser afetados. Os limites fornecem um nível de proteção contra aumentos aleatórios e inesperados em volumes de solicitação que ameaçam as características de disponibilidade e desempenho da plataforma do Dataverse.

A Microsoft limita o número de conexões simultâneas para cada conta de usuário, o número de solicitações de API para cada conexão e a quantidade de runtime que pode ser usada para cada conexão. Essas limitações são avaliadas em uma janela deslizante de cinco minutos. Quando um desses limites for excedido, uma exceção será lançada pela plataforma.

Repetir políticas e padrões

A lógica personalizada que usa as APIs deve tratar repetições. Quando ocorre um erro de limite da API de proteção de serviço, ele fornece um valor indicando que a duração antes de uma nova solicitação do usuário pode ser processada.

A API Web retornará um erro 429 se o limite for atingido. A resposta incluirá Retry-After com o número de segundos. Com o Serviço da Organização, um valor TimeSpan é retornado na coleção OrganizationServiceFault.ErrorDetails com a chave Retry-After.

Para obter mais informações, consulte Limites de proteção de serviço.

Minimizar chamadas de API

O projeto da solução não deve depender da capacidade infinita disponível. Para usuários normais de aplicativos interativos, os limites foram definidos altos o suficiente para que os usuários não sejam afetados.

Os aplicativos criados para carregar dados no Dataverse ou executar atualizações em massa também devem ser capazes de gerenciar erros de limite de API de proteção de serviço. Esses aplicativos priorizam a taxa de transferência para poder concluir o trabalho no período mínimo. Esses aplicativos devem ter uma estratégia para repetir operações.

Os aplicativos de portal costumam enviar solicitações de usuários anônimos por meio de uma conta principal de serviço. Como os limites da API de proteção de serviço se baseiam em cada usuário, os aplicativos de portal podem atingir os limites da API de proteção de serviço com base na quantidade de tráfego do portal.

As integrações devem ser otimizadas para minimizar o número de chamadas à API.

O arquiteto de soluções também deve considerar a alta disponibilidade no design da solução.