Opciones de configuración de AzCopy v10 (Azure Storage)
AzCopy es una utilidad de línea de comandos que puede usar para copiar blobs o archivos a una cuenta de almacenamiento o desde una cuenta de almacenamiento. Este artículo contiene una lista de variables de entorno que se pueden usar para configurar AzCopy v10.
Nota:
Si busca contenido que le ayude a empezar a trabajar con AzCopy, consulte Introducción a AzCopy.
Variables de entorno de AzCopy v10
La tabla siguiente describe cada variable de entorno e incluye vínculos al contenido que pueden ayudarle a usar la variable.
| Variable de entorno | Descripción |
|---|---|
| AWS_ACCESS_KEY_ID | Clave de acceso de Amazon Web Services. Proporciona una clave para autorizar el acceso con Amazon Web Services. Copia de datos de Amazon S3 a Azure Storage mediante AzCopy |
| AWS_SECRET_ACCESS_KEY | La clave de acceso secreta de Amazon Web Services proporciona una clave secreta para autorizar el acceso con Amazon Web Services. Copia de datos desde Amazon S3 a Azure Storage con AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Punto de conexión de Microsoft Entra que se va a usar. Esta variable solo se usa para el inicio de sesión automático. Utilice la marca de línea de comandos en su lugar para invocar el comando de inicio de sesión. |
| AZCOPY_AUTO_LOGIN_TYPE | Establezca esta variable DEVICEen , MSI, SPN, AZCLIy PSCRED. Esta variable permite autorizar el acceso sin usar el comando azcopy login. Consulte Autorización del acceso a blobs con AzCopy y Microsoft Entra ID. |
| AZCOPY_BUFFER_GB | Establezca la cantidad máxima de memoria del sistema que desea que AzCopy utilice para descargar y cargar archivos. Exprese este valor en gigabytes (GB). Consulte Optimización del uso de memoria. |
| AZCOPY_CACHE_PROXY_LOOKUP | De forma predeterminada, AzCopy en Windows almacenará en caché las búsquedas del servidor proxy en el nivel de nombre de host, sin tener en cuenta la dirección URL. Establezca en cualquier otro valor que no sea "true" para deshabilitar la memoria caché. |
| AZCOPY_CONCURRENCY_VALUE | Especifica el número de solicitudes simultáneas que pueden producirse. Puede usar esta variable para aumentar el rendimiento. Si el equipo tiene menos de cinco CPU, el valor de esta variable se establece en 32. En caso contrario, el valor predeterminado es igual a 16 multiplicado por el número de CPU. El valor máximo predeterminado de esta variable es 3000, pero puede establecerlo manualmente en un valor superior o inferior. Consulte Aumento de la simultaneidad. |
| AZCOPY_CONCURRENT_FILES | Invalida el número aproximado de archivos que están en curso en un momento dado al controlar el número de archivos para los que se inician simultáneamente las transferencias. |
| AZCOPY_CONCURRENT_SCAN | Determina el grado máximo de paralelismo empleado en un examen. Solo afecta a los enumeradores paralelizados, como Azure Files blobs y los sistemas de archivos locales. |
| AZCOPY_CONTENT_TYPE_MAP | Invalida una o varias de las asignaciones de tipos MIME predeterminadas definidas por el sistema operativo. Establezca esta variable en la ruta de acceso de un archivo JSON que define cualquier asignación. Este es el contenido de un archivo JSON de ejemplo: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Invalida la versión de la API de servicio para que AzCopy pueda dar cabida a entornos personalizados como Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Solo se aplica cuando el origen es Azure Blobs. El examen simultáneo es más rápido, pero emplea la API de lista jerárquica, lo cual puede dar lugar a un aumento de las operaciones de E/S y el costo. Especifique "true" para ahorrar en costos, sacrificando el rendimiento. |
| AZCOPY_DISABLE_SYSLOG | Deshabilita el registro en Syslog o en el registrador de eventos de Windows. De forma predeterminada, AzCopy envía registros a estos canales. Puede establecer esta variable en true si desea reducir el ruido en Syslog o en el registro de eventos de Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Configura AzCopy para que se descargue en una ruta de acceso temporal antes de la descarga real. Los valores predeterminados son true o false |
| AZCOPY_JOB_PLAN_LOCATION | Invalida la ubicación en la que se almacenan los archivos del plan de trabajo (que se emplean para hacer un seguimiento del progreso y reanudar la actividad) con el fin de evitar que un disco se llene. |
| AZCOPY_LOG_LOCATION | Invalida la ubicación en la que se almacenan los archivos de registro con el fin de evitar que un disco se llene. |
| AZCOPY_MSI_CLIENT_ID | La identidad de cliente para una identidad administrada asignada por el usuario. Se usa cuando AZCOPY_AUTO_LOGIN_TYPE se establece en MSI. Consulte Autorización sin un almacén secreto. |
| AZCOPY_MSI_OBJECT_ID | El identificador de objeto de la identidad administrada asignada por el usuario. Se usa cuando AZCOPY_AUTO_LOGIN_TYPE se establece en MSI. Consulte Autorización sin un almacén secreto. |
| AZCOPY_MSI_RESOURCE_STRING | El identificador del recurso de la identidad administrada asignada por el usuario. Consulte Autorización sin un almacén secreto. |
| AZCOPY_PACE_PAGE_BLOBS | ¿Se debería ajustar automáticamente el rendimiento de los blobs en páginas para que coincidan con los límites del servicio? El valor predeterminado es true. Para deshabilitarlo, establezca el valor en "false". |
| AZCOPY_PARALLEL_STAT_FILES | Hace que AzCopy busque propiedades de archivo en "subprocesos" simultáneos al examinar el sistema de archivos local. Los subprocesos proceden del grupo definido por AZCOPY_CONCURRENT_SCAN. Si el valor se establece en "true", puede mejorar el rendimiento del examen en Linux. No es necesario ni recomendable hacerlo en Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Establezca el número de minutos en que AzCopy debe intentar cargar archivos para cada solicitud antes de que AzCopy agote el tiempo de espera. |
| AZCOPY_SHOW_PERF_STATES | Si se establece cualquier valor, la salida en pantalla incluirá el número de fragmentos en función del estado. |
| AZCOPY_SPA_APPLICATION_ID | El identificador de aplicación del registro de aplicación de la entidad de servicio. Se usa cuando AZCOPY_AUTO_LOGIN_TYPE se establece en SPN. Consulte Autorización sin un almacén secreto. |
| AZCOPY_SPA_CERT_PASSWORD | La contraseña de un certificado. Se usa cuando AZCOPY_AUTO_LOGIN_TYPE se establece en SPN. Consulte Autorización sin un almacén secreto. |
| AZCOPY_SPA_CERT_PATH | La ruta de acceso relativa o completa de un archivo de certificado. Se usa cuando AZCOPY_AUTO_LOGIN_TYPE se establece en SPN. Consulte Autorización sin un almacén secreto. |
| AZCOPY_SPA_CLIENT_SECRET | Secreto del cliente. Se usa cuando AZCOPY_AUTO_LOGIN_TYPE se establece en SPN. Consulte Autorización sin un almacén secreto. |
| AZCOPY_TENANT_ID | El identificador de inquilino de Microsoft Entra que se usa para el inicio de sesión interactivo de dispositivos compatibles con OAuth. Esta variable solo se usa para el inicio de sesión automático. Utilice la marca de línea de comandos en su lugar para invocar el comando de inicio de sesión. |
| AZCOPY_TUNE_TO_CPU | Establezca el valor en "false" para evitar que AzCopy tenga en cuenta el uso de CPU al ajustar automáticamente el nivel de simultaneidad (por ejemplo, en el comando de punto de referencia). |
| AZCOPY_USER_AGENT_PREFIX | Agregue un prefijo al agente de usuario de AzCopy predeterminado, que se usa con fines de telemetría. Se insertará un espacio automáticamente. |
| CPK_ENCRYPTION_KEY | Valor de clave de cifrado AES-256 con codificación Base64. Esta variable es necesaria para las solicitudes de lectura y escritura cuando se usan claves proporcionadas por el cliente para cifrar y descifrar datos en las operaciones de Blob Storage. Puede usar las claves proporcionadas por el cliente si establece la marca --cpk-by-value=true. |
| CPK_ENCRYPTION_KEY_SHA256 | SHA256 con codificación Base64 de la clave de cifrado. Esta variable es necesaria para las solicitudes de lectura y escritura cuando se usan claves proporcionadas por el cliente para cifrar y descifrar datos en las operaciones de Blob Storage. Puede usar las claves proporcionadas por el cliente si establece la marca --cpk-by-value=true. |
| GOOGLE_APPLICATION_CREDENTIALS | La ruta de acceso absoluta al archivo de clave de la cuenta de servicio proporciona una clave para autorizar el acceso con Google Cloud Storage. Copia de datos de Google Cloud Storage a Azure Storage con AzCopy (versión preliminar) |
| GOOGLE_CLOUD_PROJECT | Identificador de proyecto necesario para recorridos de nivel de servicio en Google Cloud Storage. |
| HTTPS_PROXY | Configura los valores de proxy para AzCopy. Establezca esta variable en la dirección IP y el número de puerto del proxy. Por ejemplo, xx.xxx.xx.xxx:xx. Si ejecuta AzCopy en Windows, AzCopy detecta automáticamente la configuración de proxy, por lo que no tiene que usar esta opción en Windows. Si decide usar esta opción en Windows, invalidará la detección automática. Consulte Configuración de proxy. |
Configuración de los valores de proxy
Para configurar las opciones de proxy para AzCopy, establezca la variable de entorno HTTPS_PROXY. Si ejecuta AzCopy en Windows, AzCopy detecta automáticamente la configuración de proxy, por lo que no tiene que usar esta opción en Windows. Si decide usar esta opción en Windows, invalidará la detección automática.
| Sistema operativo | Get-Help |
|---|---|
| Windows | En un símbolo del sistema, use: set HTTPS_PROXY=<proxy IP>:<proxy port>En PowerShell, use: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
En la actualidad, AzCopy no admite servidores proxy que requieren autenticación con NTLM o Kerberos.
Omisión de un proxy
Si está ejecutando AzCopy en Windows y desea indicarle que no use ningún proxy en absoluto (en lugar de detectar automáticamente la configuración), use estos comandos. Con esta configuración, AzCopy no buscará ni intentará usar ningún proxy.
| Sistema operativo | Entorno | Comandos: |
|---|---|---|
| Windows | Símbolo del sistema (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
En otros sistemas operativos, simplemente deje la variable HTTPS_PROXY sin establecer si no desea usar ningún proxy.