Tüm Ürünler
Search
Belge Merkezi

:ModifyReplicationJobAttribute

Son Güncelleme:Oct 10, 2026

Bir geçiş görevinin bilgilerini değiştirir.

Operation description

Açıklama

Bir geçiş görevini değiştirmeden önce aşağıdakilere dikkat edin:

  • Name ve Description parametreleri, geçiş görevinin yaşam döngüsü boyunca herhangi bir zamanda değiştirilebilir.

  • Frequency ve MaxNumberOfImageToKeep parametreleri yalnızca geçiş görevi çalıştırılmadan önce veya görev Waiting durumundayken değiştirilebilir.

  • Diğer parametreler yalnızca geçiş görevi çalıştırılmadan önce değiştirilebilir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

smc:ModifyReplicationJobAttribute

update

*ReplicationJob

acs:smc:{#regionId}:{#accountId}:replicationjob/{#JobId}

None None

Request parameters

Parameter

Type

Required

Description

Example

JobId

string

Yes

Geçiş görevinin kimliği.

j-bp19vlwm0tyigbmj****

Name

string

No

Geçiş görevinin adı. Ad aşağıdaki gereksinimleri karşılamalıdır:

  • Ad benzersiz olmalıdır.

  • Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harf veya Çince karakterle başlamalıdır. http:// veya https:// ile başlayamaz. Rakamlar, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

testMigrationTaskName

Description

string

No

Geçiş görevinin açıklaması.

Açıklama 2 ila 128 karakter uzunluğunda olmalıdır. Bir harf veya Çince karakterle başlamalıdır. http:// veya https:// ile başlayamaz. Rakamlar, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

This_is_my_migration_task

TargetType

string

No

Geçiş hedefinin türü. Bu parametre yalnızca geçiş görevi başlamadan önce değiştirilebilir. Geçerli değerler:

  • Image: Geçiş tamamlandıktan sonra SMC, kaynak sunucudan bir Alibaba Cloud görüntüsü oluşturur. Bu görüntüyü bir ECS örneği oluşturmak için kullanabilirsiniz.

  • ContainerImage: Geçiş tamamlandıktan sonra SMC, kaynak sunucudan bir konteyner görüntüsü oluşturur. Bu görüntüyü Container Registry'de kullanabilirsiniz.

  • TargetInstance: Geçiş tamamlandıktan sonra SMC, kaynağı bir hedef örneğe geçirir. Bu parametreyi bu değere ayarlarsanız, InstanceId parametresini de belirtmeniz gerekir.

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

  • Windows veya Arm tabanlı bir işletim sistemi çalıştıran sunucuların konteyner görüntülerine geçirilmesi desteklenmez.

Image

ScheduledStartTime

string

No

Geçiş görevini başlatmak istediğiniz zaman. SMC, geçiş görevini belirtilen zamanda otomatik olarak başlatır.

Zaman ISO 8601 standardına uygun ve UTC olmalıdır. Biçim YYYY-MM-DDThh:mm:ssZ şeklindedir. Örneğin, 2018-01-01T12:00:00Z, 1 Ocak 2018 saat 20:00:00'i (UTC+8) belirtir.

Not

Bu parametreyi boş bırakırsanız, SMC geçiş görevini otomatik olarak başlatmaz. Görevi başlatmak için StartReplicationJob işlemini çağırmanız gerekir.

2019-06-04T13:35:00Z

ImageName

string

No

Hedef görüntünün adı. Ad aşağıdaki gereksinimleri karşılamalıdır:

  • Görüntü adı aynı Alibaba Cloud bölgesinde benzersiz olmalıdır.

  • Ad 2 ila 128 karakter uzunluğunda olmalıdır. Bir harf veya Çince karakterle başlamalıdır. http:// veya https:// ile başlayamaz. Rakamlar, iki nokta üst üste (:), alt çizgi (_) ve tire (-) içerebilir.

Not

Geçiş görevi çalışırken geçerli bölgede aynı ada sahip bir görüntü zaten varsa, sistem görüntü adının sonuna ek olarak geçiş görevi kimliğini (JobId) ekler. Örnek: ImageName-JobId.

testAliCloudImageName

InstanceId

string

No

Hedef örneğin kimliği.

i-bp1f1dvfto1sigz5****

SystemDiskSize

integer

No

Hedef ECS örneğinin sistem diski boyutu. Birim: GiB. Geçerli değerler: 20 ile 500 arası.

Not

Bu parametrenin değeri, kaynak sunucunun sistem diski tarafından kullanılan alandan büyük olmalıdır. Örneğin, kaynak sunucunun sistem diski 500 GiB boyutundaysa ve alanın 100 GiB'lik kısmı kullanılıyorsa, bu parametreyi 100'den büyük bir değere ayarlamanız gerekir.

50

Frequency

integer

No

Artımlı geçiş görevinin çalışma aralığı. Birim: saat. Geçerli değerler: 1 ile 168 arası.

RunOnce parametresi false olarak ayarlanmışsa bu parametre gereklidir.

10

MaxNumberOfImageToKeep

integer

No

Artımlı geçiş görevi için tutulacak maksimum görüntü sayısı. Geçerli değerler: 1 ile 10 arası.

RunOnce parametresi false olarak ayarlanmışsa bu parametre gereklidir.

5

InstanceType

string

No

Ara örneğin örnek türü.

ECS tarafından sağlanan örnek türlerini sorgulamak için DescribeInstanceTypes işlemini çağırabilirsiniz.

  • Bu parametreyi belirtirseniz, sistem bu örnek türünde bir ara örnek oluşturur. Belirtilen örnek türü stokta yoksa, geçiş görevi oluşturulamaz.

  • Bu parametreyi belirtmezseniz, sistem ara örneği oluşturmak için belirli bir sırayla bir örnek türü seçer. Daha fazla bilgi için SMC SSS bölümüne bakın.

ecs.c5.large

LaunchTemplateId

string

No

Başlatma şablonunun kimliği.

lt-bp16jovvln1cgaaq****

LaunchTemplateVersion

string

No

Başlatma şablonunun sürümü.

Latest

InstanceRamRole

string

No

Örnek için RAM rolünün adı.

SMCAdmin

ContainerNamespace

string

No

Docker konteynerinin ad alanı. Docker konteyner görüntüleri hakkında daha fazla bilgi için Container Registry bölümüne bakın.

testNamespace

ContainerRepository

string

No

Docker konteyneri için görüntü deposu. Docker konteyner görüntüleri hakkında daha fazla bilgi için Container Registry bölümüne bakın.

testRepository

ContainerTag

string

No

Docker konteyneri için görüntü etiketi. Docker konteyner görüntüleri hakkında daha fazla bilgi için Container Registry bölümüne bakın.

CentOS:v1

ValidTime

string

No

Geçiş görevinin sona erme zamanı. Değer, geçiş görevinin oluşturulma zamanından 7 ila 90 gün sonrasına ait bir zaman olabilir.

  • Sona erme zamanını yalnızca geçiş görevi Ready, Running, Stopped, InError veya Waiting durumundayken değiştirebilirsiniz.

  • Zaman ISO 8601 standardına uygun ve UTC olmalıdır. Biçim YYYY-MM-DDThh:mm:ssZ şeklindedir. Örneğin, 2018-01-01T12:00:00Z, 1 Ocak 2018 saat 20:00:00'i (UTC+8) belirtir.

  • Bu parametreyi boş bırakırsanız, görevin süresi dolmaz.

  • Bir görevin süresi dolduktan sonra Expired olarak işaretlenir. Görev 7 gün boyunca tutulur. 7 gün sonra sistem görevi otomatik olarak siler.

Varsayılan değer: Geçiş görevi oluşturulduktan 30 gün sonrası. Bu, geçiş görevinin varsayılan olarak 30 gün boyunca geçerli olduğu anlamına gelir.

2019-06-04T13:35:00Z

SystemDiskPart

array<object>

No

Sistem diskinin bölümleri.

object

No

Sistem diskinin bölümleri.

SizeBytes

integer

No

Hedef sistem diskinin N. bölümünün boyutu. Birim: bayt. Varsayılan değer, kaynak sistem diski bölümünün boyutudur.

Not

Bir bölümün boyutu sistem diskinin boyutunu aşamaz. Bir sistem diskindeki tüm bölümlerin toplam boyutu sistem diskinin boyutunu aşamaz.

254803968

Block

boolean

No

Hedef sistem diskinin N. bölümü için blok çoğaltmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true

  • false

true

Device

string

No

Hedef sistem diskinin N. bölümünün aygıt kimliği.

Not

N değeri için kaynak bölümün aygıt kimliğine bakın.

0_1

DataDisk

array<object>

No

Veri diskleri.

array<object>

No

Veri diskleri.

Index

integer

No

Hedef ECS örneğindeki veri diskinin sıra numarası. Geçerli değerler: 1 ile 16 arası.

Başlangıç değeri 1'dir.

Not

Yalnızca kaynak sunucuda bulunan bir veri diski için hedef veri diski oluşturabilirsiniz.

1

Part

array<object>

No

Bölümler.

object

No

Bölümler.

SizeBytes

integer

No

Veri diskinin N. bölümünün boyutu. Birim: bayt. Varsayılan değer, kaynak veri diski bölümünün boyutudur.

Not

Bir bölümün boyutu veri diskinin boyutunu aşamaz. Bir veri diskindeki tüm bölümlerin toplam boyutu veri diskinin boyutunu aşamaz.

254803968

Block

boolean

No

Veri diskinin N. bölümü için blok çoğaltmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true

  • false

true

Device

string

No

Veri diskinin N. bölümünün aygıt kimliği.

Not

N değeri için kaynak bölümün aygıt kimliğine bakın.

0_1

Size

integer

No

Hedef ECS örneğindeki veri diskinin boyutu. Birim: GiB. Geçerli değerler: 20 ile 32768 arası.

Not

Bu parametrenin değeri, kaynak sunucunun veri diski tarafından kullanılan alandan büyük olmalıdır. Örneğin, kaynak sunucunun veri diski 500 GiB boyutundaysa ve alanın 100 GiB'lik kısmı kullanılıyorsa, bu parametreyi 100'den büyük bir değere ayarlamanız gerekir.

100

NetMode

integer

No

Veri iletimi için ağ modu. Geçerli değerler:

  • 0: İnternet aktarım modu. Kaynak sunucunun İnternet'e erişebilmesi gerekir. Veriler İnternet üzerinden aktarılır.

  • 2: Dahili ağ aktarım modu. Bu modu seçerseniz, VSwitchId parametresini ayarlamanız gerekir. Hizmet VPC kimliğini otomatik olarak sorgulayabildiği için VpcId parametresi gerekli değildir.

0

VSwitchId

string

No

Belirtilen VPC'deki vSwitch'in kimliği.

vsw-bp1ddbrxdlrcbim46****

VpcId

string

No

Express Connect veya VPN Gateway ile yapılandırılmış VPC'nin kimliği.

vpc-bp1vwnn14rqpyiczj****

ReplicationParameters

string

No

Çoğaltma sürücüsünün parametreleri. Parametreler JSON biçiminde anahtar-değer çiftleridir. Anahtarlar sabittir. Değer en fazla 2.048 karakter uzunluğunda olabilir.

Çoğaltma sürücüsü, verileri kaynak sunucudan ara örneğe çoğaltmak için kullanılan bir araçtır. Çoğaltma sürücüleri tarafından desteklenen parametreler farklılık gösterebilir. SMT çoğaltma sürücüsü aşağıdaki parametreleri destekler:

  • bandwidth_limit: Veri iletimi için bant genişliği sınırı.

  • compress_level: Aktarılacak verilerin sıkıştırma oranı.

  • checksum: Sağlama toplamı doğrulamasının etkinleştirilip etkinleştirilmeyeceğini belirtir.

Çoğaltma sürücüsünün değeri hakkında bilgi için DescribeSourceServers işleminin yanıtındaki SourceServers.ReplicationDriver parametresine bakın.

{"bandwidth_limit":0,"compress_level":1,"checksum":true}

Response elements

Element

Type

Description

Example

object

RequestId

string

İstek kimliği.

1C488B66-B819-4D14-8711-C4EAAA13AC01

Examples

Success response

JSON format

{
  "RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Error codes

HTTP status code

Error code

Error message

Description

400 DataDisk.DuplicateIndex The source server data disk cannot contain the same index. The source server data disk cannot contain the same index.
400 ReplicationJobDataDiskIndex.Invalid The specified replication job contains data disk index not found in source server. The specified replication job contains data disk indexes that do not exist in the source server.
400 ReplicationJobName.Duplicate The specified replication job name already exists. The specified replication job name already exists.
400 ReplicationJob.InvalidStatus The specified replication job status: %s is invalid. This operation can only be performed in the following status: %s. The specified replication job status: %s is invalid. This operation can only be performed in the following status: %s.
400 ReplicationJob.InvalidBusinessStatus The specified business status: %s of the replication job is invalid. This operation can only be performed in the following status: %s. The specified business status: %s of the replication job is invalid. This operation can only be performed in the following status: %s.
400 ImageName.UsedByReplicationJob The specified imageName: "%s" was used by another replication job in the current region. The specified imageName: "%s" was used by another replication job in the current region.
500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.