Tüm Ürünler
Search
Belge Merkezi

Data Transmission Service:DescribeSynchronizationJobs

Son Güncelleme:Oct 05, 2026

Veri senkronizasyonu örneklerini ve ayrıntılarını listelemek için bu API'yi kullanın.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Zorunlu

Örnek

Açıklama

Action

String

Evet

DescribeSynchronizationJobs

API eylemi. Geçerli değer: DescribeSynchronizationJobs

RegionId

String

Hayır

cn-hangzhou

Veri senkronizasyonu örneğinin bölge kimliği. Daha fazla bilgi için bkz. Desteklenen bölgelerin listesi.

PageSize

Integer

Hayır

30

Her sayfada döndürülecek kayıt sayısı. Geçerli değerler: 10, 20 ve 30. Varsayılan değer: 30. Maksimum değer: 30.

PageNum

Integer

Hayır

1

Sayfa numarası. Değer 0'dan büyük olmalı ve Integer veri türünün maksimum değerini aşmamalıdır. Varsayılan değer: 1.

SynchronizationJobName

String

Hayır

MySQL Synchronization

Veri senkronizasyonu görevinin adı.

Not

Bulanık eşleştirme desteklenir.

ClientToken

String

Hayır

0c593ea1-3bea-11e9-b96b-88e9fe63****

İstemcinin her istek için benzersizliğini sağlamak amacıyla ürettiği benzersiz değerdir. Yalnızca ASCII karakterlerini destekler ve 64 karakteri aşamaz.

AccountId

String

Hayır

12323344****

Alibaba Cloud hesap kimliğiniz. Yakında kaldırılacağından bu parametreyi ayarlamanız gerekmez.

Tag.N.Key

String

Evet

testkey1

Etiket anahtarı. Bu değeri ListTagResources API'sini çağırarak alabilirsiniz.

Not
  • N, etiketin sıra numarasını belirtir. Örneğin Tag.1.Key ilk etiketin anahtarını, Tag.2.Key ise ikinci etiketin anahtarını belirtir. Bir seferde 1 ila 20 etiket anahtarı belirtebilirsiniz.

  • Bu parametre boş bir dize olamaz.

Tag.N.Value

String

Hayır

testvalue1

Etiket değeri. Bu değeri ListTagResources API'sini çağırarak alabilirsiniz.

Not
  • N, etiketin sıra numarasını belirtir. Örneğin Tag.1.Value ilk etiketin değerini, Tag.2.Value ise ikinci etiketin değerini belirtir. Bir seferde 1 ila 20 etiket değeri belirtebilirsiniz.

  • Etiket değeri boş bir dize olabilir.

ResourceGroupId

String

Hayır

rg-acfmzawhxxc****

Kaynak grubu kimliği.

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

PageNumber

Integer

1

Döndürülen sonuçların sayfa numarası.

RequestId

String

92E1E99D-5224-4AD3-8C94-23A3516B****

Benzersiz istek kimliği.

PageRecordCount

Integer

30

Geçerli sayfada görüntülenebilecek maksimum kayıt sayısı.

TotalRecordCount

Long

100

Alibaba Cloud hesabınıza ait toplam veri senkronizasyonu örneği sayısı.

SynchronizationInstances

Array of SynchronizationInstance

Veri senkronizasyonu örneklerinin ve ayrıntılarının listesi.

DataInitialization

String

true

Tam veri senkronizasyonunun yapılıp yapılmadığını gösterir. Geçerli değerler:

  • true: evet.

  • false: hayır.

Status

String

synchronizing

Veri senkronizasyonu görevinin mevcut durumu. Geçerli değerler:

  • NotStarted: Görev başlatılmadı.

  • Prechecking: Görev ön denetimden geçiriliyor.

  • PrecheckFailed: Görev ön denetimi geçemedi.

  • Initializating : Görev ilk senkronizasyonu gerçekleştiriyor.

  • InitializeFailed: İlk senkronizasyon başarısız oldu.

  • Synchronizing: Görev verileri senkronize ediyor.

  • Failed: Görev veri senkronizasyonunu tamamlayamadı.

  • Suspending: Görev duraklatıldı.

  • Modifying: Görevdeki nesneler değiştiriliyor.

  • Finished: Görev tamamlandı.

SynchronizationJobName

String

MySQL Synchronization

Veri senkronizasyonu görevinin adı.

Delay

String

0

Senkronizasyon gecikme süresi.

Birim: saniye.

ErrorMessage

String

DTS-070211: Connect Source DB failed. cause by [com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException:Could not create connection to database server. Attempted reconnect 3 times. Giving up.][com.mysql.jdbc.exceptions.jdbc4.CommunicationsException:Communications link failure\n\nThe last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.][java.net.ConnectException:Connection timed out (Connection timed out)] About more information in [https://yq.aliyun.com/articles/499178].

Veri senkronizasyonu başarısız olduğunda döndürülen hata mesajı.

ExpireTime

String

2021-07-07T16:00:00Z

Veri senkronizasyonu örneğinin sona erme zamanı. Format: UTC saat diliminde yyyy-MM-ddTHH:mm:ssZ.

Not

Bu parametre yalnızca PayType parametresinin dönüş değeri PrePaid olduğunda döndürülür.

CreateTime

String

2021-06-28 17:34:53.0

Veri senkronizasyonu görevinin oluşturulma zamanı. Format: UTC+8 saat diliminde yyyy-MM-dd HH:mm:ss.0.

PayType

String

PrePaid

Veri senkronizasyonu örneğinin faturalama yöntemi. Geçerli değerler:

  • PrePaid: abonelik.

  • PostPaid: kullandıkça öde.

StructureInitialization

String

true

Şema senkronizasyonunun yapılıp yapılmadığını gösterir. Geçerli değerler:

  • true: evet

  • false: hayır

SynchronizationJobClass

String

large

Veri senkronizasyonu örneğinin teknik özellikleri.

InstanceCreateTime

String

2021-06-28T09:36:32Z

Örneğin oluşturulma zamanı. Format: UTC saat diliminde yyyy-MM-ddTHH:mm:ssZ.

SynchronizationJobId

String

dtsexjk1alb116****

Veri senkronizasyonu örneğinin kimliği.

SynchronizationDirection

String

Forward

Senkronizasyon yönü. Geçerli değerler:

  • Forward: ileri.

  • Reverse: geri.

JobCreateTime

String

2021-06-28T09:34:53Z

Veri senkronizasyonu görevinin oluşturulma zamanı. Format: UTC saat diliminde yyyy-MM-ddTHH:mm:ssZ.

Tags

Array of Tag

Etiket koleksiyonu.

Key

String

testkey1

Etiket anahtarı.

Value

String

testvalue1

Etiket anahtarına karşılık gelen etiket değeri.

SynchronizationObjects

Array of SynchronizationObject

Görev tarafından senkronize edilen nesneler.

NewSchemaName

String

newdtstestdatabase

Hedef örnekte kullanılan veritabanı adı.

SchemaName

String

dtstestdatabase

Senkronize edilen veritabanının adı.

TableExcludes

Array of TableExclude

Veri senkronizasyonu görevinden hariç tutulan kaynak tablolar.

TableName

String

order

Hariç tutulan tablonun adı.

TableIncludes

Array of TableInclude

Görev tarafından senkronize edilen tablolar.

TableName

String

customer

Senkronize edilen tablonun adı.

DataInitializationStatus

Object

Tam veri senkronizasyonunun durumu.

Status

String

Finished

Tam veri senkronizasyonunun durumu. Geçerli değerler:

  • NotStarted: Tam veri senkronizasyonu başlatılmadı.

  • Migrating: Tam veri senkronizasyonu devam ediyor.

  • Failed: Tam veri senkronizasyonu başarısız oldu.

  • Finished: Tam veri senkronizasyonu tamamlandı.

Percent

String

100

Tam veri senkronizasyonunun ilerleme durumu. Birim: %.

ErrorMessage

String

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

Tam veri senkronizasyonu başarısız olduğunda döndürülen hata mesajı.

Progress

String

200001

Tam veri senkronizasyonu sırasında senkronize edilen kayıt sayısı.

DataSynchronizationStatus

Object

Artımlı veri senkronizasyonunun durumu.

Not

Bu parametre ve alt parametreleri artık kullanılamamaktadır.

Status

String

Finished

Artımlı veri senkronizasyonunun durumu.

Not

Bu parametre artık kullanılamamaktadır.

Delay

String

0

Artımlı veri senkronizasyonunun gecikme süresi.

Not

Bu parametre artık kullanılamamaktadır.

Percent

String

100

Artımlı veri senkronizasyonunun ilerleme durumu.

Not

Bu parametre artık kullanılamamaktadır.

ErrorMessage

String

The task has failed for a long time and cannot be recovered

Artımlı veri senkronizasyonu başarısız olduğunda döndürülen hata mesajı.

Not

Bu parametre artık kullanılamamaktadır.

DestinationEndpoint

Object

Hedef örneğin bağlantı ayarları.

InstanceId

String

rm-bp162d4tp0500****

Hedef örneğin kimliği.

IP

String

172.16.88.***

Hedef örneğin uç noktası.

InstanceType

String

RDS

Hedef örneğin türü.

Port

String

3306

Hedef örneğin veritabanı hizmet bağlantı noktası.

UserName

String

dtstest

Hedef örneğin veritabanı hesabı.

EngineName

String

MySQL

Hedef örneğin veritabanı türü.

Performance

Object

Veri senkronizasyonu örneğinin performansı.

RPS

String

100

Saniyede senkronize edilen SQL deyimi sayısı. Buna BEGIN, COMMIT, DML ve DDL deyimleri dahildir. DML deyimleri INSERT, DELETE ve UPDATE deyimlerini içerir.

FLOW

String

1

Saniyede senkronize edilen veri trafiği. Birim: MB/s.

PrecheckStatus

Object

Ön denetim durumu.

Status

String

Success

Ön denetim sonucu. Geçerli değerler:

  • Success: Görev ön denetimi geçti.

  • Failed: Görev ön denetimi geçemedi.

Percent

String

100

Ön denetim ilerleme durumu.

Birim: %.

Detail

Array of CheckItem

Her bir ön denetim öğesinin sonucu.

CheckStatus

String

Success

Ön denetim sonucu. Geçerli değerler:

  • Success: Görev ön denetimi geçti.

  • Failed: Görev ön denetimi geçemedi.

ErrorMessage

String

Original error: Access denied for user 'dtstest'@'100.104.*.' (using password: YES)

Görev ön denetimi geçemediğinde döndürülen hata mesajı.

Not

Bu parametre yalnızca CheckStatus parametresinin dönüş değeri Failed olduğunda döndürülür.

ItemName

String

CHECK_CONN_SRC

Ön denetim öğesinin adı.

RepairMethod

String

CHECK_ERROR_DEST_CONN_REPAIR2

Ön denetim hatasını düzeltme yöntemi.

Not

Bu parametre yalnızca CheckStatus parametresinin dönüş değeri Failed olduğunda döndürülür.

SourceEndpoint

Object

Kaynak örneğin bağlantı ayarları.

InstanceId

String

rm-bp1i99e8l7913****

Kaynak örneğin kimliği.

IP

String

172.16.88.***

Kaynak örneğin uç noktası.

InstanceType

String

RDS

Kaynak örneğin türü.

Port

String

3306

Kaynak örneğin veritabanı hizmet bağlantı noktası.

UserName

String

dtstest

Kaynak örneğin veritabanı hesabı.

EngineName

String

MySQL

Kaynak örneğin veritabanı türü.

StructureInitializationStatus

Object

Şema senkronizasyonunun durumu.

Status

String

Finished

Şema senkronizasyonunun durumu. Geçerli değerler:

  • NotStarted: Şema senkronizasyonu başlatılmadı.

  • Migrating : Şema senkronizasyonu devam ediyor.

  • Failed : Şema senkronizasyonu başarısız oldu.

  • Finished: Şema senkronizasyonu tamamlandı.

Percent

String

100

Şema senkronizasyonunun ilerleme durumu. Birim: %.

ErrorMessage

String

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

Şema senkronizasyonu başarısız olduğunda döndürülen hata mesajı.

Progress

String

1

Şemaları senkronize edilen tablo sayısı.

Örnekler

Örnek istekler

http(s)://dts.aliyuncs.com/?Action=DescribeSynchronizationJobs
&Tag.1.Key=testkey1
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSynchronizationJobsResponse>
    <TotalRecordCount>100</TotalRecordCount>
    <SynchronizationInstances>
        <Status>synchronizing</Status>
        <SynchronizationObjects>
            <SchemaName>dtstestdatabase</SchemaName>
            <NewSchemaName>newdtstestdatabase</NewSchemaName>
        </SynchronizationObjects>
        <DataInitializationStatus>
            <Status>Finished</Status>
            <Progress>200001</Progress>
            <Percent>100</Percent>
        </DataInitializationStatus>
        <SynchronizationJobName>MySQL Synchronization</SynchronizationJobName>
        <InstanceCreateTime>2021-06-28T09:36:32Z</InstanceCreateTime>
        <CreateTime>2021-06-28 17:34:53.0</CreateTime>
        <JobCreateTime>2021-06-28T09:34:53Z</JobCreateTime>
        <PayType>PostPaid</PayType>
        <Delay>0</Delay>
        <PrecheckStatus>
            <Status>Finished</Status>
            <Percent>100</Percent>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_CONN_SRC</ItemName>
            
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_AUTH_SRC</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_CONN_DEST</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_AUTH_DEST</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_BINLOG_ON</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_BINLOG_MODE</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_BINLOG_ROW_IMAGE</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_SERVER_ID</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_BINLOG_EXIST</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_ENGINE</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_MYSQL_PASSOWRD_FORMAT</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_SRC</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_SAME_OBJ</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_SQL_MODE</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_SAME_USER</ItemName>
            </Detail>
            <Detail>
                <CheckStatus>Success</CheckStatus>
                <ItemName>CHECK_TOPOLOGY</ItemName>
            </Detail>
        </PrecheckStatus>
        <SynchronizationJobId>dtsexjk1alb116lbf1</SynchronizationJobId>
        <DataInitialization>true</DataInitialization>
        <DestinationEndpoint>
            <InstanceId>rm-bp162d4tp0500****</InstanceId>
            <InstanceType>RDS</InstanceType>
            <EngineName>MySQL</EngineName>
        </DestinationEndpoint>
        <SourceEndpoint>
            <InstanceId>rm-bp1i99e8l7913****</InstanceId>
            <InstanceType>RDS</InstanceType>
            <EngineName>MySQL</EngineName>
        </SourceEndpoint>
        <StructureInitialization>true</StructureInitialization>
        <ExpireTime>2021-07-07T16:00:00Z</ExpireTime>
        <Performance>
            <RPS>0</RPS>
            <FLOW>0.00MB/s</FLOW>
        </Performance>
        <SynchronizationJobClass>large</SynchronizationJobClass>
        <DataSynchronizationStatus/>
        <StructureInitializationStatus>
            <Status>Finished</Status>
            <Progress>1</Progress>
            <Percent>100</Percent>
        </StructureInitializationStatus>
    </SynchronizationInstances>
    <PageRecordCount>30</PageRecordCount>
    <RequestId>92E1E99D-5224-4AD3-8C94-23A3516B****</RequestId>
    <PageNumber>1</PageNumber>
</DescribeSynchronizationJobsResponse>

JSON biçimi

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalRecordCount" : 100,
  "SynchronizationInstances" : [ {
    "Status" : "synchronizing",
    "SynchronizationObjects" : [ {
      "TableIncludes" : [ ],
      "TableExcludes" : [ ],
      "SchemaName" : "dtstestdatabase",
      "NewSchemaName" : "newdtstestdatabase"
    } ],
    "DataInitializationStatus" : {
      "Status" : "Finished",
      "Progress" : "200001",
      "Percent" : "100"
    },
    "SynchronizationJobName" : "MySQL Synchronization",
    "InstanceCreateTime" : "2021-06-28T09:36:32Z",
    "CreateTime" : "2021-06-28 17:34:53.0",
    "JobCreateTime" : "2021-06-28T09:34:53Z",
    "PayType" : "PostPaid",
    "Delay" : "0",
    "PrecheckStatus" : {
      "Status" : "Finished",
      "Percent" : "100",
      "Detail" : [ {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_CONN_SRC"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_AUTH_SRC"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_CONN_DEST"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_AUTH_DEST"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_BINLOG_ON"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_BINLOG_MODE"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_BINLOG_ROW_IMAGE"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_SERVER_ID"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_BINLOG_EXIST"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_ENGINE"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_MYSQL_PASSOWRD_FORMAT"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_SRC"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_SAME_OBJ"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_SQL_MODE"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_SAME_USER"
      }, {
        "CheckStatus" : "Success",
        "ItemName" : "CHECK_TOPOLOGY"
      } ]
    },
    "SynchronizationJobId" : "dtsexjk1alb116lbf1",
    "DataInitialization" : true,
    "DestinationEndpoint" : {
      "InstanceId" : "rm-bp162d4tp0500****",
      "InstanceType" : "RDS",
      "EngineName" : "MySQL"
    },
    "SourceEndpoint" : {
      "InstanceId" : "rm-bp1i99e8l7913****",
      "InstanceType" : "RDS",
      "EngineName" : "MySQL"
    },
    "StructureInitialization" : true,
    "ExpireTime" : "2021-07-07T16:00:00Z",
    "Performance" : {
      "RPS" : "0",
      "FLOW" : "0.00MB/s"
    },
    "SynchronizationJobClass" : "large",
    "Tags" : [ ],
    "DataSynchronizationStatus" : { },
    "StructureInitializationStatus" : {
      "Status" : "Finished",
      "Progress" : "1",
      "Percent" : "100"
    }
  } ],
  "PageRecordCount" : 30,
  "RequestId" : "92E1E99D-5224-4AD3-8C94-23A3516B****",
  "PageNumber" : 1
}

Hata kodları


HttpCode


Hata kodu


Hata mesajı


Açıklama


400


Throttling.User


Request was denied due to user flow control.


İstek sayısı sınıra ulaştığından istek reddedildi. Lütfen daha sonra tekrar deneyin.


500


ServiceUnavailable


The request has failed due to a temporary failure of the server.


Sunucu yanıtı zaman aşımına uğradı veya sunucu kullanılamıyor. Lütfen tekrar deneyin. Sorun devam ederse teknik destekle iletişime geçin.


403


InvalidSecurityToken.Expired


Specified SecurityToken is expired.


İmzanın süresi doldu. Yeni bir imza kullanın.

Hata kodlarının listesi için API Error Center adresini ziyaret edin.