All Products
Search
Document Center

Data Transmission Service:CreateSynchronizationJob

Last Updated:May 28, 2026

Membeli instans sinkronisasi data.

Sebelum memanggil operasi ini, pastikan Anda telah memahami sepenuhnya metode penagihan dan pricing layanan Data Transmission Service (DTS).

Setelah membeli instans sinkronisasi data, Anda harus memanggil operasi ConfigureSynchronizationJob untuk mengonfigurasi tugas sinkronisasi data. Setelah dikonfigurasi, tugas tersebut akan dimulai secara otomatis.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan, kami menyarankan Anda memanggil operasi ini di OpenAPI Explorer, yang juga secara otomatis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

ParameterTypeRequiredExampleDescription
ActionStringYesCreateSynchronizationJob

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateSynchronizationJob.

DestRegionStringYescn-hangzhou

ID wilayah tempat database tujuan berada. Untuk informasi selengkapnya, lihat Daftar wilayah yang didukung.

Catatan Jika parameter SourceRegion diatur ke wilayah China (Hong Kong) atau wilayah di luar Tiongkok daratan, Anda harus mengatur parameter DestRegion ke ID wilayah yang sama.
PayTypeStringYesPostPaid

Metode penagihan instans sinkronisasi data.

  • PrePaid: subscription
  • PostPaid (nilai default): pay-as-you-go
SourceRegionStringYescn-hangzhou

ID wilayah tempat database sumber berada. Untuk informasi selengkapnya, lihat Daftar wilayah yang didukung.

SynchronizationJobClassStringYessmall

Spesifikasi instans sinkronisasi data. Nilai yang valid: micro, small, medium, dan large.

Catatan Untuk informasi lebih lanjut mengenai kinerja pengujian setiap spesifikasi, lihat Spesifikasi instans sinkronisasi data.
RegionIdStringNocn-hangzhou

ID wilayah tempat instans sinkronisasi data berada. ID wilayah ini sama dengan nilai parameter DestRegion.

TopologyStringNooneway

Topologi sinkronisasi. Nilai yang valid:

  • oneway: Sinkronisasi satu arah
  • bidirectional: Sinkronisasi dua arah
Catatan
  • Nilai default adalah oneway.
  • Parameter ini hanya dapat diatur ke bidirectional jika parameter SourceEndpoint.InstanceType dan DestinationEndpoint.InstanceType diatur ke MySQL, PolarDB, atau Redis.
PeriodStringNoYear

Siklus penagihan instans langganan. Nilai yang valid:

  • Year
  • Month
Catatan Anda hanya perlu menentukan parameter ini jika Anda mengatur parameter PayType ke PrePaid.
UsedTimeIntegerNo1

Durasi langganan.

  • Jika siklus penagihan adalah Year, rentang nilainya adalah 1 hingga 5.
  • Jika siklus penagihan adalah Month, rentang nilainya adalah 1 hingga 60.
Catatan Anda hanya perlu menentukan parameter ini jika Anda mengatur parameter PayType ke PrePaid.
ClientTokenStringNo0c593ea1-3bea-11e9-b96b-88e9fe63****

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

SourceEndpoint.InstanceTypeStringNoMySQL

Jenis instans database sumber. Nilai yang valid:

  • MySQL: Instans ApsaraDB RDS for MySQL atau database MySQL yang dikelola sendiri
  • PolarDB: Kluster PolarDB for MySQL atau kluster PolarDB O Edition
  • Redis: Database Redis
  • DRDS: Instans PolarDB-X V1.0
Catatan
DestinationEndpoint.InstanceTypeStringNoMySQL

Jenis instans database tujuan. Nilai yang valid:

  • MySQL: Instans ApsaraDB RDS for MySQL atau database MySQL yang dikelola sendiri
  • PolarDB: Kluster PolarDB for MySQL atau kluster PolarDB O Edition
  • Redis: Database Redis
  • MaxCompute: Proyek MaxCompute
Catatan
networkTypeStringNoIntranet

Jenis jaringan. Nilai yang valid: Intranet, yang menunjukkan virtual private cloud (VPC).

AccountIdStringNo12323344****

ID Akun Alibaba Cloud. Anda tidak perlu menentukan parameter ini karena parameter ini akan dihapus di masa mendatang.

DBInstanceCountIntegerNo3

Jika Anda mengatur parameter SourceEndpoint.InstanceType ke DRDS, Anda harus menentukan parameter DBInstanceCount. Parameter ini menentukan jumlah instans RDS privat yang disambungkan ke instans PolarDB-X sumber. Nilai default: 1.

Parameter respons

ParameterTypeExampleDescription
ErrCodeStringInternalError

Kode kesalahan yang dikembalikan jika pemanggilan gagal.

ErrMessageStringThe request processing has failed due to some unknown error.

Pesan kesalahan yang dikembalikan jika pemanggilan gagal.

RequestIdString9056C8B0-5799-493A-9655-70F607B8****

ID permintaan.

SuccessStringtrue

Menunjukkan apakah pemanggilan berhasil.

SynchronizationJobIdStringdtshvj11k25255****

ID instans sinkronisasi data.

Contoh

Contoh permintaan

http(s)://dts.aliyuncs.com/?Action=CreateSynchronizationJob
&SourceRegion=cn-hangzhou
&DestRegion=cn-hangzhou
&SynchronizationJobClass=small
&PayType=PostPaid 
&<Common request parameters>

Contoh respons sukses

XML format

<CreateSynchronizationJobResponse>
      <SynchronizationJobId>dtshvj11k25255****</SynchronizationJobId>
      <RequestId>9056C8B0-5799-493A-9655-70F607B8****</RequestId>
      <Success>true</Success>
</CreateSynchronizationJobResponse>

JSON format

{
    "SynchronizationJobId": "dtshvj11k25255****",
    "RequestId": "9056C8B0-5799-493A-9655-70F607B8****",
    "Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.