Adding Nodes for an Instance
Function
This API is used to add nodes for a specified instance.
Constraints
This API supports the following types of instances:
- GeminiDB Cassandra
- GeminiDB Mongo
- GeminiDB Influx
- GeminiDB Redis
The maximum and minimum storage space of each GeminiDB Redis instance depends on its node quantity and specifications. If the new storage space cannot meet the requirements for running the instance, nodes cannot be added.
This API supports both yearly/monthly and pay-per-use instances.
GeminiDB Influx does not allow you to add nodes to single-node instances.
GeminiDB Mongo allows you to add only read-only nodes for instances.
This API can be used to add nodes for two GeminiDB Redis instances between which there is a dual-active DR relationship.
URI
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/enlarge-node
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID of a tenant in a region. To obtain this value, see Obtaining a Project ID. |
instance_id |
Yes |
String |
Instance ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
num |
Yes |
Integer |
Number of new nodes. |
subnet_id |
No |
String |
ID of the subnet where the new node is deployed.
|
is_auto_pay |
No |
String |
Whether the order will be automatically paid after a yearly/monthly instance is created. This parameter does not affect the payment mode of automatic renewal.
|
Response Parameters
Status code: 202
Parameter |
Type |
Description |
---|---|---|
job_id |
String |
Task ID. This parameter is returned only for pay-per-use instances. |
order_id |
String |
Order ID. This parameter is returned only for yearly/monthly instances. |
Example Requests
- URI example
POST https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/375d8d8fad1f43039e23d3b6c0f60a19/instances/9136fd2a9fcd405ea4674276ce36dae8in06/enlarge-node
- Adding a node
{ "num" : 1 }
Example Responses
Status code: 202
Accepted
Example response for a pay-per-use instance:
{ "job_id" : "3711e2ad-5787-49bc-a47f-3f0b066af9f5" }
Example response for a yearly/monthly instance:
{ "order_id" : "CS20070721568OVO9" }
Status Codes
For details, see Status Codes.
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot