Configura as políticas de imutabilidade para os contêineres

Para configurar uma política de retenção baseada em tempo em um contêiner no 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 seção Armazenamento de blobs imutável, selecione Adicionar política.

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

5. Para criar uma política com escopo de contêiner, não marque a caixa de seleção Habilitar imutabilidade em nível de versão.

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

   A opção Acrescentar blobs permite que suas cargas de trabalho adicionem novos blocos de dados ao final de um blob de acréscimo usando a operação Bloco de Acréscimo.

   A opção Bloquear e acrescentar blobs fornece as mesmas permissões que a opção Acrescentar blobs, mas adiciona a capacidade de gravar novos blocos em um blob de blocos. A API de Armazenamento de Blobs não fornece uma maneira de os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando métodos de acréscimo e liberação disponíveis na API do Data Lake Storage. Além disso, alguns aplicativos da Microsoft usam APIs internas para criar blobs de blocos e, em seguida, acrescentar a eles. Se suas cargas de trabalho dependem de qualquer uma dessas ferramentas, você pode usar essa propriedade para evitar erros que podem ocorrer quando essas ferramentas tentarem acrescentar blocos a um blob de blocos.

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

   

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

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

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

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

A opção AllowProtectedAppendWrite permite que suas cargas de trabalho adicionem novos blocos de dados ao final de um blob de acréscimo usando a operação Bloco de Acréscimo.

A opção AllowProtectedAppendWriteAll fornece as mesmas permissões que a opção AllowProtectedAppendWrite, mas adiciona a capacidade de gravar novos blocos em um blob de blocos. A API de Armazenamento de Blobs não fornece uma maneira de os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando métodos de acréscimo e liberação disponíveis na API do Data Lake Storage. Além disso, alguns aplicativos da Microsoft usam APIs internas para criar blobs de blocos e, em seguida, acrescentar a eles. Se suas cargas de trabalho dependem de qualquer uma dessas ferramentas, você pode usar essa propriedade para evitar erros que podem ocorrer quando essas ferramentas tentam acrescentar blocos a um blob de blocos.

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

Para configurar uma política de retenção baseada em tempo em um contêiner com CLI do Azure, chame o comando az storage container immutability-policy create, fornecendo o intervalo de retenção em dias. Lembre-se de substituir os valores dos espaços reservados entre colchetes angulares pelos seus valores:

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

Para permitir gravações 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 suas cargas de trabalho adicionem novos blocos de dados ao final de um blob de acréscimo por meio da operação Append Block.

A opção --allow-protected-append-writes-all fornece as mesmas permissões que a opção --allow-protected-append-writes, mas adiciona a capacidade de gravar novos blocos em um blob de blocos. A API de Armazenamento de Blobs não fornece uma maneira de os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando métodos de acréscimo e liberação disponíveis na API do Data Lake Storage. Além disso, alguns aplicativos da Microsoft usam APIs internas para criar blobs de blocos e, em seguida, acrescentar a eles. Se suas cargas de trabalho dependem de qualquer uma dessas ferramentas, você pode usar essa propriedade para evitar erros que podem ocorrer quando essas ferramentas tentarem acrescentar blocos a um blob de blocos.

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

Para modificar uma política de retenção baseada em 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 seção Versões imutáveis de BLOB, localize a política existente que está desbloqueada. Selecione o botão Mais e, em seguida, escolha Editar no menu.

4. Forneça um novo intervalo de retenção para a política. Você também pode selecionar Permitir acréscimos protegidos adicionais para permitir gravações em blobs de acréscimo protegidos.

   

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

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 parâmetro -ExtendPolicy. Lembre-se de substituir os valores dos espaços reservados 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 excluir uma política desbloqueada, chame 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 em tempo desbloqueada 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 dos espaços reservados entre colchetes angulares pelos seus 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 excluir uma política desbloqueada, chame o comando az storage container immutability-policy delete.

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

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

Para bloquear uma política com o PowerShell, primeiro chame o comando Get-AzRmStorageContainerImmutabilityPolicy para recuperar a Etag da política. Em seguida, chame o comando Lock-AzRmStorageContainerImmutabilityPolicy e passe o valor do ETag para bloquear a política. Lembre-se de substituir os valores dos espaços reservados 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 o CLI do Azure, primeiro chame o comando az storage container immutability-policy show para recuperar a Etag da política. Em seguida, chame o comando az storage container immutability-policy lock e passe o valor da ETag para bloquear a política. Lembre-se de substituir os valores dos espaços reservados 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 seção Versões imutáveis de blob, selecione Adicionar política.

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

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

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

   A opção Acrescentar blobs permite que suas cargas de trabalho adicionem novos blocos de dados ao final de um blob de acréscimo usando a operação Bloco de Acréscimo.

   Essa configuração também adiciona a capacidade de gravar novos blocos em um blob de blocos. A API de Armazenamento de Blobs não fornece uma maneira de os aplicativos fazerem isso diretamente. No entanto, os aplicativos podem fazer isso usando métodos de acréscimo e liberação disponíveis na API do Data Lake Storage. Além disso, essa propriedade permite que aplicativos da Microsoft, como Azure Data Factory, acrescentem blocos de dados usando as APIs internas. Se suas cargas de trabalho dependerem de qualquer uma dessas ferramentas, você poderá usar essa propriedade para evitar erros que possam aparecer quando essas ferramentas tentarem acrescentar dados a blobs.

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

   

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

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

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, exclua todas as tags da política para remover a retenção.

Para configurar uma retenção legal em um contêiner com o PowerShell, chame o comando Add-AzRmStorageContainerLegalHold. Lembre-se de substituir os valores dos espaços reservados 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, chame o comando Remove-AzRmStorageContainerLegalHold:

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

Para configurar uma retenção legal em um contêiner com o PowerShell, chame o comando az storage container legal-hold set. Lembre-se de substituir os valores dos espaços reservados 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 retençã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> \