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 Type Required Example Description
Action String No DeleteDBNodes

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

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

The ID of the PolarDB cluster whose node is to be deleted.

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

The ID of the node to be deleted. N is a positive integer that starts from 1. The maximum value of N is the number of current nodes minus 2. Each cluster must contain at least one primary node and one read-only node.

Note You can delete multiple read-only nodes at a time from only a ApsaraDB PolarDB MySQL-compatible edition cluster.
ClientToken String No 6000170000591aed949d0f54a343f1a42***********

The client token that is used to ensure the idempotence of the 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, but you must make sure that the value is unique among different requests. The token is case-sensitive, and can contain a maximum of 64 ASCII 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.