Compartilhar via

FAQ sobre APIs e serviços medidos no Microsoft Graph

  • Artigo

Este artigo fornece respostas a perguntas mais frequentes sobre APIs e serviços limitados no Microsoft Graph.

FAQs sobre a configuração da faturação

Que permissões são necessárias para configurar a faturação?

A configuração da faturação requer permissões para o registo de aplicações e para a subscrição do Azure que pretende utilizar. As permissões necessárias para o registo de aplicações são Proprietário da Aplicação ou Administrador de Aplicações. As permissões necessárias para a subscrição do Azure são Contribuidor da Subscrição, Proprietário/Contribuidor do Grupo de Recursos ou Proprietário.

Posso utilizar um principal de serviço para configurar a faturação no registo da minha aplicação?

Sim, requer um administrador de aplicação ou uma função semelhante para o registo de aplicações atribuído ao principal de serviço. A função só pode ser confinada à aplicação de destino configurada para faturação para impedir que sejam concedidas permissões excessivamente amplas.

Posso utilizar uma identidade gerida para configurar a faturação no registo da minha aplicação?

Sim, pode criar uma identidade gerida para os recursos do Azure. Atribua o controlo de acesso baseado em funções à sua subscrição ou grupo de recursos e adicione a função de administrador da aplicação Microsoft Entra ao principal de serviço associado à identidade gerida. Para obter mais informações, veja Tutorial: Utilizar uma VM/VMSS do Windows para aceder aos recursos do Azure , por exemplo.

Como posso verificar se a minha aplicação está configurada corretamente para faturação?

Para obter informações sobre como verificar a configuração da faturação, veja Ativar APIs e serviços limitados.

FAQs sobre a faturação da API de exportação do Microsoft Teams

Existem mais requisitos para além da configuração da faturação para chamar as APIs de exportação do Microsoft Teams?

Sim, as APIs de exportação do Microsoft Teams requerem a passagem de um model parâmetro como parte da chamada à API. Dependendo do valor do model parâmetro, também pode ser necessária uma licença de utilizador para determinados dados. Para obter mais informações, veja Modelos de pagamento e requisitos de licenciamento da API do Teams.

Como posso saber que parâmetro de modelo está a ser utilizado nas chamadas à API?

A melhor forma de determinar que model parâmetro está a ser utilizado é inspecionar o código da aplicação de chamada.

Como é calculada a capacidade propagada?

A capacidade propagada para as APIs de exportação do Teams que estão a ser chamadas com o model=a parâmetro é calculada com base no número de utilizadores elegíveis no inquilino de destino. Em seguida, a capacidade propagada é aplicada a cada aplicação em execução nesse inquilino.

Como é aplicada a capacidade propagada?

A capacidade propagada é avaliada no início do mês e qualquer licença elegível conta para o cálculo ao nível do inquilino da capacidade semeada. Em seguida, cada aplicação consome a capacidade propagada que lhe é atribuída até ficar esgotada. Em seguida, o consumo adicional por parte da aplicação é medido e é apresentado na fatura mensal.

O que acontece quando uma aplicação registada, mas não configurada para faturação, inicia uma chamada à API de exportação do Teams com tráfego limitado?

A chamada à API falha com um erro 402 de pagamento obrigatório. Isto ocorre mesmo quando direciona um utilizador com uma licença de utilizador válida e transmite o model=a parâmetro .

O que acontece quando o parâmetro do modelo é excluído de uma chamada a uma API de exportação do Microsoft Teams que o requer?

Ao chamar uma API sem um parâmetro necessário, a API é predefinida model para o comportamento do modo de avaliação. O modo de avaliação fornece um número limitado de chamadas à API por mês antes de devolver o erro 402 de pagamento necessário. O modo de avaliação é fornecido apenas para avaliação e desenvolvimento e não se destina à utilização de produção.

FAQ do consumidor da aplicação

Porque é que o meu fornecedor de aplicações está a pedir-me para configurar a faturação?

O proprietário do registo de aplicações processa a faturação de APIs e serviços limitados no Microsoft Graph. Se adquiriu uma aplicação que exige que seja o proprietário do registo da aplicação, é responsável por quaisquer APIs e serviços medidos utilizados pela aplicação.

Preciso de licenças para todos os utilizadores no meu inquilino?

É necessária uma licença para cada utilizador sujeito a políticas de segurança e conformidade. Outros cenários podem não exigir uma licença. Para obter mais informações, veja Modelos de pagamento e requisitos de licenciamento da API do Teams.

FAQ sobre gestão de custos e faturação

Onde posso obter as informações de faturação de APIs e serviços medidos?

Os dados de faturação são submetidos para a subscrição do Azure utilizada para criar o recurso de faturação do Microsoft Graph com o nome do serviço Serviços Microsoft Graph e, normalmente, estão disponíveis 24 horas após a ocorrência das transações.

Para obter mais informações, veja Descrição geral da faturação e gestão de custos do Azure.

A tabela seguinte lista as ferramentas utilizadas mais frequentemente para rever e monitorizar os custos de faturação.

Tipo Descrição
Análise de custos Gráfico interativo que apresenta o consumo. Sugestão: utilize os custos acumulados e filtre por serviços de nome de serviço do Microsoft Graph.
Exportações Cria relatórios detalhados com a frequência pretendida (por exemplo, diariamente ou mensalmente).
Alertas Configura alertas ao combinar filtros.

A fatura está dividida para cada API?

A tabela seguinte mostra como os detalhes de faturação podem ser agregados ou quebrados.

Tipo Propriedade Exportações Filtro de análise de custos, orçamentos e alertas
Informações do medidor MeterName, MeterId, MeterCategory, MeterSubcategory, ProductName, ConsumedService Medidor, Categoria do medidor, Subcategoria do medidor, Nome do serviço
Informações de recursos InstanceId, ResourceType, ResourceGroup, SubscriptionGuid Recurso, Guid de recurso, Tipo de recurso, Grupo de recursos, Nome do serviço
Marcações TenantId TenantId
AdditionalInfo AppId, TenantId

Alguns pontos finais podem partilhar um medidor e os dados de faturação não podem ser divididos por ponto final. Em alternativa, uma aplicação cliente pode configurar o registo de API do lado do cliente ou utilizar os registos de atividades do Microsoft Graph.

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.

Conteúdo relacionado