az carbon
Note
Эта ссылка является частью расширения carbon для Azure CLI (версия 2.70.0 или более поздней). Расширение автоматически установит первый раз, когда вы запускаете команду az carbon . Подробнее о расширениях.
Управление углеродом.
Команды
| Имя | Описание | Тип | Состояние |
|---|---|---|---|
| az carbon get-emission-data-available-date-range |
API для запроса данных о выбросах углерода, доступных для диапазона дат. |
Extension | GA |
| az carbon get-emission-report |
API для отчетов о выбросах углерода. |
Extension | GA |
az carbon get-emission-data-available-date-range
API для запроса данных о выбросах углерода, доступных для диапазона дат.
az carbon get-emission-data-available-date-range [--acquire-policy-token]
[--change-reference]
Примеры
Запрос данных о выбросах углерода, доступный диапазон дат
az carbon get-emission-data-available-date-range
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Автоматическое получение маркера Политика Azure для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Связанный идентификатор ссылки на изменение для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az carbon get-emission-report
API для отчетов о выбросах углерода.
az carbon get-emission-report --carbon-scope-list
--date-range
--subscription-list
[--acquire-policy-token]
[--change-reference]
[--item-details]
[--location-list]
[--monthly-summary]
[--overall-summary]
[--resource-group-urls]
[--resource-type-list]
[--top-items-monthly]
[--top-items-summary]
Примеры
Общий сводный отчет 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
Ежемесячный сводный отчет 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
Отчет сведений об элементе 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}"
Сводный отчет о верхних элементах 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}"
Ежемесячный сводный отчет queryCarbonEmission Top Items
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}
Обязательные параметры
Список областей выбросов углерода. Required. Принимает одно или несколько значений из ВыбросовScopeEnum (например, Scope1, Scope2, Scope3) в форме списка. Выходные данные будут включать общий объем выбросов для указанных областей. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Дата начала и окончания данных о выбросах углерода. Required. Для ItemDetailsReport и TopItemsSummaryReport поддерживается только один месяц данных, поэтому даты начала и окончания должны быть равными в DateRange (например, начало: 2024-06-01 и конец: 2024-06-01). Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Список идентификаторов подписок, для которых запрашиваются данные о выбросах углерода. Required. Каждый идентификатор подписки должен быть в нижнем регистре. Максимальная длина списка составляет 100. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Автоматическое получение маркера Политика Azure для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Связанный идентификатор ссылки на изменение для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Используйте этот параметр, чтобы получить отчет сведений о элементе для поддержки сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Список расположений (Azure отображаемое имя региона) для данных о выбросах углерода с каждым расположением, указанным в нижнем регистре (например, "восточная часть сша"). Optional. Команду az account list-locations -o table можно использовать для поиска отображаемых имен Azure региона. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Используйте этот параметр, чтобы получить ежемесячный сводный отчет о поддержке сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Используйте этот параметр, чтобы получить общий сводный отчет о поддержке сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Список URL-адресов группы ресурсов для данных о выбросах углерода. Optional. Каждый URL-адрес должен соответствовать формату "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}" и должен находиться в нижнем регистре. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Список типов ресурсов для данных о выбросах углерода. Optional. Каждый тип ресурса должен быть указан в нижнем регистре, следуя формату "microsoft". {service}/{resourceType}", например "microsoft.storage/storageaccounts". Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Используйте этот параметр, чтобы получить краткий синтаксис отчета "Основные элементы", json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Используйте этот параметр, чтобы получить краткий синтаксис сводки элементов, json-file и yaml-file. Попробуйте "??", чтобы показать больше.
| Свойство | Значение |
|---|---|
| Группа параметров: | QueryParameters Arguments |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |