Executar uma restauração pontual em dados de blob de blocos

Para configurar a restauração pontual com o portal do Azure, siga estas etapas:

1. Navegue até sua conta de armazenamento no portal do Azure.
2. Em Gerenciamento de dados, escolha Proteção de dados.
3. Selecione Ativar a restauração pontual. Quando você seleciona essa opção, a exclusão temporária para blobs, controle de versão e feed de alteração também são habilitadas.
4. Defina o ponto de restauração máximo para a restauração pontual, em dias. Esse número deve ser pelo menos um dia menor que o período de retenção especificado para exclusão temporária do blob.
5. Salve suas alterações.

A imagem a seguir mostra uma conta de armazenamento configurada para a restauração pontual com um ponto de restauração de sete dias atrás e um período de retenção para exclusão temporária de blob de 14 dias.

Para configurar a restauração pontual com o PowerShell, primeiro instale o módulo Az.Storage versão 2.6.0 ou posterior. Em seguida, chame o comando Enable-AzStorageBlobRestorePolicy para habilitar a restauração pontual para a conta de armazenamento.

O exemplo a seguir habilita a exclusão temporária e define o período de retenção de exclusão temporária, habilita o feed de alterações e o controle de versão e, em seguida, habilita a restauração pontual. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores quando executar o exemplo:

# Set resource group and account variables.
$rgName = "<resource-group>"
$accountName = "<storage-account>"

# Enable blob soft delete with a retention of 14 days.
Enable-AzStorageBlobDeleteRetentionPolicy -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -RetentionDays 14

# Enable change feed and versioning.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -EnableChangeFeed $true `
    -IsVersioningEnabled $true

# Enable point-in-time restore with a retention period of 7 days.
# The retention period for point-in-time restore must be at least
# one day less than that set for soft delete.
Enable-AzStorageBlobRestorePolicy -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -RestoreDays 7

# View the service settings.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $accountName

Para configurar a restauração pontual com a CLI do Azure, primeiro instale a CLI do Azure versão 2.2.0 ou posterior. Em seguida, chame o comando az storage account blob-service-properties update para habilitar a restauração pontual e as outras configurações de proteção de dados necessárias para a conta de armazenamento.

O exemplo a seguir habilita a exclusão temporária e define o período de retenção de exclusão temporária como 14 dias, habilita o feed de alterações e o controle de versão e, em seguida, habilita a restauração pontual com um período de restauração de 7 dias. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores quando executar o exemplo:

az storage account blob-service-properties update \
    --resource-group <resource_group> \
    --account-name <storage-account> \
    --enable-delete-retention true \
    --delete-retention-days 14 \
    --enable-versioning true \
    --enable-change-feed true \
    --enable-restore-policy true \
    --restore-days 7

Para restaurar todos os contêineres e blobs na conta de armazenamento com o portal do Azure, siga estas etapas:

1. Navegue até a lista de contêineres para sua conta de armazenamento.

2. Na barra de ferramentas, escolha restaurar contêinerese restaurar tudo.

3. No painel restaurar todos os contêineres, especifique o ponto de restauração fornecendo uma data e hora.

4. Confirme que você deseja continuar marcando a caixa.

5. Selecione Restaurar para iniciar a operação de restauração.

   

Para restaurar todos os contêineres e blobs na conta de armazenamento com o PowerShell, chame o comando Restore-AzStorageBlobRange e forneça o ponto de restauração como um valor de data/hora UTC. Por padrão, o comando Restore-AzStorageBlobRange é executado de forma assíncrona e retorna um objeto do tipo PSBlobRestoreStatus que você pode usar para verificar o status da operação de restauração.

O exemplo a seguir restaura de forma assíncrona os contêineres na conta de armazenamento para seu estado 12 horas antes do momento atual e verifica algumas das propriedades da operação de restauração:

# Specify -TimeToRestore as a UTC value
$restoreOperation = Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -TimeToRestore (Get-Date).ToUniversalTime().AddHours(-12)

# Get the status of the restore operation.
$restoreOperation.Status
# Get the ID for the restore operation.
$restoreOperation.RestoreId
# Get the restore point in UTC time.
$restoreOperation.Parameters.TimeToRestore

Para executar a operação de restauração de forma síncrona, inclua o parâmetro -WaitForComplete no comando. Quando o parâmetro -WaitForComplete estiver presente, o PowerShell exibirá uma mensagem que inclui a ID de restauração da operação e, em seguida, bloqueará a execução até que a operação de restauração seja concluída. Tenha em mente que o período de tempo exigido por uma operação de restauração depende da quantidade de dados a serem restaurados e uma grande operação de restauração pode levar até uma hora para ser concluída.

Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -TimeToRestore (Get-Date).AddHours(-12) -WaitForComplete

Para restaurar todos os contêineres e blobs na conta de armazenamento com a CLI do Azure, chame o comando az storage blob restore e forneça o ponto de restauração como um valor de data/hora UTC.

O exemplo a seguir restaura de forma assíncrona todos os contêineres na conta de armazenamento para seu estado 12 horas antes de uma data e hora especificadas. Para verificar o status da operação de restauração, chame az storage account show:

az storage blob restore \
    --resource-group <resource_group> \
    --account-name <storage-account> \
    --time-to-restore 2021-01-14T06:31:22Z \
    --no-wait

Para verificar as propriedades de uma operação de restauração, chame az storage account show e expanda a propriedade blobRestoreStatus. O exemplo a seguir mostra como usar a propriedade de status.

az storage account show \
    --name <storage-account> \
    --resource-group <resource_group> \
    --expand blobRestoreStatus \
    --query blobRestoreStatus.status \
    --output tsv

Para executar o comando az storage blob restore de forma síncrona e bloquear a execução até que a operação de restauração seja concluída, omita o --no-wait parâmetro.

Para restaurar um intervalo de blobs em um ou mais contêineres com o portal do Azure, siga estas etapas:

1. Navegue até a lista de contêineres para sua conta de armazenamento.

2. Selecione o contêiner ou contêineres a restaurar.

3. Na barra de ferramentas, escolha restaurar contêinerese restaurar selecionados.

4. No painel restaurar todos os contêineres, especifique o ponto de restauração fornecendo uma data e hora.

5. Especifique os intervalos a restaurar. Use uma barra (/) para delinear o nome do contêiner do prefixo de blob.

6. Por padrão, o painelRestaurar contêineres selecionados especifica um intervalo que inclui todos os blobs no contêiner. Exclua esse intervalo se você não quiser restaurar todo o contêiner. Um exemplo é mostrado na imagem a seguir.

   

7. Confirme que você deseja continuar marcando a caixa.

8. Selecione Restaurar para iniciar a operação de restauração.

A imagem a seguir mostra uma operação de restauração em um conjunto de intervalos.

A operação de restauração mostrada na imagem executa as seguintes ações:

• Restaura o conteúdo completo de container1.
• Restaura os blobs no intervalo lexicográfico de blob1 a blob5 no container2. Esse intervalo restaura os blobs com nomes como blob1, blob11, blob100, blob2e assim por diante. Como o final do intervalo é exclusivo, ele restaura os blobs cujos nomes começam com blob4, mas não restaura os blobs cujos nomes começam com blob5.
• Restaura todos os blobs em container3 e container4. Como o final do intervalo é exclusivo, esse intervalo não restaura o container5.

Para restaurar um intervalo de blobs, chame o comando Restore-AzStorageBlobRange e especifique um intervalo lexicográfico de nomes de contêiner e blob para o -BlobRestoreRangeparâmetro. Por exemplo, para restaurar os blobs em um único contêiner chamado container1, você pode especificar um intervalo que comece com container1 e termine com container2. Não há nenhum requisito para os contêineres nomeados nos intervalos de início e de término existirem. Como o final do intervalo é exclusivo, mesmo que a conta de armazenamento inclua um contêiner chamado container2, somente o contêiner chamado container1 será restaurado:

$range = New-AzStorageBlobRangeToRestore -StartRange container1 `
    -EndRange container2

Para especificar um subconjunto de blobs em um contêiner a ser restaurado, use uma barra (/) para separar o nome do contêiner do padrão de prefixo de blob. Por exemplo, o intervalo a seguir seleciona blobs em um único contêiner cujos nomes começam com as letras d até f:

$range = New-AzStorageBlobRangeToRestore -StartRange container1/d `
    -EndRange container1/g

Em seguida, forneça o intervalo para o comando Restore-AzStorageBlobRange. Especifique o ponto de restauração fornecendo um valor UTC DateTime para o parâmetro -TimeToRestore. O exemplo a seguir restaura os blobs no intervalo especificado para seu estado 3 dias antes de agora:

# Specify -TimeToRestore as a UTC value
Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -BlobRestoreRange $range `
    -TimeToRestore (Get-Date).AddDays(-3)

Por padrão, o comando Restore-AzStorageBlobRange é executado de forma assíncrona. Quando você inicia uma operação de restauração de forma assíncrona, o PowerShell exibe imediatamente uma tabela de propriedades para a operação:

Status     RestoreId                            FailureReason Parameters.TimeToRestore     Parameters.BlobRanges
------     ---------                            ------------- ------------------------     ---------------------
InProgress 459c2305-d14a-4394-b02c-48300b368c63               2020-09-15T23:23:07.1490859Z ["container1/d" -> "container1/g"]

Para restaurar vários intervalos de blobs de blocos, especifique uma matriz de intervalos para o parâmetro -BlobRestoreRange. O exemplo a seguir especifica dois intervalos para restaurar o conteúdo completo de container1 e container4 para seu estado 24 horas atrás e salva o resultado em uma variável:

# Specify a range that includes the complete contents of container1.
$range1 = New-AzStorageBlobRangeToRestore -StartRange container1 `
    -EndRange container2
# Specify a range that includes the complete contents of container4.
$range2 = New-AzStorageBlobRangeToRestore -StartRange container4 `
    -EndRange container5

$restoreOperation = Restore-AzStorageBlobRange -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -TimeToRestore (Get-Date).AddHours(-24) `
    -BlobRestoreRange @($range1, $range2)

# Get the status of the restore operation.
$restoreOperation.Status
# Get the ID for the restore operation.
$restoreOperation.RestoreId
# Get the blob ranges specified for the operation.
$restoreOperation.Parameters.BlobRanges

Para executar a operação de restauração de forma síncrona e bloquear a execução até que ela seja concluída, inclua o parâmetro -WaitForComplete no comando.

Para restaurar um intervalo de blobs, chame o comando az storage blob restore e especifique um intervalo lexicográfico de nomes de contêiner e blob para o parâmetro --blob-range. Para especificar vários intervalos, forneça o --blob-range parâmetro para cada intervalo distinto.

Por exemplo, para restaurar os blobs em um único contêiner chamado container1, você pode especificar um intervalo que comece com container1 e termine com container2. Não há nenhum requisito para os contêineres nomeados nos intervalos de início e de término existirem. Como o final do intervalo é exclusivo, mesmo que a conta de armazenamento inclua um contêiner chamado container2, somente o contêiner chamado container1 será restaurado.

Para especificar um subconjunto de blobs em um contêiner a ser restaurado, use uma barra (/) para separar o nome do contêiner do padrão de prefixo de blob. O exemplo mostrado abaixo restaura de forma assíncrona um intervalo de blobs em um contêiner cujos nomes começam com as letras d a f.

az storage blob restore \
    --account-name <storage-account> \
    --time-to-restore 2021-01-14T06:31:22Z \
    --blob-range container1 container2
    --blob-range container3/d container3/g
    --no-wait

Para executar o comando az storage blob restore de forma síncrona e bloquear a execução até que a operação de restauração seja concluída, omita o --no-wait parâmetro.