Compartir a través de

az carbon

Note

Esta referencia forma parte de la extensión carbon para la CLI de Azure (versión 2.70.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az carbon . Obtenga más información sobre las extensiones.

Administrar carbono.

Comandos

Nombre Description Tipo Estado
az carbon get-emission-data-available-date-range

API para consultar el intervalo de fechas disponible de los datos de emisión de carbono.

 Extension GA
az carbon get-emission-report

API para informes de emisiones de carbono.

 Extension GA

az carbon get-emission-data-available-date-range

API para consultar el intervalo de fechas disponible de los datos de emisión de carbono.

az carbon get-emission-data-available-date-range

Ejemplos

Consulta del intervalo de fechas disponible de datos de emisión de carbono

az carbon get-emission-data-available-date-range
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az carbon get-emission-report

API para informes de emisiones de carbono.

az carbon get-emission-report --carbon-scope-list
                              --date-range
                              --subscription-list
                              [--item-details]
                              [--location-list]
                              [--monthly-summary]
                              [--overall-summary]
                              [--resource-group-urls]
                              [--resource-type-list]
                              [--top-items-monthly]
                              [--top-items-summary]

Ejemplos

Informe de resumen general de QueryCarbonEmission

az carbon get-emission-report --subscription-list "[00000000-0000-0000-0000-000000000000]" --carbon-scope-list "[Scope1,Scope2,Scope3]" --date-range "{start:2024-03-01,end:2025-03-01}" --overall-summary

Informe de resumen mensual de QueryCarbonEmission

az carbon get-emission-report --subscription-list "[00000000-0000-0000-0000-000000000000]" --carbon-scope-list "[Scope1,Scope2,Scope3]" --date-range "{start:2024-03-01,end:2025-03-01}" --monthly-summary

Informe de detalles del elemento QueryCarbonEmission

az carbon get-emission-report --subscription-list "[00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001]" --carbon-scope-list "[Scope1,Scope2,Scope3]" --date-range "{start:2025-03-01,end:2025-03-01}" --item-details "{category-type:ResourceType,order-by:itemName,page-size:10,sort-direction:asc}"

Informe de resumen de elementos principales de QueryCarbonEmission

az carbon get-emission-report --subscription-list "[00000000-0000-0000-0000-000000000000,00000000-0000-0000-0000-000000000001]" --carbon-scope-list "[Scope1,Scope2,Scope3]" --date-range "{start:2025-03-01,end:2025-03-01}" --top-items-summary "{category-type:ResourceType,top-items:5}"

Informe de resumen mensual de elementos principales de QueryCarbonEmission

az carbon get-emission-report --subscription-list "[00000000-0000-0000-0000-000000000000]" --carbon-scope-list "[Scope1,Scope2,Scope3]" --date-range "{start:2024-03-01,end:2025-03-01}" --top-items-monthly "{category-type:ResourceType,top-items:5}

Parámetros requeridos

--carbon-scope-list

Lista de ámbitos de emisión de carbono. Required. Acepta uno o varios valores de EmissionScopeEnum (por ejemplo, Scope1, Scope2, Scope3) en forma de lista. La salida incluirá las emisiones totales de los ámbitos especificados. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--date-range

Las fechas de inicio y finalización de los datos de emisiones de carbono. Required. Para ItemDetailsReport y TopItemsSummaryReport, solo se admite un mes de datos a la vez, por lo que las fechas de inicio y finalización deben ser iguales en DateRange (por ejemplo, start: 2024-06-01 y end: 2024-06-01). Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--subscription-list

Lista de identificadores de suscripción para los que se solicitan los datos de emisiones de carbono. Required. Cada identificador de suscripción debe estar en minúsculas. La longitud máxima de la lista es 100. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--item-details

Use esta opción para obtener la sintaxis abreviada del informe de detalles del elemento, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--location-list

Lista de ubicaciones (nombre para mostrar de la región de Azure) para los datos de emisiones de carbono, con cada ubicación especificada en minúsculas (por ejemplo, "este de nosotros"). Optional. Puede usar el comando "az account list-locations -o table" para buscar nombres para mostrar de la región de Azure. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--monthly-summary

Use esta opción para obtener el informe de resumen mensual Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--overall-summary

Use esta opción para obtener el informe de resumen general Compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--resource-group-urls

Lista de direcciones URL del grupo de recursos para los datos de emisiones de carbono. Optional. Cada dirección URL debe seguir el formato '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}', y debe estar en minúsculas. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--resource-type-list

Lista de tipos de recursos para los datos de emisiones de carbono. Optional. Cada tipo de recurso debe especificarse en minúsculas, siguiendo el formato "microsoft". {service}/{resourceType}', por ejemplo, 'microsoft.storage/storageaccounts'. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--top-items-monthly

Use esta opción para obtener la sintaxis abreviada del informe de resumen mensual de elementos principales, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
--top-items-summary

Use esta opción para obtener la sintaxis abreviada del informe de resumen de elementos principales, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: QueryParameters Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False