---
title: "Cloud Hadoopの概要"
slug: "analytics-cloudhadoop"
updated: 2026-09-17T09:57:32Z
published: 2026-09-17T09:57:32Z
canonical: "api.ncloud-docs.com/analytics-cloudhadoop"
---

> ## 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の概要

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分以上の場合は無効なリクエストとみなす - Unix Timestamp形式 |
| `x-ncp-apigw-api-key` | Required | NAVERクラウドプラットフォームの API Gatewayサービスから発行された APIキー |
| `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: [パラメータ名] | 必須パラメータ欠落 - 必須パラメータを追加して再試行 |
| 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クラウドプラットフォームポータルの[**サポート**](https://www.ncloud.com/support/question/service)に問い合わせ |
| 500 | 10713 | No such item found. If the error persists,contact Customer Service. | クラスタインスタンス番号の入力エラー - クラスタインスタンス番号を変更して再試行 |

参考

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

```
{
    "error": {
        "returnCode": "string",
        "returnMessage": "string",
    }
}
```
- XML

```
<error>
    <returnCode>string</returnCode>
    <returnMessage>string</returnMessage>
</error>
```

## Cloud Hadoop API

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

| API | 説明 |
| --- | --- |
| [changeCloudHadoopNodeCount](/docs/ja/analytics-cloudhadoop-changeworkernodecount) | クラスタワーカーノード数を変更 |
| [createCloudHadoopInstance](/docs/ja/analytics-cloudhadoop-createcloudhadoopinstance) | クラスタを作成 |
| [deleteCloudHadoopInstance](/docs/ja/analytics-cloudhadoop-deletecloudhadoopistance) | クラスタを削除 |
| [getCloudHadoopBucketList](/docs/ja/analytics-cloudhadoop-getcloudhadoopbucketlist) | 使用可能な Object Storageバケットを照会 |
| [getCloudHadoopImageProductList](/docs/ja/docs/ja/analytics-cloudhadoop-getcloudhadoopimageproductlist) | 使用可能なクラスタイメージを照会 |
| [getCloudHadoopInstanceList](/docs/ja/analytics-cloudhadoop-getcloudhadoopinstancelist) | クラスタリストを照会 |
| [getCloudHadoopProductList](/docs/ja/analytics-cloudhadoop-getcloudhadoopproductlist) | 使用可能なノード別サーバタイプを照会 |

## Cloud Hadoop関連リソース

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

- Cloud Hadoop APIの使用方法
  - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi): リクエストヘッダに追加する署名の作成方法
  - [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに追加する API Keyの発行方法
  - [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ご利用ガイド](https://guide.ncloud-docs.com/docs/ja/hadoop-chadoop-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): Cloud Hadoopサービスに関するお知らせ
  - [よくある質問](https://www.ncloud.com/support/faq/all): Cloud Hadoopサービスに関するよくあるご質問
  - [お問い合わせ](https://www.ncloud.com/support/question/general): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ