Definir a camada de acesso de um blob

Você pode definir a camada de acesso de um blob de qualquer uma das seguintes maneiras:

Ao definir a configuração padrão do nível de acesso da conta para a conta de armazenamento. Os blobs na conta herdam essa camada de acesso, a menos que você substitua explicitamente a configuração de um blob individual.
Ao definir explicitamente a camada de um blob durante o upload. Você pode criar um blob na camada quente, morna, fria ou de arquivo.
Ao alterar a camada de um blob existente através de uma operação de definição de camada do blob. Normalmente, você usaria essa operação para passar de uma camada mais quente para uma mais fria.
Copiando um blob com uma operação Copy Blob. Normalmente, você usaria essa operação para passar de uma camada mais fria para uma mais quente.

Este artigo descreve como gerenciar um blob em uma camada de acesso online. Para obter mais informações sobre como mover um blob para a camada de arquivamento, consulte Arquivar um blob. Para obter mais informações sobre como reidratar um blob da camada de arquivamento, consulte Reidratar um blob arquivado para uma camada online.

Para obter mais informações sobre camadas de acesso para blobs, consulte Camadas de acesso para dados de blobs.

Definir a camada de acesso padrão para uma conta de armazenamento

A configuração de camada de acesso padrão para uma conta de armazenamento v2 de uso geral determina em qual camada online um novo blob é criado por padrão. Você pode definir a camada de acesso padrão para uma conta de armazenamento v2 de uso geral no momento em que criar a conta ou atualizando a configuração de uma conta existente.

Quando você altera a configuração da camada de acesso padrão para uma conta de armazenamento v2 de uso geral existente, a alteração se aplica a todos os blobs na conta para os quais uma camada de acesso não foi definida explicitamente. Alterar a camada de acesso padrão pode ter um impacto na cobrança. Para obter mais detalhes, consulte Definição de nível de acesso à conta padrão.

Para contas de armazenamento que utilizam a versão prévia pública do smart tier, mover objetos para o smart tier só é possível através da configuração padrão do nível de acesso à conta. Os objetos no nível inteligente podem ser movidos individualmente para diferentes níveis ao definir explicitamente um nível diferente para um objeto. Uma vez movidos para um nível explícito, os objetos não podem ser redirecionados para o nível inteligente. Para mais informações, consulte Otimização de custos com a camada inteligente.

Para definir a camada de acesso padrão para uma conta de armazenamento em tempo de criação no portal do Azure, siga estas etapas:

Navegue até a página Contas de armazenamento e selecione o botão Criar .
Preencha a guia Noções básicas .
Na guia Avançado, em Armazenamento de Blob, defina a Camada de Acesso como Quente, Frio ou Arquivado. A configuração padrão é Hot.
Selecione Rever + Criar para validar as definições e criar a sua conta de armazenamento.

Para atualizar a camada de acesso padrão para uma conta de armazenamento existente no portal do Azure, siga estas etapas:

Navegue até a conta de armazenamento no portal do Azure.
Em Definições, selecione Configuração.
Localize a configuração da camada de acesso de Blob (padrão) e selecione Quente, Frio ou Frio. A configuração padrão é Hot, se você não tiver definido anteriormente essa propriedade.
Guardar as suas alterações.

Para alterar a configuração da camada de acesso padrão para uma conta de armazenamento com o PowerShell, chame o comando Set-AzStorageAccount , especificando a nova camada de acesso padrão.

$rgName = <resource-group>
$accountName = <storage-account>

# Change the storage account tier to cool
Set-AzStorageAccount -ResourceGroupName $rgName -Name $accountName -AccessTier Cool

Para alterar a configuração da camada de acesso padrão para uma conta de armazenamento com o PowerShell, chame o comando Set-AzStorageAccount , especificando a nova camada de acesso padrão.

# Change the storage account tier to cool
az storage account update \
    --resource-group <resource-group> \
    --name <storage-account> \
    --access-tier Cool

Definir a camada de um blob ao carregar

Ao carregar um blob no Armazenamento do Azure, você tem duas opções para definir a camada do blob no carregamento:

Você pode especificar explicitamente a camada na qual o blob será criado. Essa configuração substitui a camada de acesso padrão para a conta de armazenamento. Você pode definir a camada de um blob ou conjunto de blobs ao carregar para quente, frio, frio extremo ou arquivo.
Você pode carregar um blob sem especificar uma camada. Nesse caso, o blob será criado na camada de acesso padrão especificada para a conta de armazenamento (quente ou fria).

Se você estiver carregando um novo blob que usa um escopo de criptografia, não poderá alterar a camada de acesso para esse blob.

As seções a seguir descrevem como especificar que um blob seja carregado para a camada quente ou fria. Para obter mais informações sobre como arquivar um blob no upload, consulte Arquivar blobs no upload.

Carregar um blob para uma camada online específica

Para criar um blob na camada quente, morna ou fria, especifique essa camada ao criar o blob. A camada de acesso especificada no upload substitui a camada de acesso padrão para a conta de armazenamento.

Para carregar um blob ou conjunto de blobs para uma camada específica do portal do Azure, siga estas etapas:

Navegue até o contêiner de destino.
Selecione o botão Carregar.
Selecione o(s) ficheiro(s) a carregar.
Expanda a seção Avançada e defina a camada de Acesso como Hot ou Cool.
Selecione o botão Carregar.

Para carregar um blob ou conjunto de blobs para uma camada específica com o PowerShell, chame o comando Set-AzStorageBlobContent , conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores de espaço reservado entre colchetes pelos seus próprios valores:

$rgName = <resource-group>
$storageAccount = <storage-account>
$containerName = <container>
# tier can be hot, cool, cold, or archive
$tier = <tier>

# 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 cool tier.
Set-AzStorageBlobContent -Container $containerName `
    -File "blob1.txt" `
    -Blob "blob1.txt" `
    -Context $ctx `
    -StandardBlobTier Cool

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

Para carregar um blob para uma camada específica com a CLI do Azure, chame o comando az storage blob upload , conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores de espaço reservado entre colchetes pelos seus próprios valores. Substitua o espaço reservado <tier> por hot, cool, coldou archive.

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

Para carregar um conjunto de blobs em uma camada específica com a CLI do Azure, chame o comando az storage blob upload-batch , conforme mostrado no exemplo a seguir. Lembre-se de substituir os valores de espaço reservado entre colchetes pelos seus próprios valores. Substitua o espaço reservado <tier> por hot, cool, coldou archive.

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

Para carregar um blob para uma camada específica usando AzCopy, use o comando azcopy copy e defina o --block-blob-tier parâmetro como hot, coolou archive.

Nota

Este exemplo encapsula 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 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 Introdução ao AzCopy para saber mais sobre as maneiras de fornecer credenciais de autorização para o serviço de armazenamento.

azcopy copy '<local-file-path>' 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier <blob-tier>

Para carregar um conjunto de blobs para uma camada específica usando AzCopy, consulte o diretório local ou o conteúdo do diretório local e acrescente --recursive=true ao comando.

Exemplo de diretório local

azcopy copy '<local-directory-path>' 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier <blob-tier> --recursive=true

Exemplo de conteúdo do diretório local

azcopy copy '<local-directory-path>\*' 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier <blob-tier> --recursive=true

Carregar um blob para a camada padrão

As contas de armazenamento têm uma configuração de camada de acesso padrão que indica em qual camada online um novo blob é criado. A configuração da camada de acesso padrão pode ser definida como quente ou fria. O comportamento dessa configuração é ligeiramente diferente, dependendo do tipo de conta de armazenamento:

A camada de acesso padrão para uma nova conta de armazenamento v2 de uso geral é definida como a camada ativa por padrão. Você pode alterar a configuração da camada de acesso padrão ao criar uma conta de armazenamento ou depois que ela for criada.
Ao criar uma conta de Armazenamento Blob legada, deve-se especificar a configuração do nível de acesso padrão como frequente ou esporádico. Você pode alterar a configuração da camada de acesso padrão para a conta de armazenamento depois que ela for criada.

Um blob que não tenha um nível atribuído explicitamente inferirá o seu nível a partir da configuração padrão do nível de acesso da conta. Você pode determinar se a camada de acesso de um blob é inferida usando o portal do Azure, o PowerShell ou a CLI do Azure.

Se a camada de acesso de um blob for inferida a partir da configuração padrão da camada de acesso à conta, o portal do Azure exibirá a camada de acesso como Hot (inferred), Cool (inferred) ou Cold (inferred).

Captura de ecrã a mostrar blobs com a camada de acesso predefinida no portal do Azure.

Para determinar a camada de acesso de um blob e se ele é inferido do Azure PowerShell, recupere o blob e verifique suas propriedades AccessTier e AccessTierInferred .

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

# Get the storage account context.
$ctx = New-AzStorageContext -StorageAccountName $storageAccount -UseConnectedAccount

# Get the blob from the service.
$blob = Get-AzStorageBlob -Context $ctx -Container $containerName -Blob $blobName

# Check the AccessTier and AccessTierInferred properties.
# If the access tier is inferred, that property returns true.
$blob.BlobProperties.AccessTier
$blob.BlobProperties.AccessTierInferred

Para determinar a camada de acesso de um blob e se ele é inferido da CLI do Azure, recupere o blob e verifique suas propriedades blobTier e blobTierInferred .

az storage blob show \
    --container-name <container> \
    --name <blob> \
    --account-name <storage-account> \
    --query '[properties.blobTier, properties.blobTierInferred]' \
    --output tsv \
    --auth-mode login

Mover um blob para um nível online diferente

Você pode mover um blob para uma camada online diferente de duas maneiras:

Alterando a camada de acesso.
Copiando o blob para uma camada online diferente.

Para obter mais informações sobre cada uma dessas opções, consulte Definindo ou alterando a camada de um blob.

Utilize PowerShell, CLI do Azure, AzCopy v10 ou uma das bibliotecas de cliente do Azure Storage para mover um blob para um escalão diferente.

Alterar a camada de um blob

Ao alterar a camada de um blob, você move esse blob e todos os seus dados para a camada de destino chamando a operação set Blob Tier (diretamente ou por meio de uma política de gerenciamento de ciclo de vida) ou usando o comando azcopy set-properties com AzCopy. Essa opção geralmente é a melhor quando você está alterando a camada de um blob de uma camada mais quente para uma mais fria.

Gorjeta

Você pode usar uma tarefa de armazenamento para alterar a camada de acesso dos blobs em grande escala em várias contas de armazenamento, com base num conjunto de condições que definir. Uma tarefa de armazenamento é um recurso disponível nas Ações de Armazenamento do Azure, uma estrutura sem servidor que você pode usar para executar operações de dados comuns em milhões de objetos em várias contas de armazenamento. Para saber mais, consulte O que são as Ações de Armazenamento do Azure?.

Para alterar a camada de um blob para uma camada mais fria no portal do Azure, siga estas etapas:

Navegue até o blob para o qual pretende alterar a classificação.
Selecione o blob e, em seguida, selecione o botão Alterar camada .
Na caixa de diálogo Alterar camada, selecione a camada de destino.
Selecione o botão Save.

Para alterar a camada de um blob para uma camada mais fria com o PowerShell, use a propriedade BlobClient do blob para retornar uma referência .NET ao blob e, em seguida, 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>"
$tier = "<tier>"

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

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

Para alterar a camada de um blob para uma camada mais fria com a CLI do Azure, chame 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 <tier> \
    --auth-mode login

Para alterar a camada de um blob para uma camada mais fria, use o comando azcopy set-properties e defina o -block-blob-tier parâmetro.

Importante

O uso do AzCopy para alterar a camada de acesso de um blob está atualmente em PRÉ-VISUALIZAÇÃO. Veja os Termos Complementares de Utilização das Pré-visualizações do Microsoft Azure para consultar os termos legais aplicáveis às funcionalidades do Azure que se encontram em versão beta, em pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Nota

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

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=<tier> --recursive=true

Copiar um blob para uma camada online diferente

Chame a operação Copiar Blob para copiar um blob de uma camada para outra. Quando você copia um blob para uma camada diferente, move esse blob e todos os seus dados para a camada de destino. O blob de origem permanece na camada original e um novo blob é criado na camada de destino. Chamar Copy Blob é recomendado para a maioria dos cenários em que se está movendo um blob para uma camada mais quente ou reidratando um blob da camada de arquivo.

N/A

Para copiar um blob de cool para hot com o PowerShell, chame o comando Start-AzStorageBlobCopy e especifique a camada de destino. 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 hot tier.
Start-AzStorageBlobCopy -SrcContainer $srcContainerName `
    -SrcBlob $srcBlobName `
    -DestContainer $destContainerName `
    -DestBlob $destBlobName `
    -StandardBlobTier Hot `
    -Context $ctx

Para copiar um blob para uma camada mais quente com a CLI do Azure, chame o comando az storage blob copy start e especifique a camada de destino. 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 hot \
    --auth-mode login

Para copiar um blob de cool para hot com AzCopy, use o comando azcopy copy e defina o parâmetro --block-blob-tier para hot.

Nota

Este exemplo encapsula 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 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 Introdução ao AzCopy para saber mais sobre as maneiras de fornecer credenciais de autorização para o serviço de armazenamento.

O AzCopy não suporta copiar de um bloco de origem na camada de arquivamento.

azcopy copy 'https://mystorageeaccount.blob.core.windows.net/mysourcecontainer/myTextFile.txt' 'https://mystorageaccount.blob.core.windows.net/mydestinationcontainer/myTextFile.txt' --block-blob-tier=hot

A operação de cópia é síncrona, portanto, quando o comando retorna, todos os arquivos são copiados.

Hierarquização em massa

Para mover blobs para outra camada em um contêiner ou pasta, enumere blobs e chame a operação Definir Camada de Blob em cada um deles. O exemplo a seguir 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("Cold", $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 Cold --name "{}"

Ao mover um grande número de blobs para outra camada, use uma operação em lote para obter o desempenho ideal. 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 alterar a camada de acesso dos blobs através de uma operação em lote, utilize 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.

Próximos passos

Comentários

Esta página foi útil?

Last updated on 2025-11-19

Partilhar via

Definir a camada de acesso de um blob

Definir a camada de acesso padrão para uma conta de armazenamento

Definir a camada de um blob ao carregar

Carregar um blob para uma camada online específica

Carregar um blob para a camada padrão

Mover um blob para um nível online diferente

Alterar a camada de um blob

Copiar um blob para uma camada online diferente

Hierarquização em massa

Próximos passos

Comentários

Recursos adicionais