Alibaba Cloud CLI:Configure and manage credentials

Configuración interactiva

La configuración interactiva emplea un asistente en línea de comandos que lo guía paso a paso. El sistema le solicitará introducir cada parámetro de la credencial en secuencia. Este método es ideal para entornos de desarrollo local o para configuraciones iniciales.

aliyun configure --mode <AuthenticateMode> --profile <ProfileName>

Ejemplo: para crear un perfil de credenciales EcsRamRole llamado EcsProfile:

aliyun configure --mode EcsRamRole --profile EcsProfile

A continuación se muestra un ejemplo de sesión interactiva:

Configuring profile 'EcsProfile' in 'EcsRamRole' authenticate mode...
Ecs Ram Role []: ECSAdmin
Default Region Id []: cn-shanghai
Default Output Format [json]: json (Only support json)
Default Language [zh|en] en: en
Saving profile[EcsProfile] ...Done.

Configuración no interactiva

Especifique los parámetros de configuración directamente mediante argumentos en la línea de comandos, sin interacción. Esta opción es adecuada para escenarios de automatización como scripts y canalizaciones de CI/CD.

Ejemplo: para crear un perfil de credenciales AK denominado AkProfile:

aliyun configure set \
  --profile AkProfile \
  --mode AK \
  --access-key-id  ************ \
  --access-key-secret ************ \
  --region "cn-shanghai"

aliyun configure set `
  --profile AkProfile `
  --mode AK `
  --access-key-id  ************ `
  --access-key-secret  ************ `
  --region "cn-shanghai"

aliyun sts get-caller-identity

Consultar configuraciones

aliyun configure list

Profile      | Credential               | Valid   | Region           | Language
---------    | ------------------       | ------- | ---------------- | --------
default      | AK:***UyLX               | Valid   | cn-shanghai      | en
OAuthProfile | OAuth:fiA5bnZkyw@CN      | Valid   | cn-hangzhou      | en
EcsProfile * | EcsRamRole:ecs-role-name | Valid   | cn-beijing       | zh

aliyun configure get [--profile <ProfileName>] [<SETTING_NAME>...]

aliyun configure get --profile OAuthProfile

{
    "name": "OAuthProfile",
    "mode": "OAuth",
    "access_key_id": "STS.9jYc5erFPDLrwNGWc7Sob2ZRHenhHfz7pw9*************",
    "access_key_secret": "3AcNFz37QykuHEwgzWramXGZaCrM1mDHpG1s7v******",
    "sts_token": "CAIS5gJ1q6Ft5DqyfSjI2KnsKI/Rn5lx846Zd******",
    "region_id": "cn-hangzhou",
    "output_format": "json",
    "language": "zh",
    "sts_expiration": 1776751437,
    "oauth_access_token": "eyJhbGciOiJSUzI1NiIsI*******",
    "oauth_refresh_token": "ALGuHPAmSWxR5ynSsoRXhWpUtsxXHcLpGLnZqVvVXZDkjcbMsMasoshv1MnyRhkTq******",
    "oauth_access_token_expire": 1776751436,
    "oauth_site_type": "CN"
}

aliyun configure get --profile OAuthProfile profile mode language

profile=OAuthProfile
mode=OAuth
language=en

Cambiar de perfil

aliyun configure switch --profile <ProfileName>

aliyun configure switch --profile prod

aliyun ecs describe-regions --profile prod

Modificar un perfil

Use aliyun configure set para modificar los valores de los parámetros de un perfil existente. Solo necesita especificar los parámetros que desea cambiar; los demás permanecerán sin modificaciones.

aliyun configure set --profile <ProfileName> --<ParameterName> <NewValue>

Parámetros comunes:

• --region: Región predeterminada

• --language: Idioma de salida (zh / en)

Para más detalles sobre los parámetros, consulte la documentación de cada tipo de credencial.

Ejemplo: Modificar la región predeterminada del perfil default:

aliyun configure set --profile default --region cn-shanghai

Eliminar un perfil

Ejecute el siguiente comando para eliminar un perfil específico:

aliyun configure delete --profile <ProfileName>

Ejemplo: Eliminar un perfil llamado dev:

aliyun configure delete --profile dev

Tras la eliminación, ejecute el comando aliyun configure list para confirmar que el perfil se quitó de la lista.

¿Qué hago si introduzco información incorrecta durante la configuración interactiva?

Utilice aliyun configure set para modificar el campo correspondiente. No es necesario volver a configurar todo desde cero. Ejemplo:

aliyun configure set --profile <ProfileName> --<ParameterName> <CorrectValue>

Un comando de la CLI no usa el perfil activo

La CLI determina el perfil que debe usar según la siguiente prioridad (de mayor a menor). Una prioridad más alta anula a las inferiores:

• El parámetro de línea de comandos --profile: Aplica solo al comando actual y tiene la máxima precedencia.

• La variable de entorno ALIBABA_CLOUD_PROFILE: Aplica a todos los comandos en la sesión de terminal actual.

• El perfil activo: Es el perfil marcado con un * en la salida del comando aliyun configure list. Esta configuración es persistente.

Si el resultado de un comando no coincide con lo esperado, compruebe si están definidos el parámetro --profile o la variable de entorno ALIBABA_CLOUD_PROFILE, ya que estos anulan al perfil activo. Ejecute echo $ALIBABA_CLOUD_PROFILE para verificar si la variable de entorno está configurada.

Error: load current configuration failed unknown profile default

Mensaje de error completo:

ERROR: load current configuration failed unknown profile default, run configure to check

Causa:

Se eliminaron todos los perfiles de credenciales, lo que impide que Alibaba Cloud CLI funcione correctamente.

Solución:

Elimine manualmente el archivo config.json y ejecute el comando aliyun configure para volver a configurar las credenciales. Para conocer la ubicación del archivo, consulte Configuration file location. Por ejemplo, en Linux o macOS, ejecute el siguiente comando para eliminar el archivo:

rm ~/.aliyun/config.json