--- title: "Cloud Hadoop (VPC)の概要" slug: "analytics-vhadoop" updated: 2026-09-17T09:57:29Z published: 2026-09-17T09:57:29Z canonical: "api.ncloud-docs.com/analytics-vhadoop" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Cloud Hadoop (VPC)の概要 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分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 | | `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 | | `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 | ### レスポンス 共通レスポンス形式を説明します。 #### レスポンスボディ レスポンスボディの説明は次の通りです。 **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クラウドプラットフォームポータルの[**サポート**](https://www.ncloud.com/support/question/service)に問い合わせ | | 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クラウドプラットフォームポータルの[**サポート**](https://www.ncloud.com/support/question/service)に問い合わせ | | 400 | 5001269 | The instance could not be found. | クラスタが削除されて存在しない - 運用中のクラスタで再試行 | 参考 NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 #### レスポンス例 呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。 - JSON ``` { "responseError":{ "returnCode":"stirng", "returnMessage":"stirng" } } ``` - XML ``` stirng stirng ``` ## Cloud Hadoop API Cloud Hadoopサービスで提供する APIの説明は次の通りです。 ### Clusters クラスタ関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [backupClusterConfiguration](/docs/ja/analytics-vhadoop-backupclusterconfiguration) | Object Storageバケットにクラスタ設定をバックアップ | | [changeCloudHadoopNodeCount](/docs/ja/analytics-vhadoop-changecloudhadoopnodecount) | クラスタノード数を変更 | | [changeCloudHadoopNodeSpec](/docs/ja/analytics-vhadoop-changecloudhadoopnodespec) | クラスタノードスペックをアップグレード | | [createCloudHadoopInstance](/docs/ja/analytics-vhadoop-createcloudhadoopinstance) | クラスタを作成 | | [deleteCloudHadoopInstance](/docs/ja/analytics-vhadoop-deletecloudhadoopinstance) | クラスタを削除 | | [getCloudHadoopAddOnList](/docs/ja/analytics-vhadoop-getcloudhadoopaddonlist) | 追加でインストール可能なコンポーネントリストを照会 | | [getCloudHadoopBucketList](/docs/ja/analytics-vhadoop-getcloudhadoopbucketlist) | 使用可能な Object Storageバケットを照会 | | [getCloudHadoopClusterTypeList](/docs/ja/analytics-vhadoop-getcloudhadoopclustertypelist) | 使用可能なクラスタタイプを照会 | | [getCloudHadoopImageProductList](/docs/ja/analytics-vhadoop-getcloudhadoopimageproductlist) | 使用可能なクラスタイメージを照会 | | [getCloudHadoopInstanceDetail](/docs/ja/analytics-vhadoop-getcloudhadoopinstancedetail) | クラスタの詳細を個別照会 | | [getCloudHadoopInstanceList](/docs/ja/analytics-vhadoop-getcloudhadoopinstancelist) | クラスタリストを照会 | | [getCloudHadoopLoginKeyList](/docs/ja/analytics-vhadoop-getcloudhadooploginkeylist) | 使用中の認証キーを照会 | | [getCloudHadoopMysqlInstanceList](/docs/ja/analytics-vhadoop-getcloudhadoopmysqlinstancelist) | Hiveメタストアと連携可能な Cloud DB for MySQLを照会 | | [getCloudHadoopMysqlUserList](/docs/ja/analytics-vhadoop-getcloudhadoopmysqluserlist) | Hiveメタストアと連携可能な Cloud DB for MySQLのユーザー情報を照会 | | [getCloudHadoopObjectList](/docs/ja/analytics-vhadoop-getcloudhadoopobjectlist) | 使用中の Object Storageバケット内のオブジェクトリストを照会 | | [getCloudHadoopProductList](/docs/ja/analytics-vhadoop-getcloudhadoopproductlist) | 使用可能なノード別サーバタイプを照会 | | [getCloudHadoopTargetSubnetList](/docs/ja/analytics-vhadoop-getcloudhadooptargetsubnetlist) | 使用中の Subnetを照会 | | [getCloudHadoopTargetVpcList](/docs/ja/analytics-vhadoop-getcloudhadooptargetvpclist) | 使用中の VPCを照会 | | [saveExternalHiveMetaStore](/docs/ja/analytics-vhadoop-saveexternalhivemetastore) | Hiveメタストア連携 | | [testConnectExternalHiveMetaStore](/docs/ja/analytics-vhadoop-testconnectexternalhivemetastore) | Hiveメタストアと連携可能かどうかテスト | ### Notebooks ノートブック関連 APIの説明は次の通りです。 | API | 説明 | | --- | --- | | [createCloudHadoopNotebookInstance](/docs/ja/analytics-vhadoop-createcloudhadoopnotebookinstance) | ノートブックを作成 | | [deleteCloudHadoopNotebookInstance](/docs/ja/analytics-vhadoop-deletecloudhadoopnotebookinstance) | ノートブックを削除 | | [getCloudHadoopNotebookBucketList](/docs/ja/analytics-vhadoop-getcloudhadoopnotebookbucketlist) | 使用可能な Object Storageバケットを照会 | | [getCloudHadoopNotebookComponentList](/docs/ja/analytics-vhadoop-getcloudhadoopnotebookcomponentlist) | 使用可能なノートブックコンポーネントを照会 | | [getCloudHadoopNotebookImageProductList](/docs/ja/analytics-vhadoop-getcloudhadoopnotebookimageproductlist) | 使用可能なノートブックイメージを照会 | | [getCloudHadoopNotebookInstanceDetail](/docs/ja/analytics-vhadoop-getcloudhadoopnotebookinstancedetail) | ノートブックの詳細を個別照会 | | [getCloudHadoopNotebookInstanceList](/docs/ja/analytics-vhadoop-getcloudhadoopnotebookinstancelist) | ノートブックリストを照会 | | [getCloudHadoopNotebookProductList](/docs/ja/analytics-vhadoop-getcloudhadoopnotebookproductlist) | 使用可能なノートブックノードサーバタイプを照会 | ## Cloud Hadoop関連リソース Cloud Hadoop APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。 - Cloud Hadoop APIの使用方法 - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi): リクエストヘッダに追加する署名の作成方法 - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法 - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Cloud Hadoopサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報 - Cloud Hadoopサービスの使用方法 - [Cloud Hadoop (VPC)ご利用ガイド](https://guide.ncloud-docs.com/docs/ja/hadoop-vpc-1): NAVERクラウドプラットフォームで Cloud Hadoopを使用する方法 - [Ncloud使用環境ガイド](https://guide.ncloud-docs.com//docs/ja/environment-environment-1-1): VPC、Classic環境とサポートの有無に関するご利用ガイド - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/analytics/cloudHadoop): Cloud Hadoopの料金体系、特徴、詳細機能のサマリー - [サービスのお知らせ](https://www.ncloud.com/intro/news?categoryCode=ANALY&serviceCode=SV_0086): Cloud Hadoopサービスに関するお知らせ - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0086&page=1): Cloud Hadoopサービスに関するよくあるご質問 - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ