Partilhar via


az restore-point

Gerencie o ponto de restauração com res.

Comandos

Nome Descrição Tipo Estado
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, apenas as tags podem ser modificadas.

Core disponibilidade geral
az restore-point collection create

Criar 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, apenas as tags podem ser modificadas.

Core disponibilidade geral
az restore-point collection delete

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

Core disponibilidade geral
az restore-point collection list

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

Core disponibilidade geral
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 disponibilidade geral
az restore-point collection show

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

Core disponibilidade geral
az restore-point collection update

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

Core disponibilidade geral
az restore-point collection wait

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

Core disponibilidade geral
az restore-point create

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

Core disponibilidade geral
az restore-point delete

Exclua o ponto de restauração.

Core disponibilidade geral
az restore-point show

Obtenha o ponto de restauração.

Core disponibilidade geral
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 disponibilidade geral

az restore-point create

Crie o ponto de restauração. A atualização das 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"

Crie 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 Obrigatórios

--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 parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--consistency-mode
Previsualizar

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, apenas CrashConsistent é aceito como uma entrada válida. Consulte https://aka.ms/RestorePoints para obter mais detalhes.

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

A criptografia de disco de dados gerenciados pelo cliente define a ID do recurso.

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

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

Propriedade Valor
Valores aceites: 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: O id do recurso 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 espere que a operação de longa duração termine.

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

A criptografia de disco do sistema operacional gerenciado pelo cliente define a ID do recurso.

--os-restore-point-encryption-type

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

Propriedade Valor
Valores aceites: 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 SO de origem.

--source-restore-point

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

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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 da subscrição. 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
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 parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais 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

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
--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 espere que a operação de longa duração termine.

Propriedade Valor
Valores aceites: 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 subscrição. 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 do log para mostrar todos os logs de depuração.

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

Mostrar esta mensagem de ajuda e sair.

--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 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
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 Obrigatórios

--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 parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--instance-view

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

Parâmetros globais
--debug

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

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

Mostrar esta mensagem de ajuda e sair.

--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 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 da subscrição. 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
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 do script 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 do script 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 Obrigatórios

--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 parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais 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 satisfaç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 expand 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é ser 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 do log para mostrar todos os logs de depuração.

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

Mostrar esta mensagem de ajuda e sair.

--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 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 da subscrição. 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
Valor padrão: False