Descrição geral das APIs e serviços limitados no Microsoft Graph
O Microsoft Graph inclui APIs que estão disponíveis sem custos adicionais com licenças de subscrição de utilizador e APIs e serviços com tráfego limitado. As APIs e serviços limitados no Microsoft Graph incorrem em custos com base na utilização. Os custos podem ser incorridos por chamada à API efetuada, por objeto devolvido numa chamada à API ou através de outras medidas.
Com tráfego limitado ou não, as APIs no Microsoft Graph seguem estes dois princípios:
- Propriedade dos dados do cliente: os dados do cliente pertencem ao cliente. Saiba mais sobre como a Microsoft categoriza os dados dos clientes.
- Acesso razoável: o serviço fornece acesso ao conteúdo do cliente, dentro dos limites definidos.
A medição de algumas APIs ajuda a garantir o estado de funcionamento do ecossistema atual e futuro do Microsoft Graph ao equilibrar o acesso e o custo da plataforma. No caso de uma API do Microsoft Graph incluída com licenças de subscrição de utilizador ficar com tráfego limitado, isso seria uma alteração não retrocompatível e aplicar-se-iam as políticas de controlo de versões, suporte e alteração interruptiva do Microsoft Graph .
Para obter a lista de APIs e serviços medidos, veja APIs e serviços medidos.
Categorias de API e medição
As APIs do Microsoft Graph enquadram-se em três categorias e a medição pode ser aplicada com base na categoria da API.
APIs Padrão
A maioria das APIs do Microsoft Graph são APIs padrão. Estas APIs executam operações padrão (criar, ler, atualizar, eliminar) no conteúdo do cliente e nos pontos finais administrativos. Os limites de acesso razoáveis para estas APIs são definidos com base nos limiares de utilização documentados. Isto ajuda a garantir uma experiência positiva do cliente e incentiva padrões de utilização eficientes da API. O acesso às APIs padrão dentro dos limiares de utilização definidos está disponível como parte da licença de utilizador sem custos adicionais.
APIs de alta capacidade
As APIs de alta capacidade garantem que os clientes e programadores têm acesso aos dados em escala. Esta categoria inclui pontos finais de exportação ou importação em massa criados para fins e serviços do Microsoft Graph. Estas APIs podem ser limitadas e incorrer em custos adicionais para além das licenças de subscrição de utilizador.
APIs Avançadas
As APIs avançadas fornecem acesso a dados melhorados ou agregados ou a funcionalidades avançadas que se expandem a partir do Microsoft 365. A API assignSensitivityLabel é um exemplo de uma API avançada. Estas APIs podem ser limitadas e incorrer em custos adicionais para além das licenças de subscrição de utilizador.
Aceder a APIs com tráfego limitado
Para aceder a APIs e serviços limitados no Microsoft Graph, uma aplicação tem de estar associada a uma subscrição ativa do Microsoft Azure. Para obter detalhes sobre como associar uma aplicação a uma subscrição, consulte Ativar APIs e serviços com tráfego limitado no Microsoft Graph.
Considerações sobre a utilização de APIs com tráfego limitado
Tenha em atenção as seguintes considerações quando utilizar APIs e serviços com tráfego limitado no Microsoft Graph:
- As APIs com tráfego limitado podem devolver erros relacionados com o estado da subscrição, além de outros erros comuns. Para obter detalhes sobre os erros do Microsoft Graph, veja Erros e tipos de recursos do Microsoft Graph.
- As APIs com tráfego limitado são faturadas de acordo com a utilização da API. Certifique-se de que compreende a unidade de medição para que possa estimar os custos associados a uma API específica.
Limitações conhecidas
As seguintes limitações aplicam-se às APIs com tráfego limitado:
- Atualmente, as APIs e serviços medidos no Microsoft Graph estão disponíveis apenas no ambiente global da Microsoft e não em implementações na cloud nacionais, incluindo implementações do Microsoft 365 GCC acedidas através do ponto final mundial do Microsoft Graph. Para obter detalhes sobre clouds nacionais, veja Implementações de cloud nacionais.
- A aplicação de destino tem de ser uma aplicação cliente confidencial (por exemplo, aplicação Web, API Web ou daemon/serviço). As aplicações cliente públicas (aplicações móveis e de ambiente de trabalho) não são suportadas.
- As identidades geridas do Azure não são suportadas para chamar APIs com tráfego limitado. Para obter mais informações, veja Serviços do Azure que suportam identidades geridas.