--- title: "서버 스펙 조회" slug: "nks-viewserverspec" updated: 2026-09-17T09:10:13Z published: 2026-09-17T09:10:13Z canonical: "api-fin.ncloud-docs.com/nks-viewserverspec" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 서버 스펙 조회 클러스터 또는 노드풀을 생성할 때 이용할 수 있는 서버 스펙을 조회합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET | /nks/v2/option/server-product-code | ### 요청 헤더 Ncloud Kubernetes Service API에서 공통으로 사용하는 헤더에 대한 정보는 [Ncloud Kubernetes Service 요청 헤더](/docs/compute-kubernetesservice#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `softwareCode` | String | Required | 서버 이미지 코드 - `zoneCode`와 `zoneNo` 둘 중 하나의 유효 값 입력 필요 | | `zoneCode` | String | Conditional | 존 코드 - `zoneNo`를 입력하지 않은 경우 필수 - [getZoneList](/docs/compute-vserver-server-common-getzonelist) 참조 | | `zoneNo` | String | Conditional | 존 번호 - `zoneCode`를 입력하지 않은 경우 필수 - [getZoneList](/docs/compute-vserver-server-common-getzonelist) 참조 | ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location 'https://nks.apigw.fin-ntruss.com/nks/v2/option/server-product-code' \ --header 'x-ncp-apigw-timestamp: {timestamp}' \ --header 'x-ncp-iam-access-key: {access key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## 응답 응답 형식을 설명합니다. ### 응답 구문 응답 구문은 다음과 같습니다. ``` [ { "label": "string", "value": "string", "detail": { "productCode": "string", "productEnglishName": "string", "productName": "string", "serverSpecCode": "string", "serverSpecTypeCode": "string", "hypervisorCode": "string", "generationCode": "string", "productKindCode": "string", "productType2Code": "string", "cpuCount": 0, "memorySize": 0, "memorySizeGb": 0, "isFabricClusterType": false, "fabricClusterPoolList": [ { "poolNo": 0, "poolName": "string" } ] } } ] ``` ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `label` | String | - | 서버 이미지명 | | `value` | String | - | 서버 상품 코드 | | `detail` | Object | - | 서버 스펙 상세 정보 | | `detail.productName` | String | - | 상품명 | | `detail.serverImageNo` | Integer | - | 서버 이미지 번호 | | `detail.productCode` | String | - | 상품 코드 | | `detail.productEnglishName` | String | - | 상품 영문명 | | `detail.serverSpecCode` | String | - | 서버 스펙 코드 | | `detail.serverSpecTypeCode` | String | - | 서버 스펙 타입 코드 | | `detail.hypervisorCode` | String | - | 하이퍼바이저 코드 | | `detail.generationCode` | String | - | 세대 코드 | | `detail.productKindCode` | String | - | 상품 종류 코드 | | `detail.productType2Code` | String | - | 상품 타입2 코드 | | `detail.cpuCount` | Integer | - | CPU 개수 | | `detail.memorySize` | Integer | - | 메모리 크기 (바이트) | | `detail.memorySizeGb` | Integer | - | 메모리 크기 (GB) | | `detail.isFabricClusterType` | Boolean | - | Fabric Cluster 타입 여부 | | `detail.fabricClusterPoolList` | Array | - | Fabric Cluster Pool 목록: [fabricClusterPoolList](/docs/nks-viewserverspec#fabricClusterPoolList) - Fabric Cluster 타입인 경우에만 포함 | #### `fabricClusterPoolList` `fabricClusterPoolList`에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `poolNo` | Integer | - | Fabric Cluster Pool 번호 | | `poolName` | String | - | Fabric Cluster Pool 이름 | ### 응답 상태 코드 Ncloud Kubernetes Service API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud Kubernetes Service 응답 상태 코드](/docs/compute-kubernetesservice#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. #### XEN인 경우 ``` [ { "label": "vCPU 2EA, Memory 4GB, [SSD]Disk 50GB", "value": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002", "detail": { "cpuCount": 2, "productKoreanDesc": "vCPU 2개, 메모리 4GB, [SSD]디스크 50GB", "softwareTypeCode": "", "packageProductYn": "N", "productKindCode": "INFRA", "productType2Code": "HICPU", "productCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B050.G002", "productEnglishName": "vCPU 2EA, Memory 4GB, [SSD]Disk 50GB", "productDesc": "vCPU 2개, 메모리 4GB, [SSD]디스크 50GB", "diskType2Code": "NET", "diskType2DetailCode": "SSD", "productName": "vCPU 2개, 메모리 4GB, [SSD]디스크 50GB", "productEnglishDesc": "vCPU 2EA, Memory 4GB, [SSD]Disk 50GB", "memorySize": 4294967296, "memorySizeGb": 4 } }, { "label": "vCPU 2EA, Memory 4GB, [SSD]Disk 100GB", "value": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B100.G002", "detail": { "cpuCount": 2, "productKoreanDesc": "vCPU 2개, 메모리 4GB, [SSD]디스크 100GB", "softwareTypeCode": "", "packageProductYn": "N", "productKindCode": "INFRA", "productType2Code": "HICPU", "productCode": "SVR.VSVR.HICPU.C002.M004.NET.SSD.B100.G002", "productEnglishName": "vCPU 2EA, Memory 4GB, [SSD]Disk 100GB", "productDesc": "vCPU 2개, 메모리 4GB, [SSD]디스크 100GB", "diskType2Code": "NET", "diskType2DetailCode": "SSD", "productName": "vCPU 2개, 메모리 4GB, [SSD]디스크 100GB", "productEnglishDesc": "vCPU 2EA, Memory 4GB, [SSD]Disk 100GB", "memorySize": 4294967296, "memorySizeGb": 4 } } ] ``` #### KVM인 경우 ``` [ { "label": "c2-g3(vCPU 2EA, Memory 4GB)", "value": "c2-g3", "detail": { "productName": "c2-g3(vCPU 2EA, Memory 4GB)", "serverImageNo": 12345, "productCode": "SVR.VSVR.STAND.C002.M004.G003", "productEnglishName": "c2-g3(vCPU 2EA, Memory 4GB)", "serverSpecCode": "c2-g3", "serverSpecTypeCode": "STAND", "hypervisorCode": "KVM", "generationCode": "G003", "productKindCode": "INFRA", "productType2Code": "STAND", "cpuCount": 2, "memorySize": 4294967296, "memorySizeGb": 4, "isFabricClusterType": false, "fabricClusterPoolList": [] } }, { "label": "c4-g3(vCPU 4EA, Memory 8GB)", "value": "c4-g3", "detail": { "productName": "c4-g3(vCPU 4EA, Memory 8GB)", "serverImageNo": 12345, "productCode": "SVR.VSVR.STAND.C004.M008.G003", "productEnglishName": "c4-g3(vCPU 4EA, Memory 8GB)", "serverSpecCode": "c4-g3", "serverSpecTypeCode": "STAND", "hypervisorCode": "KVM", "generationCode": "G003", "productKindCode": "INFRA", "productType2Code": "STAND", "cpuCount": 4, "memorySize": 8589934592, "memorySizeGb": 8, "isFabricClusterType": false, "fabricClusterPoolList": [] } } ] ```