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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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 |
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 |
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.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 |