Automação para parceiros

  • Artigo

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