Variables de entorno disponibles - Alibaba Cloud CLI - Centro de documentación de Alibaba Cloud

Alibaba Cloud CLI permite configurar credenciales, región, opciones de comportamiento y otros parámetros de ejecución mediante variables de entorno. En pipelines de CI/CD, entornos de contenedores o scripts de automatización, las variables de entorno son el método preferido para pasar credenciales y configuración de ejecución. Este tema enumera todas las variables de entorno compatibles y explica su orden de prioridad para ayudarle a localizar rápidamente los elementos de configuración obligatorios.

Orden de prioridad

Al leer la configuración, Alibaba Cloud CLI aplica los ajustes en el siguiente orden de prioridad, de mayor a menor:

Parámetros de línea de comandos (como --profile y --region)
Archivo de configuración (~/.aliyun/config.json)
Variables de entorno

Para obtener más información, consulte Understand command-line parameters.

Credenciales e identidad

Use variables de entorno para configurar información de credenciales como AccessKey, token de Security Token Service (STS), OpenID Connect (OIDC) y roles de RAM sin almacenar secretos en texto plano dentro de archivos de configuración.

Variable de entorno	Descripción
`ALIBABA_CLOUD_ACCESS_KEY_ID`	ID de AccessKey.
`ALIBABA_CLOUD_ACCESS_KEY_SECRET`	Secreto de AccessKey.
`ALIBABA_CLOUD_SECURITY_TOKEN`	Token de seguridad temporal de STS. Úselo junto con el ID y el secreto de AccessKey.
`ALIBABA_CLOUD_CREDENTIALS_URI`	Endpoint del servicio de credenciales para el modo CredentialsURI. No hay alias disponible.
`ALIBABA_CLOUD_OIDC_PROVIDER_ARN`	ARN (Alibaba Cloud Resource Name) del proveedor de identidad OIDC.
`ALIBABA_CLOUD_OIDC_TOKEN_FILE`	Ruta al archivo de token OIDC.
`ALIBABA_CLOUD_ROLE_ARN`	ARN del rol de RAM; se usa con los modos de autenticación RamRoleArn y ChainableRamRoleArn.
`ALIBABA_CLOUD_EXTERNAL_ID`	ID externo; se usa en escenarios de asunción de roles entre cuentas.
`ALIBABA_CLOUD_SSO_CLIENT_ID`	ID de cliente OIDC de Cloud SSO. Si se establece, anula el ID de cliente predeterminado integrado en la CLI.

Para conocer los métodos de configuración y los escenarios aplicables a cada tipo de credencial, consulte Configurar credenciales.

Selección de perfil

Controle qué perfil usa la CLI.

Variable de entorno	Descripción
`ALIBABA_CLOUD_PROFILE`	Especifica el nombre del perfil por usar. Equivale al parámetro `--profile`.
`ALIBABA_CLOUD_IGNORE_PROFILE`	Si se establece en `TRUE` (debe estar en mayúsculas y distingue entre mayúsculas y minúsculas), la CLI ignora los perfiles del archivo de configuración y usa únicamente las credenciales proporcionadas por variables de entorno.

Región y endpoint

Variable de entorno	Descripción
`ALIBABA_CLOUD_REGION_ID`	ID de región predeterminado, por ejemplo, `cn-hangzhou`.
`ALIBABA_CLOUD_ENDPOINT`	Dirección personalizada del endpoint de API. Al configurarla, la CLI envía las solicitudes directamente a esta dirección y omite la resolución automática de endpoints.
`ALIBABA_CLOUD_ENDPOINT_TYPE`	Tipo de endpoint. Por ejemplo, establézcalo en `vpc` para usar un endpoint de red privada VPC. Déjelo vacío o sin configurar para usar el endpoint de red pública.

Gestión de plugins

Controle el comportamiento de instalación automática de plugins, la ubicación de almacenamiento y el origen de descarga.

Variable de entorno	Descripción
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL`	Si se establece en `true`, la CLI instala automáticamente los plugins faltantes al invocar comandos de plugin.
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL_ENABLE_PRE`	Si se establece en `true`, permite la instalación automática de versiones preliminares de plugins.
`ALIBABA_CLOUD_CLI_PLUGINS_DIR`	Directorio personalizado para la instalación de plugins. El valor predeterminado es `~/.aliyun/plugins/`.
`ALIBABA_CLOUD_CLI_PLUGIN_NO_CACHE`	Si se establece en `true` o `1`, se omite la caché del índice de plugins y se obtiene el índice más reciente desde el origen remoto en cada ocasión.
`ALIBABA_CLOUD_CLI_PLUGIN_SOURCE_BASE`	URL base para un origen de descarga de plugins personalizado. Resulta útil en entornos de red privada o escenarios con imágenes privadas.

Red, tiempo de espera e idioma

La CLI transfiere automáticamente los siguientes ajustes del perfil actual a los procesos secundarios de los plugins. Para ajustar el tiempo de espera y la directiva de reintentos, use el comando aliyun configure o edite directamente el archivo de configuración.

Variable de entorno	Descripción
`ALIBABA_CLOUD_READ_TIMEOUT`	Tiempo de espera de lectura de E/S, en segundos.
`ALIBABA_CLOUD_CONNECT_TIMEOUT`	Tiempo de espera de conexión, en segundos.
`ALIBABA_CLOUD_RETRY_COUNT`	Número de reintentos tras un fallo en la solicitud.
`ALIBABA_CLOUD_LANGUAGE`	Configuración de idioma de la CLI. Los valores válidos son `en` (inglés) o `zh` (chino).