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

Como parte do ecossistema do Microsoft Partner Center, os parceiros diretos da Microsoft nos programas de Provedor de Soluções em Nuvem podem solicitar a exportação de seus dados cobrados e não cobrados para o Armazenamento de Blobs do Azure de forma assíncrona. Isso elimina a necessidade de manter uma conexão aberta por horas e percorrer 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 de parceiros é definida no subnamespace microsoft.graph.partners.billingOData.

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 de parceiros dá suporte às seguintes permissões de parceiros.

Confiança Zero

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

• Verificar explicitamente
• Usar privilégios mínimos
• Assumir violação

Para saber mais sobre a Confiança Zero e outras maneiras de alinhar sua organização aos princípios orientadores, consulte o Centro de Orientação de 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 uso do Azure de alto volume, cobrados e não cobrados. Essa API também permite exportar dados de reconciliação de faturas faturadas e não faturadas.

Dados de uso cobrado

Dados de uso não cobrados

Dados de reconciliação de fatura cobrada

Dados de reconciliação de fatura não cobrada

Recuperação assíncrona de dados

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

Ponto de extremidade de item de linha de uso

Use a API billedUsage: export ou unbilledUsage: export para acessar itens de linha de consumo faturados ou não cobrados. 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 execução prolongada. Você pode marcar o status da operação de execução prolongada fazendo uma solicitação GET em intervalos regulares até receber um status de êxito com uma URL de manifesto.

Ponto de extremidade do item de linha da fatura

Use a API billedReconciliation: export ou unbilledReconciliation: export para acessar itens de linha de reconciliação de fatura faturados ou não faturados. 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 execução prolongada. Você pode marcar o status da operação de execução prolongada fazendo uma solicitação GET em intervalos regulares até receber um status de êxito com uma URL de manifesto.

Ponto de extremidade de status da operação

Até receber o status de sucesso, continue sondando a API Obter operação em intervalos regulares. Se os dados solicitados não estiverem disponíveis, a resposta da API incluirá um Retry-After cabeçalho que indica quanto tempo você deve esperar antes de enviar outra solicitação. Quando a operação for concluída com êxito, a resposta também fornecerá 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.