全部產品
Search

搜尋本產品

    Server Migration Center：CreateReplicationJob

    文件中心

    Server Migration Center：CreateReplicationJob

    更新時間：Aug 20, 2026

    呼叫 CreateReplicationJob 為遷移來源建立一個遷移任務。

    介面說明

    介面說明

    • 您只能為線上（Available）狀態的遷移來源建立遷移任務。

    • 每個遷移來源僅能關聯一個未完成狀態的遷移任務。未完成狀態包括 Ready（未開始）、Running（執行中）、Stopped（已暫停）、Waiting（等待中）、InError（出錯）和 Expired（已過期）。

    • 每個阿里雲帳號可建立 1000 個遷移任務。

    • 遷移目標類型為映像時，需指定 ImageName、SystemDiskSize、DataDisk 參數。

    • 使用 VPC 內網遷移時，VSwitchId 參數為必填，VpcId 參數為可選。

    • 支援遷移來源的遷移目標為 Docker 容器映像，實現低成本容器化應用程式遷移。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    smc:CreateReplicationJob

    create

    *ReplicationJob

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

    *SourceServer

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

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    遷移來源要遷入的目標阿里雲端地域 ID。

    例如，您需要將來源伺服器遷移至杭州，則相應的阿里雲端地域 ID 為 cn-hangzhou。您可以呼叫 DescribeRegions 檢視最新的阿里雲端地域清單。

    cn-hangzhou
    ClientToken

    string

    否

    保證請求冪等性。您可以從用戶端產生一個不超過 64 個 ASCII 字元的參數值，並將值賦予 ClientToken，保證重試請求的冪等性。更多詳情，請參見如何保證冪等性。

    123e4567-e89b-12d3-a456-426655440000
    Name

    string

    否

    遷移任務名稱。遷移任務的名稱需滿足以下要求：

    • 任務名稱必須唯一。

    • 長度為 2~128 個英文或中文字元，必須以大小寫字母或中文開頭，不能以 http:// 和 https:// 開頭，可以包含數字、半形冒號（:）、底線（_）或連字號（-）。

    testMigrationTaskName
    Description

    string

    否

    遷移任務描述。

    長度應為 2~128 個英文或中文字元，必須以大小寫字母或中文開頭，不能以 http:// 和 https:// 開頭，可以包含數字、半形冒號（:）、底線（_）或連字號（-）。

    This_is_a_migration_task
    SourceId

    string

    是

    遷移來源 ID。

    s-bp1e2fsl57knvuug****
    TargetType

    string

    否

    遷移任務交付的目標類型。取值範圍：

    • Image：遷移成功後，SMC 為您的遷移來源產生阿里雲端映像。

    • ContainerImage：遷移成功後，SMC 為您的遷移來源產生 Docker 容器映像。

    • TargetInstance：遷移成功後，SMC 將您的遷移來源直接遷移至目標執行個體。當您設定該參數值時，您需要同時指定 InstanceId 參數。

    Image
    ScheduledStartTime

    string

    否

    遷移任務的執行時間。該參數值的設定需滿足以下要求：

    • 遵循 ISO8601 標準，並需要使用 UTC+0 時間，格式為 YYYY-MM-DDThh:mm:ssZ。例如，2018-01-01T12:00:00Z，表示北京時間 2018 年 01 月 01 日 20 點 00 分 00 秒。

    • 該參數值必須晚於當前時間，並且需要設定在 30 天以內。

    說明

    如果該參數值為空，則 SMC 不會啟動遷移任務，需要您呼叫 StartReplicationJob 啟動任務。

    2019-06-04T13:35:00Z
    ValidTime

    string

    否

    遷移任務的過期時間。取值範圍：遷移任務建立時間+7 天~遷移任務建立時間+90 天。

    • 過期時間須遵循 ISO8601 標準，並需要使用 UTC+0 時間，格式為 YYYY-MM-DDThh:mm:ssZ。例如，2018-01-01T12:00:00Z，表示北京時間 2018 年 01 月 01 日 20 點 00 分 00 秒。

    • 過期時間設定為空，表示任務無限期有效。

    • 任務到期後會被標記為過期狀態，儲存 7 天，7 天後系統會自動清理。

    預設值：遷移任務建立時間+30 天（表示遷移任務的預設有效期為建立後 30 天）。

    2019-06-04T13:35:00Z
    ImageName

    string

    否

    遷移任務交付的目標阿里雲端映像名稱。目標映像的名稱需滿足以下要求：

    testAliCloudImageName
    InstanceId

    string

    否

    目標執行個體 ID。

    i-bp1f1dvfto1sigz5****
    SystemDiskSize

    integer

    否

    目標阿里雲端伺服器 ECS 的系統磁碟大小，單位為 GiB。取值範圍：20~2048。

    說明

    該參數取值需要大於遷移來源系統磁碟實際佔用大小，例如，來源系統磁碟大小為 500 GiB，實際佔用 100 GiB，則該參數取值需大於 100 GiB。

    80
    VpcId

    string

    否

    已設定高速通道服務或者 VPN 閘道器的 VPC ID。

    vpc-bp1vwnn14rqpyiczj****
    VSwitchId

    string

    否

    指定 VPC 下的虛擬交換器 ID。

    vsw-bp1ddbrxdlrcbim46****
    ReplicationParameters

    string

    否

    複製驅動器的參數資訊。參數資訊為 JSON 格式鍵值對，鍵值固定。最大長度：2048 個字元。

    複製驱动器是指，複製來源伺服器資料到中轉執行個體時所使用的工具。不同複製驱动器支援的參數可能不同。複製驱动器 SMT 目前支援以下參數：

    • bandwidth_limit：傳輸速度頻寬限制。

    • compress_level：傳輸壓縮率。

    • checksum：是否開啟 checksum 校驗。

    複製驱动器的取值，請參閱 DescribeSourceServers 的返回參數 SourceServers.ReplicationDriver。

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

    integer

    否

    資料傳輸網路模式。取值範圍：

    • 0：表示公網傳輸模式。此時要求您的來源伺服器能夠存取公網，遷雲資料從公網傳輸。

    • 2：表示內網傳輸模式，選用此模式必須設定 VSwitchId 參數（VpcId 參數可以不設定，服務內部可以透過介面反查出來）。

    預設值：0。

    0
    RunOnce

    boolean

    否

    建立一次性遷移任務還是增量遷移任務。取值範圍：

    • true（預設值）：一次性遷移任務。任務建立後，僅執行一次。

    • false：增量遷移任務。任務建立後，按照您設定的 Frequency 參數值週期性自動執行。使用增量遷移任務，可在業務不暫停的情況下，同步來源伺服器的增量資料至阿里雲，並為來源伺服器產生任務執行時刻的全量資料映像。

    說明

    該參數值只能在建立遷移任務時指定。參數值一經指定，則無法變更。

    true
    Frequency

    integer

    否

    增量遷移任務執行的時間間隔，單位：小時。取值範圍：1~168。

    12
    MaxNumberOfImageToKeep

    integer

    否

    增量遷移任務預設保留的最大映像數。取值範圍：1~10。

    10
    InstanceType

    string

    否

    中轉執行個體的執行個體規格。

    呼叫 DescribeInstanceTypes 可查詢雲端伺服器 ECS 提供的執行個體規格。

    • 指定該參數後，系統會選擇該執行個體規格建立中轉執行個體。若該執行個體規格庫存不足，則遷移任務建立失敗。

    • 不指定該參數時，系統預設會按照一定順序選擇執行個體規格來建立中轉執行個體，詳情請參見SMC FAQ 中轉執行個體規格有哪些。

    ecs.c6.large
    LaunchTemplateId

    string

    否

    執行個體啟動範本 ID。

    lt-bp16jovvln1cgaaq****
    LaunchTemplateVersion

    string

    否

    執行個體啟動範本的版本。

    1
    InstanceRamRole

    string

    否

    執行個體 RAM 角色名稱。

    SMCAdmin
    ContainerNamespace

    string

    否

    Docker 的命名空間。關於 Docker 容器映像詳情請參見容器映像服務。

    testNamespace
    ContainerRepository

    string

    否

    Docker 的映像倉庫。關於 Docker 容器映像詳情請參見容器映像服務。

    testRepository
    ContainerTag

    string

    否

    Docker 的映像標籤。關於 Docker 容器映像詳情請參見容器映像服務。

    CentOS:v1
    LicenseType

    string

    否

    授權類型。取值範圍：

    BYOL
    DataDisk

    array<object>

    否

    資料磁碟資訊清單。

    array<object>

    否

    資料磁碟資訊清單。

    Index

    integer

    否

    目標阿里雲端伺服器 ECS 的資料磁碟順序。初始值為 1。取值範圍：1~16

    1
    Part

    array<object>

    否

    分割區清單。

    object

    否

    分割區清單。

    SizeBytes

    integer

    否

    目標資料磁碟 N 分割區 N 的大小。單位：Byte。預設為來源資料磁碟分割區大小。

    說明

    • 分割區空間大小不能超過資料磁碟空間大小，並且在同一資料磁碟下所有分割區空間大小之和不能超過資料磁碟空間大小。

    • 當 DataDisk.N.Part.N.Device 不為空時，此參數也不能為空。

    254803968
    Block

    boolean

    否

    資料磁碟 N 分割區 N 是否開啟區塊複製。取值範圍：

    true
    Device

    string

    否

    目標資料磁碟 N 分割區 N 對應的分割區裝置識別碼。N 的實際取值請參考遷移來源的分割區裝置識別碼。

    說明

    當 DataDisk.N.Part.N.SizeBytes 不為空時，此參數也不能為空。

    0_1
    Size

    integer

    否

    目標阿里雲端伺服器 ECS 的資料磁碟大小，單位為 GiB。取值範圍：20~32768。

    說明

    該參數取值需要大於遷移來源資料磁碟實際佔用大小。例如，來源資料磁碟大小為 500 GiB，實際佔用 100 GiB，則該參數取值需大於 100 GiB。

    100
    Tag

    array<object>

    否

    標籤清單。

    object

    否

    標籤清單。

    Key

    string

    否

    遷移任務的標籤鍵。N 的取值範圍：1~20

    一旦傳入該值，則不允許為空字串。最多支援 128 個字元，不能以 aliyun、acs:、http:// 或 https:// 開頭。

    TestKey
    Value

    string

    否

    遷移任務的標籤值。N 的取值範圍：1~20。

    一旦傳入該值，可以為空字串。最多支援 128 個字元，不能以 aliyun、acs:、http:// 或 https:// 開頭。

    TestValue
    SystemDiskPart

    array<object>

    否

    系統磁碟分割區資訊。

    object

    否

    系統磁碟分割區清單。

    SizeBytes

    integer

    否

    系統磁碟分割區 N 大小。單位：Byte。預設為來源系統磁碟分割區大小。

    說明

    • 分割區空間大小不能超過系統磁碟空間大小，並且在系統磁碟下所有分割區空間大小之和不能超過系統磁碟空間大小。

    • 當 SystemDiskPart.N.Device 不為空時，此參數也不能為空。

    254803968
    Block

    boolean

    否

    系統磁碟分割區 N 是否開啟區塊複製。取值範圍：

    true
    Device

    string

    否

    目標系統磁碟分割區 N 裝置識別碼。N 的實際取值請參考遷移來源的分割區裝置識別碼。

    0_1
    JobType

    integer

    否

    遷移任務的類型。取值範圍：

    0
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-acfmw3ty5y7****
    Disks

    object

    否

    磁碟資訊。

    System

    object

    否

    系統磁碟資訊。

    Size

    integer

    否

    遷移來源系統磁碟的大小，單位：GiB。取值範圍為 20~32768。

    說明

    參數取值需要大於來源伺服器資料磁碟實際佔用大小。例如，來源資料磁碟大小為 500 GiB，實際佔用 100 GiB，則該參數取值需大於 100 GiB。

    100
    LVM

    boolean

    否

    是否使用 LVM。取值：

    • true：使用 LVM。

    • false：不使用 LVM。

    不支援開啟 LVM：

    • 遷移來源為 Windows 系統時，不支援開啟 LVM。

    • 系統磁碟無啟動分割區，不支援開啟 LVM。

    開啟 LVM 後，以下場景該功能不生效：

    • 遷移來源不支援 lvm2、未安裝 lvm2 軟體套件。

    • 遷移來源為核心版本在 3.x 及以下的 Debian 系統，且掛載了 XFS 檔案系統的磁碟。

    true
    Part

    array<object>

    否

    系統磁碟分割區資訊。

    object

    否

    系統磁碟分割區資訊。

    SizeBytes

    integer

    否

    系統磁碟分割區大小。單位：Byte。

    254803968
    Block

    boolean

    否

    系統磁碟分割區是否開啟區塊複製。

    true
    Path

    string

    否

    系統磁碟分割區路徑。

    /boot
    Data

    array<object>

    否

    資料磁碟分割區資訊。

    array<object>

    否

    資料磁碟分割區資訊。

    Size

    integer

    否

    遷移來源的資料磁碟大小。單位：GiB。

    80
    LVM

    boolean

    否

    資料磁碟是否使用 LVM。取值：

    DiskId

    string

    否

    資料磁碟 ID。

    d-2ze8hyowhdgd6ou2m5z6
    Part

    array<object>

    否

    資料磁碟分割區資訊。

    object

    否

    資料磁碟分割區資訊。

    SizeBytes

    integer

    否

    資料磁碟分割區大小。單位：Byte。

    21474836480
    Block

    boolean

    否

    資料磁碟分割區是否啟用區塊複製。取值：

    true
    Path

    string

    否

    資料磁碟分割區路徑。

    /home/date

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數資訊。

    RequestId

    string

    請求 ID。

    C8B26B44-0189-443E-9816-D951F59623A9
    JobId

    string

    遷移任務 ID。

    j-bp17bclvg344jlyt****

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    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.

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。