changeFabricClusterServerInstances

VPC 환경에서 이용 가능합니다.

개요

Fabric Cluster에 포함된 서버 인스턴스 목록을 변경합니다. 서버 목록이 변경되기까지 수 분에서 수십 분이 소요될 수 있습니다.

요청

요청 파라미터

요청 파라미터는 다음과 같습니다.

파라미터명	필수 여부	타입	설명
regionCode	No	String	리전 코드 변경할 Fabric Cluster의 리전(Region) 결정 가능 regionCode는 getRegionList 액션을 통해 획득 가능 Default: getRegionList 조회 결과의 첫 번째 리전을 선택
fabricClusterNo	Yes	String	변경할 Fabric Cluster 번호 fabricClusterNo는 getFabricClusterList 액션을 통해 획득 가능
clusterModeServerInstanceNoList.N	No	List<String>	클러스터 모드로 설정할 서버 인스턴스 번호 리스트 Fabric Cluster에 설정된 Fabric Cluster Pool에서 생성된 서버만 설정 가능 기존 클러스터 모드 설정을 요청한 목록으로 덮어씀 빈 목록으로 요청하거나 생략하면 기존 클러스터 모드 설정이 모두 해제됨 clusterModeServerInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 기존 클러스터 모드 서버 조회: fabricClusterNo와 fabricClusterMode=CLUSTER로 필터링 추가 가능한 싱글 모드 서버 조회: fabricClusterPoolNo와 fabricClusterMode=SINGLE로 필터링
output	No	String	응답 결과의 포맷 타입 Options: xml \| json Default: json

응답

응답 데이터 타입

응답 데이터 타입은 다음과 같습니다.

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;

예시

요청 예시

./ncloud vserver changeFabricClusterServerInstances --regionCode KR --fabricClusterNo 13** --clusterModeServerInstanceNoList 1** 2**

응답 예시

{
  "changeFabricClusterServerInstancesResponse": {
    "totalRows": 1,
    "fabricClusterList": [
      {
        "fabricClusterNo": "13**",
        "fabricClusterName": "test-***",
        "fabricClusterStatus": {
          "code": "SETUP",
          "codeName": "설정중"
        },
        "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"
  }
}

<changeFabricClusterServerInstancesResponse>
    <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>설정중</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>
</changeFabricClusterServerInstancesResponse>

Documentation Index

changeFabricClusterServerInstances

개요

요청

요청 파라미터

응답

응답 데이터 타입

예시

요청 예시

응답 예시