文档首页/ 数据安全中心 DSC/ API参考/ API/ 安全屋生命周期管理/ 查询数据安全专区列表 - ListDataSecurityZones
更新时间:2026-10-20 GMT+08:00
分享

查询数据安全专区列表 - ListDataSecurityZones

功能介绍

功能介绍:查询指定项目下的数据安全专区列表,返回分页结果。

调用方法

请参见如何调用API。

授权信息

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

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释: 项目ID

约束限制: 满足正则匹配"^[a-z0-9]{32}$"

取值范围: 32个字符,由数字和字母组成

默认取值: 不涉及

表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释: 每页数量限制

约束限制: 最小值1,最大值1000

取值范围: 不涉及

默认取值: 不涉及

marker

否

String

参数解释: 分页游标

约束限制: 无下一页时为null

取值范围: 不涉及

默认取值: 不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释: 用户Token

约束限制: 不涉及

取值范围: 不涉及

默认取值: 不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释: 专区总数

取值范围: 不涉及

limit

Integer

参数解释: 本次返回条数

取值范围: 不涉及

next_marker

String

参数解释: 下一页游标

取值范围: 不涉及

zones

Array of ZoneItem objects

参数解释: 专区列表

取值范围: 不涉及

表5 ZoneItem

参数

参数类型

描述

zone_id

String

参数解释: 专区ID

取值范围: 不涉及

zone_name

String

参数解释: 专区名称

取值范围: 不涉及

description

String

参数解释: 专区描述

取值范围: 不涉及

status

String

参数解释: 专区状态

取值范围:

  • ACTIVE-可用

  • CREATING-创建中

  • FAILED-失败

user_count

Long

参数解释: 用户数量

取值范围: 不涉及

network_count

Long

参数解释: 网络数量

取值范围: 不涉及

resource_count

Long

参数解释: 资源数量

取值范围: 不涉及

created_at

Long

参数解释: 创建时间

取值范围: 不涉及

updated_at

Long

参数解释: 更新时间

取值范围: 不涉及

请求示例

查询专区列表

/v1/da211edc7bac01a07182af742e04dc6d/data-security-zones?limit=10

响应示例

状态码:200

{
  "total" : 1,
  "limit" : 10,
  "next_marker" : null,
  "zones" : [ {
    "zone_id" : "zone-001",
    "zone_name" : "security-zone-01",
    "description" : "测试安全专区",
    "status" : "ACTIVE",
    "user_count" : 1,
    "network_count" : 1,
    "resource_count" : 0,
    "created_at" : 1787306400000,
    "updated_at" : 1787306400000
  } ]
}

状态码

状态码

描述

200

查询成功

错误码

请参见错误码。

相关文档