Arquivar um blob

A camada de arquivo é uma camada offline para armazenar dados de blobs que raramente são acedidos. O nível de arquivo oferece os custos de armazenamento mais baixos, mas custos de recuperação de dados e latência mais elevados em comparação com os níveis online (quente e frio). Os dados devem permanecer na camada de armazenamento de arquivo durante, pelo menos, 180 dias ou estar sujeitos a uma taxa de eliminação antecipada. Para mais informações sobre o nível de arquivo, veja Nível de acesso ao Arquivo.

Enquanto um blob estiver na camada de arquivamento, ele não pode ser lido ou modificado. Para ler ou descarregar um blob no tier de arquivo, deves primeiro reidratá-lo para um tier online, seja quente ou frio. Os dados na camada de arquivamento podem levar até 15 horas para serem reidratados, dependendo da prioridade especificada para a operação de reidratação. Para obter mais informações sobre a reidratação de blobs, consulte Visão geral da reidratação de blobs da camada de arquivamento.

Atenção

Um blob na camada de arquivo encontra-se offline. Ou seja, não pode ser lido ou modificado até ser reidratado. O processo de reidratação pode demorar várias horas e tem custos associados. Antes de mover dados para o escalão de arquivo, considere se colocar os dados de blobs offline pode afetar os seus fluxos de trabalho.

Pode usar o portal Azure, PowerShell, CLI do Azure ou uma das bibliotecas clientes do Armazenamento do Azure para gerir o arquivamento de dados.

Arquivar blobs ao carregar

Para arquivar um ou mais blobs ao carregar, crie o blob diretamente na camada de arquivo.

Portal
PowerShell
CLI do Azure
AzCopy

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(s) ficheiro(s) a carregar.
Expanda a secção Avançada e defina o nível de Acesso para Arquivo.
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 seguinte. Lembre-se de substituir os valores preenchidos entre colchetes pelos seus próprios 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 no upload com o CLI do Azure, chame o comando az storage blob upload, como mostrado no exemplo seguinte. Lembre-se de substituir os valores preenchidos entre colchetes pelos seus próprios 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 seguinte. Lembre-se de substituir os valores preenchidos entre colchetes pelos seus próprios 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, chama o comando azcopy copy. Fornecer um ficheiro local como fonte e o URI do blob de destino como destino, e especificar a camada de arquivo como a camada de destino, como mostrado no exemplo seguinte. Lembre-se de substituir os valores preenchidos entre colchetes pelos seus próprios valores:

Note

Este exemplo coloca os argumentos de caminho entre 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 do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').
Este exemplo exclui o token SAS porque pressupõe que você forneceu credenciais de autorização usando o ID do Microsoft Entra. Consulte o artigo Comece com AzCopy para saber como pode 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 Carregar ficheiros para armazenamento Azure Blob usando AzCopy.

Arquivar um blob existente

Podes mover um blob existente para a camada de arquivo de duas formas:

Podes mudar o nível de um blob com a operação Set Blob Tier . Set Blob Tier move um único blob de um nível para outro.

Tem em atenção que, quando moves um blob para a camada de arquivo com Set Blob Tier, não podes ler nem modificar os dados do blob até reidratares o blob. Se for necessário ler ou modificar os dados do blob antes do intervalo de eliminação inicial ter terminado, considere usar uma operação Copy Blob para criar uma cópia do blob no nível de arquivo.
Pode copiar um blob de um escalão online para o escalão de arquivo com a operação Copy Blob. Pode invocar a operação Copy Blob para copiar um blob de uma camada online (quente ou fria) para a camada de arquivo. O blob de origem permanece no nível online, e pode continuar a ler ou modificar os seus dados no nível online.

Arquiva um blob existente alterando o seu nível

Usa a operação Set Blob Tier para mover um blob do tier Quente ou Frio para o tier de arquivo. A operação Set Blob Tier é ideal para cenários onde não precisará de aceder aos dados arquivados antes do intervalo de eliminação antecipada ter terminado.

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 ótimo, a Microsoft recomenda realizar uma operação de arquivo em massa. A operação de arquivamento em massa envia um lote de chamadas Set Blob Tier para o serviço numa única transação. Para mais informações, consulte o arquivo Bulk.

Portal
PowerShell
CLI do Azure
AzCopy

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

Navegue até ao contentor do blob.
Seleciona o blob para arquivar.
Seleciona o botão Mudar nível .
Selecione Arquivo no menu suspenso do nível de acesso.
Selecione Guardar.

Para alterar o nível de um blob de hot ou cool para Archive com PowerShell, use a propriedade BlobClient do blob para devolver uma referência .NET ao blob, depois chame o método SetAccessTier nessa referência. Lembre-se de substituir os espaços reservados entre parêntesis angulares pelos seus 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 o tier de um blob de hot ou cool para Archive com a CLI do Azure, utilize o comando az storage blob set-tier. Lembre-se de substituir os espaços reservados entre parêntesis angulares pelos seus valores:

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

Para mudar o nível de um blob de hot ou cool para Archive, use o comando azcopy set-properties e defina o -block-blob-tier parâmetro para archive.

Importante

A capacidade de alterar o escalão de um blob com o AzCopy está atualmente em pré-visualização. Consulte os Termos de Utilização Complementares das Visualizações Prévias do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão em beta, em pré-visualização ou que ainda não foram lançadas para 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

Utilize a operação Copy Blob para copiar um blob da camada quente ou fria para a camada de arquivo. O blob de origem mantém-se no tier hot ou cool, enquanto o blob de destino é criado no tier de arquivo.

Uma operação Copiar Blob é mais adequada para cenários em que possa ser necessário ler ou modificar os dados arquivados antes de decorrido o período de eliminação antecipada. Podes aceder aos dados do blob de origem sem precisar de reidratar o blob arquivado.

Portal
PowerShell
CLI do Azure
AzCopy

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 parêntesis angulares pelos seus 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 arquivo com a CLI do Azure, execute o comando az storage blob copy start e especifique a camada de arquivo. Lembre-se de substituir os espaços reservados entre parêntesis angulares pelos seus 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 já existir.

Note

Lembre-se de substituir os espaços reservados entre parêntesis angulares pelos seus 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 num contentor ou pasta, enumere blobs e chame a operação Set Blob Tier em cada um. O exemplo a seguir mostra como executar essa operação:

Portal
PowerShell
CLI do Azure
AzCopy

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 a camada de arquivo, use uma operação em lote para um desempenho ótimo. Uma operação em lote envia várias chamadas de API para o serviço com uma única solicitação. As suboperações suportadas pela operação Lote de Blob 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 em lote básica com a biblioteca de cliente .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 obter um aplicativo de exemplo detalhado que mostra como alterar camadas com uma operação em lote, consulte AzBulkSetBlobTier.

Use políticas de gestão do ciclo de vida para arquivar blobs

Pode otimizar custos para dados de blobs que raramente são acedidos criando políticas de gestão do ciclo de vida que movem automaticamente os blobs para a camada de arquivo quando não foram acedidos ou modificados durante um período de tempo especificado. Depois de configurar uma política de gestão do ciclo de vida, o Armazenamento do Azure executa-a uma vez por dia. Para mais informações sobre políticas de gestão do ciclo de vida, consulte Otimizar custos gerindo automaticamente o ciclo de vida dos dados.

Pode usar o portal Azure, PowerShell, CLI do Azure ou um modelo do Azure Resource Manager para criar uma política de gestão do ciclo de vida. Para simplificar, esta secção mostra como criar uma política de gestão do ciclo de vida apenas no portal Azure. Para mais exemplos que mostrem como criar políticas de gestão do ciclo de vida, consulte Configurar uma política de gestão do ciclo de vida.

Atenção

Antes de usar uma política de gestão do ciclo de vida para mover dados para a camada de arquivo, verifique se esses dados não precisam de ser eliminados ou movidos para outro nível durante pelo menos 180 dias. Os dados que são eliminados ou transferidos para outro nível antes do período de 180 dias terem decorrido estão sujeitos a uma taxa de eliminação antecipada.

Também tenha em mente que os dados na camada de arquivo têm de ser reidratados antes de poderem ser lidos ou modificados. Reidratar um blob da camada de arquivo pode demorar várias horas e acarreta custos.

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

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

Navegue até sua conta de armazenamento no portal.
Em gestão de dados, localize as definições de gestão do ciclo de vida .
Selecione o botão Adicionar uma regra .
No separador Detalhes , especifique um nome para a sua regra.
Especifique o âmbito 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 se deve aplicar e especifique se deve incluir instantâneos ou versões dos blobs.

Passo 2: Adicionar condições de regra

Dependendo das tuas escolhas, podes configurar regras para blobs base (versões atuais), versões anteriores ou snapshots de blobs. Especifique uma de duas condições a verificar:
- Os objetos foram modificados pela última vez há alguns dias.
- Os objetos foram criados há alguns dias.
- Os objetos foram acedidos pela última vez há alguns dias.
Apenas uma destas condições pode ser aplicada para mover um determinado tipo de objeto para o nível de arquivo por regra. Por exemplo, se defines uma ação que arquiva blobs base se não foram modificados durante 90 dias, então não podes também definir uma ação que arquive blobs base se não foram acedidos durante 90 dias. De forma semelhante, pode definir uma ação por regra com qualquer uma destas condições para arquivar versões anteriores, e uma para arquivar instantâneos.
De seguida, especifique o número de dias a decorrer após o objeto ser modificado ou acedido.
Especifique que o objeto deve ser movido para o nível de arquivo após o intervalo ter passado.
Se optar por limitar os blobs afetados pela regra através de filtros, pode especificar um filtro, quer com um prefixo de blob, quer com uma correspondência no índice de blobs.

Passo 3: Certifique-se de que a regra exclui blobs rehidratados

Se reidratar um blob ao alterar o respetivo tier, esta regra moverá o blob de volta para o tier de arquivo se a hora da última modificação, a hora de criação ou a hora do último acesso forem anteriores ao limite definido na política.

Se selecionaste a condição da regra Última modificada , podes evitar que isto aconteça selecionando Saltar blobs que foram reidratados no último período, e depois introduzindo o número de dias em que queres que um blob reidratado seja excluído dessa regra.

Captura de ecrã a mostrar os blocos de salto que foram reidratados na última definição.

Note

Esta opção só aparece se selecionares a condição da regra Última modificação .

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

Ver a política JSON

Depois de criar a política de gestão do ciclo de vida, pode ver o JSON da política na página Lifecycle management, ao mudar de Vista de lista para Vista de código.

Aqui está o JSON para a política simples de gestão 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 ao carregar

Arquivar um blob existente

Arquiva um blob existente alterando o seu nível

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

Arquivo em massa

Use políticas de gestão 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

Passo 3: Certifique-se de que a regra exclui blobs rehidratados

Ver a política JSON

Consulte também

Comentários

Recursos adicionais