获取租户授权的VPCEP列表 - ListVpcepAccessControlRecords

功能介绍

此API用于获取租户授权的VPCEP访问控制列表。请在调用本接口前，确保存在对应的安全访问控制策略。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v2/vpceps

表1 Query参数
参数	是否必选	参数类型	描述
enterprise_id	是	String	参数解释：租户ID。获取方式请参考获取账号ID。约束限制：不涉及。取值范围：仅支持数字、字母和-_组成（1-40个字符）。默认取值：不涉及。
vpcep_ids	否	String	参数解释：查询的VPCEP ID列表。可通过“租户设置 > 通用设置 > 全内网安全访问”查看VPCEP ID。约束限制：不涉及。取值范围：仅支持数字、小写字母字符和-,组成（1-1229个字符）。默认取值：不涉及。
offset	否	Integer	参数解释：偏移量。约束限制：不涉及。取值范围：仅支持0-9999。默认取值：不涉及。
limit	否	Integer	参数解释：页大小。约束限制：不涉及。取值范围：仅支持1-100。默认取值：不涉及。
sort	否	String	参数解释：基于vpcep_id排序方式。约束限制：不涉及。取值范围： ● asc\|ASC：升序。 ● desc\|DESC：降序。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。（响应消息头中X-Subject-Token的值）。通过调用IAM服务接口获取，参考获取IAM用户Token。约束限制：不支持租户全局token，请使用scope为project的region级token。取值范围：不涉及。默认取值：不涉及。
region	是	String	参数解释：查询的VPCEP所在region。可通过终端节点的列表中的“区域”获取对应region。约束限制：不涉及。取值范围：仅支持数字、字母和-组成（1-40个字符）。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
status	String	参数解释：成功状态。取值范围： ● ok：表示接口调用成功。
data	TenantVpcepInfos object	参数解释：租户及其授权的VPCEP。取值范围：不涉及。
limit	Integer	参数解释：页大小。取值范围： 0-100。
offset	Integer	参数解释：偏移量。取值范围： 0-9999。
total	Integer	参数解释：总数据量。取值范围：不涉及。

表4 TenantVpcepInfos
参数	参数类型	描述
enterprise_id	String	参数解释：租户ID。取值范围：仅支持数字、字母和-_组成（1-40个字符）。
vpceps	Array of VpcepInfo objects	参数解释：授权的VPCEP信息。取值范围：不涉及。

表5 VpcepInfo
参数	参数类型	描述
create_time	String	参数解释：创建时间。取值范围：不涉及。
creator	String	参数解释：创建者。取值范围：不涉及。
description	String	参数解释： VPCEP的描述。取值范围：不涉及。
modify_time	String	参数解释：修改时间。取值范围：不涉及。
region	String	参数解释：局点。取值范围：仅支持数字、小写字母字符和-组成（1-40个字符）。
vpcep_id	String	参数解释： VPCEP的ID。取值范围：仅支持数字、小写字母字符和-组成（1-40个字符）。

状态码：400

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

状态码：401

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

状态码：404

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

请求示例

GET https://{endpoint}/v2/vpceps?enterprise_id=a8dd901e70f2485cb4f1fa2264eb3add&vpcep_ids=a8dd901e70f2485cb4f1fa2264eb3add,00120e895121420aa2c81870d09756b2&sort=asc

响应示例

状态码：200

租户授权的VPCEP列表。

{
  "data" : {
    "enterprise_id" : "a8dd901e70f2485cb4f1fa2264eb3add",
    "vpceps" : [ {
      "vpcep_id" : "a8dd901e70f2485cb4f1fa2264eb3add",
      "description" : "VPCEP1",
      "creator" : "user001",
      "create_time" : "2026-05-01T10:30:001Z",
      "modify_time" : "2026-05-01T10:30:001Z",
      "region" : "cn-north-7"
    }, {
      "vpcep_id" : "00120e895121420aa2c81870d09756b2",
      "description" : "VPCEP2",
      "creator" : "user002",
      "create_time" : "2026-05-02T14:20:001Z",
      "modify_time" : "2026-05-03T09:15:001Z",
      "region" : "cn-east-3"
    } ]
  },
  "offset" : 0,
  "limit" : 10,
  "total" : 2
}