---
title: "getFabricClusterList"
slug: "cli-vserver-fabriccluster-getfabricclusterlist"
updated: 2026-05-21T09:02:02Z
published: 2026-05-21T09:11:32Z
canonical: "cli-gov.ncloud-docs.com/cli-vserver-fabriccluster-getfabricclusterlist"
---

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

# getFabricClusterList

VPC 환경에서 이용 가능합니다.

## 개요

Fabric Cluster 목록을 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 Fabric Cluster 리스트가 조회될 리전(Region) 결정 가능 regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택 |
| fabricClusterPoolNo | No | String |  | Fabric Cluster Pool 번호로 필터링 fabricClusterPoolNo는 [getFabricClusterPoolList](/docs/cli-vserver-fabriccluster-getfabricclusterpoollist) 액션을 통해 획득 가능 |
| fabricClusterPoolName | No | String |  | Fabric Cluster Pool 이름으로 필터링 |
| fabricClusterNoList | No | List<String> |  | - Fabric Cluster 번호 리스트 Fabric Cluster 번호로 필터링하여 검색 가능 fabricClusterNo는 [getFabricClusterList](/docs/cli-vserver-fabriccluster-getfabricclusterlist) 액션을 통해 획득 가능 ex) --fabricClusterNoList 123 124 |
| fabricClusterName | No | String |  | Fabric Cluster 이름으로 필터링 |
| zoneCode | No | String |  | - Zone 코드 Zone 코드로 필터링하여 검색 가능 zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능 |
| vpcNo | No | String |  | - VPC 번호 VPC 번호로 필터링하여 검색 가능 vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해 획득 가능 |
| serverInstanceNo | No | String |  | 서버 인스턴스 번호로 필터링 - [getServerInstanceList](/docs/cli-vserver-server-getserverinstancelist) 참조 |
| pageNo | No | Integer |  | - 페이징된 결과의 페이지 번호 결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 |
| pageSize | Conditional | Integer |  | - 페이징 시 보여줄 각 페이지 사이즈 결과값을 pageNo, pageSize를 이용하여 페이징 처리 가능 pageNo 입력시 반드시 입력 필요 |
| sortedBy | No | String |  | - 정렬 대상 결과값을 Fabric Cluster 번호, Fabric Cluster Pool 코드, Zone 코드로 정렬 가능 Options : fabricClusterNo \| fabricClusterPoolCode \| zoneCode |
| sortingOrder | No | String |  | - 정렬 순서 sortedBy 이용시 오름차순/내림차순 정렬을 설정함 Options : ASC (오름차순) \| DESC (내림차순) Default : ASC |
| output | No | String |  | 응답 결과의 포맷 타입 - Options : xml \| json - Default : json |

## 응답

### 응답 데이터 타입

- getFabricClusterList 타입

| getFabricClusterList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<FabricCluster> fabricClusterList = new ArrayList<>(); |

| FabricCluster |
| --- |
| private String fabricClusterNo; |
| private String fabricClusterName; |
| private CommonCode fabricClusterStatus; |
| private String fabricClusterDescription; |
| private String regionCode; |
| private String zoneCode; |
| private String vpcNo; |
| private String fabricClusterPoolNo; |
| private String fabricClusterPoolName; |
| private String fabricClusterPoolCode; |
| private Date createDate; |
| private Long serverCount; |
| private List<FabricClusterServerInstance> fabricClusterServerInstanceList; |

## 예시

### 요청 예시

```
ncloud vserver getFabricClusterList --regionCode KR --zoneCode KR-1 --vpcNo ***84 --fabricClusterNoList 13** --pageNo 1 --pageSize 10
```

### 응답 예시

```
{
  "getFabricClusterListResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13**",
        "fabricClusterName": "test-***",
        "fabricClusterStatus": {
          "code": "RUN",
          "codeName": "운영중"
        },
        "regionCode": "KR",
        "zoneCode": "KR-1",
        "vpcNo": "***84",
        "fabricClusterPoolNo": "***01",
        "fabricClusterPoolName": "test-***",
        "fabricClusterPoolCode": "test-***",
        "createDate": "2025-12-12T13:36:17+0900",
        "serverCount": 5
      }
    ],
    "requestId": "9b0ed68f-b044-4fd8-b138-22397fba64df",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```
<getFabricClusterListResponse>
    <requestId>9b0ed68f-b044-4fd8-b138-22397fba64df</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <fabricClusterList>
        <fabricCluster>
            <fabricClusterNo>13**</fabricClusterNo>
            <fabricClusterName>test-***</fabricClusterName>
            <fabricClusterStatus>
                <code>RUN</code>
                <codeName>운영중</codeName>
            </fabricClusterStatus>
            <regionCode>KR</regionCode>
            <zoneCode>KR-1</zoneCode>
            <vpcNo>***84</vpcNo>
            <fabricClusterPoolNo>***01</fabricClusterPoolNo>
            <fabricClusterPoolName>test-***</fabricClusterPoolName>
            <fabricClusterPoolCode>test-***</fabricClusterPoolCode>
            <createDate>2025-12-12T13:36:17+0900</createDate>
            <serverCount>5</serverCount>
        </fabricCluster>
    </fabricClusterList>
</getFabricClusterListResponse>
```