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

Prev Next

VPC環境で利用できます。

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

参考

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

リクエスト

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

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

リクエストヘッダ

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

リクエストボディ

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

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

リクエスト例

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

curl --location --request POST 'https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getServerSpecList' \
--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.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)

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

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

レスポンス例

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

{
  "code": 0,
  "message": "SUCCESS",
  "result": {
    "productList": [
      {
        "serverSpecCode": "elst.c2-g3",
        "serverSpecTypeCode": "HICPU",
        "serverSpecDescription": "[HICPU] vCPU 2EA, Memory 4GB",
        "productCode": "SVR.VELST.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": "elst.c4-g3",
        "serverSpecTypeCode": "HICPU",
        "serverSpecDescription": "[HICPU] vCPU 4EA, Memory 8GB",
        "productCode": "SVR.VELST.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
      },
      {
        "serverSpecCode": "elst.c8-g3",
        "serverSpecTypeCode": "HICPU",
        "serverSpecDescription": "[HICPU] vCPU 8EA, Memory 16GB",
        "productCode": "SVR.VELST.HICPU.C008.M016.NET.SSD.B050.G003",
        "hypervisorCode": "KVM",
        "generationCode": "G3",
        "cpuArchitectureCode": "X86_64",
        "cpuCount": 8,
        "memorySize": 16,
        "blockStorageMaxCount": 20,
        "networkInterfaceMaxCount": 3,
        "zoneNoList": [
          2,
          3
        ],
        "memorySizeToBytes": 17179869184
      },
      ...
    ]
  },
  "requestId": "b9057207-****-****-****-0976a484d383"
}