更新时间：2026-10-20 GMT+08:00

查询专区资源列表 - ListZoneResources

功能介绍

功能介绍：查询指定数据安全专区下的资源列表，支持按资源类型和VPC筛选，返回分页结果。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v1/{project_id}/data-security-zones/{zone_id}/resources

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID 约束限制：满足正则匹配"^[a-z0-9]{32}$" 取值范围： 32个字符，由数字和字母组成默认取值：不涉及
zone_id	是	String	参数解释：专区ID 约束限制：长度1~64字符取值范围：不涉及默认取值：不涉及

表2 Query参数
参数	是否必选	参数类型	描述
resource_type	否	String	参数解释：资源类型筛选约束限制：长度1~64字符取值范围：不涉及默认取值：不涉及
vpc_id	否	String	参数解释： VPC ID筛选约束限制：长度1~64字符取值范围：不涉及默认取值：不涉及
limit	否	Integer	参数解释：每页数量限制约束限制：最小值1，最大值1000 取值范围：不涉及默认取值：不涉及
marker	否	String	参数解释：分页游标约束限制：无下一页时为null 取值范围：不涉及默认取值：不涉及

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token 约束限制：不涉及取值范围：不涉及默认取值：不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
total	Integer	参数解释：资源总数取值范围：不涉及
limit	Integer	参数解释：本次返回条数取值范围：不涉及
next_marker	String	参数解释：下一页游标取值范围：不涉及
resources	Array of ZoneResourceItem objects	参数解释：资源列表取值范围：不涉及

表5 ZoneResourceItem
参数	参数类型	描述
resource_id	String	参数解释：资源ID 取值范围：不涉及
resource_name	String	参数解释：资源名称取值范围：不涉及
resource_type	String	参数解释：资源类型取值范围：不涉及
vpc_id	String	参数解释：所属VPC ID 取值范围：不涉及
joined_at	Long	参数解释：加入时间取值范围：不涉及

请求示例

查询资源列表

/v1/da211edc7bac01a07182af742e04dc6d/data-security-zones/zone-001/resources?limit=10

响应示例

状态码：200

{
  "total" : 1,
  "limit" : 10,
  "next_marker" : null,
  "resources" : [ {
    "resource_id" : "res-001",
    "resource_name" : "test-bucket",
    "resource_type" : "OBS",
    "vpc_id" : "vpc-001",
    "joined_at" : 1787306400000
  } ]
}

状态码

状态码	描述
200	查询成功

错误码

请参见错误码。

父主题： 安全屋网络资源管理