---
title: "getFabricClusterList"
slug: "cli-vserver-fabriccluster-getfabricclusterlist"
updated: 2026-09-17T10:11:03Z
published: 2026-09-17T10:11:03Z
canonical: "cli.ncloud-docs.com/cli-vserver-fabriccluster-getfabricclusterlist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/docs/ja/cli-vpc-vpcmanagement-getvpclist)を参照 |
| `--zoneCode` | String | Optional | ゾーンコード - [getZoneList](/docs/ja/cli-vserver-server-common-getzonelist)を参照 |
| `--fabricClusterPoolNo` | String | Optional | Fabric Cluster Pool番号 - [getFabricClusterPoolList](/docs/ja/cli-vserver-fabriccluster-getfabricclusterpoollist)を参照 |
| `--fabricClusterPoolName` | String | Optional | Fabric Cluster Pool名 |
| `--fabricClusterNoList` | List | Optional | Fabric Cluster番号リスト - スペースで区切って複数入力可能 (例: `--fabricClusterNoList 123 124`) |
| `--fabricClusterName` | String | Optional | Fabric Cluster名 |
| `--serverInstanceNo` | String | Optional | サーバインスタンス番号 - [getServerInstanceList](/docs/ja/cli-vserver-server-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)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)をご参照ください。

## 例

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"
  }
}
```