az changesafety changerecord

Note

Essa referência faz parte da extensão azure-changesafety para a CLI do Azure (versão 2.75.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az changesafety changerecord . Saiba mais sobre extensões.

Gerenciar recursos ChangeRecord que descrevem alterações planejadas entre destinos.

Comandos

Nome Description Tipo Status
az changesafety changerecord create

Criar um recurso ChangeRecord.

 Extension GA
az changesafety changerecord delete

Excluir um recurso ChangeRecord.

 Extension GA
az changesafety changerecord list

Listar recursos ChangeRecord.

 Extension GA
az changesafety changerecord show

Mostrar detalhes de um recurso ChangeRecord.

 Extension GA
az changesafety changerecord update

Atualize um recurso ChangeRecord existente.

 Extension GA

az changesafety changerecord create

Criar um recurso ChangeRecord.

Forneça pelo menos uma definição de destino para descrever quais recursos ou operações o ChangeRecord afetará. Os destinos são expressos como pares chave=valor separados por vírgula ou ponto-e-vírgula, como resourceId=RESOURCE_ID,operation=DELETE. O comando também está disponível por meio do alias az changesafety changerecord. Se você omitir sinalizadores de agendamento, a hora de início prevista será padrão para agora e a hora de término prevista será padrão para oito horas depois (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]

Exemplos

Criar um ChangeRecord para excluir um perfil do Gerenciador de Tráfego

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"

Referenciar um StageMap por 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"

Criar com o link de referência e status do 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

Criar no escopo da assinatura (sem 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 Exigidos

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

O nome do recurso ChangeRecord.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--additional-data

Metadados adicionais para a alteração necessária para várias ferramentas de orquestração. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--anticipated-end-time

Tempo de conclusão esperado no formato ISO 8601. O padrão é de oito horas após a hora de início prevista quando omitida.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--anticipated-start-time

Hora de início esperada no formato ISO 8601. O padrão é a hora UTC atual quando omitida.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--change-definition

Alterar o corpo da solicitação e/ou os critérios de seleção de recursos usados para identificar os recursos de destino. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-type

Classifique a alteração, como AppDeployment, Config, ManualTouch ou PolicyDeployment.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Comentários sobre a última atualização para o recurso ChangeRecord.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--description

Uma descrição da alteração que está sendo executada.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--links

Adicione links de suporte repetindo --links name=NAME uri=URL [description=TEXT].

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--orchestration-tool

Ferramenta usada para orquestração de implantação dessa alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--parameters

Esquema de parâmetros que serão fornecidos para cada stageProgression. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--release-label

Rótulo para a versão associada a essa alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--rollout-type

Especifique o tipo de distribuição (Normal, Hotfix ou Emergency).

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Emergency, Hotfix, Normal
--stage-map

Faça referência a um recurso StageMap existente usando os pares key=value do resource-id=RESOURCE_ID e dos parâmetros opcionais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--stage-map-name --stagemap-name

Nome do StageMap no escopo da assinatura atual; a ID do recurso é criada para você.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--targets

Uma ou mais definições de destino expressas como pares key=value (por exemplo, resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az changesafety changerecord delete

Excluir um recurso ChangeRecord.

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

Exemplos

Excluir um ChangeRecord sem confirmação

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-record-name --name -n

O nome do recurso ChangeRecord.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az changesafety changerecord list

Listar recursos ChangeRecord.

Liste todos os recursos ChangeRecord em uma assinatura ou grupo de recursos.

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

Exemplos

Listar todos os ChangeRecords na assinatura atual

az changesafety changerecord list

Listar ChangeRecords em um grupo de recursos específico

az changesafety changerecord list -g MyResourceGroup

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--next-token

Token para especificar onde iniciar a paginação. Esse é o valor do token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az changesafety changerecord show

Mostrar detalhes de um recurso ChangeRecord.

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

Exemplos

Mostrar um ChangeRecord

az changesafety changerecord show -g MyResourceGroup -n changerecord001

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

O nome do recurso ChangeRecord.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az changesafety changerecord update

Atualize um recurso ChangeRecord existente.

Use este comando para modificar metadados descritivos, configurações de distribuição ou agendamento para um ChangeRecord existente. Observação: o changeDefinition (destinos) não pode ser modificado após a criação.

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]

Exemplos

Ajustar o tipo de distribuição e adicionar um comentário

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

Atualizar janela de agendamento

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

Descrição da atualização

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--additional-data

Metadados adicionais para a alteração necessária para várias ferramentas de orquestração. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--anticipated-end-time

Atualize o tempo de conclusão esperado no formato ISO 8601. Se omitido, o valor atual será preservado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--anticipated-start-time

Atualize a hora de início esperada no formato ISO 8601. Se omitido, o valor atual será preservado.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--change-record-name --name -n

O nome do recurso ChangeRecord.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-type

Descreve a natureza da mudança.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Forneça anotações sobre a atualização mais recente para o ChangeRecord.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--description

Atualize a descrição da alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--links

Coleção de links relacionados para a alteração. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--orchestration-tool

Ferramenta usada para orquestração de implantação dessa alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--parameters

Esquema de parâmetros que serão fornecidos para cada stageProgression. Suporte a sintaxe abreviada, arquivo json e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--release-label

Rótulo para a versão associada a essa alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--rollout-type

Descreve o tipo da distribuição usada para a alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceitos: Emergency, Hotfix, Normal
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--stage-map

Faça referência a um recurso StageMap existente usando os pares key=value do resource-id=RESOURCE_ID e dos parâmetros opcionais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--stage-map-name --stagemap-name

Nome do StageMap no escopo da assinatura atual; a ID do recurso é criada para você.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False