查询云硬盘列表

功能介绍

查询云硬盘列表。

URI

• URI格式

  GET /v3/{project_id}/volumes

• 参数说明

  参数	是否必选	描述
  project_id	是	项目ID。 获取方法请参见获取项目ID。

• Request filter参数说明

  参数	参数类型	是否必选	描述
  marker	String	否	分页查询的起始资源id，取值为上一页最后一条查询记录的资源id。
  name	String	否	云硬盘名称。最大支持255个字节。
  limit	Integer	否	返回结果个数限制。 最小值1，最大值1000，默认为1000。返回的结果中记录数不超过limit值。 当租户所有的云硬盘数量大于50个时，为了提升您的查询效率，建议查询的时候使用limit参数，并且参数值最大设置为50。查询示例： GET /v3/xxx/volumes?limit=50，表示查询第1~50个云硬盘。GET /v3/xxx/volumes?offset=50&limit=50，表示查询第51~100个云硬盘。
  sort_key	String	否	返回结果按该关键字排序，支持id，status，size，created_at等关键字，默认为“created_at”。
  sort_dir	String	否	返回结果按照降序或升序排列，默认为“desc”。 降序：desc 升序：asc
  offset	Integer	否	偏移量 偏移量为一个大于0小于磁盘总个数的整数，表示查询该偏移量后面的所有的云硬盘。
  status	String	否	云硬盘状态，具体请参见云硬盘状态。
  metadata	String	否	云硬盘元数据。
  availability_zone	String	否	AZ信息。

请求消息

以查询状态为available的云硬盘为例。

• 请求样例

  GET https://{endpoint}/v3/{project_id}/volumes?status=available

响应消息

• 响应参数

  参数	参数类型	描述
  volumes	list	查询请求返回的云硬盘列表，请参见•volumes参数说明。
  volumes_links	list	云硬盘列表查询位置标记。如果本次查询只返回部分列表信息时，会返回查询到的当前磁盘mark标记的url，可以继续使用这个url查询剩余列表信息。
  error	Object	出现错误时，返回的错误信息，具体请参见•error参数说明。

• volumes参数说明

  参数	参数类型	描述
  id	String	云硬盘ID
  links	Array of objects	云硬盘URI自描述信息，请参见•links参数说明。
  name	String	云硬盘名称。最大支持255个字节。

• links参数说明

  参数	参数类型	描述
  href	String	对应的快捷链接。
  rel	String	快捷链接标记名称。

• error参数说明

  参数	参数类型	描述
  message	String	出现错误时，返回的错误消息。
  code	String	出现错误时，返回的错误码。 错误码和其对应的含义请参考错误码。

• 响应样例

  {
      "volumes": [
          {
              "id": "6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
              "links": [
                  {
                      "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                      "rel": "self"
                  }, 
                  {
                      "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/6b604cef-9bd8-4f5a-ae56-45839e6e1f0a", 
                      "rel": "bookmark"
                  }
              ], 
              "name": "zjb_u25_test"
          }, 
          {
              "id": "2bce4552-9a7d-48fa-8484-abbbf64b206e", 
              "links": [
                  {
                      "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                      "rel": "self"
                  }, 
                  {
                      "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/2bce4552-9a7d-48fa-8484-abbbf64b206e", 
                      "rel": "bookmark"
                  }
              ], 
              "name": "zjb_u25_test"
          }, 
          {
              "id": "3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
              "links": [
                  {
                      "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                      "rel": "self"
                  }, 
                  {
                      "href": "https://volume.localdomain.com:8776/dd14c6ac581f40059e27f5320b60bf2f/volumes/3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
                      "rel": "bookmark"
                  }
              ], 
              "name": "zjb_u25_test"
          }
      ], 
      "volumes_links": [
          {
              "href": "https://volume.localdomain.com:8776/v2/dd14c6ac581f40059e27f5320b60bf2f/volumes?limit=3&marker=3f1b98ec-a8b5-4e92-a727-88def62d5ad3", 
              "rel": "next"
          }
      ]
  }

  或

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

  其中error是泛指的错误，有badRequest、itemNotFound等，如报错：

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

状态码

• 正常

  200

错误码

请参考错误码。