Available in Classic
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 creating Hadoop clusters, adding worker nodes, and querying resources 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.
|
x-ncp-apigw-api-key |
Required | API key issued by the API Gateway service of NAVER Cloud Platform |
x-ncp-iam-access-key |
Required | Access key issued on NAVER Cloud Platform
|
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)
|
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
|
500 | 908 | workerNodeCount is invalid. workerNodeCount should be in [2, 12] | Number of worker nodes exceeds the range of increase/decrease.
|
500 | 929 | Please try your call again later.\nTemporarily out of service.\nIf error continue, Please contact our customer service center. | Temporary error
|
500 | 10713 | No such item found. If the error persists,contact Customer Service. | Cluster instance number entry error
|
For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.
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
{ "error": { "returnCode": "string", "returnMessage": "string", } }
- XML
<error> <returnCode>string</returnCode> <returnMessage>string</returnMessage> </error>
Cloud Hadoop API
The following describes the APIs provided by the Cloud Hadoop service.
API | Description |
---|---|
changeCloudHadoopNodeCount | Change the number of cluster worker nodes. |
createCloudHadoopInstance | Create cluster. |
deleteCloudHadoopInstance | Delete cluster. |
getCloudHadoopBucketList | Get available Object Storage buckets. |
getCloudHadoopImageProductList | Get available cluster images. |
getCloudHadoopInstanceList | Get cluster list. |
getCloudHadoopProductList | Get available node-specific 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: how to create a signature to add to the request header
- API Gateway User Guide: how to issue the API key to be added to the request header
- Sub Account User Guide: how to issue the access key to be added to the request header
- Common Ncloud response status codes: 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 User Guide: how to use Cloud Hadoop in the NAVER Cloud Platform console
- Ncloud use environment guide: guide on VPC and Classic environments and supported features
- Introduction to pricing, characteristics, and detailed features: the summary of pricing system, characteristics, and detailed features of Cloud Hadoop
- Latest service news: the latest news on the Cloud Hadoop service
- FAQ: frequently asked questions from the Cloud Hadoop service users
- Contact us: Send direct inquiries for unresolved questions that aren't answered by the API guide.