Compartir vía

Automatización para los asociados

  • Artículo

Microsoft Cost Management está disponible de forma nativa para asociados directos que incorporaron a sus clientes a un Contrato de cliente de Microsoft y compraron 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 los escenarios sin automatización, consulte Cost Management for Partners.

Nota:

Aunque en los ejemplos de este artículo se muestran versiones de API específicas, se recomienda usar la versión más reciente de la API disponible. Es posible que las versiones de API más recientes hayan mejorado la funcionalidad. Las versiones de API posteriores admiten versiones anteriores.

API de Microsoft 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.

Los asociados pueden llamar a las API en el ámbito de la suscripción, independientemente de la directiva de costos, siempre y cuando tengan 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 facturas durante un 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}

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

Para consultar los detalles de uso, use el valor del campo Id. devuelto anterior y reemplácelo en el ejemplo siguiente como ámbito.

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

Contenido relacionado