Alibaba Cloud CLI:Konfigurasikan dan kelola kredensial

Konfigurasi interaktif

Konfigurasi interaktif menggunakan wizard command line yang memandu Anda melalui proses konfigurasi kredensial. Sistem akan meminta Anda memasukkan setiap parameter kredensial secara berurutan. Metode ini cocok untuk lingkungan pengembangan lokal atau konfigurasi pertama kali.

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

Contoh: membuat profil kredensial EcsRamRole bernama EcsProfile:

aliyun configure --mode EcsRamRole --profile EcsProfile

Berikut contoh sesi interaktif:

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.

Konfigurasi non-interaktif

Tentukan parameter konfigurasi kredensial langsung melalui argumen command line tanpa input interaktif. Metode ini cocok untuk skenario otomatisasi seperti skrip dan pipeline CI/CD.

Contoh: membuat profil kredensial AK bernama 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"

Lihat konfigurasi

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

Beralih profil

aliyun configure switch --profile <ProfileName>

aliyun configure switch --profile prod

aliyun ecs describe-regions --profile prod

Modifikasi profil

Gunakan aliyun configure set untuk memodifikasi nilai parameter profil yang sudah ada. Anda hanya perlu menentukan parameter yang ingin diubah. Parameter yang tidak ditentukan tetap tidak berubah.

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

Parameter umum:

• --region: Wilayah default

• --language: Bahasa output (zh / en)

Untuk parameter detail, lihat dokumentasi masing-masing jenis kredensial.

Contoh: Modifikasi wilayah default profil default:

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

Hapus profil

Jalankan perintah berikut untuk menghapus profil tertentu:

aliyun configure delete --profile <ProfileName>

Contoh: Hapus profil bernama dev:

aliyun configure delete --profile dev

Setelah penghapusan, jalankan perintah aliyun configure list untuk memastikan profil telah dihapus dari daftar.

Apa yang harus dilakukan jika saya memasukkan informasi salah selama konfigurasi interaktif?

Gunakan aliyun configure set untuk memodifikasi field yang sesuai. Anda tidak perlu mengonfigurasi ulang dari awal. Contoh:

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

Perintah CLI tidak menggunakan profil aktif

CLI menentukan profil aktual yang digunakan berdasarkan prioritas berikut (dari tertinggi ke terendah). Prioritas lebih tinggi menggantikan prioritas lebih rendah:

• Parameter command line --profile: Berlaku hanya untuk perintah saat ini dan memiliki prioritas tertinggi.

• Variabel lingkungan ALIBABA_CLOUD_PROFILE: Berlaku untuk semua perintah dalam sesi terminal saat ini.

• Profil aktif: Profil yang ditandai dengan * dalam output perintah aliyun configure list. Pengaturan ini bersifat persisten.

Jika hasil perintah tidak sesuai ekspektasi, periksa apakah parameter --profile atau variabel lingkungan ALIBABA_CLOUD_PROFILE telah diatur, karena keduanya menggantikan profil aktif. Jalankan echo $ALIBABA_CLOUD_PROFILE untuk memeriksa apakah variabel lingkungan tersebut diatur.

Error: load current configuration failed unknown profile default

Pesan error lengkap:

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

Penyebab:

Semua profil kredensial telah dihapus, sehingga Alibaba Cloud CLI tidak dapat berfungsi dengan baik.

Solusi:

Hapus secara manual file config.json dan jalankan perintah aliyun configure untuk mengonfigurasi ulang kredensial. Untuk lokasi file, lihat Lokasi file konfigurasi. Misalnya, pada Linux atau macOS, jalankan perintah berikut untuk menghapus file:

rm ~/.aliyun/config.json