Topik ini menjelaskan cara menggunakan SDK untuk memanggil operasi OpenAPI dan membuat ACK managed cluster.
Langkah 1: Tinjau dokumentasi API
Sebelum melakukan pemanggilan, tinjau Buat ACK managed cluster menggunakan operasi OpenAPI untuk mengetahui parameter yang diperlukan dan izin yang dibutuhkan. Lihat Ikhtisar API untuk detail parameter.
Langkah 2: Buat RAM user dan berikan izin
Operasi ini dapat dilakukan menggunakan Akun Alibaba Cloud, RAM user, atau RAM role. Lihat identitas untuk mengetahui perbedaannya.
Akun Alibaba Cloud memiliki akses ke semua API. Untuk alasan keamanan, disarankan membuat dan menggunakan RAM user untuk pemanggilan API dan operasi harian.
-
-
Masuk ke RAM console menggunakan Akun Alibaba Cloud Anda.
-
Di panel navigasi sebelah kiri, pilih .
-
Pada halaman User, klik Create User.
-
Pada halaman Create User, atur Logon Name dan Display Name, lalu pilih Console Password Logon sebagai Access Method.
-
Klik OK.
Setelah pembuatan selesai, catat logon name dan password untuk masuk ke OpenAPI Developer Portal.
-
-
Berikan izin AliyunCSFullAccess kepada RAM user tersebut. Lihat Kelola izin untuk RAM user.
CatatanAliyunCSFullAccess: Akses penuh ke Container Service for Kubernetes.
AliyunCSReadOnlyAccess: Akses hanya-baca ke Container Service for Kubernetes.
Untuk membuat kebijakan kustom, lihat Informasi otorisasi.
-
Pada halaman detail RAM user, buka tab Authentication dan klik Create AccessKey. Lihat Buat AccessKey.
Langkah 3: Panggil API
Contoh ini memanggil CreateCluster sebagai RAM user menggunakan Java SDK untuk membuat ACK Pro cluster. Untuk bahasa lainnya, lihat Container Service for Kubernetes (ACK) SDK. Untuk metode pemanggilan alternatif, lihat Metode untuk memanggil operasi.
Konfigurasikan variabel lingkungan
Konfigurasikan variabel lingkungan untuk kredensial sebelum melakukan pemanggilan. Lihat Konfigurasikan variabel lingkungan di Linux, macOS, dan Windows.
Unduh kode contoh SDK
-
Buka CreateCluster.
-
Pada bagian Parameters, 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****
-
-
Pada tab SDK Sample, pilih versi SDK 2.0 dan bahasa yang Anda gunakan, lalu klik Download Project. Ekstrak paket yang diunduh secara lokal.
CatatanGunakan SDK V2.0. Lihat Perbedaan antara SDK V1.0 dan SDK V2.0 untuk perbandingan versi.
Setelah menentukan parameter seperti
name,region_id,cluster_type,cluster_spec, dancluster_versionpada tab Parameters, panel kode akan secara otomatis menghasilkan kode contoh dalam bahasa yang dipilih.
Jalankan kode contoh SDK
-
Buka IntelliJ IDEA. Pilih File > Open, pilih folder proyek, lalu tunggu hingga Maven menginstal dependensi.
-
Jalankan kode contoh.
Klik ganda file Sample, pastikan tidak ada error, lalu jalankan.
-
Lihat hasilnya.
Di konsol bagian bawah, cari
statusCode."statusCode": 202menunjukkan pemanggilan berhasil dan pembuatan kluster telah dimulai. Lihat 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..." } }