サーバタイプの照会(G3)

Prev Next

VPC環境で利用できます。

使用可能なノードサーバタイプを照会します。

参考

KVMハイパーバイザタイプの第3世代サーバ専用の APIです。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /api/v1/cluster/getServerSpecList (韓国リージョン)
POST /api/sgn-v1/cluster/getServerSpecList (シンガポールリージョン)
POST /api/jpn-v1/cluster/getServerSpecList (日本リージョン)

リクエストヘッダ

Cloud Data Streaming Service APIで共通して使用されるヘッダの詳細は、Cloud Data Streaming Serviceのリクエストヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
softwareProductCode String Required OSタイプコード

リクエスト例

リクエストのサンプルコードは次の通りです。

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"
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
code Integer - レスポンスコード
message String - レスポンスメッセージ
result Object - レスポンス結果
result.productList Array - サーバタイプリスト
requestId String - リクエスト ID
  • UUID形式

result.productList

result.productListの説明は次の通りです。

フィールド タイプ 必須の有無 説明
serverSpecCode String - サーバスペックコード
serverSpecTypeCode String - サーバ区分
serverSpecDescription String - サーバの説明
productCode String - サーバタイプコード
hypervisorCode String - ハイパーバイザコード
generationCode String - サーバの世代コード
cpuArchitectureCode String - CPUアーキテクチャタイプ
cpuCount Integer - CPU数
memorySize Integer - メモリ容量(GB)
blockStorageMaxCount Integer - 割り当て可能な最大ストレージ数
networkInterfaceMaxCount Integer - 割り当て可能な最大ネットワークインターフェース数
zoneNoList Array - ゾーン番号リスト
memorySizeToBytes Integer - メモリ容量(Byte)

レスポンスステータスコード

Cloud Data Streaming Service APIで共通して使用されるレスポンスステータスコードの詳細は、Cloud Data Streaming Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "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"
}