Compartilhar via

Automação para parceiros

  • Artigo

O Gerenciamento de Custos da Microsoft está disponível nativamente para parceiros diretos que integraram seus 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.

Observação

Embora versões específicas da API sejam mostradas nos exemplos deste artigo, recomendamos que você use a versão mais recente da API disponível. Versões mais recentes da API podem ter funcionalidades aprimoradas. Versões posteriores da API oferecem suporte a versões anteriores.

APIs de Gerenciamento de Custos da Microsoft – 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.

Os parceiros podem chamar APIs no escopo da assinatura, independentemente da política de custo, desde que 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 para um período específico

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        },        ...    }

Para consultar detalhes de uso, use o valor do campo de ID retornado anteriormente e substitua-o no exemplo a seguir como o escopo.

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

Conteúdo relacionado