Key Management Service (KMS) menyediakan konsol untuk operasi visual dan berbagai metode untuk memanggil Operasi API, termasuk OpenAPI Explorer, Alibaba Cloud SDK, dan Terraform. OpenAPI Explorer mendukung debugging online Operasi API.
Tinjauan OpenAPI Explorer
Alibaba Cloud menyediakan OpenAPI Explorer untuk membantu pengembang memahami dan menggunakan Operasi API dari berbagai layanan Alibaba Cloud secara cepat dan efisien. OpenAPI Explorer mengintegrasikan fitur-fitur seperti pencarian cerdas, dokumentasi, debugging online, perolehan SDK, CodeSample, diagnosis kesalahan panggilan, dan statistik panggilan. Di OpenAPI Explorer, Anda dapat memanggil Operasi API layanan Alibaba Cloud serta melihat permintaan dan respons API. Selain itu, OpenAPI Explorer secara otomatis menghasilkan kode contoh SDK yang sesuai untuk memudahkan penggunaan layanan Alibaba Cloud. Untuk informasi lebih lanjut, lihat Apa itu API?.
Deskripsi Versi
OpenAPI Explorer mendukung debugging online untuk API versi 2016-01-20. 2016-01-20 adalah nomor versi API, bukan tanggal. Pengguna diberikan informasi publik terbaru tentang API. 2016-01-20 merupakan versi terbaru API KMS. Untuk informasi lebih lanjut tentang cara melihat versi API, lihat Versi API.
Versi | Deskripsi |
Direkomendasikan |
Debugging Online
KMS menyediakan fitur debugging API di OpenAPI Explorer. Sebelum memanggil Operasi API, perhatikan informasi berikut yang disediakan oleh KMS: versi, titik akhir, dan parameter.
URL halaman debugging API adalah https://next.api.alibabacloud.com/api/Kms/2016-01-20.
Titik Akhir
Kami merekomendasikan Anda memilih titik akhir berdasarkan wilayah tempat sumber daya yang ingin Anda akses berada untuk mengurangi latensi. Misalnya, jika KMS berada di wilayah China (Hangzhou), titik akhir publiknya adalah kms.cn-hangzhou.aliyuncs.com, sedangkan titik akhir virtual private cloud (VPC) adalah kms-vpc.cn-hangzhou.aliyuncs.com.
Titik akhir publik dapat diakses secara global.
Titik akhir VPC hanya dapat diakses dari dalam VPC di wilayah Alibaba Cloud tertentu. Titik akhir VPC memberikan keuntungan sebagai berikut:
Keamanan lebih tinggi: Titik akhir VPC hanya dapat diakses dari dalam VPC, memberikan keamanan dan privasi yang lebih baik.
Respons lebih cepat: Titik akhir VPC menggunakan lingkungan jaringan internal untuk memberikan respons lebih cepat dibandingkan dengan titik akhir publik. Selain itu, dengan menggunakan titik akhir VPC, Anda bebas dari masalah seperti latensi jaringan dan batasan bandwidth.
Biaya rendah: Titik akhir VPC diakses melalui jaringan internal.
Detail titik akhir adalah sebagai berikut:
Identitas
Setelah Anda masuk ke OpenAPI Explorer menggunakan akun Alibaba Cloud Anda, OpenAPI Explorer akan menggunakan akun tersebut untuk men-debug Operasi API online secara default. Akun Alibaba Cloud memiliki izin pada semua Operasi API. Namun, risiko keamanan mungkin muncul jika Anda menggunakan akun Alibaba Cloud untuk memanggil Operasi API. Kami sangat menyarankan Anda memanggil Operasi API atau melakukan O&M rutin sebagai Pengguna Resource Access Management (RAM). Sebelum memanggil Operasi API menggunakan Pengguna RAM, berikan izin yang diperlukan kepada Pengguna RAM berdasarkan kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Gunakan RAM untuk mengimplementasikan kontrol akses.
Identitas | Didukung |
Ya | |
Pengguna RAM (direkomendasikan) | Ya |
Peran RAM (direkomendasikan) | Ya |
Referensi
Metode Integrasi
SDK dapat dengan mudah diintegrasikan dengan aplikasi Anda dan mencakup rentang operasi yang paling luas. Kami merekomendasikan Anda menggunakan SDK untuk memanggil Operasi API.
Metode integrasi | Didukung |
Ya | |
Ya | |
Tidak | |
Sebagian | |
Ya |
Alibaba Cloud SDK
Alibaba Cloud menyediakan SDK dalam berbagai bahasa pemrograman, seperti Java, C#, Go, Python, Node.js, TypeScript, PHP, dan C++. Anda dapat mengintegrasikan SDK dengan aplikasi Anda untuk langsung memanggil Operasi API. SDK mengenkapsulasi berbagai informasi, termasuk logika penandatanganan data, mekanisme timeout, dan mekanisme retry. SDK mengembalikan objek respons terstruktur berdasarkan spesifikasi untuk memudahkan pengembangan. Untuk informasi lebih lanjut, lihat Alibaba Cloud SDK.
Anda dapat menggunakan KMS SDK untuk memanggil Operasi API. Untuk informasi lebih lanjut tentang bahasa pemrograman yang didukung oleh KMS SDK dan cara menginstal dependensi terkait, lihat KMS SDK.
Alibaba Cloud CLI
Anda dapat menjalankan perintah
aliyununtuk berinteraksi dengan layanan Alibaba Cloud dan mengelola sumber daya layanan cloud. Untuk informasi lebih lanjut, lihat Apa itu Alibaba Cloud CLI?.Anda dapat menggunakan Alibaba Cloud CLI untuk memanggil Operasi API KMS. Untuk informasi lebih lanjut, lihat Panduan pengguna Alibaba Cloud CLI.
ROS
Resource Orchestration Service (ROS) adalah layanan Alibaba Cloud yang dapat menyederhanakan manajemen sumber daya komputasi cloud. Anda dapat membuat template untuk menggambarkan sumber daya komputasi cloud yang Anda butuhkan, seperti instance Elastic Compute Service (ECS) dan ApsaraDB RDS, serta hubungan antar sumber daya. ROS secara otomatis membuat dan mengonfigurasi semua sumber daya berdasarkan template untuk mengimplementasikan penyebaran dan O&M otomatis. Untuk informasi lebih lanjut, lihat Apa itu ROS?.
Anda tidak dapat menggunakan ROS untuk memanggil Operasi API KMS.
Terraform
Terraform adalah alat open source yang digunakan untuk melihat pratinjau, mengonfigurasi, dan mengelola infrastruktur cloud dan sumber daya secara aman dan efisien. Terraform bekerja dengan cara yang mirip dengan ROS. Terraform memanggil Operasi API dengan menafsirkan template. Untuk informasi lebih lanjut, lihat Apa itu Terraform?.
Untuk informasi lebih lanjut, lihat Tinjauan Umum.
Enkapsulasi API Kustom
Untuk membuat panggilan HTTP asli, Anda harus membuat permintaan kustom dan menandatangani permintaan tersebut. Untuk informasi lebih lanjut tentang mekanisme tanda tangan, lihat Tinjauan API dan Sintaks permintaan dan metode tanda tangan V3.
Catatan Penggunaan
Jumlah permintaan per detik (QPS) yang dapat dilakukan oleh akun Alibaba Cloud bervariasi berdasarkan Operasi API. Untuk informasi lebih lanjut, lihat bagian batas QPS di referensi API setiap operasi.
CatatanSemua Pengguna RAM yang termasuk dalam akun Alibaba Cloud berbagi kuota QPS dari akun Alibaba Cloud.
Jika kesalahan dikembalikan setelah Anda memanggil Operasi API KMS, periksa apakah parameter input dan nilainya valid berdasarkan kode kesalahan yang dikembalikan. Untuk informasi lebih lanjut, lihat Kode kesalahan umum.
Anda juga dapat menggunakan platform Alibaba Cloud OpenAPI Diagnostics untuk melakukan diagnostik mandiri berdasarkan ID permintaan yang dikembalikan atau pesan kesalahan SDK.