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

Prev Next

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 번호

선택 옵션

changeFabricClusterServerInstances의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--clusterModeServerInstanceNoList List Optional 클러스터 모드로 설정할 서버 인스턴스 번호 목록
  • Fabric Cluster에 설정된 Fabric Cluster Pool에서 생성된 서버만 설정 가능
  • 기존 클러스터 모드 설정을 요청한 목록으로 덮어쓰며, 기존 서버를 유지하려면 해당 번호도 포함하여 요청
  • 빈 목록으로 요청하거나 생략하면 기존 클러스터 모드 설정이 모두 해제됨
  • 공백으로 구분하여 여러 개 입력 가능 (예시: --clusterModeServerInstanceNoList 123 124)
  • getServerInstanceList 참조
    • 기존 클러스터 모드 서버 조회: fabricClusterNofabricClusterMode=CLUSTER로 필터링
    • 추가 가능한 싱글 모드 서버 조회: fabricClusterPoolNofabricClusterMode=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"
  }
}