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を参照

任意オプション

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

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

共通オプション

vserverコマンドで共通して使用するオプションについては、Server (VPC)のオプションをご参照ください。

例

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"
  }
}

Documentation Index