Tutorial: inicialización de un conjunto de datos de costo histórico con la API de exportaciones

Artículo
01/07/2025

A menudo, las grandes organizaciones necesitan analizar sus costos históricos que vuelven un año o más. La creación del conjunto de datos podría ser necesaria para las consultas de un solo uso dirigidas o para configurar paneles de informes para visualizar las tendencias de costos a lo largo del tiempo. En cualquier caso, necesita una manera de obtener los datos de forma confiable para poder cargarlos en un almacén de datos que pueda consultar. Después de inicializar el conjunto de datos de costos históricos, el almacén de datos se puede actualizar a medida que entren nuevos costos para que los informes se mantengan actualizados. Los costos históricos rara vez cambian pero, si es así, se le notificará. Por lo tanto, se recomienda actualizar los costos históricos no más de una vez al mes.

En este tutorial, aprenderá a:

Obtener un token de portador para la entidad de servicio
Dar formato a la solicitud
Ejecutar las solicitudes en fragmentos de un mes

Prerrequisitos

Necesita permisos adecuados para llamar correctamente a la API de exportaciones. Se recomienda usar una entidad de servicio en escenarios de automatización.

Para más información, consulte Asignación de permisos a las API de Cost Management.
Para obtener más información sobre los permisos específicos necesarios para la API de exportaciones, consulte Descripción y trabajo con ámbitos.

Además, necesita una manera para consultar la API directamente. Algunas formas populares de consultar la API son:

Obtener un token de portador para la entidad de servicio

Para obtener información sobre cómo obtener un token de portador con una entidad de servicio, consulte Adquisición de un token de acceso.

Dar formato a la solicitud

Consulte la siguiente solicitud de ejemplo y cree su propia exportación de datos de un solo uso. La solicitud de ejemplo siguiente crea un conjunto de datos de costo real de un mes en la cuenta de almacenamiento de Azure especificada. Se recomienda que no solicite más de un mes de datos por informe. Si tiene un conjunto de datos grande cada mes, se recomienda establecer partitionData = true para la exportación única a fin de dividirlo en varios archivos. Para obtener más información, consulte Creación de particiones de archivos para grandes conjuntos de datos.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{enrollmentId}/providers/Microsoft.CostManagement/exports/{ExportName}?api-version=2021-10-01

Encabezados de solicitud

Authorization: <YOUR BEARER TOKEN>
Accept: /*/
Content-Type: application/json

Cuerpo de la solicitud

{
  "properties": {
    "definition": {
      "dataset": {
        "granularity": "Daily",
        "grouping": []
      },
      "timePeriod": {
        "from": "2021-09-01T00:00:00.000Z",
        "to": "2021-09-30T00:00:00.000Z"
      },
      "timeframe": "Custom",
      "type": "ActualCost"
    },
    "deliveryInfo": {
      "destination": {
        "container": "{containerName}",
        "rootFolderPath": "{folderName}",
        "resourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}"
      }
    },
    "format": "Csv",
    "partitionData": false
  }
}

Crear exportaciones en fragmentos de un mes

Se recomienda crear exportaciones de datos únicas en fragmentos de un mes. Si desea inicializar un conjunto de datos histórico de un año, debe ejecutar 12 solicitudes de API de exportaciones, una por cada mes. Después de haber consultado el conjunto de datos histórico, puede crear entonces una exportación programada para seguir rellenando los datos de costos en Azure Storage a medida que se acumulan los cargos.

Ejecutar cada exportación

Ahora que ha creado la exportación para cada mes, debe ejecutar manualmente cada una mediante una llamada a la API Ejecutar. A continuación se muestra una solicitud de ejemplo a la API.

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/exports/{exportName}/run?api-version=2021-10-01

Pasos siguientes

En este tutorial ha aprendido a:

Obtener un token de portador para la entidad de servicio
Dar formato a la solicitud
Ejecutar las solicitudes en fragmentos de un mes

Para más información sobre los detalles de costos, consulte Ingesta de datos de detalles de costos.

Para más información sobre qué datos están disponibles en el conjunto de datos de detalles de costos, consulte Descripción de los campos de datos de detalles de costos.

Compartir a través de