Partilhar via

az carbon

Note

Essa referência faz parte da extensão de carbono para a CLI do Azure (versão 2.70.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az carbon . Saiba mais sobre extensões.

Gerencie o carbono.

Comandos

Nome Descrição Tipo Estado
az carbon get-emission-data-available-date-range

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

 Extension disponibilidade geral
az carbon get-emission-report

API para Relatórios de Emissões de Carbono.

 Extension disponibilidade geral

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

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

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

Exemplos

Consultar dados de emissão de carbono disponíveis Intervalo de datas

az carbon get-emission-data-available-date-range
Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. 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 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 Resumido Mensal 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 do 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 do 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 Obrigatórios

--carbon-scope-list

Lista de escopos de emissão de carbono. Required. Aceita um ou mais valores de EmissionScopeEnum (por exemplo, Scope1, Scope2, Scope3) em forma de lista. Os resultados incluirão as emissões totais para os âmbitos especificados. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--date-range

As datas de início e fim dos dados de emissões de carbono. Required. Para ItemDetailsReport e TopItemsSummaryReport, apenas um mês de dados é suportado de cada vez, portanto, as datas de início e término devem ser iguais dentro do DateRange (por exemplo, início: 2024-06-01 e fim: 2024-06-01). Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--subscription-list

Lista de IDs de assinatura para os 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--item-details

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

Propriedade Valor
Grupo de parâmetros: 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 minúsculas (por exemplo, 'leste dos EUA'). Optional. Você pode usar o comando 'az account list-locations -o table' para localizar Nomes de Exibição da Região do Azure. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--monthly-summary

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

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--overall-summary

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

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--resource-group-urls

Lista de URLs de grupos 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: 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 minúsculas, seguindo o formato 'microsoft. {service}/{resourceType}', por exemplo, 'microsoft.storage/storageaccounts'. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--top-items-monthly

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

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
--top-items-summary

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

Propriedade Valor
Grupo de parâmetros: QueryParameters Arguments
Parâmetros globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False