Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola tugas migrasi menggunakan API

MySQL | PostgreSQL | PostgreSQL ke AlloyDB

Ringkasan

Di halaman ini, Anda akan mempelajari cara menggunakan Database Migration Service API untuk mengelola tugas migrasi untuk database sumber MySQL.

Ada dua cara untuk menggunakan Database Migration Service API. Anda dapat melakukan panggilan REST API atau menggunakan Google Cloud CLI (CLI).

Untuk melihat informasi umum tentang penggunaan gcloud untuk mengelola tugas migrasi Database Migration Service, klik di sini.

Membuat draf tugas migrasi

Berikut adalah permintaan untuk membuat tugas migrasi dalam mode draf. Dengan begitu, Anda tidak perlu membuat tugas migrasi sekaligus. Anda dapat membuat sebagiannya, lalu memperbaruinya menggunakan operasi PATCH.

Misalnya, jika ingin membuat tugas migrasi, tetapi tidak memiliki database tujuan atau metode konektivitas jaringan, Anda dapat menggunakan kode berikut:

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi
migration-job-name: Nama tugas migrasi
source-connection-profile-id: ID profil koneksi sumber
destination-connection-profile-id: ID profil koneksi tujuan
provider: Penyedia yang terkait dengan jenis klasifikasi database sumber.
- Untuk instance MySQL mandiri, gunakan DATABASE_PROVIDER_UNSPECIFIED karena nilai ini dikaitkan dengan database lokal.
- Untuk instance Cloud SQL untuk MySQL, gunakan CLOUDSQL.
- Untuk layanan database terkelola, gunakan nilai ENUM yang sesuai. Lihat referensi objek DatabaseProvider.
cloud-storage-bucket (opsional): Bucket di Cloud Storage tempat Anda menyimpan file dump.
dump-file (opsional): File dump yang Anda simpan di bucket di Cloud Storage.
Jika Anda ingin memberikan file dump Anda sendiri, simpan file di Cloud Storage, lalu berikan jalurnya.

Anda dapat menyimpan file dump yang di-zip atau tidak di-zip di bucket di Cloud Storage.
- Untuk file zip, gunakan gzip_filename.gz. Contoh, gzip_dump.gz.
- Untuk file yang diekstrak, gunakan filename.sql. Contoh, dump.sql.
flag-name dan flag-value (opsional): Nama dan nilai flag yang Anda tambahkan ke utilitas mysqldump. Utilitas ini membuat file dump.
Anda dapat menambahkan satu atau beberapa flag ke file dump. Misalnya, untuk menambahkan flag max-allowed-packet, ignore-error, dan add-locks ke file, gunakan baris kode berikut:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Untuk informasi selengkapnya tentang flag ini serta flag lain yang dapat Anda tambahkan ke file dump, lihat dokumentasi tentang utilitas mysqldump di Manual Referensi MySQL 8.0.

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Meminta isi JSON:


{
  "displayName": "migration-job-name",
  "state": "DRAFT",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  //"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  //"vpcPeeringConnectivity": {
  //"vpc": "default"
  //},
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Membuat tugas migrasi berkelanjutan dengan konektivitas peering VPC

Berikut adalah permintaan untuk membuat tugas migrasi berkelanjutan guna memigrasikan database MySQL (yang berjalan di VM Google Compute Engine) ke Cloud SQL untuk MySQL, menggunakan konektivitas peering VPC.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi
migration-job-name: Nama tugas migrasi
source-connection-profile-id: ID profil koneksi sumber
destination-connection-profile-id: ID profil koneksi tujuan
provider: Penyedia yang terkait dengan jenis klasifikasi database sumber.
- Untuk instance MySQL mandiri, gunakan DATABASE_PROVIDER_UNSPECIFIED karena nilai ini dikaitkan dengan database lokal.
- Untuk instance Cloud SQL untuk MySQL, gunakan CLOUDSQL.
- Untuk layanan database terkelola, gunakan nilai ENUM yang sesuai. Lihat referensi objek DatabaseProvider.
cloud-storage-bucket (opsional): Bucket di Cloud Storage tempat Anda menyimpan file dump.
dump-file (opsional): File dump yang Anda simpan di bucket di Cloud Storage.
Jika Anda ingin memberikan file dump Anda sendiri, simpan file di Cloud Storage, lalu berikan jalurnya.

Anda dapat menyimpan file dump yang di-zip atau tidak di-zip di bucket di Cloud Storage.
- Untuk file zip, gunakan gzip_filename.gz. Contoh, gzip_dump.gz.
- Untuk file yang diekstrak, gunakan filename.sql. Contoh, dump.sql.
flag-name dan flag-value (opsional): Nama dan nilai flag yang Anda tambahkan ke utilitas mysqldump. Utilitas ini membuat file dump.
Anda dapat menambahkan satu atau beberapa flag ke file dump. Misalnya, untuk menambahkan flag max-allowed-packet, ignore-error, dan add-locks ke file, gunakan baris kode berikut:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Untuk informasi selengkapnya tentang flag ini serta flag lain yang dapat Anda tambahkan ke file dump, lihat dokumentasi tentang utilitas mysqldump di Manual Referensi MySQL 8.0.

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Meminta isi JSON:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "vpcPeeringConnectivity": {
    "vpc": "default"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk membuat tugas migrasi Database Migration Service, klik di sini.

Membuat tugas migrasi berkelanjutan dengan konektivitas SSH terbalik

Berikut adalah permintaan untuk membuat tugas migrasi yang terus berjalan untuk memigrasikan database MySQL Amazon RDS ke Cloud SQL untuk MySQL, menggunakan konektivitas SSH terbalik.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi
migration-job-name: Nama tugas migrasi
source-connection-profile-id: ID profil koneksi sumber
destination-connection-profile-id: ID profil koneksi tujuan
vm-name: Nama VM SSH. Misalnya, dms-ssh-bastion.
vm-ip-address: Alamat IP VM SSH. Misalnya, 11.22.33.44.
vm-port: Port koneksi VM SSH. Misalnya, 3306.
vpc-name: Nama jaringan VPC. Misalnya, projects/project-id/global/networks/test-network.
provider: Penyedia yang terkait dengan jenis klasifikasi database sumber.
- Untuk instance MySQL mandiri, gunakan DATABASE_PROVIDER_UNSPECIFIED karena nilai ini dikaitkan dengan database lokal.
- Untuk instance Cloud SQL untuk MySQL, gunakan CLOUDSQL.
- Untuk layanan database terkelola, gunakan nilai ENUM yang sesuai. Lihat referensi objek DatabaseProvider.
cloud-storage-bucket (opsional): Bucket di Cloud Storage tempat Anda menyimpan file dump.
dump-file (opsional): File dump yang Anda simpan di bucket di Cloud Storage.
Jika Anda ingin memberikan file dump Anda sendiri, simpan file di Cloud Storage, lalu berikan jalurnya.

Anda dapat menyimpan file dump yang di-zip atau tidak di-zip di bucket di Cloud Storage.
- Untuk file zip, gunakan gzip_filename.gz. Contoh, gzip_dump.gz.
- Untuk file yang diekstrak, gunakan filename.sql. Contoh, dump.sql.
flag-name dan flag-value (opsional): Nama dan nilai flag yang Anda tambahkan ke utilitas mysqldump. Utilitas ini membuat file dump.
Anda dapat menambahkan satu atau beberapa flag ke file dump. Misalnya, untuk menambahkan flag max-allowed-packet, ignore-error, dan add-locks ke file, gunakan baris kode berikut:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Untuk informasi selengkapnya tentang flag ini serta flag lain yang dapat Anda tambahkan ke file dump, lihat dokumentasi tentang utilitas mysqldump di Manual Referensi MySQL 8.0.

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Meminta isi JSON:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "reverseSshConnectivity": {
    "vm": "vm-name",
    "vm_ip": "vm-ip-address",
    "vm_port": vm-port,
    "vpc": "vpc-name"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk membuat tugas migrasi Database Migration Service, klik di sini.

Membuat tugas migrasi dengan konektivitas daftar IP yang diizinkan

Berikut adalah permintaan untuk membuat tugas migrasi guna memigrasikan instance MySQL mandiri atau layanan database terkelola ke database Cloud SQL untuk MySQL, menggunakan daftar IP yang diizinkan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi
migration-job-name: Nama tugas migrasi
source-connection-profile-id: ID profil koneksi sumber
destination-connection-profile-id: ID profil koneksi tujuan
provider: Penyedia yang terkait dengan jenis klasifikasi database sumber.
- Untuk instance MySQL mandiri, gunakan DATABASE_PROVIDER_UNSPECIFIED karena nilai ini dikaitkan dengan database lokal.
- Untuk instance Cloud SQL untuk MySQL, gunakan CLOUDSQL.
- Untuk layanan database terkelola, gunakan nilai ENUM yang sesuai. Lihat referensi objek DatabaseProvider.
cloud-storage-bucket (opsional): Bucket di Cloud Storage tempat Anda menyimpan file dump.
dump-file (opsional): File dump yang Anda simpan di bucket di Cloud Storage.
Jika Anda ingin memberikan file dump Anda sendiri, simpan file di Cloud Storage, lalu berikan jalurnya.

Anda dapat menyimpan file dump yang di-zip atau tidak di-zip di bucket di Cloud Storage.
- Untuk file zip, gunakan gzip_filename.gz. Contoh, gzip_dump.gz.
- Untuk file yang diekstrak, gunakan filename.sql. Contoh, dump.sql.
flag-name dan flag-value (opsional): Nama dan nilai flag yang Anda tambahkan ke utilitas mysqldump. Utilitas ini membuat file dump.
Anda dapat menambahkan satu atau beberapa flag ke file dump. Misalnya, untuk menambahkan flag max-allowed-packet, ignore-error, dan add-locks ke file, gunakan baris kode berikut:
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
Untuk informasi selengkapnya tentang flag ini serta flag lain yang dapat Anda tambahkan ke file dump, lihat dokumentasi tentang utilitas mysqldump di Manual Referensi MySQL 8.0.

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

Meminta isi JSON:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "staticIpConnectivity": {}
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk membuat tugas migrasi Database Migration Service, klik di sini.

Mendapatkan informasi tentang tugas migrasi

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/migrationJobs/one-time-vpc-job",
  "createTime": "2020-06-12T15:48:39.666093835Z",
  "updateTime": "2020-06-12T15:48:39.666093835Z",
  "displayName": "migration-job-display-name",
  "state": "CREATING",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  
  "sourceDatabase": {
    "engine": "MYSQL"
  },
  "destinationDatabase": {
    "provider": "CLOUDSQL"
  },
  
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang tugas migrasi Anda, klik di sini.

Mencantumkan tugas migrasi

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project

Anda juga dapat memfilter daftar tugas migrasi yang diambil Database Migration Service, sebagai berikut:

orderBy: Gunakan filter ini untuk mengambil listingan semua tugas migrasi untuk region tertentu dalam urutan abjad. Misalnya, filter orderBy=name menampilkan semua tugas migrasi, menurut abjad, berdasarkan nama.
pageSize: Gunakan filter ini untuk menentukan jumlah maksimum tugas migrasi yang diambil dan ditampilkan Database Migration Service di halaman. Misalnya, dengan menetapkan pageSize=10, Database Migration Service akan menampilkan hingga 10 tugas migrasi untuk satu halaman.

Jika ada lebih dari 10 tugas migrasi, tugas tersebut akan muncul di halaman lain. Di akhir setiap halaman, parameter nextPageToken dan ID unik akan muncul (misalnya, oasndfoasdnoasun1241243ojsandf). Gunakan ID untuk mengambil listingan tugas migrasi untuk halaman berikutnya. Di halaman terakhir, parameter nextPageToken dan ID unik tidak muncul.

Metode HTTP dan URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "migrationJobs": [
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-first-migration-job",
      "createTime": "2020-06-12T15:48:39.666093835Z",
      "updateTime": "2020-06-12T15:48:39.666093835Z",
      "displayName": "display-name-of-first-migration-job",
      "state": "NOT_STARTED",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "vpcPeeringConnectivity": {
        "vpc": "default"
      }
    }
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-second-migration-job",
      "createTime": "2021-02-13T11:59:39.104613835Z",
      "updateTime": "2021-02-13T12:01:38.666093835Z",
      "displayName": "display-name-of-second-migration-job",
      "state": "RUNNING",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "staticIpConnectivity": {}
        "vpc": "default"
    }
  ],
  "nextPageToken": "unique-identifier"
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mengambil informasi tentang semua tugas migrasi Anda, klik di sini.

Membuat skrip konfigurasi tunnel SSH untuk tugas migrasi

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript

Meminta isi JSON:

{
  "vm":"vm-name",
  "vmCreationConfig":{
    "vmMachineType":"machine-type",
    "subnet":"subnet-name"
	}
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "generate",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk membuat skrip SSH untuk tugas migrasi Anda, klik di sini.

Memverifikasi tugas migrasi

Berikut adalah permintaan untuk memverifikasi tugas migrasi. Dengan memverifikasi tugas migrasi, Anda dapat memastikan bahwa tugas akan dimulai dan berhasil dijalankan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "verify",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk memverifikasi tugas migrasi, klik di sini.

Memperbarui tugas migrasi

Berikut adalah permintaan untuk memperbarui nama tampilan tugas migrasi yang ada. Dengan menggunakan parameter updateMask dalam permintaan, hanya kolom ini yang perlu disertakan dalam isi permintaan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

PATCH https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName

Meminta isi JSON:

{
  "displayName": "updated-display-name",
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName"

PowerShell (Windows)

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk memperbarui tugas migrasi, klik di sini.

Memulai tugas migrasi

Berikut ini permintaan untuk memulai tugas migrasi.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "start",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk memulai tugas migrasi, klik di sini.

Memulai ulang tugas migrasi yang gagal

Berikut ini permintaan untuk memulai ulang tugas migrasi. Tugas migrasi dapat dimulai ulang dari awal jika migrasi gagal dan tidak dapat dipulihkan, atau dihentikan selama dump penuh.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "restart",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk memulai ulang tugas migrasi, klik di sini.

Menghentikan tugas migrasi

Berikut ini permintaan untuk menghentikan tugas migrasi.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "stop",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk menghentikan tugas migrasi, klik di sini.

Melanjutkan tugas migrasi

Berikut ini permintaan untuk melanjutkan tugas migrasi.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "resume",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk melanjutkan tugas migrasi, klik di sini.

Mempromosikan tugas migrasi

Berikut ini permintaan untuk mempromosikan tugas migrasi.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "promote",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk mempromosikan tugas migrasi, klik di sini.

Menghapus tugas migrasi

Berikut ini permintaan untuk menghapus tugas migrasi.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

project-id: ID project
region: Region project
migration-job-id: ID tugas migrasi

Metode HTTP dan URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

Untuk mengirim permintaan, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id"

PowerShell (Windows)

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

Untuk informasi selengkapnya tentang cara menggunakan gcloud untuk menghapus tugas migrasi, klik di sini.