getFabricClusterList

VPC環境で利用できます。

Fabric Clusterリストを照会します。

構文

getFabricClusterList構文は次の通りです。

./ncloud vserver getFabricClusterList \
    [--fabricClusterPoolNo <fabric-cluster-pool-no>] \
    [--fabricClusterPoolName <fabric-cluster-pool-name>] \
    [--fabricClusterNoList <fabric-cluster-no-list>] \
    [--fabricClusterName <fabric-cluster-name>] \
    [--zoneCode <zone-code>] \
    [--vpcNo <vpc-no>] \
    [--serverInstanceNo <server-instance-no>] \
    [--pageNo <page-no>] \
    [--pageSize <page-size>] \
    [--sortedBy <fabricClusterNo|fabricClusterPoolCode|zoneCode>] \
    [--sortingOrder <ASC|DESC>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

getFabricClusterListの実行時に指定できるオプションについて説明します。

必須オプション

getFabricClusterListの必須オプションです。

オプション	タイプ	必須の有無	説明
`--pageSize`	Integer	Conditional	ページごとの項目数 `1`~`1000` `pageNo`入力時、必ず入力

任意オプション

getFabricClusterListの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--vpcNo`	String	Optional	VPC番号 getVpcListを参照
`--zoneCode`	String	Optional	ゾーンコード getZoneListを参照
`--fabricClusterPoolNo`	String	Optional	Fabric Cluster Pool番号 getFabricClusterPoolListを参照
`--fabricClusterPoolName`	String	Optional	Fabric Cluster Pool名
`--fabricClusterNoList`	List	Optional	Fabric Cluster番号リストスペースで区切って複数入力可能 (例: `--fabricClusterNoList 123 124`)
`--fabricClusterName`	String	Optional	Fabric Cluster名
`--serverInstanceNo`	String	Optional	サーバインスタンス番号 getServerInstanceListを参照
`--pageNo`	Integer	Optional	ページ番号 `0`~N (デフォルト: `0`) 最初のページ: `0`または`1`を入力
`--sortedBy`	String	Optional	ソート基準 `fabricClusterNo` \| `fabricClusterPoolCode` \| `zoneCode` `fabricClusterNo`: Fabric Cluster番号 `fabricClusterPoolCode`: Fabric Cluster Poolコード `zoneCode`: ゾーンコード
`--sortingOrder`	String	Optional	ソート順序 `ASC` (デフォルト) \| `DESC` `ASC`: 昇順 `DESC`: 降順

共通オプション

vserverコマンドで共通して使用するオプションについては、Server (VPC)のオプションをご参照ください。

例

Fabric Clusterリストの照会リクエストが成功すると、各クラスタの識別および構成情報が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vserver getFabricClusterList \
    --fabricClusterPoolNo 24680135 \
    --fabricClusterNoList 13579246 \
    --zoneCode KR-1 \
    --vpcNo 12345678 \
    --pageNo 0 \
    --pageSize 10 \
    --sortedBy fabricClusterNo \
    --sortingOrder ASC \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "getFabricClusterListResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13579246",
        "fabricClusterName": "test-cluster-01",
        "fabricClusterStatus": {
          "code": "RUN",
          "codeName": "実行中"
        },
        "regionCode": "KR",
        "zoneCode": "KR-1",
        "vpcNo": "12345678",
        "fabricClusterPoolNo": "24680135",
        "fabricClusterPoolName": "gpu-cluster-pool-01",
        "fabricClusterPoolCode": "gpu-cluster-pool-01",
        "createDate": "2026-05-15T10:02:05+0900",
        "serverCount": 0
      }
    ],
    "requestId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index