调用DeleteIpsecServer接口删除IPsec服务端。

使用说明

  • DeleteIpsecServer接口属于异步接口，即系统先返回一个请求ID，但该IPsec服务端尚未删除成功，系统后台的删除任务仍在进行。您可以调用DescribeVpnGateway查询VPN网关实例状态，来确定IPsec服务端的删除状态：
    • 当VPN网关实例处于updating状态时，表示IPsec服务端正在删除中。
    • 当VPN网关实例处于active状态时，表示IPsec服务端删除成功。
  • DeleteIpsecServer接口不支持在同一VPN网关下并发删除IPsec服务端。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DeleteIpsecServer

系统规定参数。取值：DeleteIpsecServer。

RegionId String 是 cn-hangzhou

IPsec服务端所属地域ID。
IpsecServerId String 是 iss-bp1jougp8cfsbo8y9****

IPsec服务端ID。
ClientToken String 否 02fb3da4-130e-11e9-8e44-00****

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
DryRun String 否 false

是否只预检此次请求，取值：

  • true：只预检此次请求，不会删除IPsec服务端。检查项包括是否填写了必需参数、请求格式、业务限制等。如果检查不通过，则返回对应错误信息。如果检查通过，则返回DryRunOperation。
  • false（默认值）：发送正常请求，通过检查后直接删除IPsec服务端。

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DeleteIpsecServer
&IpsecServerId=iss-bp1jougp8cfsbo8y9****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteIpsecServerResponse>
<RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteIpsecServerResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

错误码

HttpCode 错误码 错误信息 描述
400 VpnGateway.Configuring The specified service is configuring. 服务正在配置中，请您稍后再试。
403 Forbidden User not authorized to operate on the specified resource. 您没有权限操作指定资源，请申请权限后再操作。

访问错误中心查看更多错误码。