All Products
Search
Document Center

Data Transmission Service:Kueri status tugas migrasi data

Last Updated:May 28, 2026

Topik ini menjelaskan cara mengkueri status tugas migrasi data menggunakan operasi API lawas.

Uji Coba

Anda dapat langsung memanggil operasi ini di OpenAPI Explorer. Hal ini menghilangkan kebutuhan untuk menghitung signature. Setelah pemanggilan berhasil, OpenAPI Explorer secara otomatis menghasilkan contoh kode untuk berbagai software development kit (SDK).

Parameter permintaan

Parameter

Type

Required

Example

Description

Action String Yes DescribeMigrationJobStatus

Parameter yang diperlukan. Tetapkan nilainya ke DescribeMigrationJobStatus.

RegionId String No cn-hangzhou

ID wilayah tempat instans migrasi data berada. Untuk informasi selengkapnya, lihat Wilayah yang didukung.

MigrationJobId String Yes dtsxxxxxxxx

ID instans migrasi data. Anda dapat memanggil operasi DescribeMigrationJobs untuk mengkueri ID instans tersebut.

ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxxxxx

Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token tersebut, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Parameter ClientToken hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter.

AccountId String No 12323344****

ID Akun Alibaba Cloud. Anda tidak perlu menentukan parameter ini. Parameter ini direncanakan akan dihentikan penggunaannya.

ResourceGroupId String No rg-acfmzawhxxc****

ID kelompok sumber daya.

Parameter respons

Parameter

Type

Example

Description

RequestId String A032E3B4-929B-48E9-97B9-37587CBF****

ID permintaan.

MigrationJobName String MySQL Migration

Nama instans migrasi data.

MigrationJobStatus String Migrating

Status tugas migrasi data. Nilai yang valid:

  • NotStarted: Tugas belum dimulai.
  • Prechecking: Tugas sedang dalam pemeriksaan awal.
  • PrecheckFailed: Tugas gagal dalam pemeriksaan awal.
  • Migrating: Tugas sedang melakukan migrasi data.
  • Suspending: Tugas dijeda.
  • MigrationFailed: Tugas gagal melakukan migrasi data.
  • Finished: Tugas selesai.
ErrCode String InternalError

Kode kesalahan yang dikembalikan jika pemanggilan gagal.

Success String true

Menunjukkan apakah pemanggilan berhasil.

PayType String PostPaid

Metode penagihan tugas migrasi data. Nilainya tetap PostPaid, yang menunjukkan metode penagihan pay-as-you-go.

ErrMessage String The request processing has failed due to some unknown error.

Pesan kesalahan yang dikembalikan jika pemanggilan gagal.

MigrationObject String [{\"DBName\":\"dtstestdata\",\"TableIncludes\":[{\"TableName\":\"customer\"}]}]

Objek yang dimigrasikan.

MigrationJobId String dtsxxxxxxxx

ID instans migrasi data.

TaskId String z2v12jfo309****

ID tugas migrasi data.

MigrationJobClass String 2xlarge

Spesifikasi instans migrasi data. Nilai yang valid: small, medium, large, xlarge, dan 2xlarge. Untuk informasi selengkapnya, lihat Spesifikasi instans migrasi data.

DataInitializationStatus Object

Status sinkronisasi data penuh awal.

Status String Finished

Status sinkronisasi data penuh awal. Nilai yang valid:

  • NotStarted: Belum dimulai.
  • Migrating: Sedang berlangsung.
  • Failed: Gagal.
  • Finished: Selesai.
Percent String 100

Kemajuan sinkronisasi data penuh awal. Satuan: persentase.

ErrorMessage String java.lang.NumberFormatException: For input string: ""

Pesan kesalahan yang dikembalikan jika sinkronisasi data penuh awal gagal.

Progress String 200001

Jumlah catatan yang telah disinkronkan selama sinkronisasi data penuh awal.

DataSynchronizationStatus Object

Status migrasi data inkremental.

Status String Catched

Status migrasi data inkremental. Nilai yang valid:

  • NotStarted: Belum dimulai.
  • Migrating: Sedang berlangsung.
  • Failed: Gagal.
  • Finished: Selesai.
  • Catched: Tidak ada latensi.
Percent String 95

Kemajuan migrasi data inkremental. Satuan: persentase.

Delay String 0

Latensi migrasi data inkremental. Satuan: detik.

ErrorMessage String The task failed and cannot be recovered.

Pesan kesalahan yang dikembalikan jika migrasi data inkremental gagal.

Checkpoint String 1571040679

Stempel waktu UNIX dari data inkremental terbaru yang telah dimigrasikan. Satuan: detik.

DestinationEndpoint Object

Pengaturan koneksi instans tujuan.

DatabaseName String dtstestdata

Nama database tempat objek migrasi pada instans tujuan berada.

InstanceId String rm-bpxxxxxxxx

ID instans tujuan.

IP String 172.16.88.***

Titik akhir instans tujuan.

InstanceType String RDS

Tipe instans tujuan.

Port String 3306

Port layanan database instans tujuan.

UserName String dtstest

Akun database instans tujuan.

oracleSID String testsid

Sistem ID (SID) database Oracle.

Catatan Parameter ini hanya dikembalikan jika tipe database instans tujuan adalah Oracle.
EngineName String MySQL

Tipe database instans tujuan.

MigrationMode Object

Jenis migrasi.

dataInitialization Boolean true

Menunjukkan apakah akan melakukan sinkronisasi data penuh awal. Nilai yang valid:

  • true: Ya.
  • false: Tidak.
dataSynchronization Boolean false.

Menunjukkan apakah akan melakukan migrasi data inkremental. Nilai yang valid:

  • true: Ya.
  • false: Tidak.
structureInitialization Boolean false.

Menunjukkan apakah akan melakukan migrasi skema. Nilai yang valid:

  • true: Ya.
  • false: Tidak.
PrecheckStatus Object

Hasil pemeriksaan awal.

Status String Success

Status pemeriksaan awal. Nilai yang valid:

  • NotStarted: Belum dimulai.
  • Checking: Sedang berlangsung.
  • Failed: Gagal.
  • Finished: Selesai.
Percent String 100

Kemajuan keseluruhan pemeriksaan awal. Satuan: persentase.

Detail Array of CheckItem

Hasil pemeriksaan setiap item pemeriksaan awal.

CheckItem
CheckStatus String Success

Hasil pemeriksaan. Nilai yang valid:

  • Success: Tugas lulus pemeriksaan.
  • Failed: Tugas gagal dalam pemeriksaan.
ErrorMessage String Original error: Access denied for user 'dtstest'@'100.104.***.**' (using password: YES)

Pesan kesalahan yang dikembalikan jika tugas gagal dalam pemeriksaan awal.

Catatan Parameter ini hanya dikembalikan jika nilai parameter CheckStatus adalah Failed.
ItemName String CHECK_CONN_SRC

Item pemeriksaan awal.

RepairMethod String CHECK_ERROR_DEST_CONN_REPAIR2

Metode untuk memperbaiki kegagalan pemeriksaan awal.

Catatan Parameter ini hanya dikembalikan jika nilai parameter CheckStatus adalah Failed.
SourceEndpoint Object

Pengaturan koneksi instans sumber.

DatabaseName String dtstestdatabase

Nama database tempat objek migrasi pada instans sumber berada.

InstanceId String rm-bp1i99e8l7913****

ID instans sumber.

IP String 172.16.88.***

Titik akhir instans sumber.

InstanceType String RDS

Tipe instans sumber. Nilai yang valid:

  • RDS: Instans ApsaraDB RDS.
  • ECS: Database yang dikelola sendiri dan dihosting pada instans ECS.
  • LocalInstance: Database yang dikelola sendiri dengan alamat IP publik.
  • Express: Database yang dikelola sendiri yang terhubung melalui jalur sewa, VPN Gateway, atau Smart Access Gateway.
  • MongoDB: Instans ApsaraDB for MongoDB.
  • POLARDB: Kluster PolarDB for MySQL. Nilai ini hanya tersedia di Alibaba Cloud China Website (www.aliyun.com).
Port String 3306

Port layanan database instans sumber.

UserName String dtstest

Akun database instans sumber.

oracleSID String testsid

SID database Oracle.

Catatan Parameter ini hanya dikembalikan ketika tipe database sumber adalah Oracle.
EngineName String MySQL

Tipe database instans sumber.

StructureInitializationStatus Object

Status migrasi skema.

Status String Finished

Status migrasi skema. Nilai yang valid:

  • NotStarted: Belum dimulai.
  • Migrating: Sedang berlangsung.
  • Failed: Gagal.
  • Finished: Selesai.
Percent String 100

Kemajuan migrasi skema. Satuan: persentase.

ErrorMessage String DTS-1020042 Execute sql error sql: ERROR: type "geometry" does not exist;

Pesan kesalahan yang dikembalikan jika migrasi skema gagal.

Progress String 1

Jumlah tabel yang skemanya telah dimigrasikan.

Contoh

Permintaan contoh

Respons sukses contoh

JSON format

HTTP/1.1 200 OK

Kode kesalahan

HttpCode

Error code

Error message

Description

400 Throttling.User Request was denied due to user flow control. Permintaan ditolak karena pembatasan kecepatan tingkat pengguna. Coba lagi nanti.
403 InvalidSecurityToken.Expired Specified SecurityToken is expired. Token keamanan yang ditentukan telah kedaluwarsa. Perbarui signature.
500 ServiceUnavailable The request has failed due to a temporary failure of the server. Permintaan gagal karena server mengalami timeout atau tidak tersedia. Ulangi permintaan tersebut. Jika masalah berlanjut, hubungi dukungan teknis.

Untuk kode kesalahan lainnya, lihat Pusat Kesalahan.