Compartilhar via


az restore-point

Gerenciar ponto de restauração com res.

Comandos

Nome Description Tipo Status
az restore-point collection

Crie a coleção de pontos de restauração. Consulte https://aka.ms/RestorePoints para obter mais detalhes. Ao atualizar uma coleção de pontos de restauração, somente as marcas podem ser modificadas.

Core GA
az restore-point collection create

Crie uma operação para criar ou atualizar a coleção de pontos de restauração. Consulte https://aka.ms/RestorePoints para obter mais detalhes. Ao atualizar uma coleção de pontos de restauração, somente as marcas podem ser modificadas.

Core GA
az restore-point collection delete

Exclua a coleção de pontos de restauração. Essa operação também excluirá todos os pontos de restauração contidos.

Core GA
az restore-point collection list

Obtenha a lista de coleções de pontos de restauração em um grupo de recursos.

Core GA
az restore-point collection list-all

Obtenha a lista de coleções de pontos de restauração na assinatura. Use a propriedade nextLink na resposta para obter a próxima página de coleções de pontos de restauração. Faça isso até que nextLink não seja nulo para buscar todas as coleções de pontos de restauração.

Core GA
az restore-point collection show

Obtenha a coleção de pontos de restauração.

Core GA
az restore-point collection update

Atualize a coleção de pontos de restauração.

Core GA
az restore-point collection wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

Core GA
az restore-point create

Crie o ponto de restauração. A atualização de propriedades de um ponto de restauração existente não é permitida.

Core GA
az restore-point delete

Exclua o ponto de restauração.

Core GA
az restore-point show

Obtenha o ponto de restauração.

Core GA
az restore-point wait

Coloque a CLI em um estado de espera até que uma condição do ponto de restauração seja atendida.

Core GA

az restore-point create

Crie o ponto de restauração. A atualização de propriedades de um ponto de restauração existente não é permitida.

az restore-point create --collection-name
                        --name --restore-point-name
                        --resource-group
                        [--consistency-mode {ApplicationConsistent, CrashConsistent, FileSystemConsistent}]
                        [--data-disk-restore-point-encryption-set]
                        [--data-disk-restore-point-encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                        [--exclude-disks]
                        [--no-wait]
                        [--os-restore-point-encryption-set]
                        [--os-restore-point-encryption-type {EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey}]
                        [--source-data-disk-resource]
                        [--source-os-resource]
                        [--source-restore-point]

Exemplos

Criar um ponto de restauração

az restore-point create --exclude-disks "/subscriptions/{subscription-id}/resourceGroups/myResour               ceGroup/providers/Microsoft.Compute/disks/disk123" --resource-group "myResourceGroup"                --collection-name "rpcName" --name "rpName"

Criar um ponto de restauração com --consistency-mode CrashConsistent

az vm create -n vm -g rg --image Ubuntu2204 --tag EnableCrashConsistentRestorePoint=True

az restore-point collection create --source-id "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"                -g rg --collection-name "myRpc"

az restore-point create --exclude-disks "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"                --resource-group "myResourceGroup" --collection-name "rpcName" --name "rpName"

Parâmetros Exigidos

--collection-name

O nome da coleção de pontos de restauração.

--name --restore-point-name -n

O nome do ponto de restauração.

--resource-group -g

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

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.

--consistency-mode
Versão Prévia

Modo de consistência do ponto de restauração. Pode ser especificado na entrada durante a criação de um ponto de restauração. Por enquanto, somente CrashConsistent é aceito como uma entrada válida. Consulte https://aka.ms/RestorePoints para obter mais detalhes.

Propriedade Valor
Valores aceitos: ApplicationConsistent, CrashConsistent, FileSystemConsistent
--data-disk-restore-point-encryption-set

ID do recurso do conjunto de criptografia de disco de dados gerenciado pelo cliente.

--data-disk-restore-point-encryption-type

O tipo de chave usado para criptografar os dados do ponto de restauração do disco de dados.

Propriedade Valor
Valores aceitos: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--exclude-disks

Lista de IDs de recursos de disco que o cliente deseja excluir do ponto de restauração. Se nenhum disco for especificado, todos os discos serão incluídos.

Uso: --exclude-disks XX XX id: a ID de recurso do ARM na forma de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... Várias ações podem ser especificadas usando mais de um argumento --exclude-disks.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--os-restore-point-encryption-set

ID do recurso do conjunto de criptografia de disco do sistema operacional gerenciado pelo cliente.

--os-restore-point-encryption-type

O tipo de chave usado para criptografar os dados do ponto de restauração do disco do sistema operacional.

Propriedade Valor
Valores aceitos: EncryptionAtRestWithCustomerKey, EncryptionAtRestWithPlatformAndCustomerKeys, EncryptionAtRestWithPlatformKey
--source-data-disk-resource

ID do recurso do disco de dados de origem.

--source-os-resource

ID do recurso do disco do sistema operacional de origem.

--source-restore-point

ID do recurso do ponto de restauração de origem do qual uma cópia precisa ser criada.

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 restore-point delete

Exclua o ponto de restauração.

az restore-point delete [--collection-name --restore-point-collection-name]
                        [--ids]
                        [--name --restore-point-name]
                        [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                        [--resource-group]
                        [--subscription]
                        [--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.

--collection-name --restore-point-collection-name

O nome da coleção de pontos de restauração.

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
--name --restore-point-name -n

O nome do ponto de restauração.

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

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valores aceitos: 0, 1, f, false, n, no, t, true, y, yes
--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 restore-point show

Obtenha o ponto de restauração.

az restore-point show --collection-name
                      --name --restore-point-name
                      --resource-group
                      [--instance-view]

Exemplos

Obter um ponto de restauração

az restore-point show --resource-group "myResourceGroup" --collection-name "rpcName" --name "rpName"

Parâmetros Exigidos

--collection-name

O nome da coleção de pontos de restauração.

--name --restore-point-name -n

O nome do ponto de restauração.

--resource-group -g

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

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.

--instance-view

Mostrar a exibição da instância de um ponto de restauração.

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 restore-point wait

Coloque a CLI em um estado de espera até que uma condição do ponto de restauração seja atendida.

az restore-point wait --collection-name
                      --name --restore-point-name
                      --resource-group
                      [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--expand]
                      [--interval]
                      [--timeout]
                      [--updated]

Exemplos

Pause a execução da próxima linha de script da CLI até que o ponto de restauração seja criado com êxito.

az restore-point wait --resource-group "myResourceGroup" --collection-name "rpcName" --name "rpName" --created

Pause a execução da próxima linha de script da CLI até que o ponto de restauração seja excluído com êxito.

az restore-point wait --resource-group "myResourceGroup" --collection-name "rpcName" --name "rpName" --deleted

Parâmetros Exigidos

--collection-name

O nome da coleção de pontos de restauração.

--name --restore-point-name -n

O nome do ponto de restauração.

--resource-group -g

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

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.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--expand

A expressão de expansão a ser aplicada na operação. 'InstanceView' recupera informações sobre o estado de tempo de execução de um ponto de restauração. O valor padrão 'instanceView' é None.

--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
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.

--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