Automatización para los asociados

  • Artículo

Azure Cost Management está disponible de forma nativa para los asociados directos que hayan incorporado sus clientes a un contrato de cliente de Microsoft y hayan adquirido un plan de Azure. Los asociados y sus clientes pueden usar las tareas comunes de las API de Cost Management. Para obtener más información sobre escenarios sin automatización, consulte Cost Management para asociados.

API de Azure Cost Management: proveedores directos e indirectos

Los asociados con acceso a los ámbitos de facturación en el inquilino de un asociado pueden usar las siguientes API para ver los costos facturados.

Un asociado puede llamar a las API en el ámbito de la suscripción (independientemente de la directiva de costos) siempre que tenga acceso a la suscripción. Otros usuarios con acceso a la suscripción, como el cliente o el revendedor, pueden llamar a las API solo después de que el asociado habilite la directiva de costos para el inquilino del cliente.

Para obtener una lista de cuentas de facturación

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

Para obtener una lista de clientes

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview

Para obtener una lista de suscripciones

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview

Para obtener una lista de las facturas de un período de tiempo

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate}

La llamada API devuelve una matriz de facturas que tiene elementos similares al siguiente código JSON.

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    }

Use el valor de campo de identificador devuelto anterior y reemplácelo en el ejemplo siguiente como ámbito para consultar los detalles de uso.

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

En el ejemplo se devuelven los registros de uso asociados a la factura específica.

Para obtener la directiva para que los clientes vean los costos

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview

Para establecer la directiva para que los clientes vean los costos

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview

Para obtener el uso del servicio de Azure de una cuenta de facturación

Se recomienda configurar una exportación para estos escenarios. Para obtener más información, consulte Recuperación de grandes conjuntos de datos con exportaciones.

Para descargar el uso del servicio de Azure de un cliente

Se recomienda configurar también una exportación para este escenario. Sin embargo, si necesita descargar los datos a petición, puede usar la API de Detalles del costo. Para obtener más información, consulte Obtención de conjuntos de datos de costos pequeños a petición.

Para obtener o descargar la hoja de precios de los servicios de Azure consumidos

En primer lugar, use la siguiente entrada.

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose

A continuación, llame al valor de la propiedad de operación asincrónica. Por ejemplo:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview

La llamada GET anterior devuelve el vínculo de descarga que contiene la hoja de precios.

Para obtener los costos agregados

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01

Creación de un presupuesto para un asociado

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01

Creación de un presupuesto para un cliente

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01

Eliminación de un presupuesto

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

Pasos siguientes