Compartilhar via


Usar o microsoft API do Graph para exportar dados de cobrança de parceiros

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Observação

Essa API está disponível para parceiros do CSP (Provedor de Soluções na Nuvem) apenas para acessar seus dados de reconciliação cobrados e não faturados para um locatário. Para saber mais sobre o programa CSP, consulte Microsoft Cloud Solution Provider.

Como parte do ecossistema do Microsoft Partner Center, os parceiros diretos da Microsoft nos programas do Provedor de Soluções na Nuvem podem solicitar a exportação de seus dados cobrados e não faturados para Armazenamento de Blobs do Azure de forma assíncrona. Isso remove a necessidade de manter uma conexão aberta por horas e fazer loop por meio de milhões de transações iterativamente. A API assíncrona fornece uma maneira de acessar rapidamente dados de cobrança e reconciliação em partes gerenciáveis.

A API de cobrança do parceiro é definida no subnamespace microsoft.graph.partners.billingOData .

Observação

O uso com classificação diária normalmente leva 24 horas para aparecer no Centro de Parceiros da Microsoft ou para estar disponível por meio da API.

Authorization

Para exportar dados de reconciliação, a entidade de chamada deve estar no locatário do parceiro e receber as permissões apropriadas de privilégio de cobrança do parceiro. A API de cobrança do parceiro dá suporte às seguintes permissões de parceiro.

Tipo de permissão Permissão menos privilegiada Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) PartnerBilling.Read.All Sem suporte.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application PartnerBilling.Read.All Sem suporte.

Confiança Zero

Esse recurso ajuda as organizações a alinhar suas identidades com os três princípios orientadores de uma arquitetura Confiança Zero:

  • Verificar explicitamente
  • Usar privilégio mínimo
  • Assumir violação

Para saber mais sobre Confiança Zero e outras maneiras de alinhar sua organização aos princípios orientadores, consulte o Centro de Diretrizes Confiança Zero.

Casos de uso comuns

A API de cobrança de parceiros fornece métodos e ações que permitem que os parceiros diretos da Microsoft exportem seus dados de reconciliação cobrados em alto volume e dados de uso cobrados e não faturados do Azure.

Dados de uso cobrados

Caso de uso API
Criar uma nova operação de exportação para exportar dados de uso cobrados billedUsage: exportação
Sondagem para atualização de status de operação Obter operação

Dados de uso nãobilizados

Caso de uso API
Criar uma nova operação de exportação para exportar dados de uso não faturados unbilledUsage: export
Sondagem para atualização de status de operação Obter operação

Dados de reconciliação de fatura cobrada

Caso de uso API
Criar uma nova operação de exportação para exportar dados de reconciliação de fatura cobrada billedReconciliation: export
Sondagem para atualização de status de operação Obter operação

Recuperação de dados assíncrona

O download de dados de uso ou reconciliação é uma operação de longa execução que consiste nas operações a seguir.

Ponto de extremidade do item de linha de uso

Use o billedUsage: export or unbilledUsage: export API to access billed or unbilled consumption items. A API retorna um 202 Accepted código de resposta e um Location cabeçalho que contém a URL para a operação de longa execução. Você pode marcar o status da operação de longa execução fazendo uma solicitação GET em intervalos regulares até receber um status de sucesso com uma URL de manifesto.

Ponto de extremidade de item de linha sem uso

Use a cobrançaReconciliation: exportar API para acessar itens de linha de reconciliação de fatura cobrada. A API retorna um 202 Accepted código de resposta e um Location cabeçalho que contém a URL para a operação de longa execução. Você pode marcar o status da operação de longa execução fazendo uma solicitação GET em intervalos regulares até receber um status de sucesso com uma URL de manifesto.

Ponto de extremidade da operação status

Até receber o status de sucesso, continue pesquisando a API de Operação Get em intervalos regulares. Se os dados solicitados não estiverem disponíveis, a resposta à API inclui um Retry-After cabeçalho que indica quanto tempo você deve aguardar antes de enviar outra solicitação. Quando a operação for concluída com êxito, a resposta também fornece um manifesto com detalhes dos arquivos gerados. O manifesto fornece uma pasta de armazenamento da qual os dados reais de cobrança podem ser baixados. A resposta divide ou particiona os arquivos para otimizar a taxa de transferência e o paralelismo de E/S.