Tüm Ürünler
Search
Belge Merkezi

:CreateReplicationJob

Son Güncelleme:Oct 10, 2026

CreateReplicationJob çağrısı yaparak bir geçiş kaynağı için geçiş görevi oluşturur.

Operation description

İşlem açıklaması.

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:CreateReplicationJob

create

*ReplicationJob

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

*SourceServer

acs:smc:{#regionId}:{#accountId}:sourceserver/{#SourceServerId}

None None

Request parameters

Parameter

Type

Required

Description

Example

RegionId

string

Yes

Geçiş kaynağının geçirileceği hedef Alibaba Cloud bölgesinin kimliği.

cn-hangzhou

ClientToken

string

No

İsteğin yinelenemezliğini (idempotency) sağlar. Yeniden deneme isteklerinin yinelenemezliğini sağlamak için istemciden en fazla 64 ASCII karakterlik bir parametre değeri oluşturabilir ve bu değeri ClientToken parametresine atayabilirsiniz. Daha fazla bilgi için Yinelenemezlik nasıl sağlanır konusuna bakın.

123e4567-e89b-12d3-a456-426655440000

Name

string

No

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

  • Görev adı benzersiz olmalıdır.

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

testMigrationTaskName

Description

string

No

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

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

This_is_a_migration_task

SourceId

string

Yes

Geçiş kaynağının kimliği.

s-bp1e2fsl57knvuug****

TargetType

string

No

Geçiş görevinin hedef türü. Geçerli değerler:

  • Image: Başarılı bir geçişten sonra Server Migration Center (SMC), geçiş kaynağınız için bir Alibaba Cloud görüntüsü oluşturur.

  • ContainerImage: Başarılı bir geçişten sonra SMC, geçiş kaynağınız için bir Docker konteyner görüntüsü oluşturur.

  • TargetInstance: Başarılı bir geçişten sonra SMC, geçiş kaynağınızı doğrudan hedef örneğe geçirir. Bu parametreyi TargetInstance olarak ayarlarsanız, InstanceId parametresini de belirtmeniz gerekir.

Image

ScheduledStartTime

string

No

Geçiş görevinin çalıştırma zamanı. Bu parametrenin değeri aşağıdaki gereksinimleri karşılamalıdır:

  • Zaman, UTC+0'da ISO 8601 standardına uygun 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) gösterir.

  • Değer, geçerli zamandan sonra ve geçerli zamandan itibaren 30 gün içinde olmalıdır.

Not

Bu parametre boş bırakılırsa Server Migration Center (SMC) geçiş görevini başlatmaz. Görevi başlatmak için StartReplicationJob API'sini çağırmanız gerekir.

2019-06-04T13:35:00Z

ValidTime

string

No

Geçiş görevinin sona erme zamanı. Geçerli değerler: geçiş görevinin oluşturma zamanı + 7 gün ile geçiş görevinin oluşturma zamanı + 90 gün arası.

2019-06-04T13:35:00Z

ImageName

string

No

Geçiş görevi tarafından teslim edilen hedef Alibaba Cloud görüntüsünün adı. Görüntü adı aşağıdaki gereksinimleri karşılamalıdır:

  • Görüntü adı aynı Alibaba Cloud bölgesi içinde benzersiz olmalıdır.

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

Not

Geçiş görevi sırasında, geçerli bölgede aynı ada sahip bir görüntü zaten varsa, sistem varsayılan olarak ImageName_j-2zexxxxxxxxxxxxx şeklinde görüntü adına son ek olarak geçiş görevi kimliğini (JobId) ekler.

testAliCloudImageName

InstanceId

string

No

Hedef örnek kimliği.

i-bp1f1dvfto1sigz5****

SystemDiskSize

integer

No

Hedef Alibaba Cloud ECS örneğinin sistem bulut diski boyutu. Birim: GiB. Geçerli değerler: 20 ila 2048.

Not

Bu parametrenin değeri, geçiş kaynağı sistem bulut diskinin fiilen kullanılan alanından büyük olmalıdır. Örneğin, kaynak sistem bulut diski boyutu 500 GiB ancak fiilen kullanılan alan 100 GiB ise, bu parametrenin değeri 100 GiB'den büyük olmalıdır.

80

VpcId

string

No

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

vpc-bp1vwnn14rqpyiczj****

VSwitchId

string

No

Belirtilen VPC'deki vSwitch'in kimliği.

vsw-bp1ddbrxdlrcbim46****

ReplicationParameters

string

No

Çoğaltma sürücüsünün parametre bilgileri. Parametre bilgileri, sabit anahtarlara sahip JSON anahtar-değer çifti biçimindedir. Maksimum uzunluk: 2048 karakter.

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

NetMode

integer

No

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

  • 0: Genel ağ iletim modu. Geçiş kaynağının İnternet'e erişimi olmalıdır ve geçiş verileri İnternet üzerinden iletilir.

  • 2: Dahili ağ iletim modu. Bu modu seçerseniz VSwitchId parametresini ayarlamanız gerekir. Hizmet, dahili API çağrıları aracılığıyla VPC kimliğini otomatik olarak alabildiği için VpcId parametresini ayarlamanıza gerek yoktur.

Varsayılan değer: 0.

0

RunOnce

boolean

No

Tek seferlik bir geçiş görevi mi yoksa artımlı bir geçiş görevi mi oluşturulacağını belirtir. Geçerli değerler:

  • true (varsayılan): Tek seferlik geçiş görevi. Görev, oluşturulduktan sonra yalnızca bir kez çalışır.

  • false: Artımlı geçiş görevi. Görev oluşturulduktan sonra, Frequency parametresinin değerine göre periyodik olarak otomatik şekilde çalışır. Artımlı geçiş görevleri, işinizi duraklatmadan geçiş kaynağından Alibaba Cloud'a artımlı verileri senkronize etmenize ve görevin çalıştığı anda geçiş kaynağının tam veri görüntüsünü oluşturmanıza olanak tanır.

Not

Bu parametre yalnızca bir geçiş görevi oluştururken belirtilebilir. Değer belirtildikten sonra değiştirilemez.

true

Frequency

integer

No

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

RunOnce false olarak ayarlandığında bu parametre gereklidir.

Varsayılan değer: null.

12

MaxNumberOfImageToKeep

integer

No

Artımlı bir geçiş görevi için varsayılan olarak tutulan maksimum görüntü sayısı. Geçerli değerler: 1 ila 10.

RunOnce false olarak ayarlandığında bu parametre gereklidir.

Varsayılan değer: null.

10

InstanceType

string

No

Ara ECS örneğinin örnek türü.

Elastic Compute Service (ECS) tarafından sağlanan örnek türlerini sorgulamak için DescribeInstanceTypes API'sini çağırın.

  • Bu parametreyi belirtirseniz, sistem ara örneği belirtilen örnek türüyle 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'de ara örnekler için hangi örnek türleri kullanılabilir konusuna bakın.

ecs.c6.large

LaunchTemplateId

string

No

Örnek başlatma şablonunun kimliği.

lt-bp16jovvln1cgaaq****

LaunchTemplateVersion

string

No

Örnek başlatma şablonunun sürümü.

1

InstanceRamRole

string

No

Örnek 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 konusuna bakın.

testNamespace

ContainerRepository

string

No

Docker görüntü deposu. Docker konteyner görüntüleri hakkında daha fazla bilgi için Container Registry konusuna bakın.

testRepository

ContainerTag

string

No

Docker görüntü etiketi. Docker konteyner görüntüleri hakkında daha fazla bilgi için Container Registry konusuna bakın.

CentOS:v1

LicenseType

string

No

Lisans türü. Geçerli değerler:

  • Boş değer: Lisans yok.

  • BYOL: Kendi Lisansınızı Getirin (Bring Your Own License).

Daha fazla bilgi için SMC SSS konusuna bakın.

BYOL

DataDisk

array<object>

No

Veri bulut diski bilgileri listesi.

array<object>

No

Veri bulut diski bilgileri listesi.

Index

integer

No

Hedef Alibaba Cloud ECS örneğindeki veri bulut diskinin dizini. Başlangıç değeri 1'dir. Geçerli değerler: 1 ila 16.

Not

Yalnızca geçiş kaynağında bulunan veri diskleri için hedef veri bulut diskleri oluşturabilirsiniz.

1

Part

array<object>

No

Bölüm listesi.

object

No

Bölüm listesi.

SizeBytes

integer

No

Hedef N veri bulut diskindeki N bölümünün boyutu. Birim: bayt. Varsayılan değer: kaynak veri bulut diski bölümünün boyutu.

Not
  • Bölüm boyutu veri bulut diski boyutunu aşamaz ve aynı veri bulut diskindeki tüm bölümlerin toplam boyutu veri bulut diski boyutunu aşamaz.

  • DataDisk.N.Part.N.Device boş değilse, bu parametre de boş olamaz.

254803968

Block

boolean

No

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

true

Device

string

No

N veri bulut diskindeki N bölümünün aygıt tanımlayıcısı. N'nin gerçek değeri için geçiş kaynağının bölüm aygıt tanımlayıcısına bakın.

Not

DataDisk.N.Part.N.SizeBytes boş değilse, bu parametre de boş olamaz.

0_1

Size

integer

No

Hedef Alibaba Cloud ECS örneğindeki veri bulut diskinin boyutu. Birim: GiB. Geçerli değerler: 20 ila 32768.

Not

Bu parametrenin değeri, geçiş kaynağı veri bulut diskinin fiilen kullanılan alanından büyük olmalıdır. Örneğin, kaynak veri bulut diski boyutu 500 GiB ve fiilen kullanılan alan 100 GiB ise, bu parametrenin değeri 100 GiB'den büyük olmalıdır.

100

Tag

array<object>

No

Etiket listesi.

object

No

Etiket listesi.

Key

string

No

Geçiş görevinin etiket anahtarı. N için geçerli değerler: 1 ila 20.

TestKey

Value

string

No

Geçiş görevinin etiket değeri. N için geçerli değerler: 1 ila 20.

TestValue

SystemDiskPart

array<object>

No

Sistem bulut diskinin bölüm bilgileri.

object

No

Sistem bulut diski bölümlerinin listesi.

SizeBytes

integer

No

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

254803968

Block

boolean

No

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

true

Device

string

No

N sistem diski bölümünün aygıt tanımlayıcısı. N'nin gerçek değeri için geçiş kaynağının bölüm aygıt tanımlayıcısına bakın.

Not

SystemDiskPart.N.SizeBytes boş değilse, bu parametre de boş olamaz.

0_1

JobType

integer

No

Geçiş görevinin türü. Geçerli değerler:

0

ResourceGroupId

string

No

Kaynak grubunun kimliği.

rg-acfmw3ty5y7****

Disks

object

No

Disk bilgileri.

System

object

No

Sistem bulut diski bilgileri.

Size

integer

No

Geçiş kaynağındaki sistem diskinin boyutu. Birim: GiB. Geçerli değerler: 20 ila 32768.

Not

Değer, kaynak sistem diskinin fiilen kullanılan alanından büyük olmalıdır. Örneğin, kaynak sistem diski 500 GiB ancak yalnızca 100 GiB kullanılıyorsa, bu parametreyi 100 GiB'den büyük bir değere ayarlayın.

100

LVM

boolean

No

Mantıksal Birim Yöneticisi (LVM) kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

  • true: LVM kullanır.

  • false: LVM kullanmaz.

Aşağıdaki senaryolarda LVM etkinleştirilemez:

  • Geçiş kaynağı bir Windows işletim sistemi çalıştırıyorsa.

  • Sistem bulut diskinde bir önyükleme bölümü yoksa.

LVM etkinleştirildikten sonra, aşağıdaki senaryolarda özellik etkili olmaz:

  • Geçiş kaynağı lvm2'yi desteklemiyorsa veya lvm2 paketi yüklü değilse.

  • Geçiş kaynağı 3.x veya daha önceki bir çekirdek sürümüne sahip bir Debian sistemi çalıştırıyorsa ve XFS dosya sistemi bağlanmış bir diske sahipse.

true

Part

array<object>

No

Sistem bulut diskinin bölüm bilgileri.

object

No

Sistem bulut diskinin bölüm bilgileri.

SizeBytes

integer

No

Sistem bulut diski bölümünün boyutu. Birim: bayt.

254803968

Block

boolean

No

Sistem bulut diski bölümü için blok çoğaltmanın etkinleştirilip etkinleştirilmeyeceğini belirtir.

true

Path

string

No

Sistem bulut diski bölümünün yolu.

/boot

Data

array<object>

No

Veri bulut diskinin bölüm bilgileri.

array<object>

No

Veri bulut diskinin bölüm bilgileri.

Size

integer

No

Geçiş kaynağındaki veri bulut diskinin boyutu. Birim: GiB.

80

LVM

boolean

No

Veri bulut diski için LVM kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

DiskId

string

No

Veri bulut diskinin kimliği.

d-2ze8hyowhdgd6ou2m5z6

Part

array<object>

No

Veri bulut diskinin bölüm bilgileri.

object

No

Veri bulut diskinin bölüm bilgileri.

SizeBytes

integer

No

Veri bulut diski bölümünün boyutu. Birim: bayt.

21474836480

Block

boolean

No

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

  • true: Veri bulut diski bölümü için blok çoğaltma etkinleştirilmiştir.

  • false: Veri bulut diski bölümü için blok çoğaltma etkinleştirilmemiştir.

true

Path

string

No

Veri bulut diski bölümünün yolu.

/home/date

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

RequestId

string

İstek kimliği.

C8B26B44-0189-443E-9816-D951F59623A9

JobId

string

Geçiş görevinin kimliği.

j-bp17bclvg344jlyt****

Examples

Success response

JSON format

{
  "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  "JobId": "j-bp17bclvg344jlyt****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ReplicationJobDataDiskIndex.Invalid The specified replication job contains data disk index not found in source server.
400 VSwitchIdVpcId.Mismatch The specified VSwitchId and VpcId does not match.
400 InvalidSecurityGroupId.IncorrectNetworkType The network type of the specified security group does not support this action.
400 InvalidSecurityGroupId.VPCMismatch The specified security group and the specified virtual switch are not in the same VPC.
400 QuotaExceeded.ReplicationJob The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota.
400 ReplicationJobName.Duplicate The specified replication job name already exists.
400 SourceServerState.Invalid The specified source server status: %s 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.
400 InvalidOsMigrationType.NotMatched The SourceOsType: %s and TargetOsType: %s are not matched. The supported TargetOsType list is: %s.
500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.
403 EntityNotExist.Role The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account.
403 RealNameAuthenticationError You must perform real-name verification for your account.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.