getFabricClusterList

Available in VPC

Get the list of Fabric clusters.

Syntax

The getFabricClusterList syntax is as follows:

./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>]

Options

This section describes the options available when running getFabricClusterList.

Required options

The following options are required for getFabricClusterList.

Options	Type	Required	Description
`--pageSize`	Integer	Conditional	Number of items per page `1`-`1000` Required when entering `pageNo`

Optional options

These are the optional options for getFabricClusterList. Options that are not specified will use their default values.

Options	Type	Required	Description
`--vpcNo`	String	Optional	VPC number See getVpcList.
`--zoneCode`	String	Optional	Zone code See getZoneList.
`--fabricClusterPoolNo`	String	Optional	Fabric cluster pool number See getFabricClusterPoolList.
`--fabricClusterPoolName`	String	Optional	Fabric cluster pool name
`--fabricClusterNoList`	List	Optional	Fabric cluster number list You can enter multiple items separated by spaces. (e.g., `--fabricClusterNoList 123 124`)
`--fabricClusterName`	String	Optional	Fabric cluster name
`--serverInstanceNo`	String	Optional	Server instance number See getServerInstanceList.
`--pageNo`	Integer	Optional	Page number `0`-N (default: `0`) First page: Enter `0` or `1`.
`--sortedBy`	String	Optional	Sort by `fabricClusterNo` \| `fabricClusterPoolCode` \| `zoneCode` `fabricClusterNo`: Fabric cluster number `fabricClusterPoolCode`: Fabric cluster pool code `zoneCode`: Zone code
`--sortingOrder`	String	Optional	Sort order `ASC` (default) \| `DESC` `ASC`: Ascending order `DESC`: Descending order

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the Fabric cluster list query request is successful, the cluster's identification and configuration information are returned.

Command

The command example is as follows:

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

Output

The output example is as follows:

{
  "getFabricClusterListResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13579246",
        "fabricClusterName": "test-cluster-01",
        "fabricClusterStatus": {
          "code": "RUN",
          "codeName": "In operation"
        },
        "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