changeFabricClusterServerInstances

Available in VPC

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.

Syntax

The changeFabricClusterServerInstances syntax is as follows:

./ncloud vserver changeFabricClusterServerInstances \
    --fabricClusterNo <fabric-cluster-no> \
    [--clusterModeServerInstanceNoList <cluster-mode-server-instance-no-list>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running changeFabricClusterServerInstances.

Required options

The following options are required for changeFabricClusterServerInstances.

Options	Type	Required	Description
`--fabricClusterNo`	String	Required	Fabric cluster number See getFabricClusterList.

Optional options

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

Options	Type	Required	Description
`--clusterModeServerInstanceNoList`	List	Optional	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. This overwrites the existing cluster mode settings with the list provided in the request. To retain the existing server, include its number in the request. Requesting an empty list or omitting it will disable all existing cluster mode settings. You can enter multiple items separated by spaces. (e.g., `--clusterModeServerInstanceNoList 123 124`) See getServerInstanceList. Get existing cluster mode servers: Filter by `fabricClusterNo` and `fabricClusterMode=CLUSTER`. Get single-mode servers that can be added: Filter by `fabricClusterPoolNo` and `fabricClusterMode=SINGLE`.

Common options

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

Examples

If the request to change the Fabric cluster server instance is successful, the latest information about the cluster is returned.

Command

The command example is as follows:

./ncloud vserver changeFabricClusterServerInstances \
    --fabricClusterNo 13579246 \
    --clusterModeServerInstanceNoList 34567890 34567891 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "changeFabricClusterServerInstancesResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13579246",
        "fabricClusterName": "test-cluster-01",
        "fabricClusterStatus": {
          "code": "SETUP",
          "codeName": "Configuring"
        },
        "fabricClusterDescription": "Test fabric cluster",
        "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",
        "fabricClusterServerInstanceList": []
      }
    ],
    "requestId": "f6a7b8c9-d0e1-2345-f012-456789012345",
    "returnCode": "0",
    "returnMessage": "success"
  }
}

Documentation Index