Tüm Ürünler
Search
Belge Merkezi

Data Transmission Service:ConfigureMigrationJob

Son Güncelleme:Oct 05, 2026

Bir veri geçiş görevini yapılandırır.

Bu işlemi çağırarak bir veri geçiş görevini yapılandırdığınızda görev otomatik olarak başlar. Görevi başlatmak için StartMigrationJob işlemini çağırmanıza gerek yoktur.

Ön denetim hataları nedeniyle veri geçiş görevi başlamayabilir. Ön denetim hatalarıyla ilgili hata iletilerini sorgulamak için DescribeMigrationJobStatus işlemini çağırabilirsiniz. Ardından hata iletilerine göre sorunu düzeltebilirsiniz. Sorunu düzelttikten sonra veri geçiş görevini yeniden başlatmak için StartMigrationJob işlemini çağırmanız gerekir.

Hata Ayıklama

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

İstek parametreleri

ParameterTypeRequiredExampleDescription
ActionStringYesConfigureMigrationJob

Gerçekleştirmek istediğiniz işlem. Değeri ConfigureMigrationJob olarak ayarlayın.

DestinationEndpoint.InstanceTypeStringYesRDS

Hedef veritabanının örnek türü. Geçerli değerler:

  • ECS: Elastic Compute Service (ECS) üzerinde barındırılan kendi yönetiminizdeki veritabanı
  • LocalInstance: Genel IP adresine sahip kendi yönetiminizdeki veritabanı
  • RDS: ApsaraDB RDS örneği
  • DRDS: PolarDB-X örneği
  • MongoDB: ApsaraDB for MongoDB örneği
  • Redis: ApsaraDB for Redis örneği
  • PetaData: HybridDB for MySQL örneği
  • POLARDB: PolarDB for MySQL kümesi veya PolarDB for PostgreSQL kümesi
  • PolarDB_o: PolarDB O Edition kümesi
  • AnalyticDB: AnalyticDB for MySQL kümesi V3.0 veya V2.0
  • Greenplum: AnalyticDB for PostgreSQL örneği
MigrationJobIdStringYesdtsl3m1213ye7l****

Veri geçiş örneğinin kimliği. Örnek kimliğini sorgulamak için DescribeMigrationJobs işlemini çağırabilirsiniz.

MigrationJobNameStringYesMySQL_TO_RDS

Veri geçiş görevinin adı. Ad en fazla 32 karakter uzunluğunda olabilir. Görevi tanımlamak için açıklayıcı bir ad belirtmenizi öneririz. Görev adının benzersiz olması gerekmez.

MigrationMode.DataIntializationBooleanYestrue

Tam veri geçişinin yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: evet
  • false: hayır
Not Tam veri geçişini destekleyen veritabanları hakkında daha fazla bilgi için bkz. Desteklenen veritabanları ve geçiş türleri.
MigrationMode.DataSynchronizationBooleanYestrue

Artımlı veri geçişinin yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: evet
  • false: hayır
Not Artımlı veri geçişini destekleyen veritabanları hakkında daha fazla bilgi için bkz. Desteklenen veritabanları ve geçiş türleri.
MigrationMode.StructureIntializationBooleanYestrue

Şema geçişinin yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: evet
  • false: hayır
Not Şema geçişini destekleyen veritabanları hakkında daha fazla bilgi için bkz. Desteklenen veritabanları ve geçiş türleri.
MigrationObjectStringYes[{"DBName":"dtstestdata","TableIncludes":[{"TableName":"customer"}]}]

Geçişini yapmak istediğiniz nesneler. Değer bir JSON dizesidir ve düzenli ifadeler içerebilir.

Daha fazla bilgi için bkz. MigrationObject.

SourceEndpoint.InstanceTypeStringYesRDS

Kaynak veritabanının örnek türü. Geçerli değerler:

  • RDS: ApsaraDB RDS örneği
  • ECS: ECS üzerinde barındırılan kendi yönetiminizdeki veritabanı
  • LocalInstance: Genel IP adresine sahip kendi yönetiminizdeki veritabanı
  • Express: Express Connect, VPN Gateway veya Smart Access Gateway üzerinden bağlanan kendi yönetiminizdeki veritabanı
  • dg: Database Gateway üzerinden bağlanan kendi yönetiminizdeki veritabanı
  • cen: Cloud Enterprise Network (CEN) üzerinden bağlanan kendi yönetiminizdeki veritabanı
  • MongoDB: ApsaraDB for MongoDB örneği
  • POLARDB: PolarDB for MySQL kümesi veya PolarDB for PostgreSQL kümesi
  • PolarDB_o: PolarDB O Edition kümesi
RegionIdStringNocn-hangzhou

Veri geçiş örneğinin bulunduğu bölgenin kimliği. Daha fazla bilgi için bkz. Desteklenen bölgelerin listesi.

Not Veri geçiş örneğinin bölge kimliği, hedef veritabanının bölge kimliği ile aynıdır.
SourceEndpoint.InstanceIDStringNorm-bp1i99e8l7913****

Kaynak veritabanını barındıran örneğin kimliği.

Not
  • SourceEndpoint.InstanceType parametresi RDS, ECS, Express, MongoDB, POLARDB veya PolarDB_o olarak ayarlandığında yalnızca örnek kimliğini belirtmeniz gerekir. Örneğin, SourceEndpoint.InstanceType parametresi ECS olarak ayarlanırsa ECS örneğinin kimliğini belirtmeniz gerekir.
  • SourceEndpoint.InstanceType parametresi Express olarak ayarlanırsa sanal özel bulut (VPC) kimliğini belirtmeniz gerekir.
SourceEndpoint.EngineNameStringNoMySQL

Kaynak veritabanının altyapı türü. Geçerli değerler: MySQL, TiDB, SQLServer, PostgreSQL, Oracle, MongoDB, Redis, POLARDB ve polardb_pg.

Not DestinationEndpoint.InstanceType parametresi RDS, POLARDB, ECS, LocalInstance veya Express olarak ayarlandığında yalnızca altyapı türünü belirtmeniz gerekir.
SourceEndpoint.RegionStringNocn-hangzhou

Kaynak veritabanının bölge kimliği.

Not SourceEndpoint.InstanceType parametresi LocalInstance olarak ayarlanırsa cn-hangzhou veya kendi yönetiminizdeki veritabanına en yakın bölgenin kimliğini girebilirsiniz. Daha fazla bilgi için bkz. Desteklenen bölgelerin listesi.
SourceEndpoint.IPStringNo172.16.88.***

Kaynak veritabanının uç noktası.

Not SourceEndpoint.InstanceType parametresi LocalInstance veya Express olarak ayarlandığında yalnızca uç noktayı belirtmeniz gerekir.
SourceEndpoint.PortStringNo3306

Kaynak veritabanının hizmet bağlantı noktası numarası.

Not SourceEndpoint.InstanceType parametresi ECS, LocalInstance veya Express olarak ayarlandığında yalnızca hizmet bağlantı noktası numarasını belirtmeniz gerekir.
SourceEndpoint.OracleSIDStringNotestsid

Oracle veritabanının sistem kimliği (SID).

Not Bu parametreyi yalnızca SourceEndpoint.EngineName parametresi Oracle olarak ayarlandığında ve Oracle veritabanı RAC olmayan bir mimaride dağıtıldığında belirtmeniz gerekir.
SourceEndpoint.DatabaseNameStringNodtstestdatabase

Kaynak veritabanının adı veya kimlik doğrulama veritabanı.

Not
  • SourceEndpoint.EngineName parametresi PostgreSQL veya MongoDB olarak ayarlandığında yalnızca veritabanı adını belirtmeniz gerekir.
  • SourceEndpoint.EngineName parametresi PostgreSQL olarak ayarlanırsa kaynak veritabanının adını belirtin. SourceEndpoint.EngineName parametresi MongoDB olarak ayarlanırsa kimlik doğrulama veritabanının adını belirtin.
SourceEndpoint.UserNameStringNodtstestaccount

Kaynak veritabanının veritabanı hesabı.

Not Veritabanı hesapları için gereken izinler geçiş senaryosuna göre değişir. Daha fazla bilgi için bkz. Veri geçiş senaryolarına genel bakış.
SourceEndpoint.PasswordStringNoTest123456

Kaynak veritabanı hesabının parolası.

SourceEndpoint.OwnerIDStringNo140692647406****

Kaynak örneğin ait olduğu Alibaba Cloud hesabının kimliği.

Not Bu parametreyi yalnızca farklı Alibaba Cloud hesapları arasında veri geçişini yapılandırırken belirtmeniz gerekir.
SourceEndpoint.RoleStringNoram-for-dts

Kaynak örneğin yetkilendirilmiş RAM rolü. Kaynak örnek ile hedef örnek farklı Alibaba Cloud hesaplarına ait olduğunda yalnızca RAM rolünü belirtmeniz gerekir. Hedef örneğe sahip olan Alibaba Cloud hesabının kaynak örneğe erişmesine izin vermek için RAM rolünü kullanabilirsiniz.

Not RAM rolünün izinleri ve yetkilendirme yöntemleri hakkında bilgi için bkz. Hesaplar arası veri geçişi ve eşitleme için RAM yetkilendirmesini yapılandırma.
DestinationEndpoint.InstanceIDStringNorm-bp1r46452ai50****

Hedef veritabanını barındıran örneğin kimliği.

Not DestinationEndpoint.InstanceType parametresi RDS, ECS, MongoDB, Redis, DRDS, PetaData, OceanBase, POLARDB, PolarDB_o, AnalyticDB veya Greenplum olarak ayarlandığında yalnızca örnek kimliğini belirtmeniz gerekir. Örneğin, DestinationEndpoint.InstanceType parametresi ECS olarak ayarlanırsa ECS örneğinin kimliğini belirtmeniz gerekir.
DestinationEndpoint.EngineNameStringNoMySQL

Hedef veritabanının altyapı türü. Geçerli değerler: MySQL, DRDS, SQLServer, PostgreSQL, PPAS, MongoDB, Redis, POLARDB ve polardb_pg.

Not DestinationEndpoint.InstanceType parametresi RDS, POLARDB, ECS, LocalInstance veya Express olarak ayarlandığında yalnızca altyapı türünü belirtmeniz gerekir.
DestinationEndpoint.RegionStringNocn-hangzhou

Hedef veritabanının bölge kimliği.

Not DestinationEndpoint.InstanceType parametresi LocalInstance olarak ayarlanırsa cn-hangzhou veya kendi yönetiminizdeki veritabanına en yakın bölgenin kimliğini girebilirsiniz. Daha fazla bilgi için bkz. Desteklenen bölgelerin listesi.
DestinationEndpoint.IPStringNo172.16.88.***

Hedef veritabanının uç noktası.

Not DestinationEndpoint.InstanceType parametresi LocalInstance veya Express olarak ayarlandığında yalnızca uç noktayı belirtmeniz gerekir.
DestinationEndpoint.PortStringNo3306

Hedef veritabanının hizmet bağlantı noktası numarası.

Not DestinationEndpoint.InstanceType parametresi ECS, LocalInstance veya Express olarak ayarlandığında yalnızca hizmet bağlantı noktası numarasını belirtmeniz gerekir.
DestinationEndpoint.DataBaseNameStringNodtstestdatabase

Hedef veritabanının adı veya kimlik doğrulama veritabanı.

Not
  • DestinationEndpoint.EngineName parametresi PostgreSQL, DRDS veya MongoDB olarak ayarlandığında yalnızca veritabanı adını belirtmeniz gerekir.
  • DestinationEndpoint.EngineName parametresi PostgreSQL veya DRDS olarak ayarlanırsa hedef veritabanının adını belirtin. DestinationEndpoint.EngineName parametresi MongoDB olarak ayarlanırsa kimlik doğrulama veritabanının adını belirtin.
DestinationEndpoint.UserNameStringNodtstestaccount

Hedef veritabanının veritabanı hesabı.

Not Veritabanı hesapları için gereken izinler geçiş senaryosuna göre değişir. Daha fazla bilgi için bkz. Veri geçiş senaryolarına genel bakış.
DestinationEndpoint.PasswordStringNoTest123456

Hedef veritabanı hesabının parolası.

MigrationReservedStringNo{ "autoStartModulesAfterConfig": "none", "targetTableMode": 2 }

DTS'nin ayrılmış parametresi. Değer bir JSON dizesidir. Bu parametreyi ön denetimin otomatik olarak başlatılıp başlatılmayacağı gibi özel gereksinimleri karşılamak için belirtebilirsiniz. Daha fazla bilgi için bkz. MigrationReserved.

CheckpointStringNo111

Artımlı veri geçişinin başlangıç ofseti. Değer bir UNIX zaman damgasıdır. Birim: saniye.

AccountIdStringNo12323344****

Alibaba Cloud hesabının kimliği. Bu parametre gelecekte kaldırılacağından bu parametreyi belirtmenize gerek yoktur.

DestinationEndpoint.OracleSIDStringNotestsid

Oracle veritabanının SID'si.

Not Bu parametreyi yalnızca DestinationEndpoint.EngineName parametresi Oracle olarak ayarlandığında ve Oracle veritabanı RAC olmayan bir mimaride dağıtıldığında belirtmeniz gerekir.

Yanıt parametreleri

Parameter Type Example Description
ErrCode String InternalError


Çağrı başarısız olursa döndürülen hata kodu.

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


Çağrı başarısız olursa döndürülen hata iletisi.

RequestId String 40E35BD9-002E-4D63-9BE5-FBA48833****


İsteğin kimliği.

Success String true


Çağrının başarılı olup olmadığını gösterir.

Örnekler

Örnek istekler

http(s)://dts.aliyuncs.com/?Action=ConfigureMigrationJob
&DestinationEndpoint.InstanceType=RDS
&MigrationJobId=dtsl3m1213ye7l****
&MigrationJobName=MySQL_TO_RDS
&MigrationMode.DataIntialization=true
&MigrationMode.DataSynchronization=true
&MigrationMode.StructureIntialization=true
&MigrationObject=[{"DBName":"dtstestdata","TableIncludes":[{"TableName":"customer"}]}]
&SourceEndpoint.InstanceType=RDS
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

<ConfigureMigrationJobResponse>
      <RequestId>40E35BD9-002E-4D63-9BE5-FBA48833****</RequestId>
      <Success>true</Success>
</ConfigureMigrationJobResponse>

JSON biçimi

{
    "RequestId": "40E35BD9-002E-4D63-9BE5-FBA48833****",
    "Success": true
}

Hata kodları

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