Automatização para parceiros

  • Artigo

O Azure Cost Management está disponível de forma nativa para os parceiros diretos que tenham integrado os clientes num Contrato de Cliente Microsoft e tenham comprado um Plano do Azure. Os parceiros e os clientes podem utilizar tarefas comuns das APIs do Cost Management. Para obter mais informações sobre cenários de não automatização, veja Cost Management para Parceiros.

APIs do Azure Cost Management – Fornecedores 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.

As APIs no âmbito da subscrição podem ser chamadas por um parceiro, independentemente da política de custos, desde que tenham acesso à subscrição. 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 de tempo

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

Utilize o valor de campo do ID anterior devolvido e substitua-o no exemplo seguinte como âmbito para consultar os detalhes de utilização.

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 configure uma Exportação para estes cenários. Para obter mais informações, veja Obter grandes conjuntos de dados de utilização com exportações.

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

Recomendamos que configure também uma Exportação para este cenário. No entanto, se precisar de transferir os dados a pedido, pode utilizar a API Detalhes de Custos . Para obter mais informações, veja Obter conjuntos de dados de custos pequenos a pedido.

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

Passos seguintes