Reemplazo de las propiedades y los metadatos de blob mediante AzCopy v10
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.
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:
- Ejemplos: Carga
- Ejemplos: descarga
- Ejemplos: Copia entre cuentas
- Ejemplos: Sincronización
- Ejemplos: Cubos de Amazon S3
- Ejemplos: Google Cloud Storage
- Ejemplos: Azure Files
- Tutorial: Migración de datos locales al almacenamiento en la nube mediante AzCopy
Consulte estos artículos para configurar opciones, optimizar el rendimiento y solucionar problemas: