调用DeleteGatewayCacheDisk可以在网关下删除一个缓存盘。

使用该接口时,需要注意如下事项:

  • 仅对线上网关有效。
  • 仅支持删除按量付费的缓存盘。

调试

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

请求参数

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

系统规定参数。取值:DeleteGatewayCacheDisk。

CacheId String d-bp1dcnq8zldree6ok***

缓存盘ID。可以通过DescribeGatewayCaches接口获得。

GatewayId String gw-0001xv7je3580031y***

网关ID。

LocalFilePath String /dev/vdb

缓存盘内部设备名。 可以通过DescribeGatewayCaches接口获得。

返回数据

名称 类型 示例值 描述
Code String 200

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

Message String successful

请求结果描述。

RequestId String EEFC9927-B097-446D-8FDA-F848C8B2C9E3

请求ID。

Success Boolean true

请求是否成功。

TaskId String t-0001xv7je357xv4s***

任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DeleteGatewayCacheDisk
&CacheId=d-bp1dcnq8zldree6ok***
&GatewayId=gw-0001xv7je3580031y***
&LocalFilePath=/dev/vdb
&<公共请求参数>

正常返回示例

XML 格式

<DeleteGatewayCacheDiskResponse>
      <Message>successful</Message>
      <RequestId>EEFC9927-B097-446D-8FDA-F848C8B2C9E3</RequestId>
      <TaskId>t-0001xv7je357xv4s***</TaskId>
      <Code>200</Code>
      <Success>true</Success>
</DeleteGatewayCacheDiskResponse>

JSON 格式

{
    "Message":"successful",
    "RequestId":"EEFC9927-B097-446D-8FDA-F848C8B2C9E3",
    "TaskId":"t-0001xv7je357xv4s***",
    "Code":"200",
    "Success":true
}

错误码

HttpCode 错误码 错误信息 描述
400 LocationCloudRequired You must specify a cloud gateway. Try again later. 需要网关为线上网关,请检查后重试。
400 BadRequest Invalid request. You must specify valid parameters in the request.  非法请求,请检查请求参数。
400 GatewayOperationNotAllowed You cannot perform the operation when the gateway is in the current state. 网关当前状态不允许执行该操作。

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