Reemplazar las propiedades y los metadatos de blob mediante AzCopy v10 (versión preliminar)

  • Artículo

Puede usar AzCopy para cambiar el nivel de acceso de uno o varios blobs y reemplazar (sobrescribir) los metadatos y las etiquetas de índice de uno o varios blobs.

Importante

Esta funcionalidad actualmente se encuentra en VERSIÓN PRELIMINAR. Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

Introducción

Vea el artículo Introducción a AzCopy para descargar AzCopy y obtener información sobre las formas de proporcionar credenciales de autorización para el servicio de almacenamiento.

Nota:

En los ejemplos de este artículo se da por hecho que ha proporcionado credenciales de autorización mediante Microsoft Entra ID.

Si prefiere usar un token de SAS para autorizar el acceso a los datos de blob, puede anexar ese token a la dirección URL de recursos en cada comando AzCopy. Por ejemplo: 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>'.

Cambiar el nivel de acceso

Para cambiar el nivel de acceso de un blob, use el comando azcopy set-properties y establezca el parámetro -block-blob-tier en el nombre del nivel de acceso.

Sugerencia

En este ejemplo los argumentos de ruta de acceso se encierran entre comillas simples ('). Use comillas simples en todos los shells de comandos excepto en el shell de comandos de Windows (cmd.exe). Si usa un shell de comandos de Windows (cmd.exe), incluya los argumentos de la ruta de acceso entre comillas dobles ("") en lugar de comillas simples ('').

Sintaxis

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

Ejemplo

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

Para cambiar el nivel de acceso de todos los blobs de un directorio virtual, consulte el nombre del directorio virtual en lugar del nombre del blob y, a continuación, anexe --recursive=true al comando.

Ejemplo

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

Para rehidratar un blob del nivel de archivo a un nivel en línea, establezca --rehydrate-priority en standard o high. De manera predeterminada, este parámetro está establecido en standard. Para más información sobre las ventajas de cada opción, consulte Prioridad de rehidratación.

Ejemplo

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

Reemplazar metadatos

Para reemplazar los metadatos de un blob, use el comando azcopy set-properties y establezca el parámetro --metadata en uno o varios pares clave-valor.

Sugerencia

En este ejemplo los argumentos de ruta de acceso se encierran entre comillas simples ('). Use comillas simples en todos los shells de comandos excepto en el shell de comandos de Windows (cmd.exe). Si usa un shell de comandos de Windows (cmd.exe), incluya los argumentos de la ruta de acceso entre comillas dobles ("") en lugar de comillas simples ('').

Sintaxis

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

Ejemplo

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

Para reemplazar los metadatos de todos los blobs de un directorio virtual, consulte el nombre del directorio virtual en lugar del nombre del blob y, a continuación, anexe --recursive=true al comando.

Ejemplo

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

Para borrar los metadatos, omita las etiquetas y anexe --metadata=clear al final del comando.

Ejemplo

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

Reemplazar etiquetas de índice

Para reemplazar las etiquetas de índice de un blob, use el comando azcopy set-properties y establezca el parámetro --blob-tags en uno o varios pares clave-valor. El propietario de datos de blobs de almacenamiento, así como cualquier persona con una firma de acceso compartido que tenga permiso para acceder a las etiquetas de blobs (el permiso t de SAS), puede establecer las etiquetas de índice de blobs. Además, los usuarios de RBAC con el permiso Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write pueden realizar esta operación.

Sugerencia

En este ejemplo los argumentos de ruta de acceso se encierran entre comillas simples ('). Use comillas simples en todos los shells de comandos excepto en el shell de comandos de Windows (cmd.exe). Si usa un shell de comandos de Windows (cmd.exe), incluya los argumentos de la ruta de acceso entre comillas dobles ("") en lugar de comillas simples ('').

Sintaxis

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

Ejemplo

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

Para reemplazar las etiquetas de índice de todos los blobs de un directorio virtual, consulte el nombre del directorio virtual en lugar del nombre del blob y, a continuación, anexe --recursive=true al comando.

Ejemplo

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

Pasos siguientes

Encuentre más ejemplos en estos artículos:

Consulte estos artículos para configurar opciones, optimizar el rendimiento y solucionar problemas: