Automação para parceiros
O Gerenciamento de Custos do Azure está disponível nativamente para os parceiros diretos que integraram os clientes a um Contrato de Cliente da Microsoft e compraram um plano do Azure. Parceiros e seus clientes podem usar as APIs de gerenciamento de custos para tarefas comuns. Para obter mais informações sobre cenários que não são de automação, consulte Gerenciamento de Custos para Parceiros.
APIs do Gerenciamento de Custos do Azure: provedores diretos e indiretos
Os parceiros com acesso aos escopos de cobrança em um locatário do parceiro podem usar as APIs a seguir para ver os custos faturados.
As APIs no escopo da assinatura podem ser chamadas por um parceiro, seja qual for a política de custo, caso tenham acesso à assinatura. Outros usuários com acesso à assinatura, como o cliente ou o revendedor, poderão chamar as APIs somente depois que o parceiro habilitar a política de custo para o locatário do cliente.
Para obter uma lista de contas de cobrança
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview
Para obter uma lista de clientes
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview
Para obter uma lista de assinaturas
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview
Para obter uma lista de faturas por um período
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate}
A chamada à API retorna uma matriz de faturas que tem elementos semelhantes ao código JSON a seguir.
{ "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}", "name": "{InvoiceID}", "properties": { "amountDue": { "currency": "USD", "value": x.xx }, ... }
Use o valor do campo ID retornado anteriormente e substitua-o no exemplo a seguir como o escopo para consulta dos detalhes de uso.
GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01
O exemplo retorna os registros de uso associados à fatura específica.
Para obter a política para os clientes verem os custos
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview
Para definir a política para os clientes verem os custos
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview
Para obter a utilização do serviço do Azure para uma conta de cobrança
Recomendamos que você configure uma Exportação para esses cenários. Para obter mais informações, consulte Recuperar grandes conjunto de dados de uso com exportações.
Para baixar a utilização do serviço do Azure de um cliente
Recomendamos que você configure uma Exportação para esses cenários também. No entanto, se você precisar baixar os dados sob demanda, poderá usar a API de Detalhes de Custo. Para obter mais informações, confira Obter pequenos conjuntos de dados de custo sob demanda.
Para obter ou baixar a lista de preços dos serviços do Azure consumidos
Primeiro, use o POST a seguir.
POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose
Em seguida, chame o valor da propriedade de operação assíncrona. Por exemplo:
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview
A chamada GET anterior retorna o link de download que contém a lista de preços.
Para obter custos agregados
POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01
Criar um orçamento para um parceiro
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01
Criar um orçamento para um cliente
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01
Excluir um orçamento
DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01
Próximas etapas
- Saiba mais sobre a automação de Gerenciamento de Custos e Cobrança na visão geral de automação de Gerenciamento de Custos. Cenários para automação.
- Introdução ao Gerenciamento de Custos do Azure para parceiros.
- Recuperação de conjuntos grandes de dados com exportações.
- Como compreender os campos de detalhes de uso.