基本信息

弹性带宽值不得大于基础带宽。

Action

DescribeVolumes

Path

/iaas

Method

GET

请求参数

此接口除公共参数外，还包含以下参数。关于公共参数的更多信息，请参见前文内容。

参数名 类型 描述 是否必须

volumes.n

String

硬盘ID

否

volume_type

Integer

硬盘类型:

  • 性能型是 0

  • 超高性能型是 3 (只能与超高性能云服务器挂载，目前只支持北京2区)，

  • 容量型因技术升级过程中，在各区的 type 值略有不同:

    • 北京1区，亚太1区：容量型是 1

    • 北京2区，广东1区：容量型是 2

否

status.n

String

硬盘状态: pending, available, in-use, suspended, deleted, ceased

否

search_word

String

搜索关键词，支持硬盘ID，硬盘名称

否

tags.n

String

按照标签ID过滤, 只返回已绑定某标签的资源

否

verbose

Integer

是否返回冗长的信息，目前 verbose 只支持为 0 。

否

返回数据

此接口除了返回公共响应参数外，还返回以下参数。关于公共响应参数的更多信息，请参见前文内容。

参数名 类型 描述

volume_set

Array

JSON 格式的硬盘数据列表，每项参数可见下面 Response Item

total_count

Integer

根据过滤条件得到的硬盘总数

volume_set 参数说明如下。

参数名 类型 描述

volume_id

String

硬盘ID

volume_name

String

硬盘名称

description

String

硬盘描述

size

Integer

硬盘空间大小，单位为 GB

status

String

硬盘状态，有效值为pending, available, in-use, suspended, deleted, ceased。

  • pending： 等待被创建

  • available： 可用状态，此时硬盘可以加载到云服务器上。

  • in-use： 使用中，此时硬盘已经加载到云服务器上。

  • suspended： 由于欠费，已被暂停使用

  • deleted： 已被删除，但处于此状态的硬盘在2小时之内仍可以被恢复为 available 状态

  • ceased： 已被彻底删除，处于此状态的硬盘无法恢复

transition_status

String

硬盘过渡状态，有效值为creating, attaching, detaching, suspending，resuming，deleting，recovering。

  • creating： 创建中，由 pending 状态变成 available 状态

  • attaching： 加载到云服务器中，由 available 状态变成 in-use 状态

  • detaching： 从云服务器卸载中，由 in-use 状态变成 available 状态

  • suspending： 欠费暂停中，由 available/in-use 状态变成 suspended 状态

  • resuming： 恢复中，由 suspended 状态变成 available 状态

  • deleting： 删除中，由 available/in-use/suspended 状态变成 deleted 状态

  • recovering： 恢复中，由 deleted 状态变成 available 状态

create_time

TimeStamp

硬盘创建时间，为 UTC 时间，格式可参见 ISO8601.

status_time

TimeStamp

硬盘最近一次状态变更时间，为 UTC 时间，格式可参见 ISO8601.

instance

Dict

硬盘加载的云服务器信息.

  • instance_id： 云服务器 ID

  • instance_name： 云服务器名称

  • device：硬盘在云服务器系统中的设备名

owner

String

硬盘的所属用户

volume_type

Integer

硬盘类型:

  • 性能型是 0

  • 超高性能型是 3 (只能与超高性能云服务器挂载，目前只支持北京2区)，

  • 容量型因技术升级过程中，在各区的 type 值略有不同:

    • 北京1区，亚太1区：容量型是 1

    • 北京2区，广东1区：容量型是 2

请求示例

https://api.<your_domain>/iaas/?action=DescribeVolumes
&status=in-use
&COMMON_PARAMS

返回示例

{
  "action":"DescribeVolumesResponse",
  "total_count":1,
  "volume_set":[
    {
      "status":"in-use",
      "description":null,
      "volume_name":"vol 2",
      "sub_code":0,
      "transition_status":"",
      "instance":{
        "instance_id":"i-ogbndull",
        "instance_name":"",
        "device": "/dev/sdb"
      },
      "create_time":"2013-08-30T05:13:25Z",
      "volume_id":"vol-g7xy7d6g",
      "status_time":"2013-08-30T05:13:32Z",
      "size":10
    }
  ],
  "ret_code":0
}