Visão geral da API de Gerenciamento de Custos do Microsoft 365 Copilot

A API de Gerenciamento de Custos do Microsoft 365 Copilot permite que os administradores controlem e observem o consumo de créditos de Copilot e IA pelos locatários por meio do Microsoft Graph, com base em /copilot/costManagement. O contrato é sensível à unidade e denominado a crédito. Abrange o saldo de crédito do locatário snapshot, o gerenciamento da política de gastos, o escopo do público-alvo do grupo, as configurações por serviço, os alertas de limite somente de notificação e seus destinatários e os saldos de consumo por usuário.

A API é denominada em crédito e exclui deliberadamente a moeda classificada, as faturas, os preços e as previsões de compra.

Principais recursos

• Leia o snapshot do saldo de crédito em todo o locatário, com uma linha por método de cobrança.
• Crie, leia, atualize e exclua políticas de gastos que limitem o consumo de Créditos do Copilot para um público-alvo.
• Defina o escopo de uma política para cada usuário no locatário (allUsersSpendingPolicy) ou para grupos selecionados (selectedGroupsSpendingPolicy).
• Gerenciar o público-alvo de um grupo de políticas por meio de $ref links de referência.
• Defina configurações por serviço que regem ou excluem serviços de IA individuais em uma política.
• Configure alertas de limite somente de notificação e gerencie seus destinatários.
• Diagnostique o saldo de consumo por serviço de um usuário e entenda por que um usuário pode ou não consumir um serviço.

Exemplos de cenários

• Um administrador define um limite de crédito mensal para um grupo piloto e alerta os administradores quando o uso atinge 80%.
• Um administrador adiciona ou remove um serviço controlado em uma política existente.
• Um administrador de suporte diagnostica por que um usuário não pode mais consumir um serviço lendo o saldo por serviço desse usuário.
• Um leitor FinOps lista as políticas de gastos habilitadas do locatário e analisa seus limites configurados.

Personas e funções

As personas-alvo incluem o administrador de IA e o administrador de licenças para gerenciamento de políticas; o Leitor FinOps/Global e o Administrador de Faturamento para leituras; e o administrador de Suporte/Assistência Técnica para o diagnóstico por usuário. A criação de uma política de gastos também requer a função de diretório Administrador de Cobrança ou Administrador Global no tempo de execução.

Permissões

Essa API usa a família de CopilotCostManagement-* permissões. A maioria das operações dá suporte apenas a permissões delegadas (conta corporativa ou de estudante); a leitura do saldo de crédito do locatário (getTenantCreditBalance) também dá suporte à permissão do CopilotCostManagement.Read.All aplicativo. Não há suporte para contas Microsoft pessoais. Escolha a permissão menos privilegiada para cada operação.

Lista de APIs

Simultaneidade e semântica de remoção

• Para alterar uma política existente e seus recursos filho (configurações de serviço e links de referência), inclua um If-Match cabeçalho com a ETag da política pai. As configurações de serviço e os links de referência não têm sua própria ETag. A política pai gerencia a simultaneidade e aparece como parentEtag em uma configuração de serviço. Quando você cria uma política, ela não tem ETag existente e não usa If-Match.
• A serviceSettings coleção não dá suporte a DELETE. Defina state como disabled para remover um serviço. A entrada permanece nesse estado.
• Gerencie as assignedGroupsrecipients e relações como propriedades de navegação de referência com $ref adicionar e remover.

Condições de erro

As respostas de erro usam o OData error e innerError o envelope padrão. O relata innerError.code condições específicas da carga de trabalho, enquanto o OData error.code padrão relata condições genéricas. A segurança em nível de linha é executada antes da pesquisa, portanto, um recurso de locatário fora do escopo retorna uma 404 resposta em vez de uma 403 resposta.

Conteúdo relacionado

• tipo de recurso spendingPolicy
• costManagementUserBalance tipo de recurso