Tüm Ürünler
Search
Belge Merkezi

Data Transmission Service:ModifyDtsJobEndpoint

Son Güncelleme:Oct 05, 2026

Data Transmission Service (DTS) içindeki bir veri senkronizasyonu veya geçiş görevinin kaynak ya da hedef veritabanını değiştirir.

Not

Veritabanı değiştirildikten sonra DTS, artımlı yazma ofsetini 10 saniye boyunca geri alır. Senkronize edilen veya geçirilen verilerin birincil anahtarı yoksa kaynak veya hedef veritabanı değiştirilirken kaynak veritabanına veri yazılmadığından emin olun. Aksi takdirde yinelenen veriler oluşabilir.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Farklı SDK'lar için örnek kod dinamik olarak oluşturduğundan bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action

String

Evet

ModifyDtsJobEndpoint

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

RegionId

String

Hayır

cn-hangzhou

DTS örneğinin bölge kimliği.

DtsJobId

String

Hayır

m4312mab158****

Veri senkronizasyonu veya geçiş görevinin kimliği. Görev kimliğini sorgulamak için DescribeDtsJobs işlemini çağırabilirsiniz.

Not

Bu parametreyi boş bırakırsanız DtsInstanceId gereklidir.

DtsInstanceId

String

Hayır

dtsaw012y2g15q****

Veri senkronizasyonu veya geçiş örneğinin kimliği.

Not

Bu parametreyi boş bırakırsanız DtsJobId gereklidir.

SynchronizationDirection

String

Hayır

Forward

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

  • Forward (varsayılan): Veriler kaynak veritabanından hedef veritabanına senkronize edilir.

  • Reverse: Veriler hedef veritabanından kaynak veritabanına senkronize edilir.

Endpoint

String

Evet

src

Değiştirmek istediğiniz veritabanı. Geçerli değerler:

  • src: kaynak veritabanı.

  • dest: hedef veritabanı.

EndpointRegionId

String

Hayır

cn-hangzhou

Veritabanının bulunduğu bölge.

EndpointInstanceType

String

Evet

rds

Veritabanı türü. Geçerli değerler:

  • rds: ApsaraDB RDS for MySQL veya ApsaraDB RDS for PostgreSQL örneği.

  • polardb: PolarDB for MySQL veya PolarDB for PostgreSQL kümesi.

  • mongodb: Kaynak ApsaraDB for MongoDB çoğaltma kümesi örnekleri ve hedef ApsaraDB for MongoDB çoğaltma kümesi veya parçalı küme örnekleri.

  • distributed_mongodb: Kaynak ApsaraDB for MongoDB parçalı küme dağıtılmış örnekleri.

Not

Dağıtılmış örneklerin artımlı veri senkronizasyonu veya geçiş görevleri için öncelikle oplog kullanarak kaynak veritabanındaki veri değişikliklerini kaydetmeniz gerekir.

  • greenplum: AnalyticDB for PostgreSQL örneği.

  • kafka: ApsaraMQ for Kafka örneği.

  • ecs: Elastic Compute Service (ECS) örneğinde barındırılan kendi yönettiğiniz veritabanı.

  • express: Express Connect üzerinden bağlanan veritabanı.

  • other: İnternet üzerinden bağlanan veritabanı.

Not
  • Aşağıdaki veritabanı türleri desteklenir: MySQL, PolarDB for MySQL, PostgreSQL, PolarDB for PostgreSQL, MongoDB, Kafka ve AnalyticDB for PostgreSQL.

  • Değiştirmek istediğiniz veritabanı parçalı küme mimarisine sahip bir MongoDB veritabanıysa yeni MongoDB veritabanının orijinal MongoDB veritabanıyla aynı sayıda parçaya sahip olması gerekir.

  • Değiştirmek istediğiniz veritabanı bir kaynak PostgreSQL veritabanıysa DTS örneğinin gecikme süresinin 30 saniyeden az olduğundan ve değişiklik sırasında kaynak veritabanına veri yazılmadığından emin olun. Aksi takdirde veri tutarsızlığı oluşabilir.

  • Bu parametrenin değeri büyük/küçük harfe duyarlı değildir.

EndpointInstanceId

String

Hayır

rm-bp10k50h8374w****

Veritabanı kimliği.

EndpointIp

String

Hayır

172.168.XX.XXX

Veritabanının IP adresi.

EndpointPort

String

Hayır

3306

Veritabanının bağlantı noktası numarası.

ModifyAccount

Boolean

Hayır

false

Veritabanı hesabının parolasının değiştirilip değiştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Evet.

  • false (varsayılan): Hayır.

Username

String

Hayır

dtstest

Örneğin veritabanı hesabı.

Not

Bu parametre yalnızca ModifyAccount true olarak ayarlandığında geçerlidir.

Password

String

Hayır

DTStest****

Veritabanı hesabının parolası.

Not

Bu parametre yalnızca ModifyAccount true olarak ayarlandığında geçerlidir.

Database

String

Hayır

admin

Değiştirilecek veritabanının türü PostgreSQL, PolarDB for PostgreSQL veya AnalyticDB for PostgreSQL ise bu parametreyi veritabanı adına ayarlayın. Değiştirilecek veritabanının türü MongoDB ise bu parametreyi kimlik doğrulama veritabanının adına ayarlayın.

Not

Bu parametre yalnızca veritabanı türü PostgreSQL, PolarDB for PostgreSQL, AnalyticDB for PostgreSQL veya MongoDB olduğunda geçerli ve gereklidir.

ShardUsername

String

Hayır

shard

ApsaraDB for MongoDB parçalı küme örneğinde oturum açmak için kullanılan hesabın kullanıcı adı.

Not
  • Bu parametre yalnızca kaynak veritabanı bir ApsaraDB for MongoDB parçalı küme örneği olduğunda geçerli ve gereklidir.

  • Bu parametre yalnızca ModifyAccount true olarak ayarlandığında geçerlidir.

ShardPassword

String

Hayır

DTStest****

ApsaraDB for MongoDB parçalı küme örneğinde oturum açmak için kullanılan hesabın parolası.

Not
  • Bu parametre yalnızca kaynak veritabanı bir ApsaraDB for MongoDB parçalı küme örneği olduğunda geçerli ve gereklidir.

  • Bu parametre yalnızca ModifyAccount true olarak ayarlandığında geçerlidir.

RoleName

String

Hayır

ram-for-dts

Alibaba Cloud hesapları arasında kaynaklara erişmek için belirttiğiniz Resource Access Management (RAM) rolünün adı.

Not

Alibaba Cloud hesapları arasında veri senkronize ediyor veya geçiriyorsanız bu parametre gereklidir. Daha fazla bilgi için bkz. Hesaplar arası DTS görevleri için RAM yetkilendirmesini yapılandırma.

AliyunUid

String

Hayır

150780020300****

Veritabanı örneğinin ait olduğu Alibaba Cloud hesabının kimliği.

Not

Bu parametreyi belirtirseniz veriler Alibaba Cloud hesapları arasında senkronize edilir veya geçirilir. RoleName parametresini de belirtmeniz gerekir.

DryRun

Boolean

Hayır

true

Yalnızca ön kontrol yapılacağını belirtir. Geçerli değerler:

  • true: Evet. Ön kontrol başarılı olduktan sonra veritabanı değiştirilmez.

  • false (varsayılan): Hayır. Ön kontrol başarılı olduktan sonra veritabanı değiştirilir ve DTS görevi çalıştırılır.

ResourceGroupId

String

Hayır

rg-acfmzawhxxc****

Kaynak grubu kimliği.

Yanıt parametreleri


Parametre


Tür


Örnek


Açıklama


HttpStatusCode


String


200


HTTP durum kodu.


RequestId


String


3FA98DF2-2F81-51FF-8A38-AA5112DD****


İstek kimliği.


Success


Boolean


true


İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:


ErrCode


String


DTS.Msg.InvalidEndpoint


İstek başarısız olursa döndürülen hata kodu.


ErrMessage


String


The endpoint is invalid.


İstek başarısız olursa döndürülen hata iletisi.

Örnekler

Örnek istekler

http(s)://dts.aliyuncs.com/?Action=ModifyDtsJobEndpoint
&RegionId=cn-hangzhou
&DtsInstanceId=dtsaw012y2g15q****
&SynchronizationDirection=Forward
&Endpoint=src
&EndpointInstanceType=rds
&EndpointInstanceId=rm-bp10k50h8374w****
&Username=dtstest
&Password=DTStest****
&DryRun=true
& Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<ModifyDtsJobEndpointResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <RequestId>3FA98DF2-2F81-51FF-8A38-AA5112DD****</RequestId>
    <Success>true</Success>
</ModifyDtsJobEndpointResponse>

JSON biçimi

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

{
  "HttpStatusCode" : "200",
  "RequestId" : "3FA98DF2-2F81-51FF-8A38-AA5112DD****",
  "Success" : true
}

Hata kodları


HttpCode


Hata kodu


Hata iletisi


Açıklama


400


InvalidParameter.TagKey


The Tag.N.Key parameter is invalid.


Belirtilen etiket anahtarı geçersiz. Geçerli bir etiket anahtarı girin.


400


InvalidParameter.TagValue


The Tag.N.Value parameter is invalid.


Belirtilen etiket değeri geçersiz. Geçerli bir etiket değeri girin.


400


InvalidParameter.Tags


The specified value of parameter Tags is not valid.


Belirtilen etiket anahtarı veya etiket değeri geçersiz. Geçerli bir etiket anahtarı veya etiket değeri girin.


400


Missing.TagKey


You must specify the key for value %s in Tag.N.Key.


Etiket anahtarı belirtilmemiş.


400


MissingParameter.TagOrResourceId


Either Tags or ResourceIds must be specified.


Etiket veya örnek kimliği belirtilmemiş.


400


NumberExceed.Tags


The maximum number of Tags is exceeded. The maximum value is 20.


Maksimum etiket sayısına (20) ulaşıldı. Gereksiz etiketleri silin.


400


NumberExceed.ResourceIds


The maximum number of ResourceIds is exceeded. The maximum value is 50.


Maksimum örnek kimliği sayısına (20) ulaşıldı. Gereksiz örnek kimliklerini silin.


400


InvalidParameter.Category


The specified Category is invalid. Valid values are Custom and System.


Kategori değeri geçersiz. Geçerli değerler: Custom ve System.


400


InvalidParameter.NextToken


The parameter NextToken is invalid.


NextToken değeri geçersiz. Geçerli bir belirteç girin.


400


InvalidParameter.ResourceType


The ResourceType parameter is invalid.


ResourceType değeri geçersiz. Değeri ALIYUN::DTS::INSTANCE olarak ayarlayın.


400


InvalidParameter.Scope


The specified Scope is invalid. Valid value: public, private.


Etiketi görüntülemeye izin verilen belirtilen kapsam geçersiz. Geçerli değerler: public ve private.


400


Throttling.User


Request was denied due to user flow control.


İstek sayısı sınıra ulaştığından istek reddedildi. Daha sonra tekrar deneyin.


403


Duplicate.TagKey


The Tag.N.Key contains duplicate keys.


Belirtilen etiket anahtarı zaten var. Yinelenen etiket anahtarını silin.


403


NoPermission.SystemTag


You are not authorized to operate system tag because the product code is invalid.


Kod geçersiz olduğundan etiket değerlerinde işlem yapma yetkiniz yok.


403


QuotaExceed.TagsPerResource


The maximum number of tags for each resource is exceeded.


Maksimum etiket sayısına ulaşıldı. Gereksiz etiketleri silin.


403


NoPermission.Operator


The user is not authorized to operate on the specified resource.


Belirtilen kaynakta işlem yapma yetkiniz yok.


403


InvalidSecurityToken.Expired


Specified SecurityToken is expired.


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


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 durumda. Tekrar deneyin. Hata devam ederse teknik destek ile iletişime geçin.

Hata kodlarının listesi için bkz. Hata Kodları.