Cloud Hadoopの概要

Prev Next

Classic環境で利用できます。

Cloud Hadoopは、Apache Hadoop、HBase、Spark、Hive、Prestoなどのオープンソースベースのフレームワークをユーザーが自由に使用して、ビッグデータを簡単かつスピーディーに処理する NAVERクラウドプラットフォームのサービスです。Cloud Hadoopサービスは、Hadoopクラスタの作成、ワーカーノードの追加、リソース照会機能関連の APIを RESTful形式で提供します。

Cloud Hadoopの共通設定

Cloud Hadoop APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

https://ncloud.apigw.ntruss.com

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
x-ncp-apigw-api-key Required NAVERクラウドプラットフォームの API Gatewayサービスから発行された APIキー
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名

レスポンス

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

レスポンスボディ

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

responseError
responseErrorは API呼び出し失敗情報を定義します。responseErrorの説明は次の通りです。

フィールド タイプ 必須の有無 説明
returnCode String Required エラーコード
returnMessage String Required エラーメッセージ

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

レスポンスステータスコードの説明は次の通りです。

HTTPステータスコード コード メッセージ 説明
400 900 Required field is not specified. location: [パラメータ名] 必須パラメータ欠落
  • 必須パラメータを追加して再試行
500 908 workerNodeCount is invalid. workerNodeCount should be in [2, 12] ワーカーノード数増減範囲超過
  • 10個以下に変更して再試行
500 929 Please try your call again later.\nTemporarily out of service.\nIf error continue, Please contact our customer service center. 一時的なエラー
  • しばらくしてから再試行するか、エラーが続く場合は、NAVERクラウドプラットフォームポータルのサポートに問い合わせ
500 10713 No such item found. If the error persists,contact Customer Service. クラスタインスタンス番号の入力エラー
  • クラスタインスタンス番号を変更して再試行
参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

  • JSON
    {
    "error": {
        "returnCode": "string",
        "returnMessage": "string",
    }
}
  • XML
    <error>
    <returnCode>string</returnCode>
    <returnMessage>string</returnMessage>
</error>

Cloud Hadoop API

Cloud Hadoopサービスで提供する APIの説明は次の通りです。

API 説明
changeCloudHadoopNodeCount クラスタワーカーノード数を変更
createCloudHadoopInstance クラスタを作成
deleteCloudHadoopInstance クラスタを削除
getCloudHadoopBucketList 使用可能な Object Storageバケットを照会
getCloudHadoopImageProductList 使用可能なクラスタイメージを照会
getCloudHadoopInstanceList クラスタリストを照会
getCloudHadoopProductList 使用可能なノード別サーバタイプを照会

Cloud Hadoop関連リソース

Cloud Hadoop APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。