Habilitar e gerenciar o controle de versão de blob

Você pode habilitar o controle de versão do Armazenamento de Blobs para manter as versões anteriores de um blob quando ele for modificado ou excluído. Quando o controle de versão de blobs estiver habilitado, você poderá restaurar uma versão anterior de um blob para recuperar os dados, caso eles tenham sido modificados ou excluídos por engano.

Este artigo mostra como habilitar ou desabilitar o controle de versão de BLOB para a conta de armazenamento usando o portal do Azure ou um modelo de Azure Resource Manager. Para saber mais sobre o controle de versão de BLOB, consulte controle de versão de blob.

Habilitar controle de versão de blob

Você pode habilitar o controle de versão de blob no portal do Azure, no PowerShell, na CLI do Azure ou em um modelo do Azure Resource Manager.

Azure portal

Para habilitar o controle de versão de BLOB para uma conta de armazenamento no portal do Azure:

1. Navegue até sua conta de armazenamento no portal.

2. Em Gerenciamento de dados, escolha Proteção de dados.

3. Na seção Acompanhamento, selecione Habilitar controle de versão para blobs e, escolha se deseja manter todas as versões ou excluí-las após um período de tempo.

   

Importante

Se você definir a opção Excluir versões após, uma regra será adicionada automaticamente à política de gerenciamento do ciclo de vida da conta de armazenamento. Depois que essa regra é adicionada, a opção Excluir versões após não aparece mais na página de configuração Proteção de dados.

Você pode fazer essa opção reaparecer na página Proteção de dados removendo a regra. Se a política de gerenciamento do ciclo de vida contiver outras regras que excluam versões, você também precisará removê-las antes que a opção Excluir versões após possa reaparecer.

PowerShell

Para habilitar o controle de versão de BLOB para uma conta de armazenamento com o PowerShell, primeiro instale o módulo AZ. Storage versão 2.3.0 ou posterior. Em seguida, chame o comando Update-AzStorageBlobServiceProperty para habilitar o controle de versão, conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

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

# Enable versioning.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
    -StorageAccountName $accountName `
    -IsVersioningEnabled $true

CLI do Azure

Para habilitar o controle de versão de BLOB para uma conta de armazenamento com CLI do Azure, primeiro instale o CLI do Azure versão 2.2.0 ou posterior. Em seguida, chame o comando az storage account blob-service-properties update para habilitar o controle de versão, conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores entre colchetes angulares pelos seus próprios valores:

az storage account blob-service-properties update \
    --resource-group <resource_group> \
    --account-name <storage-account> \
    --enable-versioning true

Modelo

Para habilitar o controle de versão de blob com um modelo, crie um modelo com a propriedade IsVersioningEnabled como true. As etapas a seguir descrevem como criar um modelo no portal do Azure.

1. No portal do Azure, escolha Criar um recurso.

2. Em Pesquisar no Marketplace, digite implantação de modelo e pressione ENTER.

3. Escolha implantação de modelo, escolha criare, em seguida, escolha criar seu próprio modelo no editor.

4. No editor de modelo, cole o JSON a seguir. Substitua o espaço reservado <accountName> pelo nome da sua conta de armazenamento.

5. Salve o modelo.

6. Especifique o grupo de recursos da conta e, em seguida, escolha o botão comprar para implantar o modelo e habilitar o controle de versão de blob.

   {
       "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {},
       "variables": {},
       "resources": [
           {
               "type": "Microsoft.Storage/storageAccounts/blobServices",
               "apiVersion": "2019-06-01",
               "name": "<accountName>/default",
               "properties": {
                   "IsVersioningEnabled": true
               }
           }
       ]
   }
   

Para obter mais informações sobre como implantar recursos com modelos no portal do Azure, consulte implantar recursos com portal do Azure.

Listar versões de blob

Para exibir as versões de um blob, use o portal do Azure, o PowerShell ou a CLI do Azure. Você também pode listar as versões de um blob usando um dos SDKs do Armazenamento de Blobs.

Azure portal

Para listar as versões de um blob no portal do Azure:

1. Navegue até sua conta de armazenamento no portal e, em seguida, navegue até o contêiner que contém o blob.

2. Selecione o blob para o qual você deseja listar versões.

3. Selecione a guia Versões para exibir as versões do blob.

   

4. Alterne o botão Mostrar versões excluídas para exibir as versões excluídas reversivelmente. Se a exclusão reversível de blob estiver habilitada para a conta de armazenamento, então quaisquer versões excluídas que ainda estejam dentro do intervalo de retenção de exclusão reversível aparecerão na lista.

   

PowerShell

Para listar as versões de um blob com o PowerShell, chame o comando Get-AzStorageBlob com o parâmetro -IncludeVersion:

$account = Get-AzStorageAccount -ResourceGroupName <resource-group> -Name <storage-account>
$ctx = $account.Context
$container = "<container-name>"

$blobs = Get-AzStorageBlob -Container $container -Prefix "ab" -IncludeVersion -Context $ctx

foreach($blob in $blobs)
{
    Write-Host $blob.Name
    Write-Host $blob.VersionId
    Write-Host $blob.IsLatestVersion
}

CLI do Azure

Para listar as versões de um blob com a CLI do Azure, chame o comando az storage blob list com o parâmetro --include v:

storageAccount="<storage-account>"
containerName="<container-name>"

az storage blob list \
    --container-name $containerName \
    --prefix "ab" \
    --query "[[].name, [].versionId]" \
    --account-name $storageAccount \
    --include v \
    --auth-mode login \
    --output tsv 

Modelo

N/D

Próximas etapas

• Controle de versão de blobs
• Exclusão reversível para blobs do Armazenamento do Azure