Partilhar via


Automação para parceiros

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. Os parceiros e seus clientes podem usar tarefas comuns das APIs de gerenciamento de custos. Para obter mais informações sobre cenários de não automação, consulte Gerenciamento de custos para parceiros.

Nota

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. As versões mais recentes da API podem ter melhorado a funcionalidade. As versões posteriores da API suportam versões anteriores.

APIs de gerenciamento de custos da Microsoft - Provedores diretos e indiretos

Os parceiros com acesso aos âmbitos de faturação num inquilino do parceiro podem utilizar as seguintes APIs 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 utilizadores com acesso à subscrição, como o cliente ou o revendedor, só podem chamar as APIs depois de o parceiro ativar a política de custos do inquilino do cliente.

Para obter uma lista de contas de faturação

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 subscrições

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 devolve uma matriz de faturas com elementos semelhantes ao seguinte código JSON.

   {      "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 ID retornado anterior e substitua-o no exemplo a seguir como escopo.

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01 

O exemplo devolve os registos de utilização 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 faturação

Recomendamos que você configure uma exportação para esses cenários. Para obter mais informações, consulte Recuperar grandes conjuntos de dados de uso com exportações.

Para transferir a utilização do serviço do Azure de um cliente

Recomendamos que você configure uma exportação para este cenário 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, consulte Obter conjuntos de dados de pequeno custo sob demanda.

Para obter ou transferir a folha de preços dos serviços do Azure consumidos

Primeiro, utilize a seguinte publicação.

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 de propriedade da 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 devolve a ligação de transferência com a folha 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 

Eliminar um orçamento

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01