Partager via


az carbon

Note

Cette référence fait partie de l’extension carbone pour Azure CLI (version 2.70.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az carbon . Apprenez-en davantage sur les extensions.

Gérer le carbone.

Commandes

Nom Description Type État
az carbon get-emission-data-available-date-range

API pour interroger la plage de dates disponible des données d’émission de carbone.

Extension GA
az carbon get-emission-report

API pour les rapports sur les émissions de carbone.

Extension GA

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

API pour interroger la plage de dates disponible des données d’émission de carbone.

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

Exemples

Interroger la plage de dates disponibles des données d’émission de carbone

az carbon get-emission-data-available-date-range
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az carbon get-emission-report

API pour les rapports sur les émissions de carbone.

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]

Exemples

Rapport de synthèse global Query CarbonEmission

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

Rapport de synthèse mensuel Query CarbonEmission

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

Rapport détails de l’élément Query CarbonEmission

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}"

Rapport récapitulatif des éléments principaux Query CarbonEmission

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}"

Rapport récapitulative mensuel des éléments Query CarbonEmission

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}

Paramètres obligatoires

--carbon-scope-list

Liste des étendues d’émissions de carbone. Required. Accepte une ou plusieurs valeurs de EmissionScopeEnum (par exemple, Scope1, Scope2, Scope3) dans le formulaire de liste. La sortie inclut le total des émissions pour les étendues spécifiées. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--date-range

Dates de début et de fin des données sur les émissions de carbone. Required. Pour ItemDetailsReport et TopItemsSummaryReport, un seul mois de données est pris en charge à la fois. Par conséquent, les dates de début et de fin doivent être égales dans DateRange (par exemple, début : 2024-06-01 et fin : 2024-06-01). Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--subscription-list

Liste des ID d’abonnement pour lesquels les données sur les émissions de carbone sont demandées. Required. Chaque ID d’abonnement doit être au format minuscule. La longueur maximale de la liste est de 100. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--item-details

Utilisez cette option pour obtenir la syntaxe abrégée, le fichier json et le fichier yaml-support du rapport Détails de l’élément. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--location-list

Liste des emplacements (Nom complet de la région Azure) pour les données d’émissions de carbone, avec chaque emplacement spécifié en minuscules (par exemple, « usa est »). Optional. Vous pouvez utiliser la commande « az account list-locations -o table » pour rechercher les noms d’affichage de région Azure. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--monthly-summary

Utilisez cette option pour obtenir le rapport de synthèse mensuelle Prise en charge de la syntaxe abrégée, du fichier json et du fichier yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--overall-summary

Utilisez cette option pour obtenir l’ensemble du rapport récapitulative Prise en charge de la syntaxe abrégée, du fichier json et du fichier yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--resource-group-urls

Liste des URL de groupe de ressources pour les données d’émissions de carbone. Optional. Chaque URL doit suivre le format « /subscriptions/{subscriptionId}/resourcegroups/{resourceGroup} » et doit se trouver en minuscules. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--resource-type-list

Liste des types de ressources pour les données d’émissions de carbone. Optional. Chaque type de ressource doit être spécifié en minuscules, en suivant le format ' microsoft. {service}/{resourceType}', par exemple « microsoft.storage/storageaccounts ». Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--top-items-monthly

Utilisez cette option pour obtenir la syntaxe abrégée, le fichier json et le fichier yaml-file des éléments principaux. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
--top-items-summary

Utilisez cette option pour obtenir la prise en charge du rapport de synthèse des éléments principaux, la syntaxe abrégée, le fichier json et le fichier yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: QueryParameters Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False