Alibaba Cloud CLI：Panduan pengelolaan kredensial Alibaba Cloud CLI

Sintaksis

aliyun configure [--mode <AUTHENTICATE_MODE>] [--profile <PROFILE_NAME>]

• AUTHENTICATE_MODE: Menentukan jenis kredensial yang akan dikonfigurasi. Jika parameter ini tidak ditentukan, profil AccessKey (AK) dibuat secara default.

• PROFILE_NAME: Menentukan nama profil. Jika parameter ini tidak ditentukan, profil saat ini akan dimodifikasi. Jika profil yang ditentukan tidak ada, profil baru akan dibuat.

Contoh

1. Jalankan perintah berikut untuk mengonfigurasi profil AkProfile dengan tipe kredensial AK dalam mode interaktif:

   aliyun configure --mode AK --profile AkProfile

2. Proses interaktif:

   Mengonfigurasi profil 'AkProfile' dalam mode autentikasi 'AK'...
   Access Key Id []: "0wNEpMMlzy7s****"
   Access Key Secret []: <YOUR_ACCESS_KEY_SECRET>
   Default Region Id []: cn-hangzhou
   Default Output Format [json]: json (Hanya mendukung json)
   Default Language [zh|en] en: en
   Menyimpan profil[profile] ...Selesai.

Sintaksis

aliyun configure set [--mode <AUTHENTICATE_MODE>] [--profile <PROFILE_NAME>] [--settingName <settingValue>...]

• AUTHENTICATE_MODE: Menentukan jenis kredensial. Jika parameter ini tidak ditentukan, profil AK dibuat secara default.

• PROFILE_NAME: Menentukan nama profil. Jika parameter ini tidak ditentukan dan variabel lingkungan ALIBABA_CLOUD_PROFILE tidak dikonfigurasi, profil saat ini akan dimodifikasi. Jika profil yang ditentukan tidak ada, profil baru akan dibuat.

• settingName: Opsi profil yang ingin dikonfigurasi. Konfigurasikan opsi yang diperlukan untuk profil; jika tidak, pembuatan profil akan gagal. Untuk informasi lebih lanjut, lihat Konfigurasikan kredensial.

  Daftar pengaturan yang dapat dimodifikasi

  Opsi	Deskripsi	Contoh
  --region	ID wilayah default.	cn-hangzhou
  --language	Bahasa informasi bantuan. Bahasa Cina: zh Bahasa Inggris: en	zh
  --read-timeout	Periode timeout I/O. Unit: detik.	10
  --connect-timeout	Timeout koneksi dalam detik.	10
  --retry-count	Jumlah maksimum percobaan ulang.	5
  --expired-seconds	Periode validitas kredensial.	900
  --access-key-id	AccessKey ID akun Alibaba Cloud saat ini atau Pengguna Resource Access Management (RAM).	yourAccessKeyID
  --access-key-secret	Rahasia AccessKey dari akun Alibaba Cloud atau Pengguna RAM.	yourAccessKeySecret
  --sts-token	Token keamanan.	yourSecurityToken
  --sts-region	Wilayah tempat panggilan dilakukan untuk mendapatkan token Layanan Keamanan (STS).	cn-hangzhou
  --ram-role-name	Nama Peran RAM.	ECSAdmin
  --ram-role-arn	ARN Peran RAM dari Alibaba Cloud.	acs:ram::012345678910****:role/Alice
  --role-session-name	Nama sesi peran.	alice
  --source-profile	Nama profil sumber.	RamRoleArnProfile
  --process-command	Perintah untuk menjalankan program eksternal.	acs-sso login --profile sso
  --oidc-provider-arn	ARN Penyedia OpenID Connect (OIDC).	acs:ram::012345678910****:oidc-provider/TestOidcIdp
  --oidc-token-file	Jalur file token OIDC.	/path/to/oidctoken
  --cloud-sso-sign-in-url	Alamat masuk Pengguna CloudSSO.	https://signin-******.alibabacloudsso.com/device/login
  --cloud-sso-access-config	ID Profil CloudSSO.	ac-012345678910abcde****
  --cloud-sso-account-id	UID akun Alibaba Cloud yang digunakan untuk masuk ke CloudSSO.	012345678910****
  --oauth-site-type	Tipe situs untuk masuk OAuth. Situs Tiongkok (aliyun.com): CN Situs internasional (alibabacloud.com): INTL	CN

Contoh 1: Buat file dalam mode non-interaktif

1. Jalankan perintah berikut untuk mengonfigurasi profil AkProfile dengan tipe kredensial AK dalam mode non-interaktif:

   aliyun configure set \
     --access-key-id <yourAccessKeyID> \
     --access-key-secret <yourAccessKeySecret> \
     --region cn-hangzhou \
     --profile AkProfile \
     --mode AK \
     --language en

2. Jalankan perintah aliyun configure list. Jika Anda menerima keluaran berikut, profil AkProfile telah berhasil dibuat:

   Profile           | Credential            | Valid   | Region           | Language
   ---------         | ------------------    | ------- | ---------------- | --------
   default           | AK:******             | Valid   | cn-beijing       | zh
   AkProfile *       | AK:******             | Valid   | cn-hangzhou      | en

Contoh 2: Modifikasi profil

1. Jalankan perintah aliyun configure get region. ID wilayah dalam profil saat ini akan dikembalikan.

   

2. Jalankan perintah berikut untuk mengganti ID wilayah dalam profil dengan cn-shanghai:

   aliyun configure set --region cn-shanghai

3. Jalankan perintah aliyun configure get region lagi untuk memeriksa apakah ID wilayah telah diperbarui.

   

Contoh

1. Jalankan perintah berikut untuk menanyakan daftar profil:

   aliyun configure list

2. Daftar profil berikut dikembalikan:

   Daftar profil mencakup ringkasan setiap profil, termasuk nama profil, pengenal profil, beberapa informasi kredensial, periode validitas kredensial, ID wilayah default, dan bahasa informasi bantuan. Alibaba Cloud CLI menggunakan tanda asterisk (*) di sebelah kanan nama profil untuk mengidentifikasi profil aktif.

   Profile           | Credential            | Valid   | Region           | Language
   ---------         | ------------------    | ------- | ---------------- | --------
   AkProfile *       | AK:******             | Valid   | cn-beijing       | en
   StsTokenProfile   | StsToken:******       | Valid   | cn-hangzhou      | en
   RamRoleArnProfile | RamRoleArn:******     | Valid   | cn-shanghai      | en
   EcsRamRoleProfile | EcsRamRole:ECSAdmin   | Valid   | cn-qingdao       | zh

Sintaksis

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

• PROFILE_NAME: Menentukan nama profil. Jika parameter ini tidak ditentukan dan variabel lingkungan ALIBABA_CLOUD_PROFILE tidak dikonfigurasi, informasi tentang profil saat ini akan ditampilkan. Jika profil yang ditentukan tidak ada, pesan profile <PROFILE_NAME> not found! akan dikembalikan.

• SETTING_NAME: Menentukan pengaturan yang ingin dilihat. Anda dapat menentukan beberapa pengaturan. Jika parameter ini tidak ditentukan, semua pengaturan akan ditampilkan. Jika pengaturan yang ditentukan tidak ada, perintah tidak mengembalikan informasi apa pun.

  Daftar pengaturan yang dapat dilihat

  Opsi	Deskripsi	Bidang pengaturan terkait
  profile	Nama profil.	name
  mode	Tipe kredensial.	mode
  region	ID wilayah default.	region_id
  language	Bahasa informasi bantuan.	language
  access-key-id	AccessKey ID akun Alibaba Cloud saat ini atau Pengguna RAM.	access_key_id
  access-key-secret	Rahasia AccessKey dari akun Alibaba Cloud atau Pengguna RAM.	access_key_secret
  sts-token	Token Layanan Keamanan (STS) dari Pengguna RAM atau Peran.	sts_token
  sts-region	ID wilayah tempat Pengguna RAM atau Peran memperoleh token STS.	sts_region
  ram-role-name	Nama Peran RAM.	ram_role_name
  ram-role-arn	ARN Peran RAM.	ram_role_arn
  external-id	ID Eksternal Peran RAM.	external_id
  role-session-name	Nama sesi peran.	ram_session_name
  cloud-sso-sign-in-url	Alamat masuk Pengguna CloudSSO.	cloud-sso-sign-in-url
  cloud-sso-access-config	ID Profil CloudSSO.	cloud-sso-access-config
  cloud-sso-account-id	UID akun Alibaba Cloud yang digunakan untuk masuk ke CloudSSO.	cloud-sso-account-id
  oauth-site-type	Tipe situs untuk masuk OAuth.	oauth-site-type

Contoh 1: Lihat semua opsi konfigurasi profil

1. Jalankan perintah berikut untuk menanyakan semua opsi konfigurasi profil AkProfile dengan tipe AK:

   aliyun configure get --profile AkProfile

2. Contoh respons:

   {
     "name": "AkProfile",
     "mode": "AK",
     "access_key_id": "<yourAccessKeyID>",
     "access_key_secret": "<yourAccessKeySecret>",
     "region_id": "cn-hangzhou",
     "output_format": "json",
     "language": "en"
   }

Contoh 2: Kueri opsi konfigurasi tertentu dari profil

1. Jalankan perintah berikut untuk menanyakan nama profil, tipe kredensial, dan bahasa default dari ExternalProfile dengan tipe kredensial Eksternal:

   aliyun configure get profile mode language --profile ExternalProfile

2. Detail dikembalikan dalam format key=value.

   profile=ExternalProfile
   mode=Eksternal
   language=en

Sintaksis

aliyun configure switch --profile <PROFILE_NAME>

PROFILE_NAME: Menentukan nama profil. Parameter ini wajib. Perintah gagal jika parameter ini kosong atau profil yang ditentukan tidak ada.

Contoh

1. Jalankan perintah aliyun configure list untuk menanyakan daftar profil. Daftar menunjukkan bahwa profil saat ini adalah default. Alibaba Cloud CLI menggunakan tanda asterisk (*) di sebelah kanan nama profil untuk mengidentifikasi profil aktif.

   Profile           | Credential            | Valid   | Region           | Language
   ---------         | ------------------    | ------- | ---------------- | --------
   default *         | AK:******             | Valid   | cn-hangzhou      | en
   ExampleProfile    | AK:******             | Valid   | cn-beijing       | zh

2. Jalankan perintah berikut untuk beralih ke profil ExampleProfile. Jika Anda menerima pesan Profil default sekarang adalah `ExampleProfile`, perintah berhasil.

   aliyun configure switch --profile exampleProfile

3. Jalankan perintah aliyun configure list lagi untuk memeriksa apakah Anda telah beralih ke profil yang ditentukan.

   Profile           | Credential            | Valid   | Region           | Language
   ---------         | ------------------    | ------- | ---------------- | --------
   default           | AK:******             | Valid   | cn-hangzhou      | en
   ExampleProfile *  | AK:******             | Valid   | cn-beijing       | zh

Sintaksis

aliyun configure delete --profile <PROFILE_NAME>

• PROFILE_NAME: Menentukan nama profil yang akan dihapus. Parameter ini wajib. Perintah gagal jika parameter ini kosong atau profil yang ditentukan tidak ada.

• Jika Anda menghapus profil saat ini, Anda akan otomatis beralih ke profil teratas dalam daftar. Untuk informasi lebih lanjut, lihat contoh berikut.

• Kami sarankan Anda menyimpan setidaknya satu profil. Jika Anda secara tidak sengaja menghapus semua profil, Alibaba Cloud CLI tidak akan bekerja seperti yang diharapkan. Untuk menyelesaikan masalah ini, Anda harus secara manual menghapus file config.json. File ini terletak di folder .aliyun di direktori home pengguna Anda. Lokasi direktori home pengguna bervariasi berdasarkan sistem operasi.

  • Windows: C:\Users\<USER_NAME>\.aliyun

  • Linux dan macOS: /home/<USER_NAME>/.aliyun

Contoh

1. Jalankan perintah aliyun configure list untuk menanyakan daftar profil.

   Profile           | Credential            | Valid   | Region           | Language
   ---------         | ------------------    | ------- | ---------------- | --------
   default           | AK:******             | Valid   | cn-hangzhou      | en
   AkProfile         | AK:******             | Valid   | cn-hangzhou      | en
   ExampleProfile *  | AK:******             | Valid   | cn-hangzhou      | en

2. Jalankan perintah berikut untuk menghapus profil ExampleProfile:

   aliyun configure delete --profile ExampleProfile

3. Jalankan perintah aliyun configure list lagi untuk memeriksa apakah profil ExampleProfile telah dihapus. Jika ya, Anda akan beralih ke profil default.

   Profile           | Credential            | Valid   | Region           | Language
   ---------         | ------------------    | ------- | ---------------- | --------
   default *         | AK:******             | Valid   | cn-hangzhou      | en
   AkProfile         | AK:******             | Valid   | cn-hangzhou      | en