az changesafety changerecord

Note

Esta referencia forma parte de la extensión azure-changesafety para la CLI de Azure (versión 2.75.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az changesafety changerecord . Obtenga más información sobre las extensiones.

Administre los recursos ChangeRecord que describen los cambios planeados en los destinos.

Comandos

Nombre Description Tipo Estado
az changesafety changerecord create

Cree un recurso ChangeRecord.

 Extension GA
az changesafety changerecord delete

Elimine un recurso ChangeRecord.

 Extension GA
az changesafety changerecord list

Enumerar los recursos ChangeRecord.

 Extension GA
az changesafety changerecord show

Muestra los detalles de un recurso ChangeRecord.

 Extension GA
az changesafety changerecord update

Actualice un recurso ChangeRecord existente.

 Extension GA

az changesafety changerecord create

Cree un recurso ChangeRecord.

Proporcione al menos una definición de destino para describir qué recursos o operaciones afectará ChangeRecord. Los destinos se expresan como pares clave=valor separados por comas o punto y coma, como resourceId=RESOURCE_ID,operation=DELETE. El comando también está disponible a través del alias az changesafety changerecord. Si omite las marcas de programación, la hora de inicio prevista tiene como valor predeterminado ahora y la hora de finalización prevista tiene como valor predeterminado ocho horas más tarde (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]

Ejemplos

Crear un changeRecord para eliminar un perfil de 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"

Hacer referencia a un StageMap por nombre

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"

Creación con vínculo de referencia y estado de 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

Creación en el ámbito de la suscripción (sin grupo de recursos)

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

Parámetros requeridos

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

Nombre del recurso ChangeRecord.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--additional-data

Metadatos adicionales para el cambio necesario para varias herramientas de orquestación. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--anticipated-end-time

Tiempo de finalización esperado en formato ISO 8601. El valor predeterminado es ocho horas después de la hora de inicio prevista cuando se omite.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--anticipated-start-time

Hora de inicio esperada en formato ISO 8601. El valor predeterminado es la hora UTC actual cuando se omite.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--change-definition

Cambiar el cuerpo de la solicitud o los criterios de selección de recursos usados para identificar los recursos de destino. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-type

Clasifique el cambio, como AppDeployment, Config, ManualTouch o PolicyDeployment.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Comentarios sobre la última actualización al recurso ChangeRecord.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--description

Descripción del cambio que se está realizando.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--links

Agregue vínculos auxiliares repitiendo --links name=NAME uri=URL [description=TEXT].

Propiedad Valor
Grupo de parámetros: Properties Arguments
--orchestration-tool

Herramienta que se usa para la orquestación de implementación de este cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--parameters

Esquema de parámetros que se proporcionarán para cada stageProgression. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--release-label

Etiqueta de la versión asociada a este cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--rollout-type

Especifique el tipo de lanzamiento (Normal, Revisión o Emergencia).

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Emergency, Hotfix, Normal
--stage-map

Haga referencia a un recurso StageMap existente mediante resource-id=RESOURCE_ID y los parámetros opcionales pares key=value.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--stage-map-name --stagemap-name

Nombre stageMap en el ámbito de la suscripción actual; el identificador de recurso se crea para usted.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--targets

Una o varias definiciones de destino expresadas como pares clave=valor (por ejemplo, resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az changesafety changerecord delete

Elimine un recurso ChangeRecord.

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

Ejemplos

Eliminar un changeRecord sin confirmación

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-record-name --name -n

Nombre del recurso ChangeRecord.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicitar confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az changesafety changerecord list

Enumerar los recursos ChangeRecord.

Enumere todos los recursos ChangeRecord de una suscripción o grupo de recursos.

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

Ejemplos

Enumerar todos los changeRecords de la suscripción actual

az changesafety changerecord list

Enumerar ChangeRecords en un grupo de recursos específico

az changesafety changerecord list -g MyResourceGroup

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

Propiedad Valor
Grupo de parámetros: Pagination Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az changesafety changerecord show

Muestra los detalles de un recurso ChangeRecord.

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

Ejemplos

Mostrar un changeRecord

az changesafety changerecord show -g MyResourceGroup -n changerecord001

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Nombre del recurso ChangeRecord.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az changesafety changerecord update

Actualice un recurso ChangeRecord existente.

Use este comando para modificar metadatos descriptivos, la configuración de lanzamiento o la programación de un changeRecord existente. Nota: El changeDefinition (destinos) no se puede modificar después de la creación.

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]

Ejemplos

Ajustar el tipo de lanzamiento y agregar un comentario

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

Ventana Actualizar programación

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

Descripción de la actualización

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--additional-data

Metadatos adicionales para el cambio necesario para varias herramientas de orquestación. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--anticipated-end-time

Actualice el tiempo de finalización esperado en formato ISO 8601. Si se omite, se conserva el valor actual.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--anticipated-start-time

Actualice la hora de inicio esperada en formato ISO 8601. Si se omite, se conserva el valor actual.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--change-record-name --name -n

Nombre del recurso ChangeRecord.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-type

Describe la naturaleza del cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Proporcione notas sobre la actualización más reciente de ChangeRecord.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--description

Actualice la descripción del cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--links

Colección de vínculos relacionados para el cambio. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--orchestration-tool

Herramienta que se usa para la orquestación de implementación de este cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--parameters

Esquema de parámetros que se proporcionarán para cada stageProgression. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--release-label

Etiqueta de la versión asociada a este cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--rollout-type

Describe el tipo del lanzamiento usado para el cambio.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: Emergency, Hotfix, Normal
--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--stage-map

Haga referencia a un recurso StageMap existente mediante resource-id=RESOURCE_ID y los parámetros opcionales pares key=value.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--stage-map-name --stagemap-name

Nombre stageMap en el ámbito de la suscripción actual; el identificador de recurso se crea para usted.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False