Ringkasan
Database Migration Service menyediakan REST API untuk mengelola profil koneksi dan tugas migrasi secara terprogram. REST API ditentukan oleh resource yang terkait dengan pembuatan dan pengelolaan profil koneksi serta tugas migrasi. Untuk mengetahui detail tentang semua resource dan metodenya, lihat Referensi API Database Migration Service.
Saat mengirim permintaan langsung ke REST API Layanan Migrasi Database, Anda harus membuat format permintaan yang benar, memberikan otorisasi permintaan sebagai pengguna terautentikasi, dan memproses respons yang ditampilkan. Banyak tugas dalam dokumentasi ini memberikan contoh API menggunakan cURL.
Untuk contoh penggunaan API lainnya, lihat halaman untuk permintaan di Referensi API Database Migration Service. Setiap halaman memiliki contoh yang memanggil API dalam beberapa bahasa pemrograman, serta Penjelajah khusus permintaan untuk membantu Anda melihat apa yang masuk ke dalam permintaan yang dibuat dengan baik dan apa yang akan Anda dapatkan dalam respons.
Anda juga menggunakan Database Migration Service API, secara tidak langsung, saat menggunakan salah satu cara berikut untuk mengelola instance:
Google Cloud CLI: Antarmuka command line (CLI) yang dapat Anda gunakan untuk menggunakan instance.
Google Cloud console: Antarmuka web grafis.
Keuntungan menggunakan metode ini, terutama konsolGoogle Cloud , adalah metode ini dapat sangat menyederhanakan pengelolaan profil koneksi dan tugas migrasi (bergantung pada kasus penggunaan Anda). Jika Anda baru memulai dengan Database Migration Service, sebaiknya mulai dengan salah satu alat ini terlebih dahulu sebelum menggunakan REST API secara langsung.
Mengaktifkan API
Untuk menggunakan Database Migration Service API, Anda harus mengaktifkannya:
Konsol
- Aktifkan Database Migration Service API.
- Pilih project Anda.
- Pilih Lanjutkan.
gcloud
- Masukkan kode berikut untuk menampilkan project ID project Google Cloud
Anda:
gcloud projects list
- Setel project default Anda:
gcloud config set project YOUR_PROJECT_ID
- Aktifkan Cloud SQL Admin API:
gcloud services enable datamigration.googleapis.com
Izin
Anda harus memiliki izin yang diperlukan untuk menggunakan Database Migration Service API. Izin ini mencakup:
- Admin Migrasi Database: Dengan izin ini, pengguna akan mendapatkan akses ke semua resource Database Migration Service yang digunakan untuk mengelola profil koneksi dan tugas migrasi.
- Database Migration Viewer: Dengan izin ini, pengguna memiliki akses hanya baca ke profil koneksi dan tugas migrasi di Database Migration Service.
- Admin Cloud SQL: Dengan izin ini, pengguna dapat membuat dan mengelola profil koneksi serta tugas migrasi untuk Cloud SQL di Database Migration Service.
Google Cloud menawarkan Identity and Access Management (IAM), yang memungkinkan Anda memberikan akses yang lebih terperinci ke resource Google Cloud tertentu dan mencegah akses yang tidak diinginkan ke resource lain. Anda dapat mendapatkan dan menetapkan izin untuk Layanan Migrasi Database menggunakan konsol Google Cloud, metode IAM API, atau Google Cloud CLI. Untuk mengetahui informasi selengkapnya, lihat Memberikan, mengubah, dan mencabut akses ke resource.
Memberikan data JSON dari file
Saat menggunakan API dengan cURL, Anda memberikan nilai properti menggunakan command line. Jika Anda menggunakan nilai sensitif seperti sandi atau kunci keamanan, menyediakan nilai tersebut di command line akan menimbulkan risiko keamanan. Untuk meningkatkan keamanan, Anda dapat membuat file yang berisi data JSON untuk panggilan API, dan memberikan jalur ke file di command line.
Untuk memberikan data JSON ke panggilan cURL API dari file:
Buat file yang berisi semua yang diapit tanda petik tunggal untuk kolom
--data.Sertakan tanda kurung kurawal, tetapi jangan sertakan tanda kutip tunggal.
Di command line, berikan jalur ke file, yang didahului dengan karakter
@, sebagai parameter--data:--data @<path-to-file>/<filename>
Menggunakan panggilan API yang berjalan lama
Beberapa panggilan API, seperti pembuatan objek, dapat memerlukan waktu beberapa saat untuk diselesaikan. Karena API bersifat asinkron, panggilan akan segera ditampilkan, meskipun operasi masih berlangsung. Jika panggilan API berikutnya menggunakan objek yang baru dibuat, Anda harus menunggu operasi pertama selesai sebelum melanjutkan.
Anda dapat menggunakan Database Migration Service API untuk mengelola operasi. Hal ini mencakup:
Database Migration Service dan Layanan Penemuan Google API
Layanan Penemuan Google API adalah layanan yang dapat Anda gunakan untuk menemukan Google API. Misalnya, saat menggunakan alat Google APIs Explorer , Anda menggunakan Layanan Penemuan.
Di Discovery Service, Database Migration Service direpresentasikan sebagai "datamigration" (misalnya: https://datamigration.googleapis.com/$discovery/rest?version=v1).