All Products
Search
Document Center

ApsaraDB RDS:DeleteDBNodes

Last Updated:Apr 17, 2024

Deletes a node from an ApsaraDB RDS for MySQL instance that runs RDS Cluster Edition.

Operation description

Supported database engine

MySQL

References

Note Before you call this operation, read the following documentation and make sure that you fully understand the prerequisites and impacts of this operation.

Delete a node from an ApsaraDB RDS for MySQL instance that runs RDS Cluster Edition

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ClientTokenstringNo

The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests.

The token can only contain ASCII characters and cannot exceed 64 characters in length.

ETnLKlblzczshOTUbOCz****
DBInstanceIdstringYes

The instance ID. You can call the DescribeDBInstances operation to query the ID of the instance.

rm-uf6wjk5****
DBNodeIdarrayYes

The node IDs.

stringYes

The node ID.

You can use one of the following methods to query the node ID:

  • Log on to the ApsaraDB RDS console, go to the instance details page, and then view the node ID in the instance topology section.
  • Call the DescribeDBInstanceAttribute operation to query the node ID.
rn-m8f****
ResourceGroupIdstringNo

The ID of the resource group. You can call the DescribeDBInstanceAttribute operation to obtain the ID of the resource group.

rg-acfmy****

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The ID of the request.

8B993DA9-5272-5414-94E3-4CA8BA0146C2
DBInstanceIdstring

The ID of the instance.

rm-uf6wjk5****
OrderIdlong

The ID of the order.

100780000000000

Examples

Sample success responses

JSONformat

{
  "RequestId": "8B993DA9-5272-5414-94E3-4CA8BA0146C2",
  "DBInstanceId": "rm-uf6wjk5****",
  "OrderId": 100780000000000
}

Error codes

HTTP status codeError codeError messageDescription
400DBNodeFormatFaultThe specified parameter DBNode is malformedThe specified dbNode parameter is invalid.
400DBNodeIdParameterInvalidThe specified parameter DBNodeId is malformed.The specified DBNodeId parameter is invalid.
400DBNodeIdParameterNotFoundThe specified parameter DBNodeId is required.You must specify the DBNodeId parameter.
400DBNodeParameter.TooFewItemsThe specified parameter DBNode has too few items.A small number of DBNode parameter items are configured.
400DBNodeParameter.InvalidClassCodeThe ClassCode of the item of the specified parameter DBNode is inconsistent.The ClassCode configuration is invalid for the DBNode parameter.
400DBNodeIdParameter.NotExistsThe DBNodeId in the parameter does not exist.The DBNodeId in the parameter does not exist.
403GroupReplicationNotSupport.InvalidEngineVersionGroup Replication requires the instance engine version to be 8.0.-
403GroupReplicationNotSupport.InvalidNodeClassCodeGroup Replication requires the ClassCode of each node to be consistent.-
403GroupReplicationNotSupport.InvalidNodeNumGroup Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.-
403GroupReplicationNotSupport.InvalidXengineGroup Replication is not supported because the instance has xengine tables.-
403GroupReplicationNotSupport.MemoryTooSmallGroup Replication is not supported because the memory is too small.-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-04-08The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
    delete Error Codes: 403
2023-11-07The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
    delete Error Codes: 403
2023-07-21The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 403
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: ResourceGroupId