Deletes a read-only node from a specified PolarDB cluster.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Position Type Required Example Description
Action Query String No DeleteDBNodes

The operation that you want to perform. Set the value to DeleteDBNodes.

DBClusterId Query String Yes pc-**************

The ID of the PolarDB cluster.

DBNodeId.N Query RepeatList Yes pi-************

The ID of the cluster node to be deleted. N is a positive integer that starts from 1. To calculate the maximum value of N, use the following formula: The maximum value of N = The number of current nodes - 2. Each cluster must contain at least a primary node and a read-only node.

Note You can delete only one node at a time.
ClientToken Query String No 6000170000591aed949d0f54a343f1a42***********

The client token that is used to ensure the idempotency of requests. If an API operation is idempotent, the API operation returns the same result for identical requests. You can use the client to generate the value. Make sure that the value is unique for different requests. The token is case-sensitive. The token can contain only ASCII characters and cannot exceed 64 characters in length.

Response parameters

Parameter Type Example Description
DBClusterId String pc-**************

The ID of the PolarDB cluster.

OrderId String 2035638*******

The ID of the order.

RequestId String 6566B2E6-3157-4B57-A693-AFB751******

The ID of the request.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/? Action=DeleteDBNodes
&DBClusterId=pc-**************
&DBNodeId.1=pi-************
&<Common request parameters>

Sample success responses

XML format

<DeleteDBNodesResponse>
  <RequestId>6566B2E6-3157-4B57-A693-AFB751******</RequestId>
  <OrderId>2035638*******</OrderId>
  <DBClusterId>pc-**************</DBClusterId>
</DeleteDBNodesResponse>

JSON format

{
    "RequestId": "6566B2E6-3157-4B57-A693-AFB751******",
    "OrderId": "2035638*******",
    "DBClusterId": "pc-**************"
}

Error codes

For a list of error codes, visit the API Error Center.