azcopy copy
Copia los datos de origen en una ubicación de destino.
Nota:
AzCopy no admite escenarios en los que el origen o el destino se están cambiando activamente durante la transferencia.
Sinopsis
Copia los datos de origen en una ubicación de destino. Estas son las direcciones que se admiten:
- local <-> Azure Blob (autenticación con SAS u OAuth)
- local <:> Azure Files (autenticación de SAS de recurso compartido/directorio o autenticación de OAuth)
- local <:> Azure Data Lake Storage (autenticación SAS, OAuth o SharedKey)
- Azure Blob (SAS o público) -> Azure Blob (autenticación con SAS u OAuth)
- Azure Data Lake Storage (SAS o público):> Azure Data Lake Storage (autenticación SAS o OAuth)
- Azure Blob (SAS o autenticación OAuth)<:> Azure Blob (SAS o autenticación OAuth): Consulte las directrices.
- Azure Data Lake Storage (autenticación SAS o OAuth): <> Azure Data Lake Storage (autenticación SAS o OAuth)
- Azure Data Lake Storage (autenticación SAS o OAuth): <> blob de Azure (autenticación SAS o OAuth)
- Azure Blob (SAS o público) -> Azure Files (SAS)
- Azure File (autenticación SAS o OAuth): <> Azure File (autenticación SAS o OAuth)
- Azure Files (SAS) -> Azure Blob (autenticación con SAS u OAuth)
- AWS S3 (clave de acceso) - >Azure Blob en bloques (autenticación con SAS u OAuth)
- Google Cloud Storage (Clave de cuenta de servicio) - > Azure Blob en bloques (autenticación SAS o OAuth)
Consulte los ejemplos para más información.
Avanzado
AzCopy detecta automáticamente el tipo de contenido de los archivos cuando se cargan desde el disco local, basándose en la extensión del archivo o en el contenido (si no se especifica ninguna extensión).
La tabla de búsqueda integrada es pequeña pero, en Unix, los archivos mime.types del sistema local la pueden aumentar si están disponibles en una o varias de estas ubicaciones:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
En Windows, los tipos MIME se extraen del registro. Esta característica se puede desactivar con la ayuda de una marca. Consulte la sección sobre marcas.
Si establece una variable de entorno mediante la línea de comandos, esa variable se puede leer en el historial de línea de comandos. Considere la posibilidad de borrar las variables que contengan credenciales del historial de la línea de comandos. Para evitar que aparezcan variables en el historial, puede usar un script para pedir al usuario sus credenciales y establecer la variable de entorno.
azcopy copy [source] [destination] [flags]
Artículos conceptuales relacionados
- Introducción a AzCopy
- Transferencia de datos con AzCopy y Blob Storage
- Transferencia de datos con AzCopy y File Storage
Ejemplos
Carga de un solo archivo mediante la autenticación de OAuth. Si aún no ha iniciado sesión en AzCopy, use el comando de inicio de sesión de azcopy antes de ejecutar el comando siguiente.
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"
Igual que antes, pero en esta ocasión también procesa el hash MD5 del contenido del archivo y lo guarda como la propiedad Content-MD5 del blob:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5
Carga de un solo archivo mediante un token de SAS:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Carga de un solo archivo mediante un token de SAS y una canalización (solo blobs en bloques):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Carga de un solo archivo mediante OAuth y una canalización (solo blobs en bloques):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Carga de un directorio completo mediante un token de SAS:
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
or
azcopy cp "/path/to/dir" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --put-md5
Carga de un conjunto de archivos mediante un token de SAS y caracteres comodín (*):
azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"
Carga de archivos y directorios mediante un token de SAS y caracteres comodín (*):
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Cargue archivos y directorios en la cuenta de Azure Storage y establezca las etiquetas codificadas en la cadena de consulta del blob.
- Para establecer las etiquetas {key = "bla bla", val = "foo"} y {key = "bla bla 2", val = "bar"}, use la sintaxis siguiente:
azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"- Las claves y los valores están codificados como dirección URL y los pares clave-valor se separan con una y comercial ("&")
- Al establecer etiquetas en los blobs, hay más permisos (no para etiquetas) en SAS sin los que el servicio devuelve el error de autorización.
Descarga de un solo archivo mediante la autenticación de OAuth. Si aún no ha iniciado sesión en AzCopy, use el comando de inicio de sesión de azcopy antes de ejecutar el comando siguiente.
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"
Descarga de un solo archivo mediante un token de SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Descarga de un solo archivo mediante un token de SAS y, luego, canalización de la salida a un archivo (solo blobs en bloques):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Descarga de un solo archivo mediante OAuth y, luego, canalización de la salida a un archivo (solo blobs en bloques):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Descarga de un directorio completo mediante un token de SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true
Una nota sobre el uso de un carácter comodín (*) en direcciones URL:
Hay solo dos formas admitidas de usar un carácter comodín en una dirección URL.
Puede usar uno justo después de la barra diagonal final (/) de una dirección URL. De esta manera, todos los archivos de un directorio se copian directamente en el destino sin colocarlos en un subdirectorio.
También puede usar uno en el nombre de un contenedor siempre y cuando la dirección URL solo haga referencia a un contenedor y no a un blob. Puede usar este enfoque para obtener archivos de un subconjunto de contenedores.
Descarga del contenido de un directorio sin copiar el propio directorio contenedor.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Descarga de una cuenta de almacenamiento completa.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Descarga de un subconjunto de contenedores en una cuenta de almacenamiento mediante un símbolo comodín (*) en el nombre del contenedor.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive
Descargue todas las versiones de un blob de Azure Storage que aparecen en un archivo de texto (por ejemplo: versionidsFile) en el directorio local. Asegúrese de que el origen es un blob válido, el destino es una carpeta local y versionidsFile es un archivo de texto donde cada versión se escribe en una línea independiente. Todas las versiones especificadas se descargan en la carpeta de destino especificada.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/another/path/to/dir/[versionidsFile]"
Copia de un blob único en otro blob mediante un token de SAS.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copia de un blob único en otro blob mediante un token de SAS y un token de OAuth.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"
Copia de un directorio virtual de blobs a otro mediante un token de SAS:
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Copia de todos los contenedores de blobs, directorios y blobs de la cuenta de almacenamiento a otra mediante un token de SAS:
azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copia de un solo objeto en Blob Storage de Amazon Web Services (AWS) S3 mediante una clave de acceso y un token de SAS. En primer lugar, establezca la variable de entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para el origen AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copia de un directorio completo en Blob Storage de AWS S3 mediante una clave de acceso y un token de SAS. En primer lugar, establezca la variable de entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para el origen AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Consulte https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html para comprender mejor el marcador de posición [folder].
Copia de todos los cubos en Blob Storage de Amazon Web Services (AWS) mediante el uso de una clave de acceso y un token de SAS. En primer lugar, establezca la variable de entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para el origen AWS S3.
azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copia de todos los cubos en Blob Storage desde una región de Amazon Web Services (AWS) mediante el uso de una clave de acceso y un token de SAS. En primer lugar, establezca la variable de entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para el origen AWS S3.
azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copia de un subconjunto de cubos mediante un símbolo comodín (*) en el nombre del cubo. Al igual que en los ejemplos anteriores, necesita una clave de acceso y un token de SAS. Asegúrese de establecer la variable de entorno AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY para el origen AWS S3.
azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true
Copie blobs de un almacenamiento de blobs en otro y conserve las etiquetas del origen. Para conservar las etiquetas, use la sintaxis siguiente:
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true
Transfiera archivos y directorios a la cuenta de Azure Storage y establezca las etiquetas codificadas de la cadena de consulta determinadas en el blob.
Para establecer las etiquetas {key = "bla bla", val = "foo"} y {key = "bla bla 2", val = "bar"}, use la sintaxis siguiente:
azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"Las claves y los valores están codificados como dirección URL y los pares clave-valor se separan con una y comercial ("&")
Al establecer etiquetas en los blobs, hay permisos adicionales ("t" para etiquetas) en SAS sin que el servicio devuelva un error de autorización.
Copie un solo objeto en Blob Storage desde Google Cloud Storage (GCS) mediante una clave de cuenta de servicio y un token de SAS. En primer lugar, establezca la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para el origen de GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copie un directorio completo en Blob Storage desde Google Cloud Storage (GCS) mediante una clave de cuenta de servicio y un token de SAS. En primer lugar, establezca la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para el origen de GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Copie un cubo completo en Blob Storage desde Google Cloud Storage (GCS) mediante una clave de cuenta de servicio y un token de SAS. En primer lugar, establezca la variable de entorno GOOGLE_APPLICATION_CREDENTIALS para el origen de GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Copie todos los cubos en Blob Storage desde Google Cloud Storage (GCS) mediante una clave de cuenta de servicio y un token de SAS. En primer lugar, establezca la variable de entorno GOOGLE_APPLICATION_CREDENTIALS y GOOGLE_CLOUD_PROJECT=<project-id> para el origen de GCS
azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Copie un subconjunto de cubos mediante un símbolo comodín (*) en el nombre del depósito de Google Cloud Storage (GCS), con una clave de cuenta de servicio y un token de SAS para el destino. En primer lugar, establezca las variables de entorno GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> para el origen de GCS
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Para copiar archivos modificados antes o después de que se haya iniciado el trabajo de AzCopy, AzCopy proporciona la fecha y hora en el registro del trabajo en ISO8601 formato (busque "HORA de inicio ISO 8601" en el registro de trabajos) que se puede usar con las --include-after marcas y --include-before , consulte los ejemplos siguientes. Esto resulta útil para las copias incrementales.
Copie un subconjunto de archivos modificados en o después de la fecha y hora especificadas (en formato ISO8601) en un contenedor mediante la include-after marca .
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"
Copie un subconjunto de archivos modificados en o antes de la fecha y hora especificadas (en formato ISO8601) en un contenedor mediante la include-before marca .
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"
Opciones
--as-subdir De forma predeterminada es True. Coloca los orígenes de carpetas como subdirectorios en el destino. (El valor predeterminado es true)
--backupActiva los privilegios SeBackupPrivilege de Windows para cargas, o SeRestorePrivilege para descargas, para que AzCopy pueda leer todos los archivos, independientemente de los permisos del sistema de archivos, y restaurar todos los permisos. Requiere que la cuenta que ejecuta AzCopy ya tenga estos permisos (por ejemplo, que tenga derechos de Administrador o que sea miembro del grupo «Operadores de copia de seguridad»). Esta marca activa los privilegios que ya tiene la cuenta
--blob-tags (string) Establece etiquetas en blobs para clasificar los datos de la cuenta de almacenamiento
--blob-type (string) Define el tipo de blob en el destino. Se usa para cargar blobs y al copiar entre cuentas (el valor predeterminado es "Detect"). Los valores válidos incluyen "Detect", "BlockBlob", "PageBlob" y "AppendBlob". Al copiar entre cuentas, un valor "Detect" hace que AzCopy use el tipo de blob de origen para determinar el tipo del blob de destino. Al cargar un archivo, "Detect" determina si el archivo es un archivo VHD o VHDX en función de la extensión del archivo. Si el archivo es VHD o VHDX, AzCopy lo trata como un blob en páginas. (el valor predeterminado es "Detect")
--block-blob-tier (string) Cargue un blob en bloques en Azure Storage con este nivel de blobs. (el valor predeterminado es "None")
--block-size-mb (float) Usa este tamaño de bloque (especificado en MiB) al cargar y descargar de Azure Storage. El valor predeterminado se calcula automáticamente en función del tamaño del archivo. Se permiten fracciones decimales (por ejemplo: 0,25). Al cargar o descargar, el tamaño máximo de bloque permitido es de 0,75 * AZCOPY_BUFFER_GB. Para obtener más información, consulte Optimizar el uso de memoria.
--cache-control (string) Establece el encabezado cache-control. Devuelto al descargar.
--check-length Comprueba la longitud de un archivo en el destino después de la transferencia. Si hay una discrepancia entre el origen y el destino, la transferencia se marca como errónea. (El valor predeterminado es true)
--check-md5(string) Especifica cómo de estrictamente se deben validar los hashes MD5 al descargarse. Solo está disponible al descargar. Opciones disponibles: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (el valor predeterminado es "FailIfDifferent") (el valor predeterminado es "FailIfDifferent")
--content-disposition(string) Establece el encabezado content-disposition. Devuelto al descargar.
--content-encoding (string) Establece el encabezado content-encoding. Devuelto al descargar.
--content-language (string) Establece el encabezado content-language. Devuelto al descargar.
--content-type (string) Especifica el tipo de contenido del archivo. Implica el uso de no-guess-mime-type. Devuelto al descargar.
--cpk-by-name (string) Clave proporcionada por el cliente por nombre que le da a los clientes que realizan solicitudes en Azure Blob Storage la opción de proporcionar una clave de cifrado por solicitud. El nombre de clave proporcionado se captura de Azure Key Vault y se usa para cifrar los datos
--cpk-by-value El valor predeterminado es false. La clave proporcionada por el cliente por nombre permite a los clientes que realizan solicitudes en Azure Blob Storage una opción para proporcionar una clave de cifrado por solicitud. La clave proporcionada y su hash se capturan de las variables de entorno
--decompressDescomprime automáticamente los archivos al realizar la descarga, si el encabezado content-encoding indica que están comprimidos. Los valores de content-encoding son "gzip" y "deflate". Las extensiones de archivo de ".gz"/".gzip" o ".zz" no son necesarias, pero se quitan si existen.
--disable-auto-decoding En "False" (desactivado) de manera predeterminada para habilitar la decodificación automática de chars ilegales en Windows. Se puede establecer en true para deshabilitar la decodificación automática.
--dry-run El valor predeterminado es false. Imprime las rutas de acceso de archivo que este comando copiaría. Esta marca no copia los archivos reales. La marca --overwrite no tiene ningún efecto. Si establece la marca --overwrite en false, los archivos del directorio de origen se muestran incluso si dichos archivos existen en el directorio de destino.
--exclude-attributes (string) (solo Windows) Excluye los archivos cuyos atributos coinciden con la lista de atributos. Por ejemplo: A;S;R
--exclude-blob-type (string) Opcionalmente, especifica el tipo de blob (BlockBlob/PageBlob/AppendBlob) que se va a excluir al copiar blobs desde el contenedor o la cuenta. El uso de esta marca no es aplicable para copiar datos desde un servicio que no es de Azure a otro que sí lo es. Si hay más de un blob deberían separarse mediante ";".
--exclude-container (cadena) Excluya estos contenedores al transferir solo de la cuenta a la cuenta. Se pueden separar varios contenedores con ';'.
--exclude-path (string) Excluye estas rutas de acceso al copiar. Esta opción no permite caracteres comodín (*). Comprueba los prefijos de ruta de acceso relativa (por ejemplo: myFolder;myFolder/subDirName/file.pdf). Cuando se usa en combinación con recorrido de cuentas, las rutas de acceso no incluyen el nombre del contenedor.
--exclude-pattern (string) Excluye estos archivos al copiar. Esta opción admite caracteres comodín (*).
--exclude-regex (string) Excluye toda la ruta de acceso relativa de los archivos que se alinean con expresiones regulares. Separe las expresiones regulares con ";".
--follow-symlinks Sigue los vínculos simbólicos al cargar desde el sistema de archivos local.
--force-if-read-only Al sobrescribir un archivo existente en Windows o Azure Files, fuerza la sobrescritura para que funcione incluso si el archivo existente tiene establecido el atributo de solo lectura
--from-to (string) Opcionalmente, especifica la combinación de destino de origen. Por ejemplo: LocalBlob, BlobLocal, LocalBlobFS. Piping: BlobPipe, PipeBlob
-h, --help Ayuda de copy
--include-after (string) Solo incluye los archivos modificados durante o después de la fecha y hora especificadas. El valor debe estar en el formato ISO8601. Si no se especifica ninguna zona horaria, se supone que el valor se encontrará en la zona horaria local de la máquina que ejecuta AzCopy. Por ejemplo,2020-08-19T15:04:00Z para una hora en UTC o 2020-08-19 para la medianoche (00:00) en la zona horaria local. A partir de AzCopy 10.5, esta marca solo se aplica a archivos, no a carpetas, por lo que las propiedades de carpeta no se copiarán cuando use esta marca con --preserve-smb-info o --preserve-smb-permissions.
--include-attributes (string) (solo Windows) Incluye los archivos cuyos atributos coinciden con la lista de atributos. Por ejemplo: A;S;R
--include-before (string) Solo incluye los archivos modificados antes o durante la fecha y hora especificadas. El valor debe estar en el formato ISO8601. Si no se especifica ninguna zona horaria, se supone que el valor se encontrará en la zona horaria local de la máquina que ejecuta AzCopy. Por ejemplo, 2020-08-19T15:04:00Z para una hora en UTC o 2020-08-19 para la medianoche (00:00) en la zona horaria local. A partir de AzCopy 10.7, esta marca solo se aplica a archivos, no a carpetas, por lo que las propiedades de carpeta no se copiarán cuando use esta marca con --preserve-smb-info o --preserve-smb-permissions.
--include-directory-stub False (desactivado) de forma predeterminada para omitir los códigos auxiliares de directorio. Los códigos auxiliares de directorio son blobs con metadatoshdi_isfolder:true. Si se establece el valor en true, se conservarán los códigos auxiliares de directorio durante las transferencias. Incluir esta marca sin valores predeterminados en true (por ejemplo, azcopy copy --include-directory-stub es igual que azcopy copy --include-directory-stub=true).
--include-path(string) Incluye solo estas rutas de acceso al copiar. Esta opción no permite caracteres comodín (*). Comprueba los prefijos de ruta de acceso relativa (por ejemplo: myFolder;myFolder/subDirName/file.pdf).
--include-pattern (string) Incluye solo estos archivos al copiar. Esta opción admite caracteres comodín (*). Separe los archivos con ";".
--include-regex (string) Incluye solo la ruta de acceso relativa de los archivos que se alinean con expresiones regulares. Separe las expresiones regulares con ";".
--list-of-versions (string) Especifica un archivo en el que cada id. de versión aparece en una línea independiente. Asegúrese de que el origen apunte a un único blob y que todos los id. de versión especificados en el archivo con esta marca solo pertenezcan al blob de origen. AzCopy descargará las versiones especificadas en la carpeta de destino proporcionada.
--metadata (string) Carga en Azure Storage con estos pares clave-valor como metadatos.
--no-guess-mime-type Impide que AzCopy detecte el tipo de contenido en función de la extensión o el contenido del archivo.
--overwrite (string) Sobrescribe los archivos y blobs en conflicto en el destino si esta marca está establecida en true. (el valor predeterminado es «true») Los valores posibles son «true», «false», «prompt» y «ifSourceNewer». En el caso de los destinos que admiten carpetas, se sobrescriben las propiedades de nivel de carpeta en conflicto si esta marca es “true” o si se proporciona una respuesta positiva al aviso. (el valor predeterminado es "true")
--page-blob-tier (string) Carga un blob en páginas en Azure Storage con este nivel de blobs. (el valor predeterminado es "None") (el valor predeterminado es "None")
--preserve-last-modified-time Solo está disponible si el destino es un sistema de archivos.
--preserve-owner Solo tiene efecto en las descargas y solo cuando se usa --preserve-smb-permissions. Si es true (valor predeterminado), el propietario del archivo y el grupo se conservan en las descargas. Si está establecida en false,
--preserve-smb-permissions conservará las listas de control de acceso, pero el propietario y el grupo se basan en el usuario que ejecuta AzCopy (el valor predeterminado es true)
--preserve-permissions El valor predeterminado es false. Conserva las ACL entre recursos compatibles (Windows y Azure Files o Azure Data Lake Storage en Azure Data Lake Storage). En el caso de las cuentas que tienen un espacio de nombres jerárquico, la entidad de seguridad debe ser el usuario propietario del contenedor de destino o debe tener asignado el rol Propietario de datos de Storage Blob, con ámbito al contenedor de destino, la cuenta de almacenamiento, el grupo de recursos primario o la suscripción. En el caso de las descargas, también necesitará la marca --backup para restaurar los permisos si el nuevo propietario no será el usuario que ejecuta AzCopy. Esta marca se aplica tanto a archivos como a carpetas, salvo que se especifique un filtro que solo permita archivos (por ejemplo, include-pattern).
--preserve-posix-properties El valor predeterminado es false. Conserva la información de propiedad que se obtiene de los metadatos del stat objeto o statx en él.
--preserve-smb-info En el caso de las ubicaciones compatibles con SMB, la marca se establece en true de forma predeterminada. Conserva la información de las propiedades de SMB (hora de la última escritura, hora de creación, bits de atributo) entre los recursos compatibles con SMB (Windows y Azure Files). Solo se transfieren los bits de atributo que admite Azure Files; los restantes se omiten. Esta marca se aplica tanto a archivos como a carpetas, salvo que se especifique un filtro que solo permita archivos (por ejemplo, include-pattern). La información transferida a las carpetas es la misma que la transferida a los archivos, excepto Last Write Timela que nunca se conserva para las carpetas. (El valor predeterminado es true)
--preserve-symlinks Si está habilitado, los destinos de vínculo simbólico se conservan como el contenido del blob, en lugar de cargar el archivo o la carpeta en el otro extremo del vínculo simbólico.
--put-blob-size-mb Use este tamaño (especificado en MiB) como umbral para determinar si se carga un blob como una única solicitud PUT al cargar en Azure Storage. El valor predeterminado se calcula automáticamente en función del tamaño del archivo. Se permiten fracciones decimales (por ejemplo: 0,25).
--put-md5 Crea un hash MD5 de cada archivo y lo guarda como la propiedad Content-MD5 del blob o archivo de destino. (De forma predeterminada, NO se crea el hash). Solo está disponible al cargar.
--recursive Busca en subdirectorios de forma recursiva al cargar desde el sistema de archivos local.
--s2s-detect-source-changed Detecta si el blob o el archivo de origen cambia mientras se está leyendo. (Este parámetro solo se aplica a las copias entre servicios, ya que la comprobación correspondiente está habilitada permanentemente para las cargas y descargas).
--s2s-handle-invalid-metadata (string) Especifica cómo se administran las claves de metadatos no válidas. Opciones disponibles: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (el valor predeterminado es "ExcludeIfInvalid") (el valor predeterminado es "ExcludeIfInvalid")
--s2s-preserve-access-tier Conserva el nivel de acceso durante la copia de servicio a servicio. Consulte Azure Blob Storage: niveles de acceso frecuente, esporádico y de archivo para asegurarse de que la cuenta de almacenamiento de destino admite la configuración del nivel de acceso. En los casos en los que no se admite la configuración del nivel de acceso, asegúrese de usar s2sPreserveAccessTier=false para omitir la copia del nivel de acceso. (El valor predeterminado es true). (El valor predeterminado es true)
--s2s-preserve-blob-tags El valor predeterminado es false. Conservar las etiquetas de índice durante la transferencia de servicios de un almacenamiento de blobs a otro
--s2s-preserve-propertiesConserva las propiedades completas durante la copia de servicio a servicio. Para el origen de archivo no único de AWS S3 y Azure Files, la operación de lista no devuelve las propiedades completas de objetos y archivos. Para conservar las propiedades completas, AzCopy debe enviar una solicitud adicional por objeto o archivo. (El valor predeterminado es true)
--trailing-dot Habilitado de forma predeterminada para tratar las operaciones relacionadas con el recurso compartido de archivos de forma segura. Opciones disponibles: Enable, Disable. Elija Disable volver al tratamiento heredado (potencialmente no seguro) de los archivos de puntos finales en los que el servicio de archivos recortará los puntos finales en las rutas de acceso. Esto puede dar lugar a posibles daños en los datos si la transferencia contiene dos rutas de acceso que solo difieren por un punto final (por ejemplo mypath , y mypath.). Si esta marca está establecida Disable en y AzCopy encuentra un archivo de puntos final, advertirá a los clientes en el registro de examen, pero no intentará anular la operación. Si el destino no admite archivos de puntos finales (Windows o Blob Storage), AzCopy producirá un error si el archivo de puntos final es la raíz de la transferencia y omite las rutas de acceso de puntos finales encontradas durante la enumeración.
Opciones heredadas de comandos primarios
--cap-mbps (float) Limita la velocidad de transferencia, en megabits por segundo. El rendimiento en un momento dado puede variar ligeramente del límite. Si esta opción se establece en cero o se omite, el rendimiento no se limita.
--log-level (string) Define el nivel de detalle para el archivo de registro; los niveles disponibles son: INFO (todas las solicitudes y respuestas), WARNING (respuestas lentas), ERROR (solo solicitudes con error) y NONE (sin registros de salida). (Valor predeterminado: "INFO"). (Valor predeterminado: "INFO").
Cadena --output-type Formato de la salida del comando. Las opciones incluyen: text, json. El valor predeterminado es "text". (Valor predeterminado: "text").
--trusted-microsoft-suffixes (cadena) Especifica sufijos de dominio adicionales donde se pueden enviar tokens de inicio de sesión de Microsoft Entra. El valor predeterminado es ".core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net". Los valores que se muestran aquí se agregan al valor predeterminado. Por seguridad, solo debe poner aquí dominios de Microsoft Azure. Separe las entradas con punto y coma.