ノードの変更可能なスペックの照会(G3)

Prev Next

VPC環境で利用できます。

Search Engineクラスタのノードごとに変更可能なサーバスペックを照会します。

参考

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

リクエスト

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

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

リクエストヘッダ

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

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
serviceGroupInstanceNo Integer Required クラスタインスタンス番号

リクエストボディ

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

フィールド タイプ 必須の有無 説明
computeInstanceProductCode String Required ノードのサーバタイプコード

リクエスト例

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

curl --location --request POST 'https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getServerSpecListForSpecChange/1039*****' \
--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 '{
    "computeInstanceProductCode": "SVR.VELST.STAND.C002.M008.NET.SSD.B050.G003"
}'

レスポンス

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

レスポンスボディ

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

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

サーバタイプ情報

サーバタイプ情報の説明は次の通りです。

フィールド タイプ 必須の有無 説明
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 - ゾーン番号リスト
computeInstanceDetailTypeCode String - サーバの詳細タイプコード
isChangeSpec Boolean - サーバタイプは変更可能かどうか
  • true | false
    • true: 変更可能
    • false: 変更不可
isSelected Boolean - 現在使用中かどうか
  • true | false
    • true: 使用中
    • false: 使用中ではない
memorySizeToBytes Integer - メモリ容量(Byte)

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

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

レスポンス例

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

{
    "code": 0,
    "message": "SUCCESS",
    "result": {
        "managerNodeProductList": [
            {
                "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
                ],
                "computeInstanceDetailTypeCode": null,
                "isChangeSpec": true,
                "isSelected": true,
                "memorySizeToBytes": 4294967296
            },
            ...
        ],
        "dataNodeProductList": [
            {
                "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
                ],
                "computeInstanceDetailTypeCode": null,
                "isChangeSpec": true,
                "isSelected": true,
                "memorySizeToBytes": 4294967296
            },
            ...
        ],
        "masterNodeProductList": [
            {
                "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
                ],
                "computeInstanceDetailTypeCode": null,
                "isChangeSpec": false,
                "isSelected": false,
                "memorySizeToBytes": 4294967296
            },
            ...
        ]
    },
    "requestId": "5ca2eb64-****-****-****-3cb468f35f7a"
}