Visão geral das APIs e serviços medidos no Microsoft Graph

  • Artigo

O Microsoft Graph inclui APIs que estão disponíveis sem nenhum custo adicional com licenças de assinatura de usuário e APIs e serviços que são medidos. APIs e serviços medidos no Microsoft Graph incorrem em custos com base no uso. Os custos podem ser incorridos por chamada de API feita, por objeto retornado em uma chamada de API ou por meio de outras medidas.

Medindo ou não, as APIs no Microsoft Graph seguem estes dois princípios:

Medir algumas APIs ajuda a garantir a integridade do ecossistema atual e futuro do Microsoft Graph equilibrando o acesso e o custo da plataforma. No caso de um microsoft API do Graph incluído com licenças de assinatura de usuário se tornar medido, isso seria uma alteração compatível com o inverso e as políticas de versão, suporte e alteração incompatíveis para o Microsoft Graph se aplicariam.

Para obter a lista de APIs e serviços medidos, consulte APIs e serviços medidos.

Categorias de API e medição

As APIs do Microsoft Graph se enquadram 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. Essas APIs executam operações padrão (criar, ler, atualizar, excluir) em conteúdo do cliente e pontos de extremidade administrativos. Limites de acesso razoáveis para essas APIs são definidos com base em limites de uso documentados. Isso ajuda a garantir uma experiência positiva do cliente e incentiva padrões eficientes de uso de API. O acesso a APIs padrão dentro dos limites de uso definidos está disponível como parte da licença de usuário sem custos adicionais.

APIs de alta capacidade

APIs de alta capacidade garantem que clientes e desenvolvedores tenham acesso a dados em escala. Essa categoria inclui pontos de extremidade de exportação ou importação em massa e serviços do Microsoft Graph. Essas APIs podem ser medidas e incorrem em custos adicionais além das licenças de assinatura do usuário.

APIs avançadas

AS APIs avançadas fornecem acesso a dados enriquecidos ou agregados ou funcionalidade avançada que se estende do Microsoft 365. A API assignSensitivityLabel é um exemplo de uma API avançada. Essas APIs podem ser medidas e incorrem em custos adicionais além das licenças de assinatura do usuário.

Acessando APIs limitadas

Para acessar APIs e serviços medidos no Microsoft Graph, um aplicativo deve ser associado a uma assinatura ativa do Microsoft Azure. Para obter detalhes sobre como associar um aplicativo a uma assinatura, consulte Habilitar APIs e serviços medidos no Microsoft Graph.

Considerações sobre o uso de APIs limitadas

Tenha em mente as seguintes considerações ao usar APIs e serviços medidos no Microsoft Graph:

  • AS APIs limitadas podem retornar erros relacionados à sua assinatura status além de outros erros comuns. Para obter detalhes sobre erros do Microsoft Graph, consulte erros do Microsoft Graph e tipos de recursos.
  • AS APIs limitadas são cobradas de acordo com o uso da API. Certifique-se de entender a unidade de medição para que você possa estimar os custos associados a uma API específica.

Limitações conhecidas

As seguintes limitações se aplicam às APIs limitadas:

  • ApIs e serviços medidos no Microsoft Graph estão disponíveis atualmente apenas no ambiente global da Microsoft e não em implantações de nuvem nacionais, incluindo implantações do Microsoft 365 GCC acessadas por meio do ponto de extremidade do Microsoft Graph em todo o mundo. Para obter detalhes sobre nuvens nacionais, consulte Implantações de nuvem nacional.
  • O aplicativo de destino deve ser um aplicativo cliente confidencial (por exemplo, aplicativo Web, API Web ou daemon/service). Não há suporte para aplicativos de cliente público (aplicativos móveis e desktop).

Conteúdo relacionado