更新时间：2025-10-28 GMT+08:00
查询订阅服务器实例列表
调试
您可以在API Explorer中调试该接口。
URI
- URI格式
GET /v3/{project_id}/instances/{instance_id}/replication/subscribers?offset={offset}&limit={limit}&subscriber_instance_id={subscriber_instance_id}&subscriber_instance_name={subscriber_instance_name}
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一region下的project ID。
获取方法请参见获取项目ID。
约束限制：
非空。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID。
约束限制：
非空。
取值范围：
不涉及。
默认取值：
不涉及。
offset
否
参数解释：
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。
约束限制：
不涉及。
取值范围：
必须为数字，不能为负数。
默认取值：
默认为0（偏移0条数据，表示从第一条数据开始查询）。
limit
否
参数解释：
查询记录数。
约束限制：
不涉及。
取值范围：
1~100
默认取值：
默认为10。
subscriber_instance_id
否
参数解释：
订阅服务器实例ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
subscriber_instance_name
否
参数解释：
订阅服务器实例名称。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
instances
Array of objects
参数解释：
实例列表。
详情请参见表3。
total_count
Integer
参数解释：
实例总数。
取值范围：
不涉及。
- 正常响应样例
{ "instances": [ { "instance_id": "07c3f2976ce04a5cb60ffbcea3d293eain04", "instance_name": "rds-2ca1", "data_vip": "192.168.75.149" }, { "instance_id": "75d98769cd5c4e8f8c20b4dd5b276bd2in04", "instance_name": "rds-4433-3", "data_vip": "192.168.106.206" } ], "total_count": 2 } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题： 发布订阅（SQL Server）
