---
title: "createFabricCluster"
slug: "cli-vserver-fabriccluster-createfabriccluster"
updated: 2026-04-23T08:56:56Z
published: 2026-04-23T08:58:53Z
canonical: "cli.ncloud-docs.com/cli-vserver-fabriccluster-createfabriccluster"
---

> ## 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.

# createFabricCluster

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

## 개요<a name="개요"></a>

Fabric Cluster를 생성합니다.

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명                    | 필수 여부 | 타입     | 제약 사항                                                                                                    | 설명                                                                                                                                                                                               |
|--------------------------|-------|--------|----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode               | No    | String |                                                                                                          | - 리전 코드<br> Fabric Cluster가 생성될 리전(Region) 결정 가능<br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br>Default : getRegionList 조회 결과의 첫 번째 리전을 선택         |
| fabricClusterName        | Yes   | String | Min : 3, Max : 30<br>소문자, 숫자, "-"의 특수문자만 허용하며 알파벳 문자로 시작해야 함<br>영어 또는 숫자로 끝나야 함                       | - Fabric Cluster 이름                                                                                                                                                                              |
| fabricClusterDescription | No    | String | Min : 0, Max : 1000 Bytes                                                                                | - Fabric Cluster 설명                                                                                                                                                                              |
| zoneCode                 | Yes   | String |                                                                                                          | - Zone 코드<br>Fabric Cluster가 생성될 Zone 결정<br>zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능                                                                    |
| vpcNo                    | Yes   | String |                                                                                                          | - VPC 번호<br>Fabric Cluster가 생성될 VPC 결정<br>vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해 획득 가능                                                                               |
| fabricClusterPoolNo      | Yes   | String |                                                                                                          | - Fabric Cluster Pool 번호<br>Fabric Cluster가 생성될 Pool 결정<br>fabricClusterPoolNo는 [getFabricClusterPoolList](/docs/cli-vserver-fabriccluster-getfabricclusterpoollist) 액션을 통해 획득 가능                |
| output                   | No    | String |                                                                                                          | 응답 결과의 포맷 타입<ul><li>Options : xml \| json</li><li>Default : json</li></ul>                                                                                                                                        |

## 응답<a name="응답"></a>

### 응답 데이터 타입<a name="응답데이터타입"></a>

- FabricClusterList 타입

| FabricClusterList extends CommonResponse                                 |
|--------------------------------------------------------------------------|
| private Integer totalRows;                                               |
| private List&lt;FabricCluster&gt; 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&lt;FabricClusterServerInstance&gt;  fabricClusterServerInstanceList;               |

## 예시<a name="예시"></a>

### 요청 예시<a name="요청예시"></a>

```
ncloud vserver createFabricCluster --regionCode KR --fabricClusterName test-*** --fabricClusterDescription test --zoneCode KR-1 --vpcNo ***84 --fabricClusterPoolNo ***01
```

### 응답 예시<a name="응답예시"></a>

```json
{
  "createFabricClusterResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13**",
        "fabricClusterName": "test-***",
        "fabricClusterStatus": {
          "code": "CREAT",
          "codeName": "생성중"
        },
        "fabricClusterDescription": "test",
        "regionCode": "KR",
        "zoneCode": "KR-1",
        "vpcNo": "***84",
        "fabricClusterPoolNo": "***01",
        "fabricClusterPoolName": "test-***",
        "fabricClusterPoolCode": "test-***",
        "createDate": "2025-12-12T13:36:17+0900",
        "fabricClusterServerInstanceList": []
      }
    ],
    "requestId": "0e14ac63-aacb-4cde-8d75-39822da26e8c",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```xml
<createFabricClusterResponse>
    <requestId>0e14ac63-aacb-4cde-8d75-39822da26e8c</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <fabricClusterList>
        <fabricCluster>
            <fabricClusterNo>13**</fabricClusterNo>
            <fabricClusterName>test-***</fabricClusterName>
            <fabricClusterStatus>
                <code>CREAT</code>
                <codeName>생성중</codeName>
            </fabricClusterStatus>
            <fabricClusterDescription>test</fabricClusterDescription>
            <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>
            <fabricClusterServerInstanceList></fabricClusterServerInstanceList>
        </fabricCluster>
    </fabricClusterList>
</createFabricClusterResponse>
```