DeleteGateway

重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

调用DeleteGateway接口从所属集群上删除一个按量付费的网关。

接口说明

调用该接口时,您需要注意:

  • 仅支持删除按量付费的网关,即后付费网关。
  • 仅支持删除状态为已初始化(Initialized)、已激活(Activated)、运行中(Running)、长时间没有心跳(Unknown)、失败(Failed)、停止(Stopped)的网关。
警告 删除网关会导致您的业务和数据同步中断,请谨慎操作。

请求参数

名称

类型

是否必选

示例值

描述

Action String DeleteGateway

系统规定参数。取值:DeleteGateway

GatewayId String gw-0001xv7je3580031y***

网关ID。

ReasonType String REASON2

删除网关的原因。

ReasonDetail String ""

删除网关的详细原因。

返回数据

名称

类型

示例值

描述

TaskId String t-0000iwdggbhaordhk***

任务ID。

Message String successful

请求结果描述。

RequestId String 151BB31D-571D-4BB9-9A02-D4210E5BF5DB

请求ID。

Code String 200

状态码。状态码为200表示请求成功。

Success Boolean true

请求是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=DeleteGateway
&GatewayId=gw-0001xv7je3580031y***
&<公共请求参数>

正常返回示例

XML格式

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

<DeleteGatewayResponse>
    <TaskId>t-0000iwdggbhaordhk***</TaskId>
    <Message>successful</Message>
    <RequestId>151BB31D-571D-4BB9-9A02-D4210E5BF5DB</RequestId>
    <Code>200</Code>
    <Success>true</Success>
</DeleteGatewayResponse>

JSON格式

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

{
  "TaskId" : "t-0000iwdggbhaordhk***",
  "Message" : "successful",
  "RequestId" : "151BB31D-571D-4BB9-9A02-D4210E5BF5DB",
  "Code" : 200,
  "Success" : true
}

错误码

HttpCode

错误码

错误信息

描述

400 EmptyGatewayId You must enter a valid ID for the gateway. 网关ID不能为空。
400 GatewayNotExist The specified gateway does not exist. You must specify a valid parameter. 网关不存在,请确认输入参数是否正确。
400 GatewayOperationNotAllowed You cannot perform the operation when the gateway is in the current state. 网关当前状态不允许执行该操作。
400 GatewayInOperation The gateway is processing requests . Try again later. 网关正在进行操作中,请稍后再试。
400 BadRequest Invalid request. You must specify valid parameters in the request.  非法请求,请检查请求参数。

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