文档首页/ 软件开发生产线 CodeArts/ API参考/ API/ Vpcep管理/ 删除vpcep访问控制信息 - DeleteVpcepAccessControlRecords
更新时间:2025-11-21 GMT+08:00
分享

删除vpcep访问控制信息 - DeleteVpcepAccessControlRecords

功能介绍

此API用于删除已创建的内网安全访问控制策略。请在调用本接口前,确保存在对应的安全访问控制策略。

调用方法

请参见如何调用API

授权信息

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

URI

DELETE /v2/vpceps

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。(响应消息头中X-Subject-Token的值)。通过调用IAM服务接口获取,参考获取IAM用户Token

约束限制

不支持租户全局token,请使用scope为project的region级token。

取值范围

不涉及。

默认取值

不涉及。

region

String

参数解释

删除的vpcep所在region。可通过终端节点的列表中的“区域”获取对应region。

约束限制

不涉及。

取值范围

仅支持数字、字母和-组成(1-40个字符)。

默认取值

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

enterprise_id

String

参数解释

租户ID。获取方式请参考获取账号ID

约束限制

不涉及。

取值范围

仅支持数字、字母字符和-_组成(1-40个字符)。

默认取值

不涉及。

vpceps

Array of VpcepRequestInfo objects

参数解释

授权的vpcep信息列表。

约束限制

不涉及。

表3 VpcepRequestInfo

参数

是否必选

参数类型

描述

description

String

参数解释

vpcep的描述。

约束限制

不涉及。

取值范围

仅支持中英文,数字空格和()[]-_~.&;(0-128个字符)。

默认取值

不涉及。

vpcep_id

String

参数解释

vpcep的ID。可通过“租户设置” - “通用设置 > 全内网安全访问”查看vpcep ID。

约束限制

不涉及。

取值范围

仅支持数字、小写字母字符和-组成(1-40个字符)。

默认取值

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

String

参数解释

成功状态。

取值范围

● ok:表示接口调用成功。

total

Integer

参数解释

计数总数。

取值范围

不涉及。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

状态码:404

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码。

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

请求示例

DELETE https://{endpoint}/v2/vpceps

{
  "enterprise_id" : "abcdbfa39r7pg09la8msyu8vq004aabcd",
  "vpceps" : [ {
    "vpcep_id" : "1234bfa39r7pg09la8msyu8vq004a1234"
  } ]
}

响应示例

状态码:200

删除成功

{
  "status" : "ok",
  "total" : 1
}

状态码

状态码

描述

200

删除成功

401

Unauthorized

404

NotFound

错误码

请参见错误码

相关文档