Cloud Hadoop (VPC)の概要

Prev Next

VPC環境で利用できます。

Cloud Hadoopは、Apache Hadoop、HBase、Spark、Hive、Prestoなどのオープンソースベースのフレームワークをユーザーが自由に使用して、ビッグデータを簡単かつスピーディーに処理する NAVERクラウドプラットフォームのサービスです。Cloud Hadoopサービスは、Cloud 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-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: [パラメータ名] 必須パラメータ欠落
  • 必須パラメータを追加して再試行
400 5000009 An error occurred while processing the internal system. 内部システムエラー発生
  • NAVERクラウドプラットフォームポータルのサポートに問い合わせ
400 5000020 Processing of [View or Change]/[Sub Accountのアクション名] SubAccount authentication failed. サブアカウントに権限がない
  • アカウントに権限を追加して再試行
400 5001005 The cluster is in another operation. Please try again after the existing work is completed. 既に動作中のクラスタを呼び出す
  • 動作が完了するのを待って再試行
400 5001022 Not a user-owned cluster. クラスタインスタンス番号の入力エラー
  • クラスタ番号を変更して再試行
400 5001049 Network Interface does not have an IP that can be assigned. Subnet不足
  • VPCに Subnetを追加して再試行
400 5001139 Contract restriction error. Creation limit is set. The cluster can no longer be created. Please contact customer support to modify the limit. 作成数制限
  • NAVERクラウドプラットフォームポータルのサポートに問い合わせ
400 5001269 The instance could not be found. クラスタが削除されて存在しない
  • 運用中のクラスタで再試行
参考

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

レスポンス例

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

  • JSON
    {
    "responseError":{
        "returnCode":"stirng",
        "returnMessage":"stirng"
    }
}
  • XML
    <responseError>
    <returnCode>stirng</returnCode>
    <returnMessage>stirng</returnMessage>
</responseError>

Cloud Hadoop API

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

Clusters

クラスタ関連 APIの説明は次の通りです。

API 説明
backupClusterConfiguration Object Storageバケットにクラスタ設定をバックアップ
changeCloudHadoopNodeCount クラスタノード数を変更
changeCloudHadoopNodeSpec クラスタノードスペックをアップグレード
createCloudHadoopInstance クラスタを作成
deleteCloudHadoopInstance クラスタを削除
getCloudHadoopAddOnList 追加でインストール可能なコンポーネントリストを照会
getCloudHadoopBucketList 使用可能な Object Storageバケットを照会
getCloudHadoopClusterTypeList 使用可能なクラスタタイプを照会
getCloudHadoopImageProductList 使用可能なクラスタイメージを照会
getCloudHadoopInstanceDetail クラスタの詳細を個別照会
getCloudHadoopInstanceList クラスタリストを照会
getCloudHadoopLoginKeyList 使用中の認証キーを照会
getCloudHadoopMysqlInstanceList Hiveメタストアと連携可能な Cloud DB for MySQLを照会
getCloudHadoopMysqlUserList Hiveメタストアと連携可能な Cloud DB for MySQLのユーザー情報を照会
getCloudHadoopObjectList 使用中の Object Storageバケット内のオブジェクトリストを照会
getCloudHadoopProductList 使用可能なノード別サーバタイプを照会
getCloudHadoopTargetSubnetList 使用中の Subnetを照会
getCloudHadoopTargetVpcList 使用中の VPCを照会
saveExternalHiveMetaStore Hiveメタストア連携
testConnectExternalHiveMetaStore Hiveメタストアと連携可能かどうかテスト

Notebooks

ノートブック関連 APIの説明は次の通りです。

API 説明
createCloudHadoopNotebookInstance ノートブックを作成
deleteCloudHadoopNotebookInstance ノートブックを削除
getCloudHadoopNotebookBucketList 使用可能な Object Storageバケットを照会
getCloudHadoopNotebookComponentList 使用可能なノートブックコンポーネントを照会
getCloudHadoopNotebookImageProductList 使用可能なノートブックイメージを照会
getCloudHadoopNotebookInstanceDetail ノートブックの詳細を個別照会
getCloudHadoopNotebookInstanceList ノートブックリストを照会
getCloudHadoopNotebookProductList 使用可能なノートブックノードサーバタイプを照会

Cloud Hadoop関連リソース

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