az changesafety changerecord

Note

Esta referência faz parte da extensão azure-changesafety para o Azure CLI (versão 2.75.0 ou superior). A extensão vai instalar-se automaticamente na primeira vez que executares um comando changesafety changerecord do Arizona . Saiba mais sobre extensões.

Gerir os recursos do ChangeRecord que descrevem alterações planeadas entre metas.

Comandos

Name Description Tipo Status
az changesafety changerecord create

Crie um recurso ChangeRecord.

 Extension disponibilidade geral
az changesafety changerecord delete

Apagar um recurso do ChangeRecord.

 Extension disponibilidade geral
az changesafety changerecord list

Lista os recursos do ChangeRecord.

 Extension disponibilidade geral
az changesafety changerecord show

Mostrar detalhes de um recurso do ChangeRecord.

 Extension disponibilidade geral
az changesafety changerecord update

Atualize um recurso ChangeRecord existente.

 Extension disponibilidade geral

az changesafety changerecord create

Crie um recurso ChangeRecord.

Forneça pelo menos uma definição de alvo para descrever que recursos ou operações o ChangeRecord irá afetar. Os alvos 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 através do pseudónimo az changesafety changerecord. Se omitir os flags de agendamento, a hora de início antecipada passa a ser agora e a hora de fim prevista é oito horas mais 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]

Exemplos

Crie um ChangeRecord para eliminar um perfil do Gestor 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"

Consulte um StageMap pelo 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 referência StageMap e link de estado

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 âmbito da subscrição (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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

Tempo esperado de conclusão no formato ISO 8601. Por defeito, oito horas após a hora prevista de início se for omitido.

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

Hora prevista de início no formato ISO 8601. Por defeito, a hora UTC atual é omitida.

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

Corpo do pedido de alteração e/ou critérios de seleção de recursos usados para identificar os recursos-alvo. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

O ID de referência de alteração relacionado 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 aceites: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

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

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

Uma descrição da alteração que está a ser realizada.

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 a orquestração de implementação desta mudança.

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

Esquema de parâmetros que serão fornecidos para cada fase Progressão. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

Rótulo para o lançamento associado a esta 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 implementação (Normal, Hotfix ou Emergência).

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

Referenciar um recurso StageMap existente usando resource-id=RESOURCE_ID e pares opcionais de parâmetros key=value.

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

Nome StageMap no âmbito atual da subscrição; o ID do recurso é criado para si.

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

Uma ou mais definições alvo expressas como pares chave=valor (por exemplo, resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az changesafety changerecord delete

Apagar um recurso do ChangeRecord.

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

Exemplos

Eliminar 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta 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

O ID de referência de alteração relacionado para esta operação de recurso.

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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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 de 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
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az changesafety changerecord list

Lista os recursos do ChangeRecord.

Liste todos os recursos ChangeRecord numa subscrição ou grupo de recursos.

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

Exemplos

Liste todos os ChangeRecords na subscrição atual

az changesafety changerecord list

Liste os ChangeRecords num 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 tornar-se necessários para que o comando seja executado com êxito.

--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 por onde começar a paginar. Este é o valor de 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 de assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az changesafety changerecord show

Mostrar detalhes de um recurso do ChangeRecord.

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

Exemplos

Mostrar um Registo de Mudança

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 tornar-se necessários para que o comando seja executado com êxito.

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

O nome do recurso ChangeRecord.

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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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 de 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az changesafety changerecord update

Atualize um recurso ChangeRecord existente.

Use este comando para modificar metadados descritivos, definições de implementação ou agendamento para um ChangeRecord existente. Nota: A changeDefinition (alvos) não pode ser modificada 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

Ajusta o tipo de lançamento e adiciona um comentário

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

Janela de agendamento de atualização

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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta 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. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

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

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

Atualize a hora prevista de início no formato ISO 8601. Se for omitido, o valor atual é 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

O ID de referência de alteração relacionado 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 aceites: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Forneça notas sobre a atualização mais recente do 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 string em vez de tentar converter para JSON.

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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Coleção de links relacionados para a mudança. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

Ferramenta usada para a orquestração de implementação desta mudança.

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

Esquema de parâmetros que serão fornecidos para cada fase Progressão. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

Rótulo para o lançamento associado a esta 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> OU --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 de implementação utilizado para a alteração.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: 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

Referenciar um recurso StageMap existente usando resource-id=RESOURCE_ID e pares opcionais de parâmetros key=value.

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

Nome StageMap no âmbito atual da subscrição; o ID do recurso é criado para si.

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

Nome ou ID de 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False