---
title: "changeFabricClusterServerInstances"
slug: "cli-vserver-fabriccluster-changefabricclusterserverinstances"
updated: 2026-09-17T10:11:03Z
published: 2026-09-17T10:11:03Z
canonical: "cli.ncloud-docs.com/cli-vserver-fabriccluster-changefabricclusterserverinstances"
---

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

# changeFabricClusterServerInstances

VPC環境で利用できます。

Fabric Clusterに含まれたサーバインスタンスリストを変更します。サーバリストが変更されるまで数分から数十分かかります。

## 構文

`changeFabricClusterServerInstances`構文は次の通りです。

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

## オプション

`changeFabricClusterServerInstances`の実行時に指定できるオプションについて説明します。

### 必須オプション

`changeFabricClusterServerInstances`の必須オプションです。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--fabricClusterNo` | String | Required | Fabric Cluster番号 - [getFabricClusterList](/docs/ja/cli-vserver-fabriccluster-getfabricclusterlist)を参照 |

### 任意オプション

`changeFabricClusterServerInstances`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

| オプション | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `--clusterModeServerInstanceNoList` | List | Optional | クラスタモードに設定するサーバインスタンス番号リスト - Fabric Clusterに設定された Fabric Cluster Poolで作成されたサーバのみ設定可能 - 既存のクラスタモード設定をリクエストしたリストで上書き、既存のサーバを維持するには、当該番号も含めてリクエスト - 空のリストでリクエストするか省略すると、既存のクラスタモード設定がすべて解除される - スペースで区切って複数入力可能 (例: `--clusterModeServerInstanceNoList 123 124`) - [getServerInstanceList](/docs/ja/cli-vserver-server-getserverinstancelist)を参照 - 既存のクラスタモードサーバの照会: `fabricClusterNo`と`fabricClusterMode=CLUSTER`で絞り込み - 追加可能なシングルモードサーバの照会: `fabricClusterPoolNo`と`fabricClusterMode=SINGLE`で絞り込み |

### 共通オプション

`vserver`コマンドで共通して使用するオプションについては、[Server (VPC)のオプション](/docs/ja/cli-vserver#%EC%98%B5%EC%85%98)をご参照ください。

## 例

Fabric Clusterサーバインスタンスの変更リクエストが成功すると、クラスタの最新情報が返されます。

### コマンド

コマンドの例は次の通りです。

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

### 出力

出力の例は次の通りです。

```
{
  "changeFabricClusterServerInstancesResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13579246",
        "fabricClusterName": "test-cluster-01",
        "fabricClusterStatus": {
          "code": "SETUP",
          "codeName": "設定中"
        },
        "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"
  }
}
```