All Products
Search

This Product

    Data Transmission Service:ConfigureSubscriptionInstance

    Document Center

    Data Transmission Service:ConfigureSubscriptionInstance

    Last Updated:May 28, 2026

    Konfigurasikan instans pelacakan perubahan.

    Sebelum memanggil operasi ini, Anda harus terlebih dahulu memanggil operasi CreateSubscriptionInstance untuk membuat instans pelacakan perubahan.

    Debugging

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

    Parameter permintaan

    Parameter Tipe Wajib Contoh Deskripsi
    Action String Ya ConfigureSubscriptionInstance

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ConfigureSubscriptionInstance.

    SubscriptionDataType.DDL Boolean Ya true

    Menentukan apakah akan melacak pernyataan DDL. Nilai default: true. Nilai yang valid:

    • true: melacak pernyataan DDL.
    • false: tidak melacak pernyataan DDL.
    SubscriptionDataType.DML Boolean Ya true

    Menentukan apakah akan melacak pernyataan DML. Nilai default: true. Nilai yang valid:

    • true: melacak pernyataan DML.
    • false: tidak melacak pernyataan DML.
    SubscriptionObject String Ya [{ "DBName": "dtstestdata" }]

    Objek yang ingin Anda lacak perubahan datanya. Nilainya berupa string JSON dan dapat berisi ekspresi reguler. Untuk informasi selengkapnya, lihat SubscriptionObjects.

    SubscriptionInstanceId String Ya dtshp8n2ze4r5x****

    ID instans pelacakan perubahan. Anda dapat memanggil operasi DescribeSubscriptionInstances untuk menanyakan ID instans tersebut.

    RegionId String Tidak cn-hangzhou

    ID wilayah tempat instans pelacakan perubahan berada. Untuk informasi selengkapnya, lihat Daftar wilayah yang didukung.

    SubscriptionInstanceName String Tidak MySQL Change Tracking

    Nama instans pelacakan perubahan.

    Catatan Kami menyarankan agar Anda menentukan nama yang informatif agar mudah diidentifikasi. Nama ini tidak perlu unik.
    SourceEndpoint.InstanceType String Tidak RDS

    Jenis database sumber. Nilai yang valid:

    • RDS: Instans ApsaraDB RDS untuk MySQL
    • PolarDB: Kluster PolarDB for MySQL
    • LocalInstance: Database yang dikelola sendiri dengan alamat IP publik
    • ECS: Database yang dikelola sendiri yang dihosting pada instans Elastic Compute Service (ECS)
    • Express: Database yang dikelola sendiri yang terhubung melalui Express Connect
    • CEN: Database yang dikelola sendiri yang terhubung melalui Cloud Enterprise Network (CEN)
    • dg: Database yang dikelola sendiri yang terhubung melalui Database Gateway
    Catatan Mesin database yang dikelola sendiri dapat berupa MySQL atau Oracle. Anda harus menentukan tipe mesin saat memanggil operasi CreateSubscriptionInstance.
    SourceEndpoint.InstanceID String Tidak rm-bp1zc3iyqe3qw****

    ID database sumber.

    Catatan Parameter ini wajib hanya jika database sumber merupakan instans ApsaraDB RDS untuk MySQL, instans PolarDB-X 1.0, atau kluster PolarDB for MySQL.
    SourceEndpoint.IP String Tidak 172.16.88.***

    Alamat IP database sumber.

    Catatan Parameter ini wajib hanya jika database sumber merupakan database yang dikelola sendiri.
    SourceEndpoint.Port String Tidak 3306

    Nomor port layanan database sumber.

    Catatan Parameter ini wajib hanya jika database sumber merupakan database yang dikelola sendiri.
    SourceEndpoint.UserName String Tidak dtstestaccount

    Username akun yang digunakan untuk menghubungkan ke database sumber.

    Catatan Izin yang diperlukan untuk akun database bervariasi tergantung skenario pelacakan perubahan. Untuk informasi selengkapnya, lihat Ikhtisar skenario pelacakan perubahan.
    SourceEndpoint.Password String Tidak Test123456

    Password akun yang digunakan untuk menghubungkan ke database sumber.

    SourceEndpoint.OracleSID String Tidak testsid

    System ID (SID) database Oracle.

    Catatan Parameter ini wajib hanya jika database sumber merupakan database Oracle yang dikelola sendiri dan tidak diterapkan dalam arsitektur Real Application Clusters (RAC).
    SourceEndpoint.DatabaseName String Tidak dtstestdata

    Nama database sumber.

    SourceEndpoint.OwnerID String Tidak 140692647406****

    ID Akun Alibaba Cloud tempat database sumber berada.

    Catatan Parameter ini wajib hanya jika Anda melacak perubahan data lintas akun Alibaba Cloud yang berbeda.
    SourceEndpoint.Role String Tidak ram-for-dts

    Peran RAM yang diberi otorisasi untuk mengakses database sumber. Parameter ini wajib jika database sumber tidak dimiliki oleh Akun Alibaba Cloud yang Anda gunakan untuk mengonfigurasi instans pelacakan perubahan. Dalam hal ini, Anda harus memberikan otorisasi kepada Akun Alibaba Cloud untuk mengakses database sumber melalui peran RAM.

    Catatan Untuk informasi selengkapnya mengenai izin yang diperlukan untuk peran RAM dan cara memberikan izin kepada peran RAM, lihat Konfigurasi otorisasi RAM untuk migrasi dan sinkronisasi data cross-account.
    SubscriptionInstanceNetworkType String Tidak vpc

    Jenis jaringan instans pelacakan perubahan. Tetapkan nilainya ke vpc. Nilai vpc menunjukkan jenis jaringan Virtual Private Cloud (VPC).

    Catatan
    • Untuk menggunakan versi baru fitur pelacakan perubahan, Anda harus menentukan parameter SubscriptionInstanceNetworkType. Anda juga harus menentukan parameter SubscriptionInstance.VPCId dan SubscriptionInstance.VSwitchID. Jika Anda tidak menentukan parameter SubscriptionInstanceNetworkType, versi sebelumnya dari fitur pelacakan perubahan akan digunakan.
    • Versi sebelumnya fitur pelacakan perubahan mendukung database MySQL yang dikelola sendiri, instans ApsaraDB RDS untuk MySQL, dan instans PolarDB-X 1.0. Versi baru fitur pelacakan perubahan mendukung database MySQL yang dikelola sendiri, instans ApsaraDB RDS untuk MySQL, kluster PolarDB for MySQL, dan database Oracle.
    SubscriptionInstance.VPCId String Tidak vpc-bp1vwnn14rqpyiczj****

    ID VPC tempat instans pelacakan perubahan ditempatkan.

    Catatan Parameter ini wajib hanya jika parameter SubscriptionInstanceNetworkType ditetapkan ke vpc.
    SubscriptionInstance.VSwitchId String Tidak vsw-bp10df3mxae6lpmku****

    ID vSwitch di VPC yang ditentukan.

    Catatan Parameter ini wajib hanya jika parameter SubscriptionInstanceNetworkType ditetapkan ke vpc.
    AccountId String Tidak 12323344****

    ID Akun Alibaba Cloud. Anda tidak perlu menentukan parameter ini karena parameter ini sudah tidak digunakan lagi.

    Parameter respons

    Parameter Tipe Contoh Deskripsi
    ErrCode String InternalError

    Kode kesalahan yang dikembalikan jika permintaan gagal.

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

    Pesan kesalahan yang dikembalikan jika permintaan gagal.

    RequestId String 0CC15092-8957-4532-B559-B4FB80AC****

    ID permintaan.

    Success String true

    Menunjukkan apakah permintaan berhasil.

    Contoh

    Contoh permintaan

    http(s)://dts.aliyuncs.com/?Action=ConfigureSubscriptionInstance
&SubscriptionDataType.DDL=true
&SubscriptionDataType.DML=true
&SubscriptionInstanceId=dtshp8n2ze4r5x****
&SubscriptionObject=[{"DBName":"dtstestdata","TableIncludes":[{"TableName":"customer"}]}]
&<Common request parameters>

    Contoh respons sukses

    XML format

    <ConfigureSubscriptionInstanceResponse>
      <RequestId>0CC15092-8957-4532-B559-B4FB80AC****</RequestId>
      <Success>true</Success>
</ConfigureSubscriptionInstanceResponse>

    JSON format

    {
	"RequestId": "0CC15092-8957-4532-B559-B4FB80AC****",
	"Success": true
}

    Kode kesalahan

    Untuk daftar kode kesalahan, kunjungi API Error Center.