Compartir vía


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.

Consulte también