Utilizar o Microsoft API do Graph para exportar dados de faturação de parceiros
Observação
Esta API está disponível para parceiros do Fornecedor de Soluções Cloud (CSP) apenas para aceder aos respetivos dados de reconciliação faturados e não faturados de um inquilino. Para saber mais sobre o programa CSP, consulte Fornecedor de Soluções Cloud da Microsoft.
Como parte do ecossistema do Centro de Parceiros da Microsoft, os parceiros diretos da Microsoft nos programas fornecedores de soluções cloud podem pedir para exportar os dados faturados e não faturados para Armazenamento de Blobs do Azure de forma assíncrona. Isto elimina a necessidade de manter uma ligação aberta durante horas e repetir o ciclo através de milhões de transações iterativamente. A API assíncrona fornece uma forma de aceder rapidamente aos dados de faturação e reconciliação em segmentos geríveis.
A API de faturação do parceiro é definida no subnamespace microsoft.graph.partners.billingOData .
Observação
Normalmente, a utilização diária demora 24 horas a aparecer no Centro de Parceiros da Microsoft ou a estar disponível através da API.
Authorization
Para exportar dados de reconciliação, o principal de chamada tem de estar no inquilino do parceiro e ser-lhe-ão concedidas as permissões de privilégios de faturação do parceiro adequadas. A API de faturação do parceiro suporta as seguintes permissões de parceiro.
| Tipo de permissão | Permissão com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| 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
Esta funcionalidade ajuda as organizações a alinhar os respetivos inquilinos com os três princípios de orientação de uma arquitetura Confiança Zero:
- Verificar explicitamente
- Utilizar menos privilégios
- Assumir violação
Para saber mais sobre Confiança Zero e outras formas de alinhar a sua organização com os princípios de orientação, consulte o Centro de Orientação do Confiança Zero.
Casos de uso comuns
A API de faturação de parceiros fornece métodos e ações que permitem aos parceiros diretos da Microsoft exportar os dados de reconciliação faturados de grande volume e dados de utilização do Azure faturados e não faturados.
Dados de utilização faturados
| Caso de uso | API |
|---|---|
| Criar uma nova operação de exportação para exportar dados de utilização faturados | billedUsage: exportação |
| Consultar a atualização do status da operação | Obter operação |
Dados de utilização não faturados
| Caso de uso | API |
|---|---|
| Criar uma nova operação de exportação para exportar dados de utilização não faturados | unbilledUsage: exportação |
| Consultar a atualização do status da operação | Obter operação |
Dados de reconciliação de faturas faturados
| Caso de uso | API |
|---|---|
| Criar uma nova operação de exportação para exportar dados de reconciliação de faturas faturados | billedReconciliation: export |
| Consultar a atualização do status da operação | Obter operação |
Obtenção de dados assíncronos
A transferência de dados de utilização ou reconciliação é uma operação de execução prolongada que consiste nas seguintes operações.
Ponto final do item de linha de utilização
Utilize o billedUsage: export or unbilledUsage: export API to access billed or unbilled consumption line items (Exportar ou não faturado) Usage: export API to access billed or unbilled consumption line items (Exportar API para aceder a itens de linha de consumo faturados ou não faturados). A API devolve um 202 Accepted código de resposta e um Location cabeçalho que contém o URL para a operação de execução prolongada. Pode marcar a status da operação de execução prolongada ao fazer um pedido GET em intervalos regulares até receber um status com êxito com um URL de manifesto.
Ponto final de item de linha sem utilização
Utilize a faturaçãoReconciliation: exportar a API para aceder aos itens da linha de reconciliação de faturas faturados. A API devolve um 202 Accepted código de resposta e um Location cabeçalho que contém o URL para a operação de execução prolongada. Pode marcar a status da operação de execução prolongada ao fazer um pedido GET em intervalos regulares até receber um status com êxito com um URL de manifesto.
Operação status ponto final
Até receber a status de êxito, continue a consultar a API get operation em intervalos regulares. Se os dados pedidos não estiverem disponíveis, a resposta da API inclui um Retry-After cabeçalho que indica quanto tempo deve esperar antes de enviar outro pedido. Quando a operação for concluída com êxito, a resposta também fornece um manifesto com detalhes dos ficheiros gerados. O manifesto fornece uma pasta de armazenamento a partir da qual os dados de faturação reais podem ser transferidos. A resposta divide ou particiona os ficheiros para otimizar o débito e o paralelismo de E/S.