az changesafety changerecord

Note

Ta dokumentacja jest częścią rozszerzenia azure-changesafety dla interfejsu wiersza polecenia platformy Azure (wersja 2.75.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az changesafety changerecord . Dowiedz się więcej o rozszerzeniach.

Zarządzaj zasobami ChangeRecord opisujących planowane zmiany między miejscami docelowymi.

Polecenia

Nazwa Opis Typ Stan
az changesafety changerecord create

Utwórz zasób ChangeRecord.

 Extension ogólna dostępność
az changesafety changerecord delete

Usuń zasób ChangeRecord.

 Extension ogólna dostępność
az changesafety changerecord list

Wyświetl listę zasobów ChangeRecord.

 Extension ogólna dostępność
az changesafety changerecord show

Pokaż szczegóły zasobu ChangeRecord.

 Extension ogólna dostępność
az changesafety changerecord update

Zaktualizuj istniejący zasób ChangeRecord.

 Extension ogólna dostępność

az changesafety changerecord create

Utwórz zasób ChangeRecord.

Podaj co najmniej jedną definicję docelową, aby opisać, które zasoby lub operacje będą mieć wpływ na wartość ChangeRecord. Obiekty docelowe są wyrażane jako rozdzielone przecinkami lub średnikami pary klucz=wartość, takie jak resourceId=RESOURCE_ID,operation=DELETE. Polecenie jest również dostępne za pośrednictwem aliasu az changesafety changerecord. Jeśli pominiesz flagi planowania, przewidywana wartość domyślna czasu rozpoczęcia to teraz, a oczekiwany czas zakończenia domyślnie to osiem godzin później (UTC).

az changesafety changerecord create --change-record-name --name
                                    [--acquire-policy-token]
                                    [--additional-data]
                                    [--anticipated-end-time]
                                    [--anticipated-start-time]
                                    [--change-definition]
                                    [--change-reference]
                                    [--change-type {AppDeployment, Config, ManualTouch, PolicyDeployment}]
                                    [--comments]
                                    [--description]
                                    [--links]
                                    [--orchestration-tool]
                                    [--parameters]
                                    [--release-label]
                                    [--resource-group]
                                    [--rollout-type {Emergency, Hotfix, Normal}]
                                    [--stage-map]
                                    [--stage-map-name --stagemap-name]
                                    [--targets]

Przykłady

Tworzenie rekordu ChangeRecord do usuwania profilu usługi Traffic Manager

az changesafety changerecord create -g MyResourceGroup -n delete-trafficmanager --change-type ManualTouch --rollout-type Hotfix --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myProfile,operation=DELETE" --description "Delete Traffic Manager profile"

Odwołuje się do elementu StageMap według nazwy

az changesafety changerecord create -g MyResourceGroup -n changerecord003 --change-type ManualTouch --rollout-type Normal --stagemap-name rolloutStageMap --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=DELETE"

Tworzenie za pomocą odwołania do elementu StageMap i linku stanu

az changesafety changerecord create -g MyResourceGroup -n changerecord002 --change-type ManualTouch --rollout-type Normal --stage-map "{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}" --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" --links "[{name:status,uri:'https://contoso.com/change/rollout-002'}]"
az changesafety changerecord delete -g MyResourceGroup -n changerecord002 --yes

Tworzenie w zakresie subskrypcji (bez grupy zasobów)

az changesafety changerecord create -n changerecord-sub-scope --change-type AppDeployment --rollout-type Normal --stagemap-name rolloutStageMap --targets "subscriptionId=00000000-0000-0000-0000-000000000000"

Parametry wymagane

--change-record-name --name -n

Nazwa zasobu ChangeRecord.

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--additional-data

Dodatkowe metadane zmiany wymagane dla różnych narzędzi orkiestracji. 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: Properties Arguments
--anticipated-end-time

Oczekiwany czas ukończenia w formacie ISO 8601. Wartość domyślna to osiem godzin po przewidywanym czasie rozpoczęcia po pominięciu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--anticipated-start-time

Oczekiwany czas rozpoczęcia w formacie ISO 8601. Wartość domyślna to bieżąca godzina UTC po pominięciu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--change-definition

Zmień kryteria wyboru treści żądania i/lub zasobów używane do identyfikowania zasobów docelowych. 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: Properties Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-type

Klasyfikuj zmiany, takie jak AppDeployment, Config, ManualTouch lub PolicyDeployment.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Komentarze dotyczące ostatniej aktualizacji zasobu ChangeRecord.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--description

Opis wykonywanej zmiany.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--links

Dodaj linki pomocnicze, powtarzając --links name=NAME uri=URL [description=TEXT].

Właściwość Wartość
Grupa parametrów: Properties Arguments
--orchestration-tool

Narzędzie używane do organizowania wdrażania tej zmiany.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--parameters

Schemat parametrów, które zostaną podane dla każdego etapuProgression. 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: Properties Arguments
--release-label

Etykieta wydania skojarzonego z tą zmianą.

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

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--rollout-type

Określ typ wdrożenia (Normalny, Poprawka lub Awaryjne).

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: Emergency, Hotfix, Normal
--stage-map

Odwołaj się do istniejącego zasobu StageMap przy użyciu atrybutu resource-id=RESOURCE_ID i opcjonalnych parametrów key=value pairs.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--stage-map-name --stagemap-name

Nazwa elementu StageMap w bieżącym zakresie subskrypcji; identyfikator zasobu jest tworzony dla Ciebie.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--targets

Co najmniej jedna definicja docelowa wyrażona jako pary key=value (na przykład resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

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 changesafety changerecord delete

Usuń zasób ChangeRecord.

az changesafety changerecord delete [--acquire-policy-token]
                                    [--change-record-name --name]
                                    [--change-reference]
                                    [--ids]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Przykłady

Usuwanie rekordu ChangeRecord bez potwierdzenia

az changesafety changerecord delete -g MyResourceGroup -n changerecord001 --yes

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-record-name --name -n

Nazwa zasobu ChangeRecord.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

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

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
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.

--verbose

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

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

az changesafety changerecord list

Wyświetl listę zasobów ChangeRecord.

Wyświetl listę wszystkich zasobów ChangeRecord w subskrypcji lub grupie zasobów.

az changesafety changerecord list [--max-items]
                                  [--next-token]
                                  [--resource-group]

Przykłady

Wyświetlanie listy wszystkich rekordów zmian w bieżącej subskrypcji

az changesafety changerecord list

Wyświetlanie listy rekordówrekordów w określonej grupie zasobów

az changesafety changerecord list -g MyResourceGroup

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.

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

Właściwość Wartość
Grupa parametrów: Pagination Arguments
--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

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

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

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 changesafety changerecord show

Pokaż szczegóły zasobu ChangeRecord.

az changesafety changerecord show [--change-record-name --name]
                                  [--ids]
                                  [--resource-group]
                                  [--subscription]

Przykłady

Pokazywanie rekordu zmiany

az changesafety changerecord show -g MyResourceGroup -n changerecord001

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.

--change-record-name --name -n

Nazwa zasobu ChangeRecord.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

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

Właściwość Wartość
Grupa parametrów: Resource Id 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.

--verbose

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

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

az changesafety changerecord update

Zaktualizuj istniejący zasób ChangeRecord.

Użyj tego polecenia, aby zmodyfikować opisowe metadane, ustawienia wprowadzania lub planowanie dla istniejącej wartości ChangeRecord. Uwaga: nie można zmodyfikować elementu changeDefinition (obiektów docelowych) po utworzeniu.

az changesafety changerecord update [--acquire-policy-token]
                                    [--add]
                                    [--additional-data]
                                    [--anticipated-end-time]
                                    [--anticipated-start-time]
                                    [--change-record-name --name]
                                    [--change-reference]
                                    [--change-type {AppDeployment, Config, ManualTouch, PolicyDeployment}]
                                    [--comments]
                                    [--description]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--links]
                                    [--orchestration-tool]
                                    [--parameters]
                                    [--release-label]
                                    [--remove]
                                    [--resource-group]
                                    [--rollout-type {Emergency, Hotfix, Normal}]
                                    [--set]
                                    [--stage-map]
                                    [--stage-map-name --stagemap-name]
                                    [--subscription]

Przykłady

Dostosowywanie typu wdrożenia i dodawanie komentarza

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --rollout-type Emergency --comments "Escalated to emergency rollout"

Aktualizowanie okna planowania

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --anticipated-start-time "2026-09-01T08:00:00Z" --anticipated-end-time "2026-09-01T12:00:00Z"

Opis aktualizacji

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --description "Updated rollout for production deployment"

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
--additional-data

Dodatkowe metadane zmiany wymagane dla różnych narzędzi orkiestracji. 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: Properties Arguments
--anticipated-end-time

Zaktualizuj oczekiwany czas ukończenia w formacie ISO 8601. Jeśli pominięto, bieżąca wartość zostanie zachowana.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--anticipated-start-time

Zaktualizuj oczekiwany czas rozpoczęcia w formacie ISO 8601. Jeśli pominięto, bieżąca wartość zostanie zachowana.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--change-record-name --name -n

Nazwa zasobu ChangeRecord.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-type

Opisuje charakter zmiany.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Podaj uwagi dotyczące najnowszej aktualizacji rekordu ChangeRecord.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--description

Zaktualizuj opis zmiany.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--links

Kolekcja powiązanych linków do zmiany. 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: Properties Arguments
--orchestration-tool

Narzędzie używane do organizowania wdrażania tej zmiany.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--parameters

Schemat parametrów, które zostaną podane dla każdego etapuProgression. 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: Properties Arguments
--release-label

Etykieta wydania skojarzonego z tą zmianą.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--rollout-type

Opisuje typ wdrożenia używanego do zmiany.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: Emergency, Hotfix, Normal
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
--stage-map

Odwołaj się do istniejącego zasobu StageMap przy użyciu atrybutu resource-id=RESOURCE_ID i opcjonalnych parametrów key=value pairs.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--stage-map-name --stagemap-name

Nazwa elementu StageMap w bieżącym zakresie subskrypcji; identyfikator zasobu jest tworzony dla Ciebie.

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

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

Właściwość Wartość
Grupa parametrów: Resource Id 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.

--verbose

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

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