Adding Nodes to a Replica Set Instance

API Description

This API is used to add nodes to a specified replica set instance.

Restrictions

• This API supports both yearly/monthly and pay-per-use DB instances.

URI

• URI format

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

• URI example
  https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein02/replicaset-node

  Table 1 Path parameters

  Name	Mandatory	Type	Description
  project_id	Yes	String	The project ID of a tenant in a region. To obtain the project ID, see Obtaining a Project ID.
  instance_id	Yes	String	Instance ID, which can be obtained by calling the API described in Querying Instances and Details. If you do not have an instance, call the API described in Creating a DB Instance to create one.

  Table 2 Request header parameters

  Name	Mandatory	Type	Description
  x-auth-token	Yes	String	User token.

Requests

• Parameter description

  Table 3 Request body parameters

  Name	Mandatory	Type	Description
  num	Yes	Integer	Number of nodes to be added to a replica set instance. If a replica set instance has three nodes, two or four nodes can be added. If a replica set instance has five nodes, only two nodes can be added. If a replica set instance has seven nodes, the standby node cannot be added.
  is_auto_pay	No	Boolean	Whether the order is automatically paid from your account when you change the class of a yearly/monthly DB instance. This parameter does not affect the payment mode of automatic renewal. This parameter is invalid when the instance class is scaled down. When the instance class is scaled up, this parameter can be set to: true: indicates that the order is automatically paid from the account. false: indicates that the order is manually paid from the account. The default value is false.

• Request example

  POST https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein02/replicaset-node 
   
  { 
    "num" : 2 
  }

Responses

• Parameter description

  Table 4 Response body parameters

  Name	Type	Description
  job_id	String	Task ID. This parameter is returned only for pay-per-use DB instances.
  order_id	String	Order ID. This parameter is returned only when yearly/monthly DB instances are created.

• Response example

  { 
    "job_id" : "6ad4eb1f-73bd-4876-aa31-aa9a1e41c4bc" 
  }

Status Code

For details, see Status Code.

Error Code

For details, see Error Code.