Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Microsoft Graph inclui APIs que estão disponíveis sem custo adicional com licenças de assinatura de usuário e APIs e serviços que são limitados. As APIs e serviços limitados no Microsoft Graph incorrem em custos com base no uso. Os custos podem ser incorridos por chamada à API feita, por objeto retornado em uma chamada à API ou por outras medidas.
Limitadas 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 a integridade do ecossistema atual e futuro do Microsoft Graph, equilibrando o acesso à plataforma e o custo. No caso de uma API do Graph do Microsoft Graph incluída nas licenças de assinatura do usuário se tornar limitada, isso seria uma alteração não compatível com versões anteriores e as políticas de controle de versão, suporte e alteração significativa do Microsoft Graph seriam aplicadas.
Para obter a lista de APIs e serviços limitados, consulte APIs e serviços limitados.
Categorias e medição de API
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 Standard
A maioria das APIs do Microsoft Graph são APIs padrão. Essas APIs executam operações padrão (criar, ler, atualizar, excluir) no conteúdo do cliente e nos 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 para o cliente e incentiva padrões eficientes de uso da API. O acesso a APIs padrão dentro dos limites de uso definidos está disponível como parte da licença do usuário sem custos adicionais.
APIs de alta capacidade
APIs de alta capacidade garantem que clientes e desenvolvedores tenham acesso aos dados em escala. Esta categoria inclui pontos de extremidade de exportação ou importação em massa criados para fins específicos e serviços do Microsoft Graph. Essas APIs podem ser limitadas e incorrer 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 funcionalidades avançadas que se estendem do Microsoft 365. A API assignSensitivityLabel é um exemplo de uma API avançada. Essas APIs podem ser limitadas e incorrer em custos adicionais além das licenças de assinatura do usuário.
Acessar APIs limitadas
Para acessar APIs e serviços limitados no Microsoft Graph, um aplicativo deve estar 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 limitados no Microsoft Graph.
Considerações sobre o uso de APIs limitadas
Lembre-se das seguintes considerações ao usar APIs e serviços limitados no Microsoft Graph:
- As APIs limitadas podem retornar erros relacionados ao status da assinatura, 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 possa estimar os custos associados a uma API específica.
Limitações conhecidas
As seguintes limitações se aplicam a APIs limitadas:
- Atualmente, as APIs e os serviços limitados no Microsoft Graph estão disponíveis apenas no ambiente global da Microsoft e não em implantações de nuvem nacional, incluindo implantações do Microsoft 365 GCC acessadas por meio do ponto de extremidade mundial do Microsoft Graph. 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/serviço). Não há suporte para aplicativos cliente públicos (aplicativos móveis e da área de trabalho).
- As identidades gerenciadas do Azure não têm suporte para chamar APIs limitadas. Para obter mais informações, consulte Serviços do Azure que dão suporte a identidades gerenciadas.