az carbon

Note

Esta referência faz parte da extensão carbono para o 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

Name	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 [--acquire-policy-token]
                                                 [--change-reference]

Exemplos

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

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

Parâmetros Opcionais

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

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

Parâmetros de Globais

--debug

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

Propriedade	Valor
Valor predefinido:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor predefinido:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor predefinido:	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 predefinido:	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
                              [--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]

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 seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--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 localizações (Nome de Exibição da Região Azure) para dados de emissões de carbono, com cada localização especificada em minúsculas (por exemplo, 'east us'). Optional. Pode usar o comando 'az account list-locations -o table' para encontrar Azure Nomes de Visualização de Regiões. 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