すべてのプロダクト
Search

このプロダクト

    Server Migration Center:DescribeSourceServers

    ドキュメントセンター

    Server Migration Center:DescribeSourceServers

    最終更新日:Sep 08, 2025

    DescribeSourceServers 操作を呼び出して、1 つ以上の移行元に関する情報をクエリします。

    操作説明

    説明

    リクエストパラメータはフィルタとして使用され、論理 AND で結合されます。パラメータが空の場合、対応するフィルタは無視されます。

    今すぐお試しください

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

    get

    *SourceServer

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    JobId

    string

    任意

    移行タスクの ID。

    j-bp19vlwm0tyigbmj****
    State

    string

    任意

    移行元サーバーの状態。有効な値:

    • Unavailable: 移行元サーバーは利用できません。オフライン状態とエラー状態が含まれます。

    • Available: 移行元サーバーはオンラインです。

    • InUse: 移行元サーバーは移行中です。

    • Deleting: 移行元サーバーは削除中です。

    Available
    Name

    string

    任意

    移行元サーバーの名前。名前は 2～128 文字の長さでなければなりません。文字で始まり、`http://` または `https://` で始めることはできません。名前に数字、コロン（:）、アンダースコア（_）、ハイフン（-）を含めることができます。

    デフォルト値: 空。

    testSourceServerName
    PageNumber

    integer

    任意

    ページ番号。ページは 1 ページ目から始まります。

    デフォルト値: 1。

    1
    PageSize

    integer

    任意

    1 ページあたりのエントリ数。最大値: 50。

    デフォルト値: 10。

    10
    SourceId

    array

    任意

    移行元サーバーの ID。複数の ID を指定できます。

    s-bp1e2fsl57knvuug****

    string

    任意

    移行元サーバーの ID。複数の ID を指定できます。

    s-bp1e2fsl57knvuug****
    ResourceGroupId

    string

    任意

    リソースグループの ID。

    rg-acfmw3ty5y7****
    Tag

    array<object>

    任意

    タグ。

    object

    任意

    タグ。

    Key

    string

    任意

    タグ N のキー。N は 1 から 20 までの整数です。

    タグキーは空の文字列にすることはできません。タグキーは最大 64 文字の長さにすることができます。`aliyun` または `acs:` で始めることはできず、`http://` または `https://` を含めることはできません。

    TestKey
    Value

    string

    任意

    タグ N の値。N は 1 から 20 までの整数です。

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

    TestValue
    RelatedJobType

    array

    任意

    関連付けられたタスクのタイプ。

    string

    任意

    関連付けられたタスクのタイプ。有効な値:

    • Not_Related: タスクは関連付けられていません。

    • Server: サーバー移行タスク。

    • Os: オペレーティングシステムの移行タスク。

    • Cross_Zone: ゾーン間の移行タスク。

    • VMWare: VMware 移行タスク。

    • Desktop: デスクトップタスク。

    Server
    WorkgroupId

    string

    任意

    ワークグループの ID。

    w-bp1ja22kdqphehlj****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメータ。

    SourceServers

    object

    SourceServer

    array<object>

    移行元サーバーに関する情報。

    object

    移行元サーバーに関する情報。

    CreationTime

    string

    移行元サーバーが作成された時刻。

    2019-06-27T02:58:09Z
    HeartbeatRate

    integer

    サーバー移行センター (SMC) クライアントのハートビート間隔。単位: 秒。

    30
    State

    string

    移行元サーバーの状態。

    InUse
    DataDisks

    object

    DataDisk

    array<object>

    移行元サーバーのデータディスク。

    object

    移行元サーバーのデータディスク。

    Index

    integer

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

    1
    Size

    integer

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

    20
    Parts

    object

    Part

    array<object>

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

    object

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

    CanBlock

    boolean

    データディスクパーティションでブロックレプリケーションがサポートされているかどうかを示します。

    false
    SizeBytes

    integer

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

    21474836480
    Need

    boolean

    データディスクパーティションを選択する必要があるかどうかを示します。

    false
    Device

    string

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

    1_0
    Path

    string

    データディスクパーティションのマウントポイント。

    /home/data
    Path

    string

    データディスクのマウントポイント。

    /home/data
    SystemDiskParts

    object

    SystemDiskPart

    array<object>

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

    object

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

    CanBlock

    boolean

    システムディスクパーティションでブロックレプリケーションがサポートされているかどうかを示します。

    true
    SizeBytes

    integer

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

    254803968
    Need

    boolean

    システムディスクパーティションを選択する必要があるかどうかを示します。

    true
    Device

    string

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

    0_0
    Path

    string

    システムディスクパーティションのマウントポイント。

    /boot
    KernelLevel

    integer

    カーネルレベル。

    1
    SourceId

    string

    移行元サーバーの ID。

    s-bp1e2fsl57knvuug****
    AgentVersion

    string

    SMC クライアントのバージョン。

    1.5.2.3
    StatusInfo

    string

    移行元サーバーの状態に関する情報。このパラメータは、移行元サーバーが異常な状態にある場合に返されます。値は JSON 形式のキーと値のペアです。例:

    - error_code: エラーコード。
- error_msg: エラーメッセージ。

    {"error_code": "S1", "error_msg": "Rsync not found. Please install rsync."}
    SystemDiskSize

    integer

    移行元サーバーのシステムディスクのサイズ。単位: GiB。

    40
    Description

    string

    移行元サーバーの説明。

    Server Source Imported By GotoAliyun.
    ErrorCode

    string

    移行元サーバーが異常な状態にある場合に返されるエラーコード。

    SourceServer.Offline
    JobId

    string

    最後の移行タスクの ID。

    j-bp19vlwm0tyigbmj****
    Platform

    string

    移行元サーバーのオペレーティングシステム。

    OpenSUSE
    ReplicationDriver

    string

    レプリケーションドライバー。デフォルト値: SMT。

    SMT
    Name

    string

    移行元サーバーの名前。

    SourceServerName
    SystemInfo

    string

    移行元サーバーのシステム情報。値は、サイズが 1 KB を超えることができない JSON 形式のキーと値のペアです。例:

    agent_mode: 実行モード。
agent_type: 実行タイプ。
client_type: クライアントタイプ。
hostname: ホスト名。
ipv4: IPv4 アドレス。
ipv6: IPv6 アドレス。
cores: CPU コア数。
cpu_usage: CPU 使用率。
memory: メモリサイズ。
memory_usage: メモリ使用量。

    {\"agent_mode\":\"daemon\",\"agent_type\":\"aliyun\",\"client_type\":\"\",\"cores\":\"2\",\"cpu_usage\":\"0.00\",\"hostname\":\"ixxxxxxxxxx\",\"ipv4\":\"10.0.0.1\",\"memory\":\"8.00\",\"memory_usage\":\"3.61\"}
    Architecture

    string

    移行元サーバーのアーキテクチャ。

    x86_64
    ResourceGroupId

    string

    リソースグループの ID。

    rg-acfmw3ty5y7****
    Tags

    object

    Tag

    array<object>

    タグ。

    object

    タグ。

    Key

    string

    タグ N のキー。N は 1 から 20 までの整数です。

    タグキーは空の文字列にすることはできません。タグキーは最大 64 文字の長さにすることができます。`aliyun` または `acs:` で始めることはできず、`http://` または `https://` を含めることはできません。

    TestKey
    Value

    string

    タグ N の値。N は 1 から 20 までの整数です。

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

    TestValue
    Disks

    object

    ディスクに関する情報。

    System

    object

    システムディスクに関する情報。

    Size

    integer

    移行元サーバーのシステムディスクのサイズ。単位: GiB。値は 20 から 32,768 の範囲でなければなりません。

    説明

    このパラメータの値は、移行元サーバーのデータディスクで使用されている容量よりも大きくなければなりません。たとえば、データディスクのサイズが 500 GiB で、100 GiB の容量が使用されている場合、このパラメータの値は 100 よりも大きくなければなりません。

    100
    Offset

    integer

    システムディスクの最初のパーティションの開始オフセット。単位: バイト。

    1024
    Parts

    object

    Part

    array<object>

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

    object

    パーティションに関する情報。

    CanBlock

    boolean

    システムディスクパーティションでブロックレプリケーションがサポートされているかどうかを示します。有効な値:

    • true: システムディスクパーティションでブロックレプリケーションがサポートされています。

    • false: システムディスクパーティションでブロックレプリケーションはサポートされていません。

    false
    SizeBytes

    integer

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

    21474836480
    Path

    string

    システムディスクパーティションのマウントポイント。

    /home/data
    Type

    string

    システムディスクパーティションのタイプ。有効な値:

    • Normal: 通常のパーティション。

    • System: システムパーティション。

    • Boot: ブートパーティション。

    Normal
    Data

    object

    Data

    array<object>

    データディスクに関する情報。

    object

    データディスクに関する情報。

    Size

    integer

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

    80
    Offset

    integer

    データディスクの最初のパーティションの開始オフセット。単位: バイト。

    1024
    Parts

    object

    Part

    array<object>

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

    object

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

    CanBlock

    boolean

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

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

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

    false
    SizeBytes

    integer

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

    21474836480
    Path

    string

    データディスクパーティションのマウントポイント。

    /home/data
    Type

    string

    データディスクパーティションのタイプ。有効な値:

    • Normal: 通常のパーティション。

    • System: システムパーティション。

    • Boot: ブートパーティション。

    Normal
    WorkgroupId

    string

    ワークグループの ID。

    w-bp1ja22kdqphehlj****
    TotalCount

    integer

    移行元サーバーの総数。

    1
    PageSize

    integer

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

    10
    RequestId

    string

    リクエストの ID。

    410E6073-66D0-45D3-AB3E-4DC3F5E4****
    PageNumber

    integer

    ページ番号。

    1

    例

    成功レスポンス

    JSONJSON

    {
  "SourceServers": {
    "SourceServer": [
      {
        "CreationTime": "2019-06-27T02:58:09Z",
        "HeartbeatRate": 30,
        "State": "InUse",
        "DataDisks": {
          "DataDisk": [
            {
              "Index": 1,
              "Size": 20,
              "Parts": {
                "Part": [
                  {
                    "CanBlock": false,
                    "SizeBytes": 21474836480,
                    "Need": false,
                    "Device": "1_0",
                    "Path": "/home/data"
                  }
                ]
              },
              "Path": "/home/data"
            }
          ]
        },
        "SystemDiskParts": {
          "SystemDiskPart": [
            {
              "CanBlock": true,
              "SizeBytes": 254803968,
              "Need": true,
              "Device": "0_0",
              "Path": "/boot"
            }
          ]
        },
        "KernelLevel": 1,
        "SourceId": "s-bp1e2fsl57knvuug****",
        "AgentVersion": "1.5.2.3",
        "StatusInfo": "{\"error_code\": \"S1\", \"error_msg\": \"Rsync not found. Please install rsync.\"}",
        "SystemDiskSize": 40,
        "Description": "Server Source Imported By GotoAliyun.",
        "ErrorCode": "SourceServer.Offline",
        "JobId": "j-bp19vlwm0tyigbmj****",
        "Platform": "OpenSUSE",
        "ReplicationDriver": "SMT",
        "Name": "SourceServerName",
        "SystemInfo": "{\\\"agent_mode\\\":\\\"daemon\\\",\\\"agent_type\\\":\\\"aliyun\\\",\\\"client_type\\\":\\\"\\\",\\\"cores\\\":\\\"2\\\",\\\"cpu_usage\\\":\\\"0.00\\\",\\\"hostname\\\":\\\"ixxxxxxxxxx\\\",\\\"ipv4\\\":\\\"10.0.0.1\\\",\\\"memory\\\":\\\"8.00\\\",\\\"memory_usage\\\":\\\"3.61\\\"}",
        "Architecture": "x86_64",
        "ResourceGroupId": "rg-acfmw3ty5y7****",
        "Tags": {
          "Tag": [
            {
              "Key": "TestKey",
              "Value": "TestValue"
            }
          ]
        },
        "Disks": {
          "System": {
            "Size": 100,
            "Offset": 1024,
            "Parts": {
              "Part": [
                {
                  "CanBlock": false,
                  "SizeBytes": 21474836480,
                  "Path": "/home/data",
                  "Type": "Normal"
                }
              ]
            }
          },
          "Data": {
            "Data": [
              {
                "Size": 80,
                "Offset": 1024,
                "Parts": {
                  "Part": [
                    {
                      "CanBlock": false,
                      "SizeBytes": 21474836480,
                      "Path": "/home/data",
                      "Type": "Normal"
                    }
                  ]
                }
              }
            ]
          }
        },
        "WorkgroupId": "w-bp1ja22kdqphehlj****"
      }
    ]
  },
  "TotalCount": 1,
  "PageSize": 10,
  "RequestId": "410E6073-66D0-45D3-AB3E-4DC3F5E4****",
  "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.

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

    変更履歴

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