すべてのプロダクト
Search
ドキュメントセンター

Server Migration Center:CreateReplicationJob

最終更新日:Nov 13, 2025

移行元サーバーの移行タスクを作成します。

操作説明

説明

  • 移行タスクは、Available 状態の移行元サーバーに対してのみ作成できます。

  • 1 つの移行元サーバーは、Ready、Running、Stopped、Waiting、InError、または Expired などの未完了状態の移行タスクに 1 つだけ関連付けることができます。

  • 各 Alibaba Cloud アカウントは、最大 1,000 個の移行タスクを作成できます。

  • 移行先がイメージの場合、ImageName、SystemDiskSize、および DataDisk パラメーターが必要です。

  • VPC 内部ネットワーク経由の移行では、VSwitchId パラメーターは必須で、VpcId パラメーターはオプションです。

  • 低コストのアプリケーションコンテナ化のために、移行元サーバーを Docker コンテナイメージに移行できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

smc:CreateReplicationJob

create

*ReplicationJob

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

*SourceServer

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

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

移行先の Alibaba Cloud リージョンの ID。

たとえば、移行元サーバーを中国 (杭州) リージョンに移行する場合、このパラメーターを cn-hangzhou に設定します。DescribeRegions 操作を呼び出して、Alibaba Cloud リージョンの最新リストをクエリできます。

cn-hangzhou

ClientToken

string

任意

リクエストのべき等性を保証するためのクライアントトークン。最大 64 文字の ASCII 文字列を生成し、このパラメーターに割り当てます。詳細については、「べき等性を確保する方法」をご参照ください。

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 は移行元から Alibaba Cloud イメージを生成します。

  • ContainerImage: SMC は移行元から Docker コンテナイメージを生成します。

  • TargetInstance: SMC は移行元サーバーを宛先インスタンスに移行します。このパラメーターを TargetInstance に設定する場合は、InstanceId パラメーターも指定する必要があります。

Image

ScheduledStartTime

string

任意

移行タスクを開始する時間。時間は次の要件を満たす必要があります。

  • 時間は ISO 8601 標準に準拠し、UTC である必要があります。フォーマットは YYYY-MM-DDThh:mm:ssZ です。たとえば、2018-01-01T12:00:00Z は 2018 年 1 月 1 日 20:00:00 (UTC+8) を指定します。

  • 時間は現在時刻より後で、30 日以内である必要があります。

説明

このパラメーターを空のままにすると、移行タスクは自動的に開始されません。StartReplicationJob 操作を呼び出してタスクを開始する必要があります。

2019-06-04T13:35:00Z

ValidTime

string

任意

移行タスクの有効期限が切れる時間。値はタスク作成後 7~90 日の間である必要があります。

  • 時間は ISO 8601 標準に準拠し、UTC である必要があります。フォーマットは YYYY-MM-DDThh:mm:ssZ です。たとえば、2018-01-01T12:00:00Z は 2018 年 1 月 1 日 20:00:00 (UTC+8) を指定します。

  • このパラメーターを空のままにすると、タスクは有効期限切れになりません。

  • タスクの有効期限が切れると、`Expired` とマークされます。有効期限切れのタスクは 7 日間保持され、その後自動的に削除されます。

デフォルト値: タスク作成後 30 日。

2019-06-04T13:35:00Z

ImageName

string

任意

移行先の Alibaba Cloud イメージの名前。名前は次の要件を満たす必要があります。

  • イメージ名は、同じ Alibaba Cloud リージョン内で一意である必要があります。

  • 名前は 2~128 文字である必要があります。文字または漢字で始める必要があります。http:// または https:// で始めることはできません。数字、コロン (:)、アンダースコア (_)、ハイフン (-) を含めることができます。

説明

移行タスクの実行中に、同じ名前のイメージが現在のリージョンに既に存在する場合、システムは移行タスク ID (JobId) をイメージ名のサフィックスとして追加します。例: `ImageName_j-2zexxxxxxxxxxxxx`。

testAliCloudImageName

InstanceId

string

任意

宛先インスタンスの ID。

i-bp1f1dvfto1sigz5****

SystemDiskSize

integer

任意

移行先の Elastic Compute Service (ECS) インスタンスのシステムディスクサイズ。単位: GiB。有効な値: 20~2048。

説明

値は、移行元システムディスクの使用済み領域より大きい必要があります。たとえば、移行元システムディスクが 500 GiB で、100 GiB の領域が使用されている場合、このパラメーターを 100 より大きい値に設定します。

80

VpcId

string

任意

Express Connect 回線または VPN Gateway が設定されている VPC の ID。

vpc-bp1vwnn14rqpyiczj****

VSwitchId

string

任意

指定された VPC 内の vSwitch の ID。

このパラメーターは、VPC 内部ネットワーク経由の移行に必要です。

vsw-bp1ddbrxdlrcbim46****

ReplicationParameters

string

任意

レプリケーションドライバーのパラメーター。パラメーターは JSON のキーと値のペアです。キーは固定です。値は最大 2,048 文字です。

レプリケーションドライバーは、移行元サーバーから中間インスタンスにデータをコピーするために使用されるツールです。サポートされるパラメーターは、レプリケーションドライバーによって異なります。SMT レプリケーションドライバーは、次のパラメーターをサポートしています。

  • bandwidth_limit: データ転送の帯域幅制限。

  • compress_level: データ転送の圧縮率。

  • checksum: チェックサム検証を有効にするかどうかを指定します。

レプリケーションドライバーの値を取得するには、「DescribeSourceServers」の SourceServers.ReplicationDriver レスポンスパラメーターをご参照ください。

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

NetMode

integer

任意

データ転送のネットワークモード。有効な値:

  • 0: インターネット。データはインターネット経由で転送されます。移行元サーバーはインターネットにアクセスできる必要があります。

  • 2: 内部ネットワーク。このモードを選択した場合は、VSwitchId パラメーターを設定する必要があります。サービスが自動的に VPC ID をクエリできるため、VpcId パラメーターはオプションです。

デフォルト値: 0。

0

RunOnce

boolean

任意

1 回限りの移行タスクを作成するか、増分移行タスクを作成するかを指定します。有効な値:

  • true (デフォルト): 1 回限りの移行タスク。タスクは作成後に 1 回だけ実行されます。

  • false: 増分移行タスク。タスクが作成されると、Frequency パラメーターで指定された間隔で自動的に実行されます。増分移行タスクを使用すると、サービスを中断することなく、移行元サーバーから Alibaba Cloud に増分データを同期し、タスク実行時の移行元サーバーの完全なデータイメージを生成できます。

説明

このパラメーターは、移行タスクの作成時にのみ指定できます。タスクの作成後に値を変更することはできません。

true

Frequency

integer

任意

増分移行タスクが実行される間隔。単位: 時間。有効な値: 1~168。

このパラメーターは、RunOnce パラメーターを `false` に設定した場合に必要です。

デフォルト値: なし。

12

MaxNumberOfImageToKeep

integer

任意

増分移行タスクで保持するイメージの最大数。有効な値: 1~10。

このパラメーターは、RunOnce パラメーターを `false` に設定した場合に必要です。

デフォルト値: なし。

10

InstanceType

string

任意

中間インスタンスのインスタンスタイプ。

DescribeInstanceTypes 操作を呼び出して、ECS が提供するインスタンスタイプをクエリできます。

  • このパラメーターを指定すると、システムは指定されたインスタンスタイプの中間インスタンスを作成します。指定されたインスタンスタイプが在庫切れの場合、移行タスクの作成は失敗します。

  • このパラメーターを指定しない場合、システムは特定順序でインスタンスタイプを選択して中間インスタンスを作成します。詳細については、「SMC よくある質問」の「中間インスタンスにはどのインスタンスタイプが使用されますか?」セクションをご参照ください。

ecs.c6.large

LaunchTemplateId

string

任意

起動テンプレートの ID。

lt-bp16jovvln1cgaaq****

LaunchTemplateVersion

string

任意

起動テンプレートのバージョン。

1

InstanceRamRole

string

任意

インスタンスの RAM ロールの名前。

SMCAdmin

ContainerNamespace

string

任意

Docker コンテナーの名前空間。詳細については、「Container Registry」をご参照ください。

testNamespace

ContainerRepository

string

任意

Docker コンテナーのイメージリポジトリ。詳細については、「Container Registry」をご参照ください。

testRepository

ContainerTag

string

任意

Docker コンテナーのイメージタグ。詳細については、「Container Registry」をご参照ください。

CentOS:v1

LicenseType

string

任意

ライセンスタイプ。有効な値:

  • このパラメーターを空のままにすると、ライセンスがないことを示します。

  • BYOL: Bring Your Own License (BYOL)。

詳細については、「SMC よくある質問」をご参照ください。

BYOL

DataDisk

array<object>

任意

データディスクのリスト。

array<object>

任意

データディスクのリスト。

Index

integer

任意

宛先 ECS インスタンス上のデータディスクのシーケンス番号。シーケンスは 1 から始まります。有効な値: 1~16。

説明

移行元に存在するデータディスクに対してのみ、宛先データディスクを作成できます。

1

Part

array<object>

任意

パーティションのリスト。

object

任意

パーティションのリスト。

SizeBytes

integer

任意

データディスク N のパーティション N のサイズ。単位: バイト。デフォルト値: 移行元データディスクパーティションのサイズ。

説明
  • パーティションサイズはデータディスクサイズを超えることはできません。データディスク上のすべてのパーティションの合計サイズは、データディスクサイズを超えることはできません。

  • このパラメーターは、DataDisk.N.Part.N.Device が空でない場合は空にできません。

254803968

Block

boolean

任意

データディスク N のパーティション N のブロックレプリケーションを有効にするかどうかを指定します。有効な値:

  • true

  • false

デフォルト値: `true`。

true

Device

string

任意

データディスク N のパーティション N のデバイス ID。N の値は、移行元パーティションのデバイス ID の N の値と同じである必要があります。

説明

このパラメーターは、DataDisk.N.Part.N.SizeBytes が空でない場合は空にできません。

0_1

Size

integer

任意

宛先 ECS インスタンスのデータディスクのサイズ。単位: GiB。有効な値: 20~32768。

説明

値は、移行元データディスクの使用済み領域より大きい必要があります。たとえば、移行元データディスクが 500 GiB で、100 GiB の領域が使用されている場合、このパラメーターを 100 より大きい値に設定します。

100

Tag

array<object>

任意

タグのリスト。

object

任意

タグのリスト。

Key

string

任意

移行タスクのタグ N のキー。N の有効な値: 1~20。

タグキーは空の文字列にできません。最大 128 文字です。aliyunacs:http://、または https:// で始めることはできません。

TestKey

Value

string

任意

移行タスクのタグ N の値。N の有効な値: 1~20。

タグ値は空の文字列にできます。最大 128 文字です。aliyunacs:http://、または https:// で始めることはできません。

TestValue

SystemDiskPart

array<object>

任意

システムディスクパーティションに関する情報。

object

任意

システムディスクパーティションのリスト。

SizeBytes

integer

任意

システムディスクパーティション N のサイズ。単位: バイト。デフォルト値: 移行元システムディスクパーティションのサイズ。

説明
  • パーティションサイズはシステムディスクサイズを超えることはできません。システムディスク上のすべてのパーティションの合計サイズは、システムディスクサイズを超えることはできません。

  • このパラメーターは、SystemDiskPart.N.Device が空でない場合は空にできません。

254803968

Block

boolean

任意

システムディスクパーティション N のブロックレプリケーションを有効にするかどうかを指定します。有効な値:

  • true

  • false

デフォルト値: `true`。

true

Device

string

任意

システムディスクパーティション N のデバイス ID。N の値は、移行元パーティションのデバイス ID の N の値と同じである必要があります。

説明

このパラメーターは、SystemDiskPart.N.SizeBytes が空でない場合は空にできません。

0_1

JobType

integer

任意

移行タスクのタイプ。有効な値:

  • 0: サーバー移行。

  • 1: オペレーティングシステム移行。

  • 2: クロスゾーン移行。

  • 3: VMware のエージェントレス移行。

0

ResourceGroupId

string

任意

リソースグループの ID。

rg-acfmw3ty5y7****

Disks

object

任意

ディスク情報。

System

object

任意

システムディスク情報。

Size

integer

任意

移行元システムディスクのサイズ。単位: GiB。有効な値: 20~32768。

説明

値は、移行元システムディスクの使用済み領域より大きい必要があります。たとえば、移行元システムディスクが 500 GiB で、100 GiB の領域が使用されている場合、このパラメーターを 100 より大きい値に設定します。

100

LVM

boolean

任意

論理ボリューム管理 (LVM) を使用するかどうかを指定します。有効な値:

  • true: LVM を使用します。

  • false: LVM を使用しません。

LVM は次のシナリオではサポートされていません。

  • 移行元サーバーが Windows オペレーティングシステムを実行している。

  • システムディスクにブートパーティションがない。

LVM を有効にしても、次のシナリオでは機能は有効になりません。

  • 移行元サーバーが lvm2 をサポートしていないか、lvm2 パッケージがインストールされていない。

  • 移行元サーバーがカーネルバージョン 3.x 以前の Debian オペレーティングシステムを実行しており、XFS ファイルシステムを持つディスクがマウントされている。

true

Part

array<object>

任意

システムディスクパーティションに関する情報。

object

任意

システムディスクパーティションに関する情報。

SizeBytes

integer

任意

システムディスクパーティションのサイズ。単位: バイト。

254803968

Block

boolean

任意

システムディスクパーティションのブロックレプリケーションを有効にするかどうかを指定します。

true

Path

string

任意

システムディスクパーティションのパス。

/boot

Data

array<object>

任意

データディスクパーティションに関する情報。

array<object>

任意

データディスクパーティションに関する情報。

Size

integer

任意

移行元データディスクのサイズ。単位: GiB。

80

LVM

boolean

任意

データディスクに LVM を使用するかどうかを指定します。有効な値:

  • true: LVM を使用します。

  • false: LVM を使用しません。

DiskId

string

任意

データディスクの ID。

d-2ze8hyowhdgd6ou2m5z6

Part

array<object>

任意

データディスクパーティションに関する情報。

object

任意

データディスクパーティションに関する情報。

SizeBytes

integer

任意

データディスクパーティションのサイズ。単位: バイト。

21474836480

Block

boolean

任意

データディスクパーティションのブロックレプリケーションを有効にするかどうかを指定します。有効な値:

  • true: データディスクパーティションのブロックレプリケーションを有効にします。

  • false: データディスクパーティションのブロックレプリケーションを無効にします。

true

Path

string

任意

データディスクパーティションのパス。

/home/date

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

RequestId

string

リクエスト ID。

C8B26B44-0189-443E-9816-D951F59623A9

JobId

string

移行タスクの ID。

j-bp17bclvg344jlyt****

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

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. 指定された VSwitchId と VpcId が一致しません。
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. 指定されたセキュリティグループと VSwitch は同じ 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. 口座が実名認証されていないので、まず実名認証を行ってください

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。