--- title: "노드 변경 가능 스펙 조회" slug: "analytics-vpcsearchengine-cluster-productlistforspecchange" updated: 2026-10-22T10:46:55Z published: 2026-10-22T10:46:55Z canonical: "api-gov.ncloud-docs.com/analytics-vpcsearchengine-cluster-productlistforspecchange" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 노드 변경 가능 스펙 조회 VPC 환경에서 이용 가능합니다. Search Engine 클러스터 노드별 변경 가능한 서버 스펙을 조회합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | POST | /api/v2/cluster/getNodeProductListForSpecChange/{serviceGroupInstanceNo} (수도권) | | POST | /api/krs-v2/cluster/getNodeProductListForSpecChange/{serviceGroupInstanceNo} (남부권) | ### 요청 헤더 Search Engine Service API에서 공통으로 사용하는 헤더에 대한 정보는 [Search Engine Service 요청 헤더](/docs/analytics-vpcsearchengine#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 경로 파라미터 요청 경로 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `serviceGroupInstanceNo` | Integer | Required | 클러스터 인스턴스 번호 - [클러스터 목록 조회](/docs/analytics-vpcsearchengine-cluster-getclusterinfolist) 참조 | ### 요청 바디 요청 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `softwareProductCode` | String | Required | 운영 체제 타입 코드 - [노드 스펙 조회](/docs/analytics-vpcsearchengine-cluster-getnodespecdetail) 참조 | ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request POST 'https://vpcsearchengine.apigw.gov-ntruss.com/api/v2/cluster/getNodeProductListForSpecChange/1037*****' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'Content-Type: application/json' \ --data '{ "softwareProductCode": "SW.VELST.OS.LNX64.CNTOS.0708.B050" }' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `code` | Integer | - | 응답 코드 | | `message` | String | - | 응답 메시지 | | `result` | Object | - | 응답 결과 | | `result.managerNodeProductList` | Array | - | 매니저 노드 서버 타입 목록: [서버 타입 정보](/docs/analytics-vpcsearchengine-cluster-productlistforspecchange#%EC%84%9C%EB%B2%84%ED%83%80%EC%9E%85%EC%A0%95%EB%B3%B4) | | `result.dataNodeProductList` | Array | - | 데이터 노드 서버 타입 목록: [서버 타입 정보](/docs/analytics-vpcsearchengine-cluster-productlistforspecchange#%EC%84%9C%EB%B2%84%ED%83%80%EC%9E%85%EC%A0%95%EB%B3%B4) | | `result.masterNodeProductList` | Array | - | 마스터 노드 서버 타입 목록: [서버 타입 정보](/docs/analytics-vpcsearchengine-cluster-productlistforspecchange#%EC%84%9C%EB%B2%84%ED%83%80%EC%9E%85%EC%A0%95%EB%B3%B4) | | `requestId` | String | - | 요청에 대한 아이디 - UUID 형식 | #### 서버 타입 정보 서버 타입 정보에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `productCode` | String | - | 서버 타입 코드 | | `productName` | String | - | 서버 타입 이름 | | `productKoreanName` | String | - | 서버 타입 이름(한국어) | | `productEnglishName` | String | - | 서버 타입 이름(영어) | | `productJapaneseName` | String | - | 서버 타입 이름(일본어) | | `productDesc` | String | - | 서버 설명 | | `productKoreanDesc` | String | - | 서버 설명(한국어) | | `productEnglishDesc` | String | - | 서버 설명(영어) | | `productJapaneseDesc` | String | - | 서버 설명(일본어) | | `productType2Code` | String | - | 서버 구분 | | `infraResourceTypeCode` | String | - | 인프라 리소스 타입 | | `infraResourceDetailTypeCode` | String | - | 인프라 리소스 상세 타입 | | `cpuCount` | String | - | CPU 수 | | `memorySize` | Integer | - | 메모리 크기(Byte) | | `baseBlockStorageProductCode` | Integer | - | 기본 블록 스토리지 타입 | | `diskType2Code` | String | - | 디스크 타입 | | `isChangeSpec` | Boolean | - | 서버 타입 변경 가능 여부 - `true` \| `false` - `true`: 변경 가능 - `false`: 변경 불가 | | `isSelected` | Boolean | - | 현재 사용 여부 - `true` \| `false` - `true`: 사용 중 - `false`: 사용 중 아님 | ### 응답 상태 코드 Search Engine Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Search Engine Service 응답 상태 코드](/docs/analytics-vpcsearchengine#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` { "code": 0, "message": "SUCCESS", "result": { "managerNodeProductList": [ { "productCode": "SVR.VELST.STAND.C002.M008.NET.SSD.B050.G002", "productName": "[STAND] vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productKoreanName": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productEnglishName": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productJapaneseName": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productDesc": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productKoreanDesc": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productEnglishDesc": "[STAND] vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productJapaneseDesc": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productType2Code": "STAND", "infraResourceTypeCode": "VELST", "infraResourceDetailTypeCode": null, "cpuCount": "2", "memorySize": 8589934592, "baseBlockStorageProductCode": "SPBSTBSTBS000005", "diskType2Code": "NET", "isChangeSpec": true, "isSelected": true }, ... ], "dataNodeProductList": [ { "productCode": "SVR.VELST.STAND.C002.M008.NET.SSD.B050.G002", "productName": "[STAND] vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productKoreanName": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productEnglishName": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productJapaneseName": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productDesc": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productKoreanDesc": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productEnglishDesc": "[STAND] vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productJapaneseDesc": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productType2Code": "STAND", "infraResourceTypeCode": "VELST", "infraResourceDetailTypeCode": null, "cpuCount": "2", "memorySize": 8589934592, "baseBlockStorageProductCode": "SPBSTBSTBS000005", "diskType2Code": "NET", "isChangeSpec": true, "isSelected": true }, ... ], "masterNodeProductList": [ { "productCode": "SVR.VELST.STAND.C002.M008.NET.SSD.B050.G002", "productName": "[STAND] vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productKoreanName": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productEnglishName": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productJapaneseName": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productDesc": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productKoreanDesc": "vCPU 2개, 메모리 8GB, [SSD]디스크 50GB", "productEnglishDesc": "[STAND] vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productJapaneseDesc": "vCPU 2EA, Memory 8GB, [SSD]Disk 50GB", "productType2Code": "STAND", "infraResourceTypeCode": "VELST", "infraResourceDetailTypeCode": null, "cpuCount": "2", "memorySize": 8589934592, "baseBlockStorageProductCode": "SPBSTBSTBS000005", "diskType2Code": "NET", "isChangeSpec": true, "isSelected": false }, ... ] }, "requestId": "4d16abf0-****-****-****-1a1e60d5ee68" } ```