You need to enable JavaScript to run this app.
文档中心
云数据库 MySQL 版

云数据库 MySQL 版

复制全文
下载 pdf
实例管理
DescribeDBInstanceNodes - 查询实例节点的详细信息
复制全文
下载 pdf
DescribeDBInstanceNodes - 查询实例节点的详细信息
调用 DescribeDBInstanceNodes 接口查询实例节点的详细信息。​
请求类型​
同步请求。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
InstanceId​
String​
是​
mysql-25651c34****​
实例 ID。​
​
返回参数​
​
参数​
类型​
示例值​
描述​
NodeInfos​
Array of InstanceNode​
请参见返回示例。​
实例节点的详细信息。​
​
InstanceNode​
​
参数​
类型​
示例值​
描述​
CPUUsedPercentage​
Double​
0.015​
节点的 CPU 使用率。​
说明​
此处的返回值为介于 0~1 之间的比例系数,并非 0~100 之间的百分比数值。​
LastIOError​
String​
-​
节点最后一次 IO 错误,可能返回为空。​
LastSQLError​
String​
-​
节点最后一次 SQL 错误,可能返回为空。​
MemoryUsedPercentage​
Double​
0.1727​
节点的内存使用率,可能不返回。​
说明​
此处的返回值为介于 0~1 之间的比例系数,并非 0~100 之间的百分比数值。​
NodeId​
String​
mysql-25651c34****-md1b4-0​
节点 ID。​
NodeStatus​
String​
Running​
节点状态,取值:​
  • Running:运行中。​
  • Creating:创建中。​
  • Deleting:删除中。​
  • Restarting:重启中。​
  • Restoring:恢复中。​
  • Updating:变更中。​
  • Upgrading:升级中。​
  • InOperation:运维锁定中。​
  • Error:错误。​
NodeType​
String​
Primary​
主节点需要传入 NodeType 为 Primary,只读节点无需传入。​
SlaveIORunning​
Boolean​
true​
节点的 IO 线程是否正常。可能不返回。​
SlaveSQLRunning​
Boolean​
true​
节点的 SQL 线程是否正常。可能不返回。​
SpaceUsedPercentage​
Double​
0.042298582457005976​
节点的存储空间使用率。可能不返回。​
说明​
此处的返回值为介于 0~1 之间的比例系数,并非 0~100 之间的百分比数值。​
SyncDelay​
Integer​
73​
节点的同步延迟。单位为毫秒。​
ZoneId​
String​
cn-beijing-a​
可用区 ID。​
​
示例​
请求示例​
​
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****"​
}​
​
返回示例​
​
{​
"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"​
}​
]​
}​
}​
​
错误码​
更多详情,请参见错误码。​
最近更新时间:2026.10.23 17:52:44
这个页面对您有帮助吗?
有用
有用
无用
无用