Help Center/ GeminiDB/ API Reference/ APIs v3 (Recommended)/ Instances/ Deleting Nodes from a Specified Instance
Updated on 2023-11-21 GMT+08:00
View PDF
Share

Deleting Nodes from a Specified Instance

Function

This API is used to delete nodes from a specified instance.

Constraints

This API supports the following types of instances:

  • GeminiDB Cassandra yearly/monthly and pay-per-use instances
  • GeminiDB Redis yearly/monthly and pay-per-use instances
  • You can change the billing mode of a GeminiDB Mongo instance from yearly/monthly to pay-per-use.

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 removed.

GeminiDB Mongo allows you to delete only read-only nodes from instances.

This API can be used to delete nodes from two GeminiDB Redis instances between which there is a dual-active DR relationship.

URI

POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/reduce-node

Table 1 Path parameters

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

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.
Table 3 Request body parameters

Parameter

Mandatory

Type

Description

num

No

Integer

Number of nodes to be deleted randomly.

For GeminiDB Cassandra instances, the value ranges from 1 to 10.

For GeminiDB Redis instances, the value is 1.

NOTE:

If users connect to nodes using the client, do no choose to delete node randomly.

node_list

No

Array of strings

ID of the node to be deleted. Make sure that the node can be deleted. If this parameter is not transferred, the number of nodes to be deleted is based on the internal policy of the system.

NOTE:
  • Either num or node_list must be set.
    • If node_list is transferred, its value can contain 1 to 10 characters for GeminiDB Cassandra and contain 1 character for GeminiDB Redis.
    • If num and node_list are both transferred, the value of node_list takes effect.
  • If node_list is empty, instance nodes are deleted randomly. If node_list is not empty, only the node whose ID is specified is deleted.
  • Before a node is deleted, do not connect to the node directly to avoid service interruptions.

Response Parameters

Status code: 202

Table 4 Response body parameters

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/reduce-node
  • Deleting a node 
    {
   "num" : 1,
   "node_list" : [ "116ba14da34a42d28ecd83a38c218907no12" ]
}

Example Responses

Status code: 202

Accepted

Example response for a pay-per-use instance:

{
  "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890"
}

Example response for a yearly/monthly instance:

{
  "order_id" : "CS20070721568OVO9"
}

Status Codes

For details, see Status Codes.

Error Codes

For details, see Error Codes.

Parent topic: Instances