--- title: "Cloud Hadoop (VPC) overview" slug: "analytics-vhadoop" updated: 2026-09-17T09:48:02Z published: 2026-09-17T09:48:02Z 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) overview Available in VPC Cloud Hadoop is a NAVER Cloud Platform service that allows users to freely use open source-based frameworks such as Apache Hadoop, HBase, Spark, Hive, and Presto to process big data easily and quickly. Cloud Hadoop provides APIs for Cloud Hadoop cluster management and notebook node management in the RESTful form. ## Common Cloud Hadoop settings The following describes commonly used request and response formats in Cloud Hadoop APIs. ### Request The following describes the common request format. #### API URL The request API URL is as follows: ``` https://ncloud.apigw.ntruss.com ``` #### Request headers The following describes the request headers. | Field | Required | Description | | --- | --- | --- | | `x-ncp-apigw-timestamp` | Required | This is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC. - Request is considered invalid if the timestamp differs from the current time by more than 5 minutes. - Unix timestamp format. | | `x-ncp-iam-access-key` | Required | Access key issued on NAVER Cloud Platform - Issue and check access key: See [Create authentication key](/docs/en/common-ncpapi). - Issue and check access key for sub account: See [Create sub account](https://guide.ncloud-docs.com/docs/en/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 | Base64-encoded signature that encrypts the request information with a secret key that maps to the access key issued on NAVER Cloud Platform, using the HMAC encryption algorithm (HmacSHA256) - Issue and check secret key: See [Create authentication key](/docs/en/common-ncpapi). - Create signature: See [Create signature](/docs/en/common-ncpapi). | ### Response The following describes the common response format. #### Response body The response body includes the following data: **responseError** responseError defines the API call failure information. The following describes responseError. | Field | Type | Required | Description | | --- | --- | --- | --- | | `returnCode` | String | Required | Errors | | `returnMessage` | String | Required | Error message | #### Response status codes The following describes the response status codes. | HTTP status code | Code | Message | Description | | --- | --- | --- | --- | | 400 | 900 | Required field is not specified. location: [Parameter name] | Missing required parameter - Add required parameter and try again. | | 400 | 5000009 | An error occurred while processing the internal system. | An internal system error has occurred. - Contact [**Support**](https://www.ncloud.com/support/question/service) from the NAVER Cloud Platform portal. | | 400 | 5000020 | Processing of [View or Change]/[Sub Account action name] SubAccount authentication failed. | No permission on sub account. - Add permission to the account and try again. | | 400 | 5001005 | The cluster is in another operation. Please try again after the existing work is completed. | Called an already running cluster. - Wait until the operation is completed and then try again. | | 400 | 5001022 | Not a user-owned cluster. | Cluster instance number input error - Try again after editing the cluster number. | | 400 | 5001049 | Network Interface does not have an IP that can be assigned. | Insufficient subnet - Add a subnet to the VPC and try again. | | 400 | 5001139 | Contract restriction error. Creation limit is set. The cluster can no longer be created. Please contact customer support to modify the limit. | Creation limit - Contact [**Support**](https://www.ncloud.com/support/question/service) from the NAVER Cloud Platform portal. | | 400 | 5001269 | The instance could not be found. | The cluster has been deleted and does not exist. - Try again from running cluster. | Note For response status codes common to NAVER Cloud Platform, see [Ncloud API response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). #### Response example For response examples when a call is successful, see each API specification. The following is a sample response upon a failed call. - JSON ``` { "responseError":{ "returnCode":"stirng", "returnMessage":"stirng" } } ``` - XML ``` stirng stirng ``` ## Cloud Hadoop API The following describes the APIs provided by the Cloud Hadoop service. ### Clusters The following describes the cluster-related APIs. | API | Description | | --- | --- | | [backupClusterConfiguration](/docs/en/analytics-vhadoop-backupclusterconfiguration) | Back up cluster settings on a Object Storage bucket. | | [changeCloudHadoopNodeCount](/docs/en/analytics-vhadoop-changecloudhadoopnodecount) | Change the number of cluster nodes. | | [changeCloudHadoopNodeSpec](/docs/en/analytics-vhadoop-changecloudhadoopnodespec) | Upgrade cluster node specification. | | [createCloudHadoopInstance](/docs/en/analytics-vhadoop-createcloudhadoopinstance) | Create cluster. | | [deleteCloudHadoopInstance](/docs/en/analytics-vhadoop-deletecloudhadoopinstance) | Delete cluster. | | [getCloudHadoopAddOnList](/docs/en/analytics-vhadoop-getcloudhadoopaddonlist) | Get the list of components that can be installed additionally. | | [getCloudHadoopBucketList](/docs/en/analytics-vhadoop-getcloudhadoopbucketlist) | Get available Object Storage buckets. | | [getCloudHadoopClusterTypeList](/docs/en/analytics-vhadoop-getcloudhadoopclustertypelist) | Get available cluster types. | | [getCloudHadoopImageProductList](/docs/en/analytics-vhadoop-getcloudhadoopimageproductlist) | Get available cluster images. | | [getCloudHadoopInstanceDetail](/docs/en/analytics-vhadoop-getcloudhadoopinstancedetail) | Get details of a single cluster. | | [getCloudHadoopInstanceList](/docs/en/analytics-vhadoop-getcloudhadoopinstancelist) | Get cluster list. | | [getCloudHadoopLoginKeyList](/docs/en/analytics-vhadoop-getcloudhadooploginkeylist) | Get the authentication key in use. | | [getCloudHadoopMysqlInstanceList](/docs/en/analytics-vhadoop-getcloudhadoopmysqlinstancelist) | Get Cloud DB for MySQL that can be integrated with a Hive metastore. | | [getCloudHadoopMysqlUserList](/docs/en/analytics-vhadoop-getcloudhadoopmysqluserlist) | Get user information of Cloud DB for MySQL that can be integrated with a Hive metastore. | | [getCloudHadoopObjectList](/docs/en/analytics-vhadoop-getcloudhadoopobjectlist) | Get the list of objects in a Object Storage bucket in use. | | [getCloudHadoopProductList](/docs/en/analytics-vhadoop-getcloudhadoopproductlist) | Get available node-specific server types. | | [getCloudHadoopTargetSubnetList](/docs/en/analytics-vhadoop-getcloudhadooptargetsubnetlist) | Get the subnet in use. | | [getCloudHadoopTargetVpcList](/docs/en/analytics-vhadoop-getcloudhadooptargetvpclist) | Get the VPC in use. | | [saveExternalHiveMetaStore](/docs/en/analytics-vhadoop-saveexternalhivemetastore) | Integrate Hive metastore. | | [testConnectExternalHiveMetaStore](/docs/en/analytics-vhadoop-testconnectexternalhivemetastore) | Test Hive metastore integration availability. | ### Notebooks The following describes the notebook-related APIs. | API | Description | | --- | --- | | [createCloudHadoopNotebookInstance](/docs/en/analytics-vhadoop-createcloudhadoopnotebookinstance) | Create a notebook. | | [deleteCloudHadoopNotebookInstance](/docs/en/analytics-vhadoop-deletecloudhadoopnotebookinstance) | Delete a notebook. | | [getCloudHadoopNotebookBucketList](/docs/en/analytics-vhadoop-getcloudhadoopnotebookbucketlist) | Get available Object Storage buckets. | | [getCloudHadoopNotebookComponentList](/docs/en/analytics-vhadoop-getcloudhadoopnotebookcomponentlist) | Get available notebook components. | | [getCloudHadoopNotebookImageProductList](/docs/en/analytics-vhadoop-getcloudhadoopnotebookimageproductlist) | Get available notebook images. | | [getCloudHadoopNotebookInstanceDetail](/docs/en/analytics-vhadoop-getcloudhadoopnotebookinstancedetail) | Get details of a single notebook. | | [getCloudHadoopNotebookInstanceList](/docs/en/analytics-vhadoop-getcloudhadoopnotebookinstancelist) | Get the list of notebooks. | | [getCloudHadoopNotebookProductList](/docs/en/analytics-vhadoop-getcloudhadoopnotebookproductlist) | Get available notebook node server types. | ## Cloud Hadoop related resources NAVER Cloud Platform provides a variety of related resources to help users better understand Cloud Hadoop APIs. - Cloud Hadoop API guides - [Create signature](/docs/en/common-ncpapi): how to create a signature to add to the request header - [Sub Account User Guide](https://guide.ncloud-docs.com/docs/en/subaccount-overview): how to issue the access key to be added to the request header - [Common Ncloud response status codes](/docs/en/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): information on common response status codes of NAVER Cloud Platform used by the Cloud Hadoop service - How to use the Cloud Hadoop service - [Cloud Hadoop (VPC) User Guide](https://guide.ncloud-docs.com/docs/en/hadoop-vpc-1): how to use Cloud Hadoop in the NAVER Cloud Platform console - [Ncloud use environment guide](https://guide.ncloud-docs.com//docs/en/environment-environment-1-1): guide on VPC and Classic environments and supported features - [Introduction to pricing, characteristics, and detailed features](https://www.ncloud.com/product/analytics/cloudHadoop): the summary of pricing system, characteristics, and detailed features of Cloud Hadoop - [Latest service news](https://www.ncloud.com/intro/news?categoryCode=ANALY&serviceCode=SV_0086): the latest news on the Cloud Hadoop service - [FAQ](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0086&page=1): frequently asked questions from the Cloud Hadoop service users - [Contact us](https://www.ncloud.com/support/question/general): Send direct inquiries for unresolved questions that aren't answered by the API guide.