Data Management (DMS) menyediakan konsol visual serta akses programatik melalui debugging online OpenAPI, Alibaba Cloud SDK, dan Alibaba Cloud CLI. Untuk membangun solusi secara efisien dengan DMS, pilih metode integrasi yang paling sesuai dengan kebutuhan Anda.
Ikhtisar OpenAPI
Untuk membantu Anda mempelajari dan menggunakan OpenAPI produk cloud kami secara efisien, Alibaba Cloud menyediakan situs web OpenAPI. Platform terpadu ini menawarkan fitur pencarian cerdas, dokumentasi, debugging online, akses ke SDK, contoh kode, diagnostik error, serta statistik pemanggilan. Anda dapat menggunakan portal OpenAPI untuk memanggil OpenAPI berbagai produk Alibaba Cloud serta melihat permintaan dan respons. Portal ini juga secara otomatis menghasilkan contoh kode SDK guna mempercepat penggunaan produk Alibaba Cloud. Untuk informasi lebih lanjut, lihat Apa itu OpenAPI?.
Versi API
Alibaba Cloud OpenAPI menggunakan nomor versi untuk mengelola versi utama API produk cloud.
Sebagai contoh, DMS mendukung versi API 2018-11-01. String 2018-11-01 merupakan pengenal versi API, bukan tanggal. Versi ini memberikan akses ke fitur API terbaru dan tidak berarti API tersebut tidak berubah sejak 2018-11-01.
|
Fitur |
Versi API |
Deskripsi |
|
Data Management (DMS) |
Disarankan. |
Debugging online
DMS menyediakan fitur debugging API dan lainnya di portal OpenAPI. Sebelum melakukan pemanggilan API, Anda harus memahami versi, titik akhir, gaya API, serta metode permintaan yang disediakan oleh DMS.
Pada halaman debugging portal OpenAPI, panel navigasi di sisi kiri mencantumkan operasi API seperti ListInstances (mengambil daftar informasi instans), AddInstance, ModifyInstance, GetInstance, dan DeleteInstance. Setelah memilih operasi API, panel tengah memungkinkan Anda mengonfigurasi titik akhir, misalnya China (Hangzhou), serta parameter permintaan. Parameter tersebut mencakup Tid (ID penyewa), SearchKey (kata kunci pencarian), DbType (tipe database), EnvType (tipe lingkungan), InstanceSource (sumber instans), NetType (jenis jaringan), InstanceState (status instans), dan PageNumber (nomor halaman). Setelah memasukkan nilai-nilai tersebut, klik Initiate Call untuk mengirim permintaan. Panel dokumentasi di sisi kanan menampilkan tipe data dan contoh nilai untuk setiap parameter.
Titik masuk debugging
|
Fitur |
Versi API |
Titik masuk |
|
Data Management (DMS) |
Titik akhir
DMS
Pilih titik akhir yang sesuai dengan wilayah tempat sumber daya Anda berada untuk meminimalkan latensi.
Sebagai contoh, titik akhir VPC untuk wilayah China (Zhangjiakou) adalah dms-enterprise-vpc.cn-zhangjiakou.aliyuncs.com. Untuk informasi lebih lanjut, lihat Titik akhir.
Identitas yang didukung
Setelah login ke situs web OpenAPI menggunakan Akun Alibaba Cloud Anda, pemanggilan API secara default dilakukan menggunakan akun tersebut untuk debugging online. Menggunakan Akun Alibaba Cloud untuk akses API rutin berisiko tinggi karena memiliki izin penuh. Kami sangat menyarankan membuat dan menggunakan Pengguna RAM untuk operasi harian. Berikan izin kepada Pengguna RAM sesuai kebutuhan bisnis Anda sebelum melakukan pemanggilan API. Pengguna RAM tersebut harus memiliki izin yang diperlukan untuk mengoperasikan DMS. Untuk informasi lebih lanjut, lihat Gunakan RAM untuk kontrol akses.
|
Identitas pengguna |
Didukung |
|
Didukung |
|
|
Pengguna RAM (disarankan) |
Didukung |
|
Peran RAM (disarankan) |
Didukung |
Metode integrasi
Ikhtisar integrasi
DMS menyediakan berbagai metode integrasi, termasuk SDK. Anda dapat memilih metode yang paling sesuai dengan kebutuhan bisnis Anda.
SDK mudah diintegrasikan dan merupakan metode yang direkomendasikan untuk memanggil OpenAPI.
DMS
|
Metode |
Didukung |
|
Alibaba Cloud SDK (disarankan) |
Didukung |
|
Didukung |
|
|
Didukung sebagian |
|
|
Tidak didukung |
|
|
Enkapsulasi API kustom (tidak disarankan) |
Didukung |
Alibaba Cloud SDK
-
Alibaba Cloud menyediakan SDK untuk berbagai bahasa pemrograman, termasuk Java, C#, Go, Python, Node.js/TypeScript, PHP, dan C++. Anda hanya perlu mengintegrasikan SDK untuk memanggil OpenAPI langsung melalui metode yang tersedia. SDK menyederhanakan pengembangan dengan menangani logika penandatanganan, timeout, dan mekanisme retry, serta mengembalikan objek Response terstruktur. Untuk informasi lebih lanjut mengenai Alibaba Cloud SDK, lihat Alibaba Cloud SDK.
-
Untuk informasi mengenai bahasa dan dependensi yang didukung oleh SDK DMS, lihat SDK DMS.
Alibaba Cloud CLI
-
Alibaba Cloud CLI memungkinkan Anda berinteraksi dengan layanan Alibaba Cloud dan mengelola sumber daya cloud Anda dari terminal menggunakan perintah
aliyun. Untuk informasi lebih lanjut mengenai Alibaba Cloud CLI, lihat Apa itu Alibaba Cloud CLI? -
Anda dapat menggunakan Alibaba Cloud CLI untuk memanggil operasi API DMS. Untuk informasi lebih lanjut, lihat Panggil operasi API RPC menggunakan Alibaba Cloud CLI.
Orkestrasi Sumber Daya (ROS)
-
Resource Orchestration Service (ROS) adalah layanan Alibaba Cloud yang menyederhanakan pengelolaan sumber daya cloud. Developer dan administrator dapat menulis templat untuk mendefinisikan sumber daya Alibaba Cloud yang diperlukan, seperti instance ECS dan instance database RDS, beserta dependensinya. Mesin orkestrasi ROS secara otomatis membuat dan mengonfigurasi semua sumber daya berdasarkan templat tersebut, sehingga memungkinkan penerapan dan O&M otomatis. Untuk informasi lebih lanjut, lihat Apa itu Resource Orchestration Service?.
-
Anda dapat menggunakan ROS untuk mengorkestrasikan sumber daya DMS. Sumber daya DMS berikut didukung:
-
ALIYUN::DMS::Instance: Mendaftarkan instans baru.
-
ALIYUN::DMS::User: Mendaftarkan pengguna baru.
-
-
Untuk segera menggunakan ROS guna mengorkestrasikan sumber daya DMS, lihat Contoh integrasi ROS.
Enkapsulasi API kustom
Untuk melakukan panggilan HTTP native, Anda harus mengimplementasikan algoritma signature, menyusun permintaan kustom, dan menginisiasi panggilan HTTP. Untuk informasi lebih lanjut mengenai mekanisme signature, lihat Ikhtisar API DMS dan Body permintaan dan mekanisme signature (V3).
Catatan penggunaan
DMS
-
Jika pemanggilan API gagal, gunakan kode kesalahan yang dikembalikan untuk memeriksa parameter permintaan dan nilainya. Untuk informasi lebih lanjut, lihat Kode kesalahan.
-
Atau, catat RequestID atau pesan error SDK dari tanggapan dan gunakan Diagnostik OpenAPI Alibaba Cloud untuk memecahkan masalah tersebut.