az carbon

Note

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

Gerenciar o 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

Formato de saída.

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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	QueryParameters Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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
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 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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
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 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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	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

Formato de saída.

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

Comentários

Esta página foi útil?

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