Container Service for Kubernetes:Contoh pemanggilan Java SDK

Langkah 1: Tinjau dokumentasi API

Sebelum memanggil operasi OpenAPI, baca dokumentasi API terkait, Buat ACK managed cluster menggunakan operasi OpenAPI, untuk memahami parameter yang diperlukan dan izin yang dibutuhkan. Untuk informasi lebih lanjut mengenai parameter tersebut, lihat Ikhtisar API.

Langkah 2: Buat RAM user dan berikan izin

Anda dapat menggunakan Akun Alibaba Cloud, RAM user, atau RAM role untuk memanggil operasi ini. Untuk informasi lebih lanjut mengenai perbedaan antara identitas tersebut, lihat identity.

1. Buat RAM user.

   1. Login ke RAM console dengan Akun Alibaba Cloud Anda.

   2. Di panel navigasi sebelah kiri, pilih Credential Management > User.

   3. Pada halaman User, klik Create User.

   4. Pada halaman Create User, atur Logon Name dan Display Name, lalu pilih Console Password Logon sebagai Access Method.

   5. Klik OK.

      Setelah RAM user dibuat, catat logon name dan password-nya. Anda memerlukannya untuk login ke Alibaba Cloud OpenAPI Developer Portal guna memanggil operasi OpenAPI.

2. Berikan izin AliyunCSFullAccess kepada RAM user tersebut. Untuk informasi lebih lanjut, lihat Kelola izin untuk RAM user.

   Catatan

   AliyunCSFullAccess: Izin untuk mengelola Container Service for Kubernetes.

   AliyunCSReadOnlyAccess: Izin read-only pada Container Service for Kubernetes.

   Jika Anda perlu membuat kebijakan kustom, lihat Informasi otorisasi.

3. Pada halaman detail RAM user, buka tab Authentication dan klik Create AccessKey. Untuk informasi lebih lanjut, lihat Buat AccessKey.

Langkah 3: Panggil API

Contoh ini menggunakan RAM user untuk memanggil operasi CreateCluster dan membuat ACK Pro cluster dengan Java SDK. SDK untuk bahasa lain dapat digunakan dengan cara serupa. Untuk informasi lebih lanjut, lihat Container Service for Kubernetes (ACK) SDK. Anda juga dapat menggunakan metode lain untuk memanggil operasi tersebut. Untuk informasi lebih lanjut, lihat Metode untuk memanggil operasi.

Konfigurasikan variabel lingkungan

Sebelum memanggil operasi, Anda harus mengonfigurasi variabel lingkungan untuk mendapatkan kredensial. Untuk informasi lebih lanjut, lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.

Unduh kode contoh SDK

1. Buka CreateCluster.

2. Di bagian Parameters di sebelah kiri, tentukan parameter yang diperlukan lalu klik Initiate Call.

   • Nilai contoh untuk name: test

   • Nilai contoh untuk region_id: cn-beijing

   • Nilai contoh untuk cluster_type: ManagedKubernetes

   • Nilai contoh untuk cluster_spec: ack.pro.small

   • Nilai contoh untuk cluster_version: 1.30.1-aliyun.1

   • Nilai contoh untuk vpcid: vpc-2zedl8cyb7tnkaux1****

   • Nilai contoh untuk container_cidr: 10.0.0.0/8

   • Nilai contoh untuk service_cidr: 172.21.0.0/20

   • Nilai contoh untuk vswitch_ids: vsw-2ze7hfp0ah8rk1nz9****

3. Pada tab SDK Sample, pilih versi SDK 2.0 dan bahasa pemrograman yang diinginkan, lalu klik Download Project. Setelah unduhan selesai, ekstrak paket tersebut di mesin lokal Anda.

   Catatan

   Kami menyarankan Anda menggunakan SDK V2.0. Untuk informasi lebih lanjut mengenai perbedaan antara V1.0 dan V2.0, lihat Perbedaan antara SDK V1.0 dan SDK V2.0.

   Setelah Anda menentukan parameter permintaan seperti name, region_id, cluster_type, cluster_spec, dan cluster_version pada tab Parameters di sebelah kiri, panel kode di sebelah kanan akan secara otomatis menghasilkan kode contoh SDK untuk bahasa yang dipilih.

Jalankan kode contoh SDK

1. Buka IntelliJ IDEA. Pilih File > Open, pilih folder proyek yang telah diekstrak, lalu tunggu hingga Maven secara otomatis menginstal dependensi.

2. Jalankan kode contoh.

   Klik ganda file Sample, pastikan tidak ada error yang dilaporkan, lalu jalankan kode tersebut.

3. Lihat hasilnya.

   Di konsol bagian bawah, cari statusCode. Jika output mencakup "statusCode": 202, pemanggilan berhasil dan pembuatan kluster telah dimulai. Anda dapat melihat kluster baru tersebut di halaman Clusters pada ACK console.

   {
     "headers": {
       "content-type": "application/json;charset=utf-8",
       "access-control-expose-headers": "*",
       "x-acs-trace-id": "30c74bc83a7fae0a081e5f5846be703e"
     },
     "statusCode": 202,
     "body": {
       "clusterId": "c6104ee21d6304ef8..."
     }
   }