Alibaba Cloud CLI:Configure and manage credentials

Configuração interativa

A configuração interativa usa um assistente de linha de comando que orienta o processo passo a passo. O sistema solicita cada parâmetro da credencial em sequência. Esta abordagem é ideal para ambientes de desenvolvimento local ou para configurações iniciais.

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

Exemplo: para criar um perfil de credencial EcsRamRole chamado EcsProfile:

aliyun configure --mode EcsRamRole --profile EcsProfile

Veja abaixo um exemplo de sessão interativa:

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.

Configuração não interativa

Especifique os parâmetros de configuração da credencial diretamente via argumentos de linha de comando, sem entrada interativa. Mais indicado para cenários de automação, como scripts e pipelines de CI/CD.

Exemplo: para crie um perfil de credencial AK chamado 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

Visualize configurações

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

Alternar perfis

aliyun configure switch --profile <ProfileName>

aliyun configure switch --profile prod

aliyun ecs describe-regions --profile prod

Modifique um perfil

Use aliyun configure set para alterar valores de parâmetros de um perfil existente. Basta especifique os parâmetros a modifique; os demais permanecerão inalterados.

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

Parâmetros comuns:

• --region: Região padrão

• --language: Idioma de saída (zh / en)

Para obter a lista completa de parâmetros, consulte a documentação de cada tipo de credencial.

Exemplo: Modifique a região padrão do perfil default:

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

Exclua um perfil

Execute o comando abaixo para remover um perfil específico:

aliyun configure delete --profile <ProfileName>

Exemplo: Exclua um perfil chamado dev:

aliyun configure delete --profile dev

Após a exclusão, execute o comando aliyun configure list para confirme que o perfil foi removido da lista.

O que fazer se eu insira informações incorretas durante a configuração interativa?

Use aliyun configure set para corrigir o campo correspondente. Não é necessário refazer toda a configuração do zero. Exemplo:

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

Um comando da CLI não está usando o perfil ativo

A CLI determina o perfil efetivo com base na seguinte ordem de prioridade (da maior para a menor). Prioridades mais altas sobrescrevem as mais baixas:

• Parâmetro de linha de comando --profile: Aplica-se apenas ao comando atual e possui a maior precedência.

• Variável de ambiente ALIBABA_CLOUD_PROFILE: Afeta todos os comandos na sessão atual do terminal.

• Perfil ativo: Perfil marcado com * na saída do comando aliyun configure list. Esta configuração é persistente.

Se o resultado de um comando não corresponder ao esperado, verifique se o parâmetro --profile ou a variável de ambiente ALIBABA_CLOUD_PROFILE estão definidos, pois eles sobrescrevem o perfil ativo. Execute echo $ALIBABA_CLOUD_PROFILE para verifique se a variável de ambiente está configurada.

Erro: load current configuration failed unknown profile default

Mensagem de erro completa:

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

Causa:

Todos os perfis de credenciais foram excluídos, impedindo o funcionamento correto da Alibaba Cloud CLI.

Solução:

Exclua manualmente o arquivo config.json e execute o comando aliyun configure para reconfigurar as credenciais. Para saber onde encontrar o arquivo, consulte Localização do arquivo de configuração. Por exemplo, no Linux ou macOS, execute o seguinte comando para exclua o arquivo:

rm ~/.aliyun/config.json