すべてのプロダクト
Search

このプロダクト

    Server Migration Center:CreateReplicationJob

    ドキュメントセンター

    Server Migration Center:CreateReplicationJob

    最終更新日:Aug 20, 2026

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

    操作説明

    操作の説明。

    今すぐお試しください

    この 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
    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: 移行が成功すると、Server Migration Center (SMC) が移行元の Alibaba Cloud イメージを生成します。

    • ContainerImage: 移行が成功すると、SMC が移行元の Docker コンテナイメージを生成します。

    • TargetInstance: 移行が成功すると、SMC が移行元をターゲットインスタンスに直接移行します。このパラメーターを TargetInstance に設定する場合、InstanceId パラメーターも指定する必要があります。

    Image
    ScheduledStartTime

    string

    任意

    移行タスクの実行時間。このパラメーターの値は、以下の要件を満たす必要があります。

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

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

    説明

    このパラメーターが空の場合、Server Migration Center (SMC) は移行タスクを開始しません。タスクを開始するには、 StartReplicationJob を呼び出す必要があります。

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

    string

    任意

    移行タスクの有効期限。有効な値: 移行タスクの作成時間 + 7 日から移行タスクの作成時間 + 90 日まで。

    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

    任意

    移行先 Alibaba Cloud ECS インスタンスのシステムクラウドディスクサイズ。単位: GiB。有効な値: 20～2048。

    説明

    このパラメーターの値は、移行元のシステムクラウドディスクの実際の使用容量より大きい必要があります。たとえば、移行元のシステムクラウドディスクサイズが 500 GiB で、実際の使用容量が 100 GiB の場合、このパラメーターの値は 100 GiB より大きくする必要があります。

    80
    VpcId

    string

    任意

    Express Connect または VPN ゲートウェイが設定されている VPC の ID。

    vpc-bp1vwnn14rqpyiczj****
    VSwitchId

    string

    任意

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

    vsw-bp1ddbrxdlrcbim46****
    ReplicationParameters

    string

    任意

    レプリケーションドライバーのパラメーター情報。パラメーター情報は固定キーを持つ JSON キーと値のペアフォーマットです。最大長: 2048 文字。

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

    integer

    任意

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

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

    • 2: 内部ネットワーク転送モード。このモードを選択する場合、VSwitchId パラメーターを設定する必要があります。サービスが内部 API 呼び出しを通じて VPC ID を自動的に取得できるため、VpcId パラメーターを設定する必要はありません。

    デフォルト値: 0。

    0
    RunOnce

    boolean

    任意

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

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

    • false: 増分移行タスク。タスクの作成後、Frequency パラメーターの値に基づいて定期的に自動実行されます。増分移行タスクを使用すると、ビジネスを停止することなく移行元から Alibaba Cloud へ増分データを同期でき、タスク実行時の移行元の完全データイメージを生成できます。

    説明

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

    true
    Frequency

    integer

    任意

    増分移行タスクの実行間隔。単位: 時間。有効な値: 1～168。

    RunOnce が false に設定されている場合、このパラメーターは必須です。

    デフォルト値: null。

    12
    MaxNumberOfImageToKeep

    integer

    任意

    増分移行タスクでデフォルトで保持されるイメージの最大数。有効な値: 1～10。

    このパラメーターは、RunOnce が false に設定されている場合に必須です。

    デフォルト値: null。

    10
    InstanceType

    string

    任意

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

    DescribeInstanceTypes を呼び出して、Elastic Compute Service (ECS) が提供するインスタンスタイプを照会できます。

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

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

    ecs.c6.large [DescribeInstanceTypes](~~25620~~) を呼び出して、Elastic Compute Service (ECS) が提供するインスタンスタイプを照会できます。
    LaunchTemplateId

    string

    任意

    インスタンス起動テンプレートの ID。

    lt-bp16jovvln1cgaaq****
    LaunchTemplateVersion

    string

    任意

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

    1
    InstanceRamRole

    string

    任意

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

    SMCAdmin
    ContainerNamespace

    string

    任意

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

    testNamespace
    ContainerRepository

    string

    任意

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

    testRepository
    ContainerTag

    string

    任意

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

    CentOS:v1
    LicenseType

    string

    任意

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

    • 空の値: ライセンスなし。

    • BYOL: Bring Your Own License (独自のライセンスを持ち込む)。

    詳細については、「SMC FAQ」を参照してください。

    BYOL
    DataDisk

    array<object>

    任意

    データクラウドディスク情報のリスト。

    array<object>

    任意

    データクラウドディスク情報のリスト。

    Index

    integer

    任意

    移行先 Alibaba Cloud ECS インスタンス上のデータクラウドディスクのインデックス。初期値は 1 です。有効な値: 1～16。

    説明

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

    1
    Part

    array<object>

    任意

    パーティションリスト。

    object

    任意

    パーティションリスト。

    SizeBytes

    integer

    任意

    送信先データクラウドディスク N のパーティション N のサイズ。単位: バイト。デフォルト値: ソースデータクラウドディスクのパーティションのサイズ。

    説明

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

    • 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

    任意

    送信先 Alibaba Cloud ECS インスタンスのデータクラウドディスクのサイズ。単位: GiB。有効な値: 20～32768。

    説明

    このパラメーターの値は、移行元のデータクラウドディスクの実際の使用容量より大きい必要があります。たとえば、移行元のデータクラウドディスクのサイズが 500 GiB で、実際の使用容量が 100 GiB の場合、このパラメーターの値は 100 GiB より大きくする必要があります。

    100
    Tag

    array<object>

    任意

    タグのリスト。

    object

    任意

    タグのリスト。

    Key

    string

    任意

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

    TestKey
    Value

    string

    任意

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

    TestValue
    SystemDiskPart

    array<object>

    任意

    システムクラウドディスクのパーティション情報。

    object

    任意

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

    SizeBytes

    integer

    任意

    システムクラウドディスクパーティション N のサイズ。単位: バイト。デフォルト値: ソースシステムクラウドディスクパーティションのサイズ。

    254803968
    Block

    boolean

    任意

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

    true
    Device

    string

    任意

    システムディスクパーティション N のデバイス識別子。N の実際の値については、移行元のパーティションデバイス識別子を参照してください。

    説明

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

    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

    任意

    Logical Volume Manager (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 を使用するかどうかを指定します。有効な値:

    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. 口座が実名認証されていないので、まず実名認証を行ってください

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

    変更履歴

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