Get server type (G3)

Prev Next

Available in VPC

Get available node server types.

Note

This is a dedicated API for third-generation servers of the KVM hypervisor type.

Request

This section describes the request format. The method and URI are as follows:

Method URI
POST /api/v1/cluster/getServerSpecList (Korea Region)
POST /api/sgn-v1/cluster/getServerSpecList (Singapore Region)
POST /api/jpn-v1/cluster/getServerSpecList (Japan Region)

Request headers

For information about the headers common to all Cloud Data Streaming Service APIs, see Cloud Data Streaming Service request headers.

Request body

You can include the following data in the body of your request:

Field Type Required Description
softwareProductCode String Required Operating system type code

Request example

The request example is as follows:

curl --location --request POST 'https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getServerSpecList' \
--header 'Content-Type: application/json' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '{
  "softwareProductCode": "SW.VCDSS.OS.LNX64.ROCKY.08.G003"
}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field Type Required Description
code Integer - Response code
message String - Response message
result Object - Response result
result.productList Array - Server type list
requestId String - ID for the request
  • UUID format

result.productList

The following describes result.productList.

Field Type Required Description
serverSpecCode String - Server specification code
serverSpecTypeCode String - Server classification
serverSpecDescription String - Server description
productCode String - Server type code
hypervisorCode String - Hypervisor code
generationCode String - Server generation code
cpuArchitectureCode String - CPU architecture type
cpuCount Integer - Number of CPUs
memorySize Integer - Memory size (GB)
blockStorageMaxCount Integer - Maximum number of assignable storage
networkInterfaceMaxCount Integer - Maximum number of assignable network interfaces
zoneNoList Array - Zone number list
memorySizeToBytes Integer - Memory size (byte)

Response status codes

For information about the HTTP status codes common to all Cloud Data Streaming Service APIs, see Cloud Data Streaming Service response status codes.

Response example

The response example is as follows:

{
    "code": 0,
    "message": "SUCCESS",
    "result": {
        "productList": [
            {
                "serverSpecCode": "cdss.c2-g3",
                "serverSpecTypeCode": "HICPU",
                "serverSpecDescription": "[HICPU] vCPU 2EA, Memory 4GB",
                "productCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G003",
                "hypervisorCode": "KVM",
                "generationCode": "G3",
                "cpuArchitectureCode": "X86_64",
                "cpuCount": 2,
                "memorySize": 4,
                "blockStorageMaxCount": 20,
                "networkInterfaceMaxCount": 3,
                "zoneNoList": [
                    2,
                    3
                ],
                "memorySizeToBytes": 4294967296
            },
            {
                "serverSpecCode": "cdss.c4-g3",
                "serverSpecTypeCode": "HICPU",
                "serverSpecDescription": "[HICPU] vCPU 4EA, Memory 8GB",
                "productCode": "SVR.VCDSS.HICPU.C004.M008.NET.SSD.B050.G003",
                "hypervisorCode": "KVM",
                "generationCode": "G3",
                "cpuArchitectureCode": "X86_64",
                "cpuCount": 4,
                "memorySize": 8,
                "blockStorageMaxCount": 20,
                "networkInterfaceMaxCount": 3,
                "zoneNoList": [
                    2,
                    3
                ],
                "memorySizeToBytes": 8589934592
            },
            ...
        ]
    },
    "requestId": "1e0a7419-****-****-****-5f648388dd38"
}