RDS for MySQL
RDS for MySQL
RDS for MySQL
Document
What's new
Announcement
Product introduction
Product billing
Billing method
Kernel functions
Feature
Stability
Performance
Quick start
User guide
Managing instances
Changing an instance configuration
Upgrading kernel versions
Managing tags
Managing disaster instances
Managing blue-green deployment
Migrating data
Managing connections
Database proxy
Connecting to an instance
Managing connection endpoints
Diagnosing connections
Managing connection pool modes
Managing access addresses and ports
Managing databases
Account and access authorization
Backup recovery
Backup data
Data recovery
Service availability
Managing logs
Managing data security
Managing allowlists
Configuring SSL encryption
Managing parameters
Monitoring and alerts
Task center
Operation and maintenance events
Backups of deleted instances
Managing cross-regional backups
API reference
V2（2022-01-01）
Global management
Managing instances
Managing connections
Managing accounts
Managing databases
Security encryption
Backup and recovery
Managing parameters
Managing tasks
Event management
Managing logs
Resource plan management
Appendix
SDK reference
Developer tools
Best practice
Performance document
Troubleshooting
- Documentation
RDS for MySQLAPI referenceV2（2022-01-01）Managing instancesDescribeDBInstanceNodes
Copy page
Download PDFManaging instances
DescribeDBInstanceNodes
Copy pageDownload PDFDescribeDBInstanceNodes
Call the DescribeDBInstanceNodes API to query the detailed information of instance nodes.
Request type
Synchronous request.
Debug
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
Request parameters
Parameter | Type | Is it required? | Sample value | Description |
InstanceId | String | Yes | mysql-25651c34**** | Instance ID. |
Response parameters
Parameter | Type | Sample value | Description |
NodeInfos | Refer to the Sample response. | Details of the instance node. |
InstanceNode
Parameter | Type | Sample value | Description |
CPUUsedPercentage | Double | 0.015 | CPU utilization of a node. tip The return value here is a proportional coefficient ranging from 0 to 1, not a percentage value from 0 to 100. |
LastIOError | String | - | The last I/O error of the node, which may be returned as empty. |
LastSQLError | String | - | The last SQL error of the node, which may be returned as empty. |
MemoryUsedPercentage | Double | 0.1727 | Memory usage rate of the node. May not be returned. tip The return value here is a proportional coefficient ranging from 0 to 1, not a percentage value from 0 to 100. |
NodeId | String | mysql-25651c34****-md1b4-0 | Node ID. |
NodeStatus | String | Running | Node status, with values:
|
NodeType | String | Primary | The primary node requires NodeType to be set to Primary, and the read-only node does not require it. |
SlaveIORunning | Boolean | true | Whether the IO thread of the node is normal. May not be returned. |
SlaveSQLRunning | Boolean | true | Whether the node's SQL thread is normal. May not be returned. |
SpaceUsedPercentage | Double | 0.042298582457005976 | The storage usage of the node. May not be returned. tip The return value here is a proportional coefficient ranging from 0 to 1, not a percentage value from 0 to 100. |
SyncDelay | Integer | 73 | Synchronized latency of the node. The unit is milliseconds. |
ZoneId | String | cn-beijing-a | Availability zone ID. |
Sample
Sample request
POST /?Action=DescribeDBInstanceNodes&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mysql.cn-beijing.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
"instanceid": "mysql-25651c34****"
}
Sample response
{
"ResponseMetadata": {
"RequestId": "20250605202902007681F01031C6680603-3c0c42",
"Action": "DescribeDBInstanceNodes",
"Version": "2022-01-01",
"Service": "rds_mysql",
"Region": "cn-beijing"
},
"Result": {
"NodeInfos": [
{
"CPUUsedPercentage": 0.015,
"MemoryUsedPercentage": 0.1727,
"NodeId": "mysql-25651c34****-md1b4-0",
"NodeStatus": "Running",
"NodeType": "Primary",
"SpaceUsedPercentage": 0.042298582457005976,
"ZoneId": "cn-beijing-a"
},
{
"CPUUsedPercentage": 0,
"MemoryUsedPercentage": 0.1873,
"NodeId": "mysql-25651c34****-sf57c-0",
"NodeStatus": "Running",
"NodeType": "Secondary",
"SlaveIORunning": true,
"SlaveSQLRunning": true,
"SpaceUsedPercentage": 0.042298582457005976,
"SyncDelay": 0,
"ZoneId": "cn-beijing-a"
},
{
"CPUUsedPercentage": 0,
"MemoryUsedPercentage": 0.1818,
"NodeId": "mysql-25651c34****-r399d",
"NodeStatus": "Running",
"NodeType": "ReadOnly",
"SlaveIORunning": true,
"SlaveSQLRunning": true,
"SpaceUsedPercentage": 0.042298582457005976,
"SyncDelay": 73,
"ZoneId": "cn-beijing-a"
}
]
}
}
Error code
Last updated: 2026.06.12 17:17:51
All rights reserved © Beijing Volcano Engine Technology Co., Ltd2024
