查询订阅监控信息 - CollectSubscriptionMonitor
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
rds:instance:update |
write |
- |
- |
rds:instance:modify |
- |
URI
- URI格式
GET /v3/{project_id}/instances/{instance_id}/replication/subscriptions/{subscription_id}/monitor
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一region下的project ID。
获取方法请参见获取项目ID。
约束限制：
非空。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID。
约束限制：
非空。
取值范围：
不涉及。
默认取值：
不涉及。
subscription_id
是
参数解释：
订阅ID。
约束限制：
非空。
取值范围：
不涉及。
默认取值：
不涉及。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
status
String
参数解释：
订阅关联的快照代理的运行状态。
取值范围：
- started：已启动。
- succeeded：成功。
- in_progress：正在运行。
- idle：空闲。
- retrying：重试中。
- failed：失败。
latency
Integer
参数解释：
数据更改的最长延迟时间（以秒为单位）。
取值范围：
不涉及。
agent_not_running
Integer
参数解释：
代理未运行的时长（以小时为单位）。
取值范围：
不涉及。
pending_cmd_count
Integer
参数解释：
订阅未执行的命令数。
取值范围：
不涉及。
last_dist_sync
String
参数解释：
上一次分发代理运行时间，格式：yyyy-mm-ddThh:mm:ssZ。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
取值范围：
不涉及。
estimated_process_time
Integer
参数解释：
预计执行完未执行的命令数所需时间（以秒为单位）。
取值范围：
不涉及。
- 正常响应样例
{ "status": "in_progress", "latency": 35, "last_dist_sync": "2025-11-04T03:10:05+0000", "pending_cmd_count": 0, "estimated_process_time": 0 } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
