更新时间：2026-09-16 GMT+08:00
查询MSDTC的hosts信息 - ListMsdtcHosts
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| rds:instance:getMsdtcHosts | read | instance | - g:EnterpriseProjectId - g:ResourceTag/<tag-key> | - | - |
URI
- 参数说明
表1 参数说明 参数
是否必选
参数类型
说明
project_id
是
String
参数解释：
租户在某一region下的project ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
String
参数解释：
实例ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
offset
否
Integer
参数解释：
索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。
约束限制：
不涉及。
取值范围：
大于等于0的整数。
默认取值：
默认为0，偏移0条数据，表示从第一条数据开始查询。
limit
否
Integer
参数解释：
查询记录数。
约束限制：
不涉及。
取值范围：
[1, 100]
默认取值：
10
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
total_count
Integer
参数解释：
host总数。
取值范围：
不涉及。
hosts
Array of objects
参数解释：
host列表。
详情请参见表3。
- 正常响应样例
{ "total_count" : 1, "hosts" : [ { "id" : "527dd9ca-cc2c-4bac-8707-f9b4f55343f4", "host" : "192.168.0.90", "host_name" : "MSSQL-00E5FB7A" } ] } - 异常响应
请参见异常响应结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
父主题： 管理数据库和用户（SQL Server）
