Udostępnij przez

az carbon

Note

Ta dokumentacja jest częścią rozszerzenia emisji dwutlenku węgla dla interfejsu wiersza polecenia platformy Azure (wersja 2.70.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az carbon . Dowiedz się więcej o rozszerzeniach.

Zarządzanie węglem.

Polecenia

Nazwa Opis Typ Stan
az carbon get-emission-data-available-date-range

Interfejs API zapytań dotyczących danych emisji dwutlenku węgla dostępny zakres dat.

 Extension ogólna dostępność
az carbon get-emission-report

Interfejs API raportów emisji dwutlenku węgla.

 Extension ogólna dostępność

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

Interfejs API zapytań dotyczących danych emisji dwutlenku węgla dostępny zakres dat.

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

Przykłady

Zakres dostępnych dat zapytań dotyczących emisji dwutlenku węgla

az carbon get-emission-data-available-date-range
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az carbon get-emission-report

Interfejs API raportów emisji dwutlenku węgla.

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]

Przykłady

Ogólny raport podsumowania zapytaniaCarbonEmission

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

Raport podsumowania miesięcznego zapytaniaCarbonEmission

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

Raport szczegółów elementu 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}"

Raport podsumowania najważniejszych elementów 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}"

Raport podsumowania miesięcznego elementu 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}

Parametry wymagane

--carbon-scope-list

Lista zakresów emisji dwutlenku węgla. Required. Akceptuje co najmniej jedną wartość z elementu EmissionScopeEnum (np. Scope1, Scope2, Scope3) w formularzu listy. Dane wyjściowe będą obejmować łączną emisję dla określonych zakresów. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--date-range

Daty rozpoczęcia i zakończenia danych dotyczących emisji dwutlenku węgla. Required. W przypadku elementu ItemDetailsReport i TopItemsSummaryReport tylko jeden miesiąc danych jest obsługiwany w danym momencie, więc daty rozpoczęcia i zakończenia powinny być równe w elemencie DateRange (np. początek: 2024-06-01 i koniec: 2024-06-01). Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--subscription-list

Lista identyfikatorów subskrypcji, dla których są wymagane dane dotyczące emisji dwutlenku węgla. Required. Każdy identyfikator subskrypcji powinien mieć małe litery. Maksymalna długość listy to 100. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--item-details

Użyj tej opcji, aby uzyskać skróconą składnię raportu szczegółów elementu, plik json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--location-list

Lista lokalizacji (nazwa wyświetlana regionu platformy Azure) dla danych emisji dwutlenku węgla z każdą lokalizacją określoną w małych literach (np. "east us"). Optional. Aby znaleźć nazwy wyświetlane regionów platformy Azure, możesz użyć polecenia "az account list-locations -o table". Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--monthly-summary

Użyj tej opcji, aby uzyskać raport podsumowania miesięcznego Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--overall-summary

Użyj tej opcji, aby uzyskać ogólny raport podsumowania Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--resource-group-urls

Lista adresów URL grup zasobów dla danych dotyczących emisji dwutlenku węgla. Optional. Każdy adres URL musi być zgodny z formatem "/subscriptions/{subscriptionId}/resourcegroups/{resourceGroup}" i powinien znajdować się we wszystkich małych literach. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--resource-type-list

Lista typów zasobów dla danych dotyczących emisji dwutlenku węgla. Optional. Każdy typ zasobu powinien być określony małymi literami, zgodnie z formatem "microsoft". {service}/{resourceType}", np. "microsoft.storage/storageaccounts". Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--top-items-monthly

Użyj tej opcji, aby pobrać skróconą składnię skróconą, plik json-file i yaml-file( Obsługa skróconej składni raportu podsumowania miesięcznego) i yaml-file(json-file). Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
--top-items-summary

Użyj tej opcji, aby uzyskać skróconą składnię raportu podsumowania elementów, plik json i plik yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: QueryParameters Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False