文档中心

云数据库 MySQL 版

请输入

实例管理

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.06.10 10:58:17

这个页面对您有帮助吗？

有用

无用