すべてのプロダクト
Search

このプロダクト

    Elastic High Performance Computing:ListClusters

    ドキュメントセンター

    Elastic High Performance Computing:ListClusters

    最終更新日:Dec 21, 2025

    各リージョンにある現在のアカウントのすべての Elastic High Performance Computing (E-HPC) クラスターを照会します。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ehpc:ListClusters

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    PageNumber

    integer

    任意

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

    1
    PageSize

    integer

    任意

    各ページで返すエントリ数。有効な値：1～50。

    デフォルト値：10

    10

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    PageSize

    integer

    ページあたりに返されるエントリ数。

    1
    RequestId

    string

    リクエスト ID。

    04F0F334-1335-436C-A1D7-6C044FE73368
    PageNumber

    integer

    返されたページ番号。

    1
    TotalCount

    integer

    返されたエントリの総数。

    1
    Clusters

    object

    ClusterInfoSimple

    array<object>

    クラスターのリスト。

    array<object>

    VpcId

    string

    VPC の ID。

    vpc-b3f3edefefeep0760yju****
    Status

    string

    クラスターのステータス。有効な値：

    • uninit：クラスターは初期化されていません。

    • creating：クラスターは作成中です。

    • init：クラスターは初期化中です。

    • running：クラスターは実行中です。

    • exception：クラスターで例外が発生しました。

    • releasing：クラスターはリリース中です。

    running
    CreateTime

    string

    インスタンスが作成された時刻。

    2020-10-30T07:39:20.000Z
    IsComputeEss

    boolean

    スケーリンググループが有効になっているかどうかを示します。有効な値：

    • true：スケーリンググループは有効です。

    • false：スケーリンググループは有効ではありません。

    false
    ComputeSpotStrategy

    string

    計算ノードの入札方式。有効な値：

    • NoSpot：計算ノードのインスタンスは従量課金インスタンスです。

    • SpotWithPriceLimit：計算ノードのインスタンスはプリエンプティブルインスタンスです。このタイプのインスタンスには、1 時間あたりの最高価格が指定されています。

    • SpotAsPriceGo：計算ノードのインスタンスはプリエンプティブルインスタンスです。これらのインスタンスの価格は、現在の市場価格に基づいています。

    NoSpot
    AccountType

    string

    アカウントのサーバータイプ。有効な値：

    • nis

    • ldap

    nis
    Count

    integer

    クラスター内の計算ノード数。

    3
    EhpcVersion

    string

    E-HPC のバージョン。

    1.0.0
    Description

    string

    クラスターの説明。

    clusterdescription
    BaseOsTag

    string

    ベースイメージのオペレーティングシステムタグ。このタグは管理ノードでのみ使用されていました。

    CentOS_7.2_64
    Name

    string

    クラスターの名前。

    test
    ImageId

    string

    イメージの ID。

    wi_1607_x64_dtc_zh_40G_alibase****
    ComputeSpotPriceLimit

    number

    計算ノード配下の ECS インスタンスの 1 時間あたりの最高価格。戻り値は、小数点以下 3 桁まで正確に指定できます。

    0.034
    SchedulerType

    string

    スケジューラタイプ。有効な値：

    • pbs

    • slurm

    • opengridscheduler

    • deadline

    pbs
    DeployMode

    string

    クラスターがデプロイされたモード。有効な値：

    • Standard：アカウントノード、スケジューリングノード、ログインノード、および複数の計算ノードが個別にデプロイされます。

    • Advanced：2 つの高可用性 (HA) アカウントノード、2 つの HA スケジューラノード、1 つのログインノード、および複数の計算ノードが個別にデプロイされます。

    • Simple：管理ノード、ログインノード、および複数の計算ノードがデプロイされます。管理ノードは、アカウントノードとスケジューリングノードで構成されます。ログインノードと計算ノードは個別にデプロイされます。

    • Tiny：管理ノードと複数の計算ノードがデプロイされます。管理ノードは、アカウントノード、スケジューリングノード、およびログインノードで構成されます。計算ノードは個別にデプロイされます。

    Standard
    NodeSuffix

    string

    ノードのサフィックス。

    name
    ImageOwnerAlias

    string

    イメージのタイプ。有効な値：

    • system：パブリックイメージ

    • self：カスタムイメージ

    • others：共有イメージ

    • marketplace：Alibaba Cloud Marketplace のイメージ

    system
    OsTag

    string

    イメージのオペレーティングシステムタグ。

    CentOS_7.2_64
    NodePrefix

    string

    ノードのプレフィックス。

    test
    InstanceType

    string

    計算ノードのインスタンスタイプ。

    ecs.n1.tiny
    RegionId

    string

    リージョン ID。

    cn-hangzhou
    InstanceChargeType

    string

    クラスター内のノードの課金方法。有効な値：

    • PostPaid：従量課金

    • PrePaid：サブスクリプション

    PostPaid
    VSwitchId

    string

    vSwitch の ID。

    vsw-bp1lfcjbfb099rrjn****
    ZoneId

    string

    ゾーン ID。

    cn-hangzhou-c
    LoginNodes

    string

    ログインノードのリスト。

    {"Id": "i-bp13x4is8pvdhws7e****"}
    Id

    string

    クラスター ID。

    ehpc-hz-jeJki6****
    Location

    string

    クラスターがデプロイされたロケーション。有効な値：

    • OnPremise：クラスターはハイブリッドクラウドにデプロイされます。

    • PublicCloud：クラスターはパブリッククラウドにデプロイされます。

    PublicCloud
    ClientVersion

    string

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

    1.0.64
    ResourceGroupId

    string

    リソースグループ ID。ListResourceGroups 操作を呼び出して、リソースグループの ID を照会できます。

    rg-acfmxazb4ph****
    Managers

    object

    管理ノードのリスト。

    OperatingCount

    integer

    キューで使用されているノードの数。これには、初期化中、インストール中、またはリリース中のノードが含まれます。

    1
    ExceptionCount

    integer

    異常なノードの数。

    0
    StoppedCount

    integer

    停止したノードの数。

    0
    Total

    integer

    管理ノードの総数。

    2
    NormalCount

    integer

    正常なノードの数。

    1
    Computes

    object

    計算ノードに関する情報。

    OperatingCount

    integer

    キューで使用されているノードの数。これには、初期化中、インストール中、またはリリース中のノードが含まれます。

    1
    ExceptionCount

    integer

    異常なノードの数。

    0
    StoppedCount

    integer

    停止したノードの数。

    0
    Total

    integer

    ノードの総数。

    2
    NormalCount

    integer

    正常なノードの数。

    1
    TotalResources

    object

    クラスター内のすべてのリソースの統計。

    Gpu

    integer

    GPU カードの数。単位：カード。

    0
    Cpu

    integer

    CPU コアの数。単位：コア。

    1
    Memory

    integer

    メモリサイズ。単位：MiB。

    1024
    UsedResources

    object

    クラスターで消費されたリソースの数。

    Gpu

    integer

    GPU カードの数。単位：カード。

    0
    Cpu

    integer

    CPU コアの数。単位：コア。

    1
    Memory

    integer

    メモリサイズ。単位：MiB。

    1024
    HasPlugin

    boolean

    クラスターでプラグインが使用されたかどうかを示します。有効な値：

    • true：プラグインが使用されます。

    • false：プラグインは使用されません。

    デフォルト値：false

    false

    例

    成功レスポンス

    JSONJSON

    {
  "PageSize": 1,
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "PageNumber": 1,
  "TotalCount": 1,
  "Clusters": {
    "ClusterInfoSimple": [
      {
        "VpcId": "vpc-b3f3edefefeep0760yju****",
        "Status": "running",
        "CreateTime": "2020-10-30T07:39:20.000Z",
        "IsComputeEss": false,
        "ComputeSpotStrategy": "NoSpot",
        "AccountType": "nis",
        "Count": 3,
        "EhpcVersion": "1.0.0",
        "Description": "clusterdescription",
        "BaseOsTag": "CentOS_7.2_64",
        "Name": "test",
        "ImageId": "wi_1607_x64_dtc_zh_40G_alibase****",
        "ComputeSpotPriceLimit": 0.034,
        "SchedulerType": "pbs",
        "DeployMode": "Standard",
        "NodeSuffix": "name",
        "ImageOwnerAlias": "system",
        "OsTag": "CentOS_7.2_64",
        "NodePrefix": "test",
        "InstanceType": "ecs.n1.tiny",
        "RegionId": "cn-hangzhou",
        "InstanceChargeType": "PostPaid",
        "VSwitchId": "vsw-bp1lfcjbfb099rrjn****",
        "ZoneId": "cn-hangzhou-c",
        "LoginNodes": "{\"Id\": \"i-bp13x4is8pvdhws7e****\"}",
        "Id": "ehpc-hz-jeJki6****",
        "Location": "PublicCloud",
        "ClientVersion": "1.0.64",
        "ResourceGroupId": "rg-acfmxazb4ph****",
        "Managers": {
          "OperatingCount": 1,
          "ExceptionCount": 0,
          "StoppedCount": 0,
          "Total": 2,
          "NormalCount": 1
        },
        "Computes": {
          "OperatingCount": 1,
          "ExceptionCount": 0,
          "StoppedCount": 0,
          "Total": 2,
          "NormalCount": 1
        },
        "TotalResources": {
          "Gpu": 0,
          "Cpu": 1,
          "Memory": 1024
        },
        "UsedResources": {
          "Gpu": 0,
          "Cpu": 1,
          "Memory": 1024
        },
        "HasPlugin": false
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParams The specified parameter %s is invalid.
    500 UnknownError An unknown error occurred.
    404 ImageNotFound The specified image does not exist.
    503 ServiceUnavailable The request has failed due to a temporary failure of the server
    406 AgentError The agent service request failed.
    406 DbError A database service error occurred.
    406 AliyunError An Alibaba Cloud product error occurred.
    406 EcsError An error occurred while calling the ECS API operation.
    407 NotAuthorized You are not authorized by RAM for this request.
    407 EntityNotExist.Role The role does not exist.

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

    変更履歴

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