az carbon

Note

This reference is part of the carbon extension for the Azure CLI (version 2.70.0 or higher). The extension will automatically install the first time you run an az carbon command. Learn more about extensions.

Manage Carbon.

Comandos

Nome	Description	Tipo	Status
az carbon get-emission-data-available-date-range	API para consultar o intervalo de datas disponíveis para dados de emissão de carbono.	Extension	GA
az carbon get-emission-report	API para Relatórios de Emissões de Carbono.	Extension	GA

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

API para consultar o intervalo de datas disponíveis para dados de emissão de carbono.

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

Exemplos

Consultar o intervalo de datas disponíveis dos dados de emissão de carbono

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

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az carbon get-emission-report

API para Relatórios de Emissões 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]

Exemplos

Relatório de Resumo Geral 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

Relatório de Resumo Mensal 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

Relatório de detalhes do item 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}"

Relatório de resumo dos principais itens 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}"

Relatório de Resumo Mensal dos Principais Itens 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 Exigidos

--carbon-scope-list

Lista de escopos de emissão de carbono. Required. Aceita um ou mais valores de EmissionScopeEnum (por exemplo, Scope1, Scope2, Scope3) no formulário de lista. A saída incluirá o total de emissões para os escopos especificados. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--date-range

As datas de início e término dos dados de emissões de carbono. Required. Para ItemDetailsReport e TopItemsSummaryReport, há suporte para apenas um mês de dados por vez, portanto, as datas de início e término devem ser iguais no DateRange (por exemplo, início: 2024-06-01 e término: 2024-06-01). Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--subscription-list

Lista de IDs de assinatura para as quais os dados de emissões de carbono são solicitados. Required. Cada ID de assinatura deve estar em formato minúsculo. O comprimento máximo da lista é 100. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--item-details

Use essa opção para obter a sintaxe abreviada, json-file e yaml-file do Suporte ao Relatório de Detalhes do Item. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--location-list

Lista de locais (Nome de Exibição da Região do Azure) para dados de emissões de carbono, com cada local especificado em letras minúsculas (por exemplo, 'leste de nós'). Optional. Você pode usar o comando 'az account list-locations -o table' para localizar nomes de exibição da região do Azure. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--monthly-summary

Use esta opção para obter o relatório de resumo mensal Suporte a sintaxe de taquigrafia, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--overall-summary

Use esta opção para obter o relatório de resumo geral Suporte a sintaxe de taquigrafia, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--resource-group-urls

Lista de URLs do grupo de recursos para dados de emissões de carbono. Optional. Cada URL deve seguir o formato '/subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}' e deve estar em letras minúsculas. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--resource-type-list

Lista de tipos de recursos para dados de emissões de carbono. Optional. Cada tipo de recurso deve ser especificado em letras minúsculas, seguindo o formato 'microsoft. {service}/{resourceType}', por exemplo, 'microsoft.storage/storageaccounts'. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--top-items-monthly

Use essa opção para obter a sintaxe abreviada, o arquivo json e o arquivo yaml de suporte de relatório de resumo mensal dos itens principais. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

--top-items-summary

Use esta opção para obter a sintaxe abreviada, arquivo json e yaml-file do Suporte de Relatório de Resumo de Itens Principais. Tente "??" para mostrar mais.

Propriedade	Valor
Parameter group:	QueryParameters Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Compartilhar via

az carbon

Comandos

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

Exemplos

az carbon get-emission-report

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários