Arquivar um blob

A camada de arquivo é uma camada offline para armazenar dados de blobs que raramente são acessados. A camada de arquivo oferece os menores custos de armazenamento, mas custos de recuperação de dados e latência maiores em comparação com as camadas online (quente e frio). Os dados devem permanecer na camada de arquivos por pelo menos 180 dias ou estar sujeitos a uma cobrança de exclusão antecipada. Para mais informações sobre o nível de arquivo, veja Nível de acesso ao Arquivo.

Um blob não pode ser lido nem modificado enquanto estiver na camada de arquivos. Para ler ou baixar um blob na camada de arquivos, você precisa primeiro reidratá-lo para uma camada online, seja a quente ou a fria. Os dados na camada de arquivo podem levar até 15 horas para reidratar, dependendo da prioridade que você especificar para a operação reidratação. Para obter mais informações sobre reidratação de blob, confira Visão geral da reidratação de blob da camada de arquivos.

Caution

Um blob na camada de arquivamento está offline. Ou seja, não pode ser lido ou modificado até ser reidratado. O processo de reidratação pode levar várias horas e tem custos associados. Antes de mover dados para a camada de arquivos, considere se a colocação de dados de blob offline pode afetar seus fluxos de trabalho.

Você pode usar o portal Azure, PowerShell, CLI do Azure ou uma das bibliotecas clientes do Armazenamento do Azure para gerenciar o arquivamento de dados.

Arquivar blobs em upload

Para arquivar um ou mais blobs durante o upload, crie o blob diretamente na camada de arquivamento.

Para arquivar um blob ou conjunto de blobs no upload do portal do Azure, siga estes passos:

Navegue até o contêiner de destino.
Selecione o botão Carregar .
Selecione o arquivo ou os arquivos a serem carregados.
Expanda a seção Avançada e defina o nível de Acesso para Arquivar.
Selecione o botão Carregar .

Para arquivar um blob ou conjunto de blobs no upload com o PowerShell, chame o comando Set-AzStorageBlobContent , como mostrado no exemplo a seguir. Não deixe de substituir os valores de espaço reservado entre colchetes pelos seus valores:

$rgName = <resource-group>
$storageAccount = <storage-account>
$containerName = <container>

# Get context object
$ctx = New-AzStorageContext -StorageAccountName $storageAccount -UseConnectedAccount

# Create new container.
New-AzStorageContainer -Name $containerName -Context $ctx

# Upload a single file named blob1.txt to the archive tier.
Set-AzStorageBlobContent -Container $containerName `
    -File "blob1.txt" `
    -Blob "blob1.txt" `
    -Context $ctx `
    -StandardBlobTier Archive

# Upload the contents of a sample-blobs directory to the archive tier, recursively.
Get-ChildItem -Path "C:\sample-blobs" -File -Recurse | 
    Set-AzStorageBlobContent -Container $containerName `
        -Context $ctx `
        -StandardBlobTier Archive

Para arquivar um único blob durante o upload com a CLI do Azure, execute o comando az storage blob upload, como mostrado no exemplo a seguir. Não deixe de substituir os valores de espaço reservado entre colchetes pelos seus valores:

az storage blob upload \
    --account-name <storage-account> \
    --container-name <container> \
    --name <blob> \
    --file <file> \
    --tier Archive \
    --auth-mode login

Para arquivar um conjunto de blobs no upload com o CLI do Azure, chame o comando azstorage blob upload-batch, como mostrado no exemplo a seguir. Não deixe de substituir os valores de espaço reservado entre colchetes pelos seus valores:

az storage blob upload-batch \
    --destination <container> \
    --source <source-directory> \
    --account-name <storage-account> \
    --tier Archive \
    --auth-mode login

Para arquivar um único blob no upload com o AzCopy, chame o comando azcopy copy. Forneça um arquivo local como fonte e o URI do blob de destino como destino, e especifique a camada de arquivo como a camada de destino, como mostrado no exemplo a seguir. Não deixe de substituir os valores de espaço reservado entre colchetes pelos seus valores:

Note

Este exemplo inclui argumentos de caminho com aspas simples (''). Use aspas simples em todos os shells de comando, exceto no shell de comando do Windows (cmd.exe). Se você estiver usando um shell de comando Windows (cmd.exe), coloque os argumentos de caminho entre aspas duplas ("") em vez de aspas simples ('').
Este exemplo exclui o token SAS porque ele pressupõe que você forneceu credenciais de autorização usando Microsoft Entra ID. Consulte o artigo Introdução ao AzCopy para saber mais sobre as formas de fornecer credenciais de autorização ao serviço de armazenamento.

azcopy copy 'C:\temp\myTextFile.txt' 'https://<storage-account>.blob.core.windows.net/<container>/myTextFile-archived.txt' --blob-type BlockBlob --block-blob-tier Archive

Para outros exemplos, veja Upload de arquivos para o armazenamento de blobs do Azure usando o AzCopy.

Arquivar um blob existente

Você pode mover um blob existente para a camada de arquivo de duas maneiras:

Você pode mudar o nível de um blob com a operação Set Blob Tier . Definir camada do blob move um único blob de uma camada para outra.

Tenha em mente que, quando você move um blob para a camada de arquivamento com Set Blob Tier, você não poderá ler nem modificar os dados do blob até reidratar o blob. Se você precisar ler ou modificar os dados do blob antes que o intervalo de exclusão inicial tenha passado, considere usar uma operação de Copy Blob para criar uma cópia do blob no tier de arquivo.
Você pode copiar um blob de uma camada online para a camada de arquivamento com a operação Copy Blob. Você pode invocar a operação Copy Blob para copiar um blob de uma camada de acesso online (quente ou fria) para a camada de arquivamento. O blob fonte permanece na camada online, e você pode continuar a ler ou modificar seus dados na camada online.

Arquive um blob existente mudando seu nível

Use a operação Set Blob Tier para mover um blob da camada Hot ou Cool para a camada de arquivamento. A operação Set Blob Tier é ideal para cenários onde você não precisará acessar os dados arquivados antes do intervalo de exclusão antecipada.

A operação Set Blob Tier altera o nível de um único blob. Para mover um conjunto de blobs para a camada de arquivo com desempenho ideal, a Microsoft recomenda realizar uma operação de arquivo em massa. A operação de arquivamento em massa envia um lote de chamadas de Definir Camada de Blob ao serviço em uma única transação. Para mais informações, veja Arquivo em bloco.

Para mover um blob existente para a camada de arquivo no portal do Azure, siga estes passos:

Navegue até o contêiner do blob.
Selecione o blob para arquivar.
Selecione o botão de Mudar Nível .
Selecione Arquivar no menu suspenso Camada de acesso.
Selecione Salvar.

Para alterar a camada de um blob de Frequente ou Esporádica para Arquivos com o PowerShell, use a propriedade BlobClient do blob para retornar uma referência do .NET para o blob e, em seguida, execute uma chamada ao método SetAccessTier nessa referência. Lembre-se de substituir os espaços reservados entre colchetes angulares pelos seus próprios valores:

# Initialize these variables with your values.
$rgName = "<resource-group>"
$accountName = "<storage-account>"
$containerName = "<container>"
$blobName = "<blob>"

# Get the storage account context
$ctx = (Get-AzStorageAccount `
        -ResourceGroupName $rgName `
        -Name $accountName).Context

# Change the blob's access tier to Archive.
$blob = Get-AzStorageBlob -Container $containerName -Blob $blobName -Context $ctx
$blob.BlobClient.SetAccessTier("Archive", $null)

Para alterar a camada de um blob de hot ou cool para Archive usando a CLI do Azure, use o comando az storage blob set-tier. Lembre-se de substituir os espaços reservados entre colchetes angulares pelos seus próprios valores:

az storage blob set-tier \
    --account-name <storage-account> \
    --container-name <container> \
    --name <blob> \
    --tier Archive \
    --auth-mode login

Para alterar a camada de um blob de acesso Frequente ou Esporádico para Arquivos, use o comando azcopy set-properties e defina o parâmetro -block-blob-tier como archive.

Importante

A capacidade de mudar o nível de um blob usando o AzCopy está atualmente em PREVIEW. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

Note

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=archive

Para alterar a camada de acesso para todos os blobs em um diretório virtual, consulte o nome do diretório virtual em vez do nome do blob e acrescente --recursive=true ao comando.

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/myvirtualdirectory' --block-blob-tier=archive --recursive=true

Arquivar um blob existente com uma operação de cópia

Use a operação Copiar Blob para copiar um blob da camada quente ou fria para a camada de arquivamento. O blob de origem permanece no tier hot ou cool, enquanto o blob de destino é criado no tier de arquivo.

Uma operação de Copiar Blob é ideal para cenários em que você pode precisar ler ou modificar os dados arquivados antes que o intervalo de exclusão inicial tenha expirado. Você pode acessar os dados do blob de origem sem precisar reidratar o blob arquivado.

N/A

Para copiar um blob de uma camada online para a camada de arquivo com o PowerShell, chame o comando Start-AzStorageBlobCopy e especifique a camada de arquivo. Lembre-se de substituir os espaços reservados entre colchetes angulares pelos seus próprios valores:

# Initialize these variables with your values.
$rgName = "<resource-group>"
$accountName = "<storage-account>"
$srcContainerName = "<source-container>"
$destContainerName = "<dest-container>"
$srcBlobName = "<source-blob>"
$destBlobName = "<dest-blob>"

# Get the storage account context
$ctx = (Get-AzStorageAccount `
        -ResourceGroupName $rgName `
        -Name $accountName).Context

# Copy the source blob to a new destination blob in archive tier.
Start-AzStorageBlobCopy -SrcContainer $srcContainerName `
    -SrcBlob $srcBlobName `
    -DestContainer $destContainerName `
    -DestBlob $destBlobName `
    -StandardBlobTier Archive `
    -Context $ctx

Para copiar um blob de uma camada online para a camada de arquivamento usando a CLI do Azure, execute o comando az storage blob copy start e especifique a camada de arquivamento. Lembre-se de substituir os espaços reservados entre colchetes angulares pelos seus próprios valores:

az storage blob copy start \
    --source-container <source-container> \
    --source-blob <source-blob> \
    --destination-container <dest-container> \
    --destination-blob <dest-blob> \
    --account-name <storage-account> \
    --tier Archive \
    --auth-mode login

Para copiar um blob de um nível online para o nível de arquivo com o AzCopy, especifique o URI do blob de origem e o URI do blob de destino. O blob de destino deve ter um nome diferente do blob de origem e não deve existir ainda.

Note

Lembre-se de substituir os espaços reservados entre colchetes angulares pelos seus próprios valores:

azcopy copy 'https://<source-account>.blob.core.windows.net/sample-container/blob1.txt' 'https://<dest-account>.blob.core.windows.net/sample-container/blob1-archived.txt' --blob-type BlockBlob --block-blob-tier Archive

Arquivo em massa

Para mover blobs para a camada de arquivo em um contêiner ou pasta, enumere blobs e chame a operação Set Blob Tier em cada um. O exemplo abaixo mostra como executar essa operação:

N/A

# Initialize these variables with your values.
    $rgName = "<resource-group>"
    $accountName = "<storage-account>"
    $containerName = "<container>"
    $folderName = "<folder>/"

    $ctx = (Get-AzStorageAccount -ResourceGroupName $rgName -Name $accountName).Context

    $blobCount = 0
    $Token = $Null
    $MaxReturn = 5000

    do {
        $Blobs = Get-AzStorageBlob -Context $ctx -Container $containerName -Prefix $folderName -MaxCount $MaxReturn -ContinuationToken $Token
        if($Blobs -eq $Null) { break }

        #Set-StrictMode will cause Get-AzureStorageBlob returns result in different data types when there is only one blob
        if($Blobs.GetType().Name -eq "AzureStorageBlob")
        {
            $Token = $Null
        }
        else
        {
            $Token = $Blobs[$Blobs.Count - 1].ContinuationToken;
        }

        $Blobs | ForEach-Object {
                if($_.BlobType -eq "BlockBlob") {
                    $_.BlobClient.SetAccessTier("Archive", $null)
                }
            }
    }
    While ($Token -ne $Null)

az storage blob list --account-name $accountName --account-key $key \
    --container-name $containerName --prefix $folderName \
    --query "[?properties.blobTier == 'Cool'].name" --output tsv \
    | xargs -I {} -P 10 \
    az storage blob set-tier --account-name $accountName --account-key $key \
    --container-name $containerName --tier Archive --name "{}"

Ao mover um grande número de blobs para o nível de arquivo, use uma operação em lote para desempenho ideal. Uma operação em lote envia várias chamadas à API para o serviço em uma única solicitação. As suboperações compatíveis com a operação Lote de Blobs incluem Excluir Blob e Definir Camada de Blob.

Para arquivar blobs com uma operação em lote, use uma das bibliotecas cliente do Armazenamento do Azure. O exemplo de código a seguir mostra como executar uma operação básica em lote com a biblioteca de clientes .NET:

static async Task BulkArchiveContainerContents(string accountName, string containerName)
{
    string containerUri = string.Format("https://{0}.blob.core.windows.net/{1}",
                                    accountName,
                                    containerName);

    // Get container client, using Azure AD credentials.
    BlobUriBuilder containerUriBuilder = new BlobUriBuilder(new Uri(containerUri));
    BlobContainerClient blobContainerClient = new BlobContainerClient(containerUriBuilder.ToUri(), 
                                                                      new DefaultAzureCredential());

    // Get URIs for blobs in this container and add to stack.
    var uris = new Stack<Uri>();
    await foreach (var item in blobContainerClient.GetBlobsAsync())
    {
        uris.Push(blobContainerClient.GetBlobClient(item.Name).Uri);
    }

    // Get the blob batch client.
    BlobBatchClient blobBatchClient = blobContainerClient.GetBlobBatchClient();

    try
    {
        // Perform the bulk operation to archive blobs.
        await blobBatchClient.SetBlobsAccessTierAsync(blobUris: uris, accessTier: AccessTier.Archive);
    }
    catch (RequestFailedException e)
    {
        Console.WriteLine(e.Message);
    }
}

Para ver um aplicativo de exemplo aprofundado que mostra como alterar camadas com uma operação em lote, veja AzBulkSetBlobTier.

Use políticas de gerenciamento do ciclo de vida para arquivar blobs

Você pode otimizar custos para dados de blobs que raramente são acessados criando políticas de gerenciamento do ciclo de vida que movem automaticamente os blobs para a camada de arquivo quando eles não foram acessados ou modificados por um período de tempo especificado. Depois que você configura uma política de gerenciamento do ciclo de vida, o Armazenamento do Azure a executa uma vez por dia. Para mais informações sobre políticas de gerenciamento do ciclo de vida, veja Otimizar custos gerenciando automaticamente o ciclo de vida dos dados.

Você pode usar o portal do Azure, PowerShell, CLI do Azure ou um template do Azure Resource Manager para criar uma política de gerenciamento do ciclo de vida. Para simplificar, esta seção mostra como criar uma política de gerenciamento do ciclo de vida apenas no portal do Azure. Para mais exemplos mostrando como criar políticas de gerenciamento do ciclo de vida, veja Configurar uma política de gerenciamento do ciclo de vida.

Caution

Antes de usar uma política de gerenciamento do ciclo de vida para mover dados para a camada de arquivo, verifique se esses dados não precisam ser deletados ou movidos para outro nível por pelo menos 180 dias. Dados que são excluídos ou movidos para outro nível antes do término do período de 180 dias estão sujeitos a uma taxa de exclusão antecipada.

Também tenha em mente que os dados no nível de arquivo precisam ser reidratados antes de poderem ser lidos ou modificados. Reidratar um blob da camada de arquivamento pode levar várias horas e envolve custos.

Para criar uma política de gerenciamento do ciclo de vida para arquivar blobs no portal do Azure, siga estes passos:

Passo 1: Crie a regra e especifique o tipo de blob

Navegue até sua conta de armazenamento no portal.
Em Gerenciamento de Dados, localize as configurações de gerenciamento do ciclo de vida .
Selecione o botão Adicionar uma regra .
Na aba Detalhes , especifique um nome para sua regra.
Especifique o escopo da regra: ou Aplicar a regra a todos os blobs na sua conta de armazenamento, ou Limitar blobs com filtros.
Selecione os tipos de blobs aos quais a regra deve ser aplicada e especifique se deve incluir os snapshots ou as versões dos blobs.

Passo 2: Adicionar condições de regra

Dependendo das suas escolhas, você pode configurar regras para blobs base (versões atuais), versões anteriores ou snapshots de blobs. Especifique uma de duas condições para verificar:
- Os objetos foram modificados pela última vez há alguns dias.
- Os objetos foram criados há alguns dias.
- Os objetos foram acessados pela última vez há alguns dias.
Apenas uma dessas condições pode ser aplicada para mover um tipo específico de objeto para a camada de arquivo por regra. Por exemplo, se você definir uma ação que arquive blobs de base se eles não tiverem sido modificados por 90 dias, então também não poderá definir uma ação que arquive blobs de base se eles não tiverem sido acessados por 90 dias. Da mesma forma, você pode definir uma ação por regra com qualquer uma dessas condições para arquivar versões anteriores, e uma para arquivar snapshots.
Em seguida, especifique o número de dias que decorrerão após o objeto ser modificado ou acessado.
Especifique que o objeto deverá ser movido para a camada de arquivamento após o término do intervalo.
Se você optar por limitar os blobs afetados pela regra com filtros, poderá especificar um filtro, seja com um prefixo de blob ou uma combinação de índice de blob.

Etapa 3: verifique se a regra exclui blobs reidratados

Se você reidratar um blob alterando a camada, esta regra moverá o blob de volta para a camada de arquivamento se a hora da última modificação, a hora de criação ou a hora do último acesso ultrapassar o limite definido pela política.

Se você tiver selecionado a condição de regra Modificados por último, poderá impedir que isso aconteça selecionando Ignorar blobs que foram reidratados nos últimos e, em seguida, inserindo o número de dias com que você deseja que um blob reidratado seja excluído dessa regra.

Captura de tela mostrando os blobs ignorados que foram reidratados na última configuração.

Note

Essa opção aparece apenas se você selecionou a condição da regra Última modificada .

Selecione o botão Adicionar para adicionar a regra à política.

Ver a política JSON

Após criar a política de gerenciamento do ciclo de vida, você pode visualizar o JSON da política na página de gerenciamento do ciclo de vida, mudando da visualização de Lista para a visualização de Código.

Aqui está o JSON para a política simples de gerenciamento do ciclo de vida criada nas imagens mostradas acima:

{
  "rules": [
    {
      "enabled": true,
      "name": "sample-archive-rule",
      "type": "Lifecycle",
      "definition": {
        "actions": {
          "baseBlob": {
            "tierToArchive": {
              "daysAfterLastAccessTimeGreaterThan": 90,
              "daysAfterLastTierChangeGreaterThan": 7
            }
          }
        },
        "filters": {
          "blobTypes": [
            "blockBlob"
          ]
        }
      }
    }
  ]
}

Consulte também

Comentários

Esta página foi útil?

Last updated on 2026-07-14

Arquivar um blob

Arquivar blobs em upload

Arquivar um blob existente

Arquive um blob existente mudando seu nível

Arquivar um blob existente com uma operação de cópia

Arquivo em massa

Use políticas de gerenciamento do ciclo de vida para arquivar blobs

Passo 1: Crie a regra e especifique o tipo de blob

Passo 2: Adicionar condições de regra

Etapa 3: verifique se a regra exclui blobs reidratados

Ver a política JSON

Consulte também

Comentários

Recursos adicionais