Available in VPC
Overview
Change the list of server instances included in a Fabric cluster. It may take several minutes to tens of minutes for the server list to update.
Request
Request parameters
| Parameter name | Required | Type | Restrictions | Description |
|---|---|---|---|---|
| regionCode | No | String | - Region code Determine the Region in which the Fabric cluster will be changed. regionCode can be obtained through the getRegionList action. Default: Select the first Region of the getRegionList query result. |
|
| fabricClusterNo | Yes | String | - Fabric cluster number to change fabricClusterNo can be obtained through the getFabricClusterList action. |
|
| clusterModeServerInstanceNoList.N | No | List<String> | - List of server instance numbers to configure in cluster mode Only servers created in the Fabric cluster pool configured for the Fabric cluster can be set. Overwrite the existing cluster mode settings with the requested list. Requesting an empty list or omitting it will disable all existing cluster mode settings. clusterModeServerInstanceNo can be obtained through the getServerInstanceList action. - Query existing cluster mode servers: Filter with fabricClusterNo and fabricClusterMode=CLUSTER. - Query single-mode servers that can be added: Filter with fabricClusterNo and fabricClusterMode=SINGLE. |
|
| output | No | String | Response result's format type
|
Response
Response data type
- FabricClusterList type
| FabricClusterList 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; |
Examples
Request example
ncloud vserver updateFabricClusterServerInstances --regionCode KR --fabricClusterNo 13** --clusterModeServerInstanceNoList 1** 2**
Response example
{
"updateFabricClusterServerInstancesResponse": {
"totalRows": 1,
"fabricClusterList": [
{
"fabricClusterNo": "13**",
"fabricClusterName": "test-***",
"fabricClusterStatus": {
"code": "SETUP",
"codeName": "Configuring"
},
"fabricClusterDescription": "test",
"regionCode": "KR",
"zoneCode": "KR-1",
"vpcNo": "***84",
"fabricClusterPoolNo": "***01",
"fabricClusterPoolName": "test-***",
"fabricClusterPoolCode": "test-***",
"createDate": "2025-12-12T13:36:17+0900",
"fabricClusterServerInstanceList": []
}
],
"requestId": "8b4841e9-0ca6-4e0e-84ef-054d42de4464",
"returnCode": "0",
"returnMessage": "success"
}
}
<updateFabricClusterServerInstancesResponse>
<requestId>8b4841e9-0ca6-4e0e-84ef-054d42de4464</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<fabricClusterList>
<fabricCluster>
<fabricClusterNo>13**</fabricClusterNo>
<fabricClusterName>test-***</fabricClusterName>
<fabricClusterStatus>
<code>SETUP</code>
<codeName>Configuring</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>
</updateFabricClusterServerInstancesResponse>