すべてのプロダクト
Search

このプロダクト

    Server Migration Center:DescribeReplicationJobs

    ドキュメントセンター

    Server Migration Center:DescribeReplicationJobs

    最終更新日:Sep 23, 2025

    1 つ以上の移行タスクに関する詳細を取得します。

    操作説明

    API 操作

    • リクエストパラメーターはフィルターとして使用され、論理 AND を使用して結合されます。パラメーターを指定しない場合、対応するフィルターは適用されません。

    • ソースを Docker コンテナイメージに移行して、低コストのアプリケーションコンテナ化を実現できます。詳細については、「Container Registry」をご参照ください。

    今すぐお試しください

    この 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:DescribeReplicationJobs

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    Name

    string

    任意

    移行タスクの名前。

    testMigrationTaskName
    RegionId

    string

    任意

    ソースの移行先となる Alibaba Cloud リージョンの ID。

    たとえば、ソースサーバーを中国 (杭州) リージョンに移行する場合、RegionId を cn-hangzhou に設定します。最新の Alibaba Cloud リージョンリストを表示するには、DescribeRegions を呼び出します。

    cn-hangzhou
    Status

    string

    任意

    移行タスクの主なステータス。有効な値:

    • Ready: タスクは開始されていません。

    • Running: タスクは実行中です。

    • Stopped: タスクは一時停止しています。

    • InError: エラーが発生しました。

    • Finished: タスクは完了しました。

    • Waiting: タスクは待機中です。

    • Expired: タスクは期限切れです。

    • Deleting: タスクは削除中です。

    Ready
    BusinessStatus

    string

    任意

    移行タスクのビジネスステータス。有効な値:

    • Preparing: タスクは準備中です。

    • Syncing: データは同期中です。

    • Processing: タスクは処理中です。

    • Cleaning: タスクはクリア中です。

    Preparing
    PageNumber

    integer

    任意

    移行タスクリストのページ番号。値は 1 から始まります。

    デフォルト値: 1。

    1
    PageSize

    integer

    任意

    ページングクエリで各ページに返すエントリ数。最大値: 50。

    デフォルト値: 10。

    10
    SourceId

    array

    任意

    移行元の ID。最大 50 個の移行元 ID を指定できます。

    s-bp1e2fsl57knvuug****

    string

    任意

    移行元の ID。最大 50 個の移行元 ID を指定できます。

    s-bp1bjhkwk2j5hlbn****
    JobId

    array

    任意

    移行タスクの ID。最大 50 個の移行タスク ID を指定できます。

    j-bp19vlwm0tyigbmj****

    string

    任意

    移行タスクの ID。最大 50 個の移行タスク ID を指定できます。

    j-bp1h3d33mekxwu0n****
    JobType

    integer

    任意

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

    • 0: サーバー移行。

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

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

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

    0
    InstanceId

    array

    任意

    インスタンス ID。

    string

    任意

    宛先インスタンスの ID。

    i-bp1f1dvfto1sigz5****
    ResourceGroupId

    string

    任意

    リソースグループの ID。

    rg-acfmw3ty5y7****
    Tag

    array<object>

    任意

    SMC リソースのタグ。

    object

    任意

    SMC リソースのタグ。

    Key

    string

    任意

    SMC リソースに指定されたタグ N のキー。N の有効な値: 1～20。

    このパラメーターは空の文字列にすることができます。タグキーは最大 64 文字で、http:// または https:// を含めることはできません。

    TestKey
    Value

    string

    任意

    SMC リソースに指定されたタグ N の値。N の有効な値: 1～20。

    このパラメーターは空の文字列にすることができます。タグ値は最大 64 文字で、http:// または https:// を含めることはできません。

    TestValue

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    TotalCount

    integer

    移行タスクの総数。

    5
    ReplicationJobs

    object

    ReplicationJob

    array<object>

    移行タスクの詳細のコレクション。

    object

    移行タスクの詳細のコレクション。

    Frequency

    integer

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

    15
    VpcId

    string

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

    vpc-bp1vwnn14rqpyiczj****
    CreationTime

    string

    移行タスクが作成された時刻。

    2014-07-24T13:00:52Z
    Status

    string

    移行タスクの主なステータス。有効な値:

    • Ready: タスクは開始されていません。

    • Running: タスクは実行中です。

    • Stopped: タスクは一時停止しています。

    • InError: エラーが発生しました。

    • Finished: タスクは完了しました。

    • Waiting: タスクは待機中です。

    • Expired: タスクは期限切れです。

    • Deleting: タスクは削除中です。

    Running
    ScheduledStartTime

    string

    移行タスクの実行がスケジュールされている時刻。時刻は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定されます。時刻は UTC である必要があります。このパラメーターは、次の要件を満たす必要があります:

    • 時刻は現在時刻より後で、現在時刻から 30 日以内でなければなりません。

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

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

    integer

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

    8
    ContainerNamespace

    string

    Docker コンテナーの名前空間。

    testNamespace
    DataDisks

    object

    DataDisk

    array<object>

    宛先の Alibaba Cloud Elastic Compute Service (ECS) インスタンスのデータディスク。

    object

    宛先の Alibaba Cloud ECS インスタンスのデータディスク。

    Index

    integer

    データディスクのインデックス番号。

    1
    Size

    integer

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

    40
    Parts

    object

    Part

    array<object>

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

    object

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

    SizeBytes

    integer

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

    21474836480
    Block

    boolean

    パーティションでブロックレプリケーションが有効になっているかどうかを示します。

    true
    Device

    string

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

    0_1
    StatusInfo

    string

    移行ステータスの詳細。

    statusinfo
    InstanceRamRole

    string

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

    SMCAdmin
    SystemDiskSize

    integer

    宛先の Alibaba Cloud ECS インスタンスのシステムディスクのサイズ。

    40
    Description

    string

    移行タスクの説明。

    This is my migration task.
    ReplicationParameters

    string

    レプリケーションドライバーのパラメーター。

    BandWidthLimit:0
    ErrorCode

    string

    移行タスクのエラーコード。

    InternalError
    ValidTime

    string

    移行タスクの有効期限が切れる時刻。時刻は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定されます。時刻は UTC である必要があります。

    説明

    コンソールに表示される時刻は UTC+8 タイムゾーンです。

    2019-06-08T14:40:52Z
    NetMode

    integer

    移行に使用されるネットワークモード。

    0
    ContainerTag

    string

    Docker イメージのタグ。

    CentOS:v1
    LicenseType

    string

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

    • 空の値はライセンスがないことを示します。

    • BYOL: Bring Your Own License。

    BYOL
    Name

    string

    移行タスクの名前。

    testMigrationTaskName
    ImageId

    string

    移行タスクから作成された宛先イメージの ID。

    m-o6w3gy99qf89rkga****
    Progress

    number

    移行タスクの全体的な進捗状況。

    100
    RunOnce

    boolean

    タスクが 1 回限りの移行タスクか増分移行タスクかを示します。有効な値:

    • true: タスクは 1 回限りの移行タスクです。タスクは作成後に 1 回だけ実行されます。

    • false: タスクは増分移行タスクです。タスクが作成されると、Frequency パラメーターで指定された間隔で自動的に実行されます。

    true
    LaunchTemplateId

    string

    起動テンプレートの ID。

    lt-launchtemplateid
    ContainerRepository

    string

    Docker イメージリポジトリ。

    testRepository
    InstanceId

    string

    宛先インスタンスの ID。

    i-bp1ff25rzvnul6kr****
    SystemDiskParts

    object

    SystemDiskPart

    array<object>

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

    object

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

    SizeBytes

    integer

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

    254803968
    Block

    boolean

    システムディスクパーティションでブロックレプリケーションが有効になっているかどうかを示します。

    true
    Device

    string

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

    0_1
    InstanceType

    string

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

    ecs.sn1ne.large
    SourceId

    string

    移行元の ID。

    s-bp1e2fsl57knvuug****
    LaunchTemplateVersion

    string

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

    1
    RegionId

    string

    ソースの移行先となる Alibaba Cloud リージョンの ID。

    cn-hangzhou
    TransitionInstanceId

    string

    中間インスタンスの ID。

    i-bp1ff25rzvnul6kr****
    EndTime

    string

    移行タスクが完了した時刻。時刻は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定されます。時刻は UTC である必要があります。

    説明

    コンソールに表示される時刻は UTC+8 タイムゾーンです。

    2019-06-04T16:00:52Z
    StartTime

    string

    移行タスクが開始された時刻。時刻は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定されます。時刻は UTC である必要があります。

    説明

    コンソールに表示される時刻は UTC+8 タイムゾーンです。

    2019-06-04T14:40:52Z
    VSwitchId

    string

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

    vsw-bp1ddbrxdlrcbim46****
    JobId

    string

    移行タスクの ID。

    j-bp19vlwm0tyigbmj****
    ImageName

    string

    移行タスクから作成された宛先イメージの名前。

    testAliCloudImageName
    BusinessStatus

    string

    移行タスクのビジネスステータス。有効な値:

    • Preparing: タスクは準備中です。

    • Syncing: データは同期中です。

    • Processing: タスクは処理中です。

    • Cleaning: タスクはクリア中です。

    Preparing
    ReplicationJobRuns

    object

    ReplicationJobRun

    array<object>

    移行タスクの実行レコード。

    object

    移行タスクの実行レコード。

    EndTime

    string

    移行タスクの実行が終了した時刻。時刻は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定されます。時刻は UTC である必要があります。

    説明

    コンソールに表示される時刻は UTC+8 タイムゾーンです。

    2019-10-04T13:35:00Z
    Type

    string

    移行タスクの実行モード。有効な値:

    • Manual: タスクは手動で実行されます。

    • Schedule: タスクはスケジュールされた時刻または特定の間隔で実行されます。

    Schedule
    StartTime

    string

    移行タスクの実行が開始された時刻。時刻は、ISO 8601 標準の yyyy-MM-ddTHH:mm:ssZ 形式で指定されます。時刻は UTC である必要があります。

    説明

    コンソールに表示される時刻は UTC+8 タイムゾーンです。

    2019-10-01T13:35:00Z
    ImageId

    string

    移行タスクによって生成されたイメージの ID。

    m-o6w3gy99qf89rkga****
    TargetType

    string

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

    • Image: 移行が完了すると、SMC は移行元用の Alibaba Cloud イメージを生成します。

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

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

    Image
    JobType

    integer

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

    • 0: サーバー移行。

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

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

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

    0
    ResourceGroupId

    string

    リソースグループの ID。

    rg-acfmw3ty5y7****
    Tags

    object

    Tag

    array<object>

    SMC リソースのタグ。

    object

    SMC リソースのタグ。

    Key

    string

    SMC リソースに指定されたタグ N のキー。N の有効な値: 1～20。

    このパラメーターは空の文字列にすることができます。タグキーは最大 64 文字で、http:// または https:// を含めることはできません。

    TestKey
    Value

    string

    SMC リソースに指定されたタグ N の値。N の有効な値: 1～20。

    このパラメーターは空の文字列にすることができます。タグ値は最大 64 文字で、http:// または https:// を含めることはできません。

    TestValue
    Disks

    object

    ディスク情報。

    System

    object

    システムディスク情報。

    Size

    integer

    ソースシステムディスクのサイズ。単位: GiB。有効な値: 20～32768。

    説明

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

    100
    LVM

    boolean

    LVM が使用されているかどうかを示します。有効な値:

    • true: LVM が使用されています。

    • false: LVM は使用されていません。

    false
    DiskId

    string

    システムディスク ID。

    d-2zeh4twm100qskw7z41z
    Parts

    object

    Part

    array<object>

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

    object

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

    SizeBytes

    integer

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

    21474836480

    Block

    boolean

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

    • true: システムディスクパーティションでブロックレプリケーションが有効になっています。

    • false: システムディスクパーティションでブロックレプリケーションが有効になっていません。

    true
    Path

    string

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

    /boot
    Data

    object

    Data

    array<object>

    データディスク情報。

    object

    データディスク情報。

    Size

    integer

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

    説明

    このパラメーターの値は、ソースデータディスクの使用済み領域より大きい必要があります。たとえば、ソースデータディスクのサイズが 500 GiB で、100 GiB の領域が使用されている場合、このパラメーターの値は 100 より大きい必要があります。

    22548578304
    LVM

    boolean

    LVM が使用されているかどうかを示します。有効な値:

    • true: LVM が使用されています。

    • false: LVM は使用されていません。

    false
    DiskId

    string

    データディスク ID。

    d-2zeh4twm100qskw7z41z
    Parts

    object

    Part

    array<object>

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

    object

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

    SizeBytes

    integer

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

    21474836480

    Block

    boolean

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

    • true: データディスクパーティションでブロックレプリケーションが有効になっています。

    • false: データディスクパーティションでブロックレプリケーションが有効になっていません。

    false
    Path

    string

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

    /home/data

    WorkgroupId

    string

    ワークグループの ID。

    w-bp1ja22kdqphehlj****
    PageSize

    integer

    1 ページあたりのエントリ数。

    10
    RequestId

    string

    リクエスト ID。

    6E1187E8-843A-4850-B97E-2F17F00D48F7
    PageNumber

    integer

    移行タスクリストのページ番号。

    1

    例

    成功レスポンス

    JSONJSON

    {
  "TotalCount": 5,
  "ReplicationJobs": {
    "ReplicationJob": [
      {
        "Frequency": 15,
        "VpcId": "vpc-bp1vwnn14rqpyiczj****",
        "CreationTime": "2014-07-24T13:00:52Z",
        "Status": "Running",
        "ScheduledStartTime": "2019-06-04T13:35:00Z",
        "MaxNumberOfImageToKeep": 8,
        "ContainerNamespace": "testNamespace",
        "DataDisks": {
          "DataDisk": [
            {
              "Index": 1,
              "Size": 40,
              "Parts": {
                "Part": [
                  {
                    "SizeBytes": 21474836480,
                    "Block": true,
                    "Device": "0_1"
                  }
                ]
              }
            }
          ]
        },
        "StatusInfo": "statusinfo",
        "InstanceRamRole": "SMCAdmin",
        "SystemDiskSize": 40,
        "Description": "This is my migration task.",
        "ReplicationParameters": "BandWidthLimit:0",
        "ErrorCode": "InternalError",
        "ValidTime": "2019-06-08T14:40:52Z",
        "NetMode": 0,
        "ContainerTag": "CentOS:v1",
        "LicenseType": "BYOL",
        "Name": "testMigrationTaskName",
        "ImageId": "m-o6w3gy99qf89rkga****",
        "Progress": 100,
        "RunOnce": true,
        "LaunchTemplateId": "lt-launchtemplateid",
        "ContainerRepository": "testRepository",
        "InstanceId": "i-bp1ff25rzvnul6kr****",
        "SystemDiskParts": {
          "SystemDiskPart": [
            {
              "SizeBytes": 254803968,
              "Block": true,
              "Device": "0_1"
            }
          ]
        },
        "InstanceType": "ecs.sn1ne.large",
        "SourceId": "s-bp1e2fsl57knvuug****",
        "LaunchTemplateVersion": "1",
        "RegionId": "cn-hangzhou",
        "TransitionInstanceId": "i-bp1ff25rzvnul6kr****",
        "EndTime": "2019-06-04T16:00:52Z",
        "StartTime": "2019-06-04T14:40:52Z",
        "VSwitchId": "vsw-bp1ddbrxdlrcbim46****",
        "JobId": "j-bp19vlwm0tyigbmj****",
        "ImageName": "testAliCloudImageName",
        "BusinessStatus": "Preparing",
        "ReplicationJobRuns": {
          "ReplicationJobRun": [
            {
              "EndTime": "2019-10-04T13:35:00Z",
              "Type": "Schedule",
              "StartTime": "2019-10-01T13:35:00Z",
              "ImageId": "m-o6w3gy99qf89rkga****"
            }
          ]
        },
        "TargetType": "Image",
        "JobType": 0,
        "ResourceGroupId": "rg-acfmw3ty5y7****",
        "Tags": {
          "Tag": [
            {
              "Key": "TestKey",
              "Value": "TestValue"
            }
          ]
        },
        "Disks": {
          "System": {
            "Size": 100,
            "LVM": false,
            "DiskId": "d-2zeh4twm100qskw7z41z",
            "Parts": {
              "Part": [
                {
                  "SizeBytes": 21474836480,
                  "Block": true,
                  "Path": "/boot"
                }
              ]
            }
          },
          "Data": {
            "Data": [
              {
                "Size": 22548578304,
                "LVM": false,
                "DiskId": "d-2zeh4twm100qskw7z41z",
                "Parts": {
                  "Part": [
                    {
                      "SizeBytes": 21474836480,
                      "Block": false,
                      "Path": "/home/data\n"
                    }
                  ]
                }
              }
            ]
          }
        },
        "WorkgroupId": "w-bp1ja22kdqphehlj****"
      }
    ]
  },
  "PageSize": 10,
  "RequestId": "6E1187E8-843A-4850-B97E-2F17F00D48F7",
  "PageNumber": 1
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. リクエストの処理中にエラーが発生しました。もう一度お試しください。それでも問題が解決しない場合、チケットを起票してください。
    403 Forbidden.Unauthorized A required authorization for the specified action is not supplied.

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

    変更履歴

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