changeWorkerNodeCount

Prev Next

Classic環境で利用できます。

Cloud Hadoopクラスタのワーカーノード数を変更します。

リクエスト

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

メソッド URI
GET | POST /hadoop/v2/changeWorkerNodeCount
参考

ガイドは GETメソッドを基準に説明します。POSTメソッドの呼び出しテストは、NAVERクラウドプラットフォームコンソールの API Gatewayサービスの Swaggerで行えます。

リクエストヘッダ

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

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

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

フィールド タイプ 必須の有無 説明
cloudHadoopInstanceNo String Required クラスタインスタンス番号
workerNodeCount Integer Required ワーカーノード数
  • 一度に最大10個増減可能
  • 11個以上増減するには複数回呼び出す
responseFormatType String Optional レスポンスデータの形式
  • xml(デフォルト) | json

リクエスト例

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

curl --location --request GET 'https://ncloud.apigw.ntruss.com/hadoop/v2/changeWorkerNodeCount?cloudHadoopInstanceNo=2777****&workerNodeCount=3&responseFormatType=json' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-apigw-api-key: {API Key}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
changeWorkerNodeCountResponse Object - レスポンス結果
changeWorkerNodeCountResponse.totalRows Integer - レスポンス結果数
changeWorkerNodeCountResponse.cloudHadoopInstanceList Array - クラスタリスト
changeWorkerNodeCountResponse.requestId String - リクエスト ID
  • UUID形式
changeWorkerNodeCountResponse.returnCode String - レスポンスコード
changeWorkerNodeCountResponse.returnMessage String - レスポンスメッセージ

changeWorkerNodeCountResponse.cloudHadoopInstanceList

changeWorkerNodeCountResponse.cloudHadoopInstanceListの説明は次の通りです。

フィールド タイプ 必須の有無 説明
cloudHadoopInstanceNo String - クラスタインスタンス番号
cloudHadoopClusterName String - クラスタ名
cloudHadoopImageProductCode String - クラスタイメージコード
cloudHadoopClusterType Object - クラスタタイプ情報
cloudHadoopClusterType.code String - クラスタタイプコード
  • CHADP | HBASE | SPARK | PRESTO
    • CHADP: Core Hadoop
    • HBASE: HBase
    • SPARK: Spark
    • PRESTO: Presto
cloudHadoopClusterType.codeName String - クラスタタイプのコード名
masterNodeCpuCount Integer - マスターノードの CPU数
masterNodeCount Integer - マスターノード数
masterNodeMemorySize Integer - マスターノードのメモリ容量(Byte)
workerNodeCpuCount Integer - ワーカーノードの CPU数
workerNodeCount Integer - ワーカーノード数
workerNodeMemorySize Integer - ワーカーノードのメモリ容量(Byte)
edgeNodeCpuCount Integer - エッジノードの CPU数
edgeNodeCount Integer - エッジノード数
edgeNodeMemorySize Integer - エッジノードのメモリ容量(Byte)
cloudHadoopInstanceOperation Object - クラスタ運用情報
  • cloudHadoopInstanceStatusNameがrunningまたはsettingupの場合、表示
cloudHadoopInstanceOperation.code String - クラスタ運用コード
  • SETUP | NULL
    • SETUP: Cloud Hadoop SETUP OP
    • NULL: Cloud Hadoop NULL OP
cloudHadoopInstanceOperation.codeName String - クラスタ運用コード名
cloudHadoopInstanceStatusName String - クラスタ状態名
  • creating | running | settingup | deleting
    • creating: 作成中
    • running: 運用中
    • settingup: 設定中
    • deleting: 削除中
publicDnsName String - グローバルドメイン
publicIp String - グローバル IPアドレス
isHa Boolean - 高可用性をサポートするかどうか
  • true (デフォルト) | false
    • true: サポート
    • false: サポートしない
zone Object - ゾーン情報
zone.zoneNo String - ゾーン番号
zone.zoneName String - ゾーン名
zone.zoneCode String - ゾーンコード
zone.zoneDescription String - ゾーンの説明
zone.regionNo String - リージョン番号
region Object - リージョン情報
region.regionNo String - リージョン番号
region.regionCode String - リージョンコード
region.regionName String - リージョン名
masterNodeServerName String - マスターノードサーバ名
createDate String - クラスタの作成日時
  • ISO 8601形式
dataArchitecture String - データアーキテクチャ
bucketName String - Object Storageバケット名
directConnectionAccount String - クラスタ直接アクセスアカウント
loginKeyName String - 認証キー名
accessControlGroupList Array - ACGリスト

accessControlGroupList

accessControlGroupListの説明は次の通りです。

フィールド タイプ 必須の有無 説明
accessControlGroupConfigurationNo String - ACG ID
accessControlGroupName String - ACG名
accessControlGroupDescription String - ACGに関するメモ
isDefault Boolean - デフォルト ACGかどうか
  • true | false
    • true: デフォルト ACG
    • false: デフォルト ACGではない
createDate String - ACGの作成日時
  • ISO 8601形式

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

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

レスポンス例

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

{
    "changeWorkerNodeCountResponse": {
        "totalRows": 1,
        "cloudHadoopInstanceList": [
            {
                "cloudHadoopInstanceNo": "2777****",
                "cloudHadoopClusterName": "cluster",
                "cloudHadoopImageProductCode": "SPSWCHADPLINUX03",
                "cloudHadoopClusterType": {
                    "code": "CHADP",
                    "codeName": "Core Hadoop"
                },
                "masterNodeCpuCount": 4,
                "masterNodeCount": 2,
                "masterNodeMemorySize": 8589934592,
                "workerNodeCpuCount": 4,
                "workerNodeCount": 2,
                "workerNodeMemorySize": 34359738368,
                "edgeNodeCpuCount": 4,
                "edgeNodeCount": 1,
                "edgeNodeMemorySize": 8589934592,
                "cloudHadoopInstanceOperation": {
                    "code": "SETUP",
                    "codeName": "Cloud Hadoop SETUP OP"
                },
                "cloudHadoopInstanceStatusName": "settingup",
                "publicDnsName": "****.hadoop.ntruss.com",
                "publicIp": "***.***.***.***",
                "isHa": true,
                "zone": {
                    "zoneNo": "3",
                    "zoneName": "KR-2",
                    "zoneCode": "KR-2",
                    "zoneDescription": "坪村ゾーン",
                    "regionNo": "1"
                },
                "region": {
                    "regionNo": "1",
                    "regionCode": "KR",
                    "regionName": "Korea"
                },
                "masterNodeServerName": "m-001-cluster-hd",
                "createDate": "2025-02-28T09:16:46+0900",
                "dataArchitecture": "OBJST",
                "bucketName": "dataforest",
                "directConnectionAccount": "sshuser",
                "loginKeyName": "test-123",
                "accessControlGroupList": [
                    {
                        "accessControlGroupConfigurationNo": "192****",
                        "accessControlGroupName": "cloud-hadoop-gjb5m",
                        "accessControlGroupDescription": "Group for Cloud Hadoop cluster cluster (automatically created)",
                        "isDefault": false,
                        "createDate": "2025-02-28T09:16:48+0900"
                    }
                ]
            }
        ],
        "requestId": "21e41806-****-****-****-e89ded4655ed",
        "returnCode": "0",
        "returnMessage": "success"
    }
}