Exportación de datos de emisiones de optimización de carbono de Azure (versión preliminar)
Artículo
Exporte datos de emisiones de optimización de carbono de Azure a través de la API REST o mediante Azure Portal para descargar un archivo CSV.
Los datos de emisiones están disponibles para el mes anterior en el día 17 del mes actual.
Exportación de datos de emisiones a un archivo CSV mediante Azure Portal
Puede exportar los datos de emisiones en formato CSV desde la página Tendencias de emisiones y la página Detalles de emisiones en Optimización del carbono de Azure en Azure Portal. Descargue y analice los datos de emisiones mediante sus herramientas preferidas, como Excel o Power BI.
Para exportar datos de emisiones desde estas páginas, seleccione la Exportar a CSV.
Los datos siguientes están disponibles en un archivo CSV descargado.
Tendencias de emisiones. Los últimos 12 meses de los datos de los filtros seleccionados, entre los que se incluyen:
Ámbito 1, 2, 3 y emisiones totales
Intensidad del carbono
Detalles de las emisiones
Suscripción/Grupo de recursos/Recurso/Servicio/Ubicación
Emisiones del mes más recientes
Emisiones del mes anterior
Reducciones de emisiones
Acciones recomendadas para reducir las emisiones
Exportación de datos de emisiones mediante la API REST
Para exportar datos de emisiones mediante la API REST, debe crear y autorizar a una entidad de servicio para acceder a los datos de emisiones. Después, puede usar la entidad de servicio para obtener un token de autorización y, a continuación, exportar datos de emisiones mediante la API REST.
Creación y autorización de una entidad de servicio para exportar datos de emisiones
Una entidad de servicio es una aplicación cuyos tokens se pueden usar para autenticar y conceder acceso a recursos específicos de Azure mediante el identificador de Microsoft Entra (anteriormente Azure Active Directory). Los recursos incluyen aplicaciones de usuario, servicios o herramientas de automatización.
Guarde el identificador de inquilino, el nuevo identificador de cliente y el valor del secreto de cliente de la aplicación para usarlo en las solicitudes de token.
A la aplicación se le debe asignar el rol de Carbon Optimization Reader para los recursos para los que desea exportar los datos de emisiones. Si planea usar la aplicación para exportar datos de emisiones para muchos recursos, puede asignar el rol en el nivel de suscripción o grupo de recursos. Para más información, consulte Asignación de roles de Azure mediante Azure Portal.
Obtención de un token de autorización
Envíe la siguiente solicitud en el símbolo del sistema o mediante un cliente como Postman.
Emisiones totales para todos los ámbitos de suscripciones y intervalo de fechas especificados en la entrada.
Datos de informes de alto nivel necesarios
MonthlySummaryReport
Emisiones para todas las suscripciones y ámbitos de emisión de cada mes especificados en el intervalo de fechas.
Desglose mensual
TopItemsSummaryReport
Emisiones de elementos X principales agregados entre suscripciones, emisiones, ámbito, categoría y intervalo de fechas especificado, desglosados por categoría.
Datos de los elementos principales por categoría
TopItemsMonthlySummaryReport
Emisiones de los elementos X principales agregados en suscripciones, emisiones, ámbitos y categoría para cada mes especificado en el intervalo de fechas. Las emisiones se desglosan por categoría. Los elementos X principales se basan en las emisiones del mes pasado.
Datos de los elementos principales por categoría y mes
ItemDetailsReport
Emisiones agregadas entre ámbitos y suscripciones seleccionadosID para un intervalo de fechas determinado y desglosados por categoría especificada.
Datos de emisiones por categoría
Exportación de parámetros de la API de emisiones
En la tabla siguiente se describen los parámetros que puede usar para exportar datos de emisiones mediante la API REST.
Parámetro
Tipo
Descripción
reportType
Cuerda
Nombre del tipo de informe. Valores admitidos:
OverallSummaryReport
MonthlySummaryReport
TopItemsSummaryReport
TopItemsMonthlySummaryReport
ItemDetailsReport
subscriptionList
[String]
Lista subscriptionId a la que desea consultar. El cliente debe tener acceso a estas suscripciones.
resourceGroupUrlList
[String]
Lista de direcciones URL de resourceGroup para la que desea obtener datos. Por ejemplo:
Lista de ámbitos de carbono. Valores admitidos: Scope1, Scope2 y Scope3. Esta lista puede ser cualquier combinación de estos tres ámbitos.
dateRange
Estructura
Admite un mes de los últimos 12 meses. El mes inicial y final debe ser igual y debe ser el primer día de un mes. Se produce una excepción cuando no se cumplen estos criterios.
Por ejemplo
dateRange": {
"start": "2023-03-01",
"end": "2023-03-01}
start y formato de end: aaaa-mm-dd.
Actualmente, los datos de emisiones de carbono se actualizan mensualmente. Por lo tanto, el valor de las propiedades dateRangestart y end debe ser el primer día de cada mes.
Nota
dateRange admite un mes a la vez (desde los últimos 12 meses). Se produce una excepción cuando las fechas de inicio y finalización son diferentes.
Parámetros específicos del informe
En la tabla siguiente se muestran parámetros adicionales necesarios para cada tipo de informe.
AdditionalParameter
Tipo
Descripción
Informes
categoryType
Cuerda
Se admiten cinco tipos de categoría:
Subscription
Location
ServiceType
ResourceGroup
Resource
TopItemsSummaryReport
TopItemsMonthlySummaryReport
ItemDetailsReport
topItemsCount
Entero
Los elementos x principales que se van a mostrar (>5)
TopItemsSummaryReport
TopItemsMonthlySummaryReport
ItemDetailsReport
category
Cuerda
Nombre de categoría.
Por ejemplo, "category": "ResourceGroup"
pageSize
Entero
Tamaño de página del resultado de la consulta. El valor predeterminado es 1000. El valor máximo es 2000.
ItemDetailsReport
orderBy
Cuerda
Consulte la tabla siguiente para ver los valores admitidos, junto con los tipos de categoría admitidos.
ItemDetailsReport
sortDirection
Cuerda
Valores de compatibilidad: Desc, Asc
ItemDetailsReport
groupCategory
Cuerda
Esto se puede establecer como una cadena vacía. Valores válidos: ResourceGroup y SubscriptionId
ItemDetailsReport
Ordenar por columnas
Las columnas de resultados siguientes admiten el parámetro orderBy.
Ordenar por nombre de columna
Tipo de categoría
Name
todo excepto Subscription
TotalCarbonEmission
todo
TotalCarbonEmissionLastMonth
todo
ResourceGroup
solo para Resource categoría
SubscriptionId
Subscription, Resource y categoría de ResourceGroup