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.