Partilhar via


Substituir propriedades de blob e metadados usando AzCopy v10

Você pode usar o AzCopy para alterar a camada de acesso de um ou mais blobs e substituir (substituir) os metadados e as tags de índice de um ou mais blobs.

Começar agora

Consulte o artigo Introdução ao AzCopy para baixar o AzCopy e saber mais sobre as maneiras de fornecer credenciais de autorização para o serviço de armazenamento.

Nota

Os exemplos neste artigo pressupõem que você forneceu credenciais de autorização usando o Microsoft Entra ID.

Se preferir usar um token SAS para autorizar o acesso aos dados de blob, você pode acrescentar esse token à URL do recurso em cada comando AzCopy. Por exemplo: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Alterar a camada de acesso

Para alterar a camada de acesso de um blob, use o comando azcopy set-properties e defina o -block-blob-tier parâmetro como o nome da camada de acesso.

Gorjeta

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 do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

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

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot

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.

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true

Para reidratar um blob da camada de arquivo para uma camada online, defina como --rehydrate-priority standard ou high. Por padrão, esse parâmetro é definido como standard. Para saber mais sobre as compensações de cada opção, consulte Prioridade de reidratação.

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high

Substituir metadados

Para substituir os metadados de um blob, use o comando azcopy set-properties e defina o --metadata parâmetro como um ou mais pares chave-valor.

Gorjeta

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 do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2

Para substituir os metadados de 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.

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true

Para limpar metadados, omita as tags e anexe --metadata=clear ao final do comando.

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear

Substituir tags de índice

Para substituir as tags de índice de um blob, use o comando azcopy set-properties e defina o --blob-tags parâmetro como um ou mais pares chave-valor. A configuração de tags de índice de blob pode ser executada pelo Proprietário de Dados do Blob de Armazenamento e por qualquer pessoa com uma Assinatura de Acesso Compartilhado que tenha permissão para acessar as tags do blob (a t permissão SAS). Além disso, os usuários do RBAC com a Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write permissão podem executar essa operação.

Gorjeta

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 do Windows (cmd.exe), coloque argumentos de caminho com aspas duplas ("") em vez de aspas simples ('').

Sintaxe

azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

Para substituir as marcas de índice para todos os blobs em um diretório virtual, consulte o nome do diretório virtual em vez do nome do blob e, em seguida, acrescente --recursive=true ao comando.

Exemplo

azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value

Próximos passos

Encontre mais exemplos nestes artigos:

Consulte estes artigos para definir configurações, otimizar o desempenho e solucionar problemas: