az changesafety changerecord

Note

Cette référence fait partie de l’extension azure-changesafety pour Azure CLI (version 2.75.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az changesafety changerecord . Apprenez-en davantage sur les extensions.

Gérez les ressources ChangeRecord qui décrivent les modifications planifiées entre les cibles.

Commandes

Nom Description Type État
az changesafety changerecord create

Créez une ressource ChangeRecord.

 Extension GA
az changesafety changerecord delete

Supprimez une ressource ChangeRecord.

 Extension GA
az changesafety changerecord list

Répertorier les ressources ChangeRecord.

 Extension GA
az changesafety changerecord show

Afficher les détails d’une ressource ChangeRecord.

 Extension GA
az changesafety changerecord update

Mettez à jour une ressource ChangeRecord existante.

 Extension GA

az changesafety changerecord create

Créez une ressource ChangeRecord.

Fournissez au moins une définition cible pour décrire quelles ressources ou opérations changeRecord affectera. Les cibles sont exprimées sous forme de virgules ou de points-virgules séparés par des paires clé=valeur telles que resourceId=RESOURCE_ID,operation=DELETE. La commande est également disponible via l’alias az changesafety changerecord. Si vous omettez des indicateurs de planification, l’heure de début prévue par défaut est maintenant et l’heure de fin prévue est par défaut de huit heures plus tard (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]

Exemples

Créer un ChangeRecord pour supprimer un profil 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"

Référencer un StageMap par nom

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"

Créer avec la référence StageMap et le lien d’état

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

Créer au niveau de l’étendue de l’abonnement (aucun groupe de ressources)

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

Paramètres obligatoires

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

Nom de la ressource ChangeRecord.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--additional-data

Métadonnées supplémentaires pour la modification requise pour différents outils d’orchestration. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--anticipated-end-time

Heure d’achèvement attendue au format ISO 8601. La valeur par défaut est de huit heures après l’heure de début prévue lorsqu’elle est omise.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--anticipated-start-time

Heure de début attendue au format ISO 8601. La valeur par défaut est l’heure UTC actuelle lorsqu’elle est omise.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--change-definition

Modifier le corps de la demande et/ou les critères de sélection des ressources utilisés pour identifier les ressources ciblées. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-type

Classifiez la modification telle que AppDeployment, Config, ManualTouch ou PolicyDeployment.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Commentaires sur la dernière mise à jour de la ressource ChangeRecord.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--description

Description de la modification en cours d’exécution.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--links

Ajoutez des liens de prise en charge en répétant --links name=NAME uri=URL [description=TEXT].

Propriété Valeur
Groupe de paramètres: Properties Arguments
--orchestration-tool

Outil utilisé pour l’orchestration du déploiement de cette modification.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--parameters

Schéma des paramètres qui seront fournis pour chaque stageProgression. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--release-label

Étiquette de la version associée à cette modification.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--rollout-type

Spécifiez le type de déploiement (Normal, Correctif logiciel ou Urgence).

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: Emergency, Hotfix, Normal
--stage-map

Référencez une ressource StageMap existante à l’aide de resource-id=RESOURCE_ID et de paramètres facultatifs key=value paires.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--stage-map-name --stagemap-name

Nom stageMap dans l’étendue de l’abonnement actuel ; l’ID de ressource est généré pour vous.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--targets

Une ou plusieurs définitions cibles exprimées sous forme de paires clé=valeur (par exemple, resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az changesafety changerecord delete

Supprimez une ressource ChangeRecord.

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

Exemples

Supprimer un ChangeRecord sans confirmation

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-record-name --name -n

Nom de la ressource ChangeRecord.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--yes -y

Ne pas demander de confirmation.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az changesafety changerecord list

Répertorier les ressources ChangeRecord.

Répertorier toutes les ressources ChangeRecord dans un abonnement ou un groupe de ressources.

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

Exemples

Répertorier tous les ChangeRecords dans l’abonnement actuel

az changesafety changerecord list

Répertorier changeRecords dans un groupe de ressources spécifique

az changesafety changerecord list -g MyResourceGroup

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token argument d’une commande suivante.

Propriété Valeur
Groupe de paramètres: Pagination Arguments
--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Propriété Valeur
Groupe de paramètres: Pagination Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az changesafety changerecord show

Afficher les détails d’une ressource ChangeRecord.

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

Exemples

Afficher un ChangeRecord

az changesafety changerecord show -g MyResourceGroup -n changerecord001

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Nom de la ressource ChangeRecord.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az changesafety changerecord update

Mettez à jour une ressource ChangeRecord existante.

Utilisez cette commande pour modifier les métadonnées descriptives, les paramètres de déploiement ou la planification d’un ChangeRecord existant. Remarque : La modification DeDefinition (cibles) ne peut pas être modifiée après la création.

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]

Exemples

Ajuster le type de déploiement et ajouter un commentaire

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

Fenêtre De planification de mise à jour

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

Description de la mise à jour

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--additional-data

Métadonnées supplémentaires pour la modification requise pour différents outils d’orchestration. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--anticipated-end-time

Mettez à jour le temps d’achèvement attendu au format ISO 8601. Si elle est omise, la valeur actuelle est conservée.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--anticipated-start-time

Mettez à jour l’heure de début attendue au format ISO 8601. Si elle est omise, la valeur actuelle est conservée.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--change-record-name --name -n

Nom de la ressource ChangeRecord.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-type

Décrit la nature du changement.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Fournissez des notes sur la dernière mise à jour de ChangeRecord.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--description

Mettez à jour la description de la modification.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--links

Collection de liens connexes pour la modification. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--orchestration-tool

Outil utilisé pour l’orchestration du déploiement de cette modification.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--parameters

Schéma des paramètres qui seront fournis pour chaque stageProgression. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--release-label

Étiquette de la version associée à cette modification.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--rollout-type

Décrit le type de déploiement utilisé pour la modification.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: Emergency, Hotfix, Normal
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--stage-map

Référencez une ressource StageMap existante à l’aide de resource-id=RESOURCE_ID et de paramètres facultatifs key=value paires.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--stage-map-name --stagemap-name

Nom stageMap dans l’étendue de l’abonnement actuel ; l’ID de ressource est généré pour vous.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False