更新时间:2022-01-22 GMT+08:00
分享

扩容云硬盘

功能介绍

对按需或者包周期云硬盘进行扩容。 在扩容包周期云硬盘的场景下:

接口约束

  • 扩容状态为available的云硬盘时,没有约束限制。

  • 扩容状态为in-use的云硬盘时,有以下约束:

    • 不支持共享云硬盘,即multiattach参数值必须为false。

    • 云硬盘所挂载的云服务器状态必须为ACTIVE、PAUSED、SUSPENDED、SHUTOFF才支持扩容。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2.1/{project_id}/cloudvolumes/{volume_id}/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。 获取方法请参见"获取项目ID"。

volume_id

String

云硬盘ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

bssParam

BssParamForResizeVolume object

按需和包周期的扩展参数。

os-extend

OsExtend object

标记扩容云硬盘操作。

表4 BssParamForResizeVolume

参数

是否必选

参数类型

描述

isAutoPay

String

功能说明:是否立即支付。该参数只有在云硬盘为包周期的情况下有意义。默认值为false 取值范围:

  • true:立即支付,从帐户余额中自动扣费

  • false:不立即支付,创建订单暂不支付

缺省值:false

枚举值:

  • false

  • true

表5 OsExtend

参数

是否必选

参数类型

描述

new_size

Integer

扩容后的云硬盘大小,单位为GB。扩容的大小必须大于原有云硬盘容量且小于云硬盘最大容量。 云硬盘最大容量:

  • 数据盘:32768GB

  • 系统盘:1024GB

响应参数

状态码: 202

表6 响应Body参数

参数

参数类型

描述

job_id

String

任务ID,云硬盘为按需计费时返回该参数。

说明:

如果需要查询job的状态,请参考:"查询job的状态"。

order_id

String

订单ID,云硬盘为包周期计费时返回该参数。

说明:

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息

表8 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。 错误码和其对应的含义请参考错误码说明

message

String

错误提示信息。

请求示例

POST https://{endpoint}/v2.1/{project_id}/cloudvolumes/{volume_id}/action

{
  "os-extend" : {
    "new_size" : 100
  },
  "bssParam" : {
    "isAutoPay" : "true"
  }
}

响应示例

状态码: 202

Accepted

  • 示例 1

    {
      "job_id" : "70a599e0-31e7-49b7-b260-868f441e862b"
    }
  • 示例 2

    {
      "order_id" : "CS1711152257C60TL"
    }

状态码: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

状态码

状态码

描述

202

Accepted

400

Bad Request

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读