az changesafety changerecord

Note

Questo riferimento fa parte dell'estensione azure-changesafety per l'interfaccia della riga di comando di Azure (versione 2.75.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az changesafety changerecord . Altre informazioni sulle estensioni.

Gestire le risorse ChangeRecord che descrivono le modifiche pianificate tra le destinazioni.

Comandi

Nome Descrizione Tipo Status
az changesafety changerecord create

Creare una risorsa ChangeRecord.

 Extension GA
az changesafety changerecord delete

Eliminare una risorsa ChangeRecord.

 Extension GA
az changesafety changerecord list

Elencare le risorse ChangeRecord.

 Extension GA
az changesafety changerecord show

Mostra i dettagli per una risorsa ChangeRecord.

 Extension GA
az changesafety changerecord update

Aggiornare una risorsa ChangeRecord esistente.

 Extension GA

az changesafety changerecord create

Creare una risorsa ChangeRecord.

Specificare almeno una definizione di destinazione per descrivere quali risorse o operazioni avranno effetto su ChangeRecord. Le destinazioni sono espresse come coppie chiave=valore separate da virgole o punto e virgola, ad esempio resourceId=RESOURCE_ID,operation=DELETE. Il comando è disponibile anche tramite l'alias az changesafety changerecord. Se si omettono flag di pianificazione, per impostazione predefinita l'ora di inizio prevista è ora e l'ora di fine prevista è otto ore dopo (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]

Esempio

Creare un oggetto ChangeRecord per eliminare un profilo di Gestione traffico

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"

Fare riferimento a StageMap per nome

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"

Creare con il collegamento di riferimento e stato StageMap

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

Creare nell'ambito della sottoscrizione (nessun gruppo di risorse)

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

Parametri necessari

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

Nome della risorsa ChangeRecord.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Azure Policy per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--additional-data

Metadati aggiuntivi per la modifica necessaria per vari strumenti di orchestrazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--anticipated-end-time

Tempo di completamento previsto nel formato ISO 8601. Il valore predefinito è otto ore dopo l'ora di inizio prevista quando viene omesso.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--anticipated-start-time

Ora di inizio prevista in formato ISO 8601. Per impostazione predefinita, l'ora UTC corrente viene omessa.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--change-definition

Modificare il corpo della richiesta e/o i criteri di selezione delle risorse usati per identificare le risorse di destinazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-type

Classificare la modifica, ad esempio AppDeployment, Config, ManualTouch o PolicyDeployment.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Commenti sull'ultimo aggiornamento della risorsa ChangeRecord.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--description

Descrizione della modifica da eseguire.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--links

Aggiungere collegamenti di supporto ripetendo --links name=NAME uri=URL [description=TEXT].

Proprietà Valore
Gruppo di parametri: Properties Arguments
--orchestration-tool

Strumento usato per l'orchestrazione della distribuzione di questa modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--parameters

Schema dei parametri che verranno forniti per ogni faseProgressione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--release-label

Etichetta per la versione associata a questa modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--rollout-type

Specificare il tipo di implementazione (Normale, Hotfix o Emergenza).

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: Emergency, Hotfix, Normal
--stage-map

Fare riferimento a una risorsa StageMap esistente usando resource-id=RESOURCE_ID e le coppie chiave=valore facoltative.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--stage-map-name --stagemap-name

Nome stageMap nell'ambito della sottoscrizione corrente; L'ID risorsa viene creato per l'utente.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--targets

Una o più definizioni di destinazione espresse come coppie chiave=valore (ad esempio resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az changesafety changerecord delete

Eliminare una risorsa ChangeRecord.

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

Esempio

Eliminare un oggetto ChangeRecord senza conferma

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Azure Policy per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-record-name --name -n

Nome della risorsa ChangeRecord.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az changesafety changerecord list

Elencare le risorse ChangeRecord.

Elencare tutte le risorse ChangeRecord in una sottoscrizione o in un gruppo di risorse.

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

Esempio

Elencare tutti i changeRecords nella sottoscrizione corrente

az changesafety changerecord list

Elencare ChangeRecords in un gruppo di risorse specifico

az changesafety changerecord list -g MyResourceGroup

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token in --next-token argomento di un comando successivo.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

Proprietà Valore
Gruppo di parametri: Pagination Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az changesafety changerecord show

Mostra i dettagli per una risorsa ChangeRecord.

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

Esempio

Mostra una modificaRecord

az changesafety changerecord show -g MyResourceGroup -n changerecord001

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

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

Nome della risorsa ChangeRecord.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False

az changesafety changerecord update

Aggiornare una risorsa ChangeRecord esistente.

Usare questo comando per modificare metadati descrittivi, impostazioni di implementazione o pianificazione per un oggetto ChangeRecord esistente. Nota: non è possibile modificare changeDefinition (destinazioni) dopo la creazione.

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]

Esempio

Regolare il tipo di implementazione e aggiungere un commento

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

Finestra di pianificazione degli aggiornamenti

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

Descrizione dell'aggiornamento

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

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--acquire-policy-token

Acquisizione automatica di un token Azure Policy per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
--additional-data

Metadati aggiuntivi per la modifica necessaria per vari strumenti di orchestrazione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--anticipated-end-time

Aggiornare il tempo di completamento previsto in formato ISO 8601. Se omesso, il valore corrente viene mantenuto.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--anticipated-start-time

Aggiornare l'ora di inizio prevista in formato ISO 8601. Se omesso, il valore corrente viene mantenuto.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--change-record-name --name -n

Nome della risorsa ChangeRecord.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-type

Descrive la natura della modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Specificare le note sull'aggiornamento più recente di ChangeRecord.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--description

Aggiornare la descrizione della modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--links

Raccolta di collegamenti correlati per la modifica. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--orchestration-tool

Strumento usato per l'orchestrazione della distribuzione di questa modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--parameters

Schema dei parametri che verranno forniti per ogni faseProgressione. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--release-label

Etichetta per la versione associata a questa modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
--rollout-type

Descrive il tipo dell'implementazione utilizzata per la modifica.

Proprietà Valore
Gruppo di parametri: Properties Arguments
Valori accettati: Emergency, Hotfix, Normal
--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

Proprietà Valore
Gruppo di parametri: Generic Update Arguments
--stage-map

Fare riferimento a una risorsa StageMap esistente usando resource-id=RESOURCE_ID e le coppie chiave=valore facoltative.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--stage-map-name --stagemap-name

Nome stageMap nell'ambito della sottoscrizione corrente; L'ID risorsa viene creato per l'utente.

Proprietà Valore
Gruppo di parametri: Properties Arguments
--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Proprietà Valore
Gruppo di parametri: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False