# 获取租户授权的VPCEP列表 - ListVpcepAccessControlRecords #### 功能介绍 此API用于获取租户授权的VPCEP访问控制列表。请在调用本接口前，确保存在对应的安全访问控制策略。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-devcloud/codearts_03_0002.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-devcloud/codearts_03_0014.html)。 #### URI GET /v2/vpceps 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | enterprise_id | 是 | String | **参数解释**： 租户ID。获取方式请参考[获取账号ID](https://support.huaweicloud.com/api-devcloud/codearts_03_0012.html)。 **约束限制**： 不涉及。 **取值范围**： 仅支持数字、字母和-_组成（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](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 **约束限制**： 不支持租户全局token，请使用scope为project的region级token。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | region | 是 | String | **参数解释**： 查询的VPCEP所在region。可通过[终端节点](https://support.huaweicloud.com/api-devcloud/codearts_03_0000.html)的列表中的"区域"获取对应region。 **约束限制**： 不涉及。 **取值范围**： 仅支持数字、字母和-组成（1-40个字符）。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | status | String | **参数解释**： 成功状态。 **取值范围**： ● ok：表示接口调用成功。 | | data | [TenantVpcepInfos] object | **参数解释**： 租户及其授权的VPCEP。 **取值范围**： 不涉及。 | | limit | Integer | **参数解释**： 页大小。 **取值范围**： 0-100。 | | offset | Integer | **参数解释**： 偏移量。 **取值范围**： 0-9999。 | | total | Integer | **参数解释**： 总数据量。 **取值范围**： 不涉及。 | 表4TenantVpcepInfos | 参数 | 参数类型 | 描述 | |:---|:---|:---| | enterprise_id | String | **参数解释**： 租户ID。 **取值范围**： 仅支持数字、字母和-_组成（1-40个字符）。 | | vpceps | Array of [VpcepInfo] objects | **参数解释**： 授权的VPCEP信息。 **取值范围**： 不涉及。 | 表5VpcepInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 租户授权的VPCEP列表。 | | 400 | 参数非法。 | | 401 | 没有权限。 | | 404 | 没有找到。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-devcloud/ErrorCode.html)。