Configurar políticas de imutabilidade para contentores

Para configurar uma política de retenção baseada no tempo em um contêiner com o portal do Azure, siga estas etapas:

1. Navegue até o contêiner desejado.

2. Selecione o botão Mais à direita e, em seguida, selecione Política de acesso.

3. Na secção Armazenamento de blobs imutáveis, selecione Adicionar política.

4. No campo Tipo de política, selecione Retenção com base no tempo e especifique o período de retenção em dias.

5. Para criar uma política com escopo de contentor, não selecione a caixa Ativar a imutabilidade ao nível da versão.

6. Escolha se deseja permitir gravações de acréscimo protegidas.

   A opção Anexar blobs permite que as suas cargas de trabalho adicionem novos blocos de dados ao fim de um blob de acréscimo, através da operação Anexar Bloco.

   A opção Bloquear e acrescentar blobs fornece as mesmas permissões que a opção Acrescentar blobs, mas adiciona a capacidade de escrever novos blocos em um blob de bloco. A API de armazenamento de Blob não fornece uma maneira para os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando os métodos append e flush disponíveis na API de armazenamento Data Lake. Além disso, algumas aplicações da Microsoft utilizam APIs internas para criar blobs de blocos e depois acrescentar dados aos mesmos. Se as suas cargas de trabalho dependerem de qualquer uma destas ferramentas, pode utilizar esta propriedade para evitar erros que podem surgir quando essas ferramentas tentam anexar blocos a um blob em blocos.

   Para saber mais sobre essas opções, consulte Permitir gravações de blobs de acréscimo protegidos.

   

Depois de configurar a política de imutabilidade, você verá que ela tem o escopo definido para o contêiner:

Para configurar uma política de retenção baseada em tempo em um contêiner com PowerShell, chame o comando Set-AzRmStorageContainerImmutabilityPolicy , fornecendo o intervalo de retenção em dias. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

Set-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName <resource-group> `
    -StorageAccountName <storage-account> `
    -ContainerName <container> `
    -ImmutabilityPeriod 10

Para permitir escritas de acréscimo protegidas, defina o parâmetro -AllowProtectedAppendWrite ou -AllowProtectedAppendWriteAll como true.

A opção AllowProtectedAppendWrite permite que as suas cargas de trabalho adicionem novos blocos de dados ao final de um blob de acréscimo ao utilizar a operação Append Block.

A opção AllowProtectedAppendWriteAll fornece-lhe as mesmas permissões que a opção AllowProtectedAppendWrite, mas acrescenta a capacidade de escrever novos blocos num blob de blocos. A API de armazenamento de Blob não fornece uma maneira para os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando os métodos append e flush disponíveis na API de armazenamento Data Lake. Além disso, algumas aplicações da Microsoft utilizam APIs internas para criar blobs de blocos e depois acrescentar dados aos mesmos. Se as suas cargas de trabalho dependerem de qualquer uma destas ferramentas, pode utilizar esta propriedade para evitar erros que podem surgir quando essas ferramentas tentam anexar blocos a um blob em blocos.

Para saber mais sobre essas opções, consulte Permitir gravações de blobs de acréscimo protegidos.

Para configurar uma política de retenção baseada no tempo num contentor com a CLI do Azure, execute o comando az storage container immutability-policy create, indicando o intervalo de retenção em dias. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

az storage container immutability-policy create \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --container-name <container> \
    --period 10

Para permitir escritas de acréscimo protegidas, defina o parâmetro --allow-protected-append-writes ou --allow-protected-append-writes-all como true.

A opção --allow-protected-append-writes permite que as suas cargas de trabalho adicionem novos blocos de dados no fim de um blob de acréscimo, utilizando a operação Append Block.

A opção --allow-protected-append-writes-all confere-lhe as mesmas permissões que a opção --allow-protected-append-writes, mas acrescenta a capacidade de escrever novos blocos num blob em blocos. A API de armazenamento de Blob não fornece uma maneira para os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando os métodos append e flush disponíveis na API de armazenamento Data Lake. Além disso, algumas aplicações da Microsoft utilizam APIs internas para criar blobs de blocos e depois acrescentar dados aos mesmos. Se as suas cargas de trabalho dependerem de qualquer uma destas ferramentas, pode utilizar esta propriedade para evitar erros que podem surgir quando essas ferramentas tentam anexar blocos a um blob em blocos.

Para saber mais sobre essas opções, consulte Permitir gravações de blobs de acréscimo protegidos.

Para modificar uma política de retenção baseada no tempo desbloqueada no portal do Azure, siga estas etapas:

1. Navegue até o contêiner desejado.

2. Selecione o botão Mais e escolha Política de acesso.

3. Na secção Versões imutáveis de blobs, localize a política existente desbloqueada. Selecione o botão Mais e, em seguida, selecione Editar no menu.

4. Forneça um novo intervalo de retenção para a política. Também pode selecionar Permitir acréscimos protegidos adicionais para permitir escritas em blobs de acréscimo protegidos.

   

Para eliminar uma política desbloqueada, selecione o botão Mais e, em seguida, Eliminar.

Para modificar uma política desbloqueada, primeiro recupere a política chamando o comando Get-AzRmStorageContainerImmutabilityPolicy . Em seguida, chame o comando Set-AzRmStorageContainerImmutabilityPolicy para atualizar a política. Inclua o novo intervalo de retenção em dias e o -ExtendPolicy parâmetro. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

$policy = Get-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName <resource-group> `
    -AccountName <storage-account> `
    -ContainerName <container>

Set-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName <resource-group> `
    -StorageAccountName <storage-account> `
    -ContainerName <container> `
    -ImmutabilityPeriod 21 `
    -AllowProtectedAppendWriteAll true `
    -Etag $policy.Etag `
    -ExtendPolicy

Para eliminar uma política desbloqueada, utilize o comando Remove-AzRmStorageContainerImmutabilityPolicy.

Remove-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName <resource-group> `
    -AccountName <storage-account> `
    -ContainerName <container>
    -Etag $policy.Etag

Para modificar uma política de retenção baseada no tempo não bloqueada com a CLI do Azure, execute o comando az storage container immutability-policy extend, fornecendo o novo intervalo de retenção em dias. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

etag=$(az storage container immutability-policy show \
        --account-name <storage-account> \
        --container-name <container> \
        --query etag \
        --output tsv)

az storage container immutability-policy extend \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --container-name <container> \
    --period 21 \
    --if-match $etag \
    --allow-protected-append-writes-all true

Para eliminar uma política de imutabilidade desbloqueada, execute o comando az storage container immutability-policy delete.

Para bloquear uma política com o portal do Azure, siga estas etapas:

1. Navegue até um contêiner com uma política desbloqueada.
2. Na secção Versões imutáveis de blobs, localize a política existente desbloqueada. Selecione o botão Mais e, em seguida, selecione Bloquear a política no menu.
3. Confirme que deseja bloquear a política.

Para bloquear uma política com o PowerShell, primeiro chame o comando Get-AzRmStorageContainerImmutabilityPolicy para recuperar o ETag da política. Em seguida, execute o comando Lock-AzRmStorageContainerImmutabilityPolicy e forneça o valor de ETag para bloquear a política. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

$policy = Get-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName <resource-group> `
    -AccountName <storage-account> `
    -ContainerName <container>

Lock-AzRmStorageContainerImmutabilityPolicy -ResourceGroupName <resource-group> `
    -AccountName <storage-account> `
    -ContainerName <container> `
    -Etag $policy.Etag

Para bloquear uma política com a CLI do Azure, execute primeiro o comando az storage container immutability-policy show para obter o ETag da política. Em seguida, execute o comando az storage container immutability-policy lock e forneça o valor de ETag para bloquear a política. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

etag=$(az storage container immutability-policy show \
        --account-name <storage-account> \
        --container-name <container> \
        --query etag \
        --output tsv)

az storage container immutability-policy lock \
    --resource-group <resource-group> \
    --account-name <storage-account> \
    --container-name <container> \
    --if-match $etag

Para configurar uma retenção legal em um contêiner com o portal do Azure, siga estas etapas:

1. Navegue até o contêiner desejado.

2. Selecione o botão Mais e escolha Política de acesso.

3. Na secção Versões imutáveis de blobs, selecione Adicionar política.

4. Escolha Retenção legal como o tipo de política.

5. Adicione uma ou mais etiquetas de retenção legal.

6. Escolha se deseja permitir gravações de acréscimo protegidas e selecione Salvar.

   A opção Anexar blobs permite que as suas cargas de trabalho adicionem novos blocos de dados ao fim de um blob de acréscimo, através da operação Anexar Bloco.

   Esta configuração também permite escrever novos blocos num block blob. A API de armazenamento de Blob não fornece uma maneira para os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando os métodos append e flush disponíveis na API de armazenamento Data Lake. Além disso, essa propriedade permite que aplicativos da Microsoft, como o Azure Data Factory, acrescentem blocos de dados usando APIs internas. Se suas cargas de trabalho dependem de qualquer uma dessas ferramentas, você pode usar essa propriedade para evitar erros que podem aparecer quando essas ferramentas tentam acrescentar dados a blobs.

   Para saber mais sobre essas opções, consulte Permitir gravações de blobs de acréscimo protegidos.

   

Depois de configurar a política de imutabilidade, você verá que ela tem o escopo definido para o contêiner:

A imagem a seguir mostra um contêiner com uma política de retenção baseada em tempo e retenção legal configurada.

Para limpar uma retenção legal, navegue até a caixa de diálogo Política de acesso e, no menu de contexto da política, selecione Editar. Em seguida, elimine todas as etiquetas da política para remover o bloqueio.

Para configurar uma retenção legal em um contêiner com o PowerShell, chame o comando Add-AzRmStorageContainerLegalHold . Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

Add-AzRmStorageContainerLegalHold -ResourceGroupName <resource-group> `
    -StorageAccountName <storage-account> `
    -Name <container> `
    -Tag <tag1>,<tag2>,...`
    -AllowProtectedAppendWriteAll true

Para remover uma retenção legal, utilize o comando Remove-AzRmStorageContainerLegalHold:

Remove-AzRmStorageContainerLegalHold -ResourceGroupName <resource-group> `
    -StorageAccountName <storage-account> `
    -Name <container> `
    -Tag <tag1>,<tag2>,...

Para configurar uma retenção legal num contentor com o PowerShell, execute o comando az storage container legal-hold set. Lembre-se de substituir os valores de marcador de posição entre colchetes angulares pelos seus próprios valores:

az storage container legal-hold set \
    --tags tag1 tag2 \
    --container-name <container> \
    --account-name <storage-account> \
    --resource-group <resource-group> \
    --allow-protected-append-writes-all true

Para remover uma suspensão legal, execute o comando az storage container legal-hold clear:

az storage container legal-hold clear \
    --tags tag1 tag2 \
    --container-name <container> \
    --account-name <storage-account> \
    --resource-group <resource-group> \