All Products
Search
Document Center

PolarDB:DescribeDBClusterMigration

Last Updated:Dec 15, 2025

Menanyakan status migrasi kluster PolarDB.

Deskripsi operasi

  • Anda dapat menggunakan operasi ini untuk menanyakan status migrasi satu klik dari instans ApsaraDB RDS for MySQL ke kluster PolarDB for MySQL. Untuk informasi selengkapnya, lihat Upgrade an ApsaraDB RDS for MySQL instance to PolarDB for MySQL.

  • Sebelum memanggil operasi ini, Anda harus membuat task upgrade satu klik untuk kluster tersebut dengan memanggil operasi CreateDBCluster dan mengatur parameter CreationOption ke MigrationFromRDS.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

polardb:DescribeDBClusterMigration

get

*dbcluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DBClusterId

string

Yes

ID kluster.

pc-**************

Elemen respons

Element

Type

Description

Example

object

DBClusterEndpointList

array<object>

Detail titik akhir PolarDB.

array<object>

AddressItems

array<object>

Detail string koneksi.

object

VSwitchId

string

ID virtual switch.

vsw-**********

ConnectionString

string

String koneksi.

pc-**************.rwlb.rds.aliyuncs.com

NetType

string

Jenis jaringan titik akhir. Nilai yang valid:

  • Public: Titik akhir untuk Internet.

  • Private: Titik akhir pribadi.

  • Inner: Titik akhir pribadi di jaringan klasik.

Private

Port

string

Port.

3306

VPCId

string

ID virtual private cloud (VPC).

vpc-**********

IPAddress

string

Alamat IP.

192.***.***.10

SSLEnabled

string

Menunjukkan apakah enkripsi Secure Sockets Layer (SSL) diaktifkan. Nilai yang valid:

  • Enabled: Enkripsi SSL diaktifkan.

  • Disabled: Enkripsi SSL dinonaktifkan.

Enabled

DBEndpointId

string

ID titik akhir.

pe-***********

EndpointType

string

Jenis titik akhir. Nilai yang valid:

  • Cluster: Titik akhir kluster default.

  • Primary: Titik akhir utama.

  • Custom: Titik akhir kluster kustom.

Cluster

ReadWriteMode

string

Mode baca/tulis. Nilai yang valid:

  • ReadWrite: Baca dan tulis (pemisahan baca/tulis otomatis).

  • ReadOnly (Default): Read-only.

ReadOnly

Comment

string

Komentar mengenai pengecualian migrasi. Jika tidak terjadi pengecualian selama migrasi, nilai kosong akan dikembalikan.

test

RequestId

string

ID permintaan.

F2A9EFA7-915F-4572-8299-85A307******

ExpiredTime

string

Waktu kedaluwarsa hubungan replikasi antara instans ApsaraDB RDS dan kluster PolarDB. Waktu dalam format YYYY-MM-DDThh:mm:ssZ dan ditampilkan dalam UTC.

2020-06-17T01:56:36Z

DBClusterId

string

ID kluster.

pc-****************

Topologies

string

Hubungan sinkronisasi data. Nilai yang valid:

  • RDS2POLARDB: Data disinkronkan dari instans ApsaraDB RDS ke kluster PolarDB.

  • POLARDB2RDS: Data disinkronkan dari kluster PolarDB ke instans ApsaraDB RDS.

RDS2POLARDB

RdsReadWriteMode

string

Mode baca/tulis instans ApsaraDB RDS sumber. Nilai yang valid:

  • rw: Baca dan tulis.

  • ro: Read-only.

rw

SourceRDSDBInstanceId

string

ID instans ApsaraDB RDS sumber.

rm-************

DBClusterReadWriteMode

string

Mode baca/tulis kluster. Nilai yang valid:

  • rw: Baca dan tulis.

  • ro: Read-only.

ro

DelayedSeconds

integer

Latensi replikasi antara instans ApsaraDB RDS dan kluster PolarDB, dalam detik.

0

MigrationStatus

string

Status migrasi kluster PolarDB. Nilai yang valid:

  • NO_MIGRATION: Tidak ada task migrasi yang dibuat.

  • RDS2POLARDB_CLONING: Data sedang dikloning.

  • RDS2POLARDB_SYNCING: Data sedang disinkronkan. Dalam status ini, kluster PolarDB bersifat read-only, dan instans ApsaraDB RDS bersifat read-write.

  • SWITCHING: Database sedang dialihkan.

  • POLARDB2RDS_SYNCING: Pengalihan database selesai. Dalam status ini, kluster PolarDB bersifat read-write, dan instans ApsaraDB RDS bersifat read-only. Ubah titik akhir di aplikasi Anda.

  • ROLLBACK: Migrasi sedang dikembalikan. Setelah rollback selesai, status migrasi berubah menjadi RDS2POLARDB_SYNCING.

  • CLOSING_MIGRATION: Task migrasi sedang dimatikan.

RDS2POLARDB_SYNCING

DtsInstanceId

string

ID task sinkronisasi.

dts**********618bs

RdsEndpointList

array<object>

Detail titik akhir ApsaraDB RDS.

array<object>

AddressItems

array<object>

Detail string koneksi.

object

VSwitchId

string

ID vSwitch.

vsw-**************

ConnectionString

string

String koneksi.

rm-***********.mysql.rds.aliyuncs.com

NetType

string

Jenis jaringan titik akhir. Nilai yang valid:

  • Public: Titik akhir untuk Internet.

  • Private: Titik akhir pribadi.

  • Inner: Titik akhir pribadi di jaringan klasik.

Private

Port

string

Port.

3306

VPCId

string

ID VPC.

vpc-************

IPAddress

string

Alamat IP.

172.***.***.173

SSLEnabled

string

Menunjukkan apakah enkripsi SSL diaktifkan. Nilai yang valid:

  • Enabled: Enkripsi SSL diaktifkan.

  • Disabled: Enkripsi SSL dinonaktifkan.

Enabled

DBEndpointId

string

ID titik akhir.

rm-************-normal

EndpointType

string

Jenis titik akhir. Nilai yang valid:

  • Normal: Titik akhir reguler.

  • ReadWriteSplitting: Titik akhir pemisahan baca/tulis.

Normal

CustinsType

string

Tipe instans.

ReadOnly Maxscale Primary

SrcDbType

string

Jenis database sumber. Nilai yang valid:

  • PolarDBMySQL: Database sumber untuk peningkatan versi utama kluster PolarDB.

  • RDS: Database sumber untuk migrasi data dari instans ApsaraDB RDS ke kluster PolarDB for MySQL.

PolarDBMySQL

Contoh

Respons sukses

JSONformat

{
  "DBClusterEndpointList": [
    {
      "AddressItems": [
        {
          "VSwitchId": "vsw-**********",
          "ConnectionString": "pc-**************.rwlb.rds.aliyuncs.com",
          "NetType": "Private",
          "Port": "3306",
          "VPCId": "vpc-**********",
          "IPAddress": "192.***.***.10",
          "SSLEnabled": "Enabled"
        }
      ],
      "DBEndpointId": "pe-***********",
      "EndpointType": "Cluster",
      "ReadWriteMode": "ReadOnly"
    }
  ],
  "Comment": "test",
  "RequestId": "F2A9EFA7-915F-4572-8299-85A307******",
  "ExpiredTime": "2020-06-17T01:56:36Z",
  "DBClusterId": "pc-****************",
  "Topologies": "RDS2POLARDB",
  "RdsReadWriteMode": "rw",
  "SourceRDSDBInstanceId": "rm-************",
  "DBClusterReadWriteMode": "ro",
  "DelayedSeconds": 0,
  "MigrationStatus": "RDS2POLARDB_SYNCING",
  "DtsInstanceId": "dts**********618bs",
  "RdsEndpointList": [
    {
      "AddressItems": [
        {
          "VSwitchId": "vsw-**************",
          "ConnectionString": "rm-***********.mysql.rds.aliyuncs.com",
          "NetType": "Private",
          "Port": "3306",
          "VPCId": "vpc-************",
          "IPAddress": "172.***.***.173",
          "SSLEnabled": "Enabled"
        }
      ],
      "DBEndpointId": "rm-************-normal",
      "EndpointType": "Normal",
      "CustinsType": "ReadOnly\nMaxscale\nPrimary"
    }
  ],
  "SrcDbType": "PolarDBMySQL"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.