查询云硬盘过户记录列表概要

功能介绍

查询当前租户下所有云硬盘的过户记录列表。

URI

• URI格式

  GET /v3/{project_id}/os-volume-transfer

• 参数说明

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

• Request filter参数说明

  参数	参数类型	是否必选	描述
  limit	Integer	否	返回结果个数限制。 最小值1，最大值1000，默认为1000。返回的结果中记录数不超过limit值。
  offset	Integer	否	偏移量，偏移量为一个大于0小于云硬盘过户记录总个数的整数，表示查询该偏移量后面的所有的云硬盘过户记录。

请求消息

以查询云硬盘过户记录的返回结果最大50个为例。

• 请求样例

  GET https://{endpoint}/v3/{project_id}/os-volume-transfer?limit=50

响应消息

• 响应参数

  参数	参数类型	描述
  transfers	List<Transfer>	云硬盘过户记录列表概要，请参见•transfers参数说明。

• transfers参数说明

  参数	参数类型	描述
  links	Array of Objects	云硬盘过户记录的链接。请参见•Link
  volume_id	String	云硬盘ID。
  id	String	云硬盘过户记录的ID。
  name	String	云硬盘过户记录的名称。

• Link参数说明

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

• 响应样例

  {
      "transfers": [
          {
              "id": "cac5c677-73a9-4288-bb9c-b2ebfb547377", 
              "name": "first volume transfer", 
              "volume_id": "894623a6-e901-4312-aa06-4275e6321cce", 
              "links": [
                  {
                      "href": "https://localhost/v2/firstproject/os-volume-transfer/1", 
                      "rel": "self"
                  }, 
                  {
                      "href": "https://localhost/firstproject/os-volume-transfer/1", 
                      "rel": "bookmark"
                  }
              ]
          }, 
          {
              "id": "f26c0dee-d20d-4e80-8dee-a8d91b9742a1", 
              "name": "second volume transfer", 
              "volume_id": "673db275-379f-41af-8371-e1652132b4c1", 
              "links": [
                  {
                      "href": "https://localhost/v2/firstproject/os-volume-transfer/2", 
                      "rel": "self"
                  }, 
                  {
                      "href": "https://localhost/firstproject/os-volume-transfer/2", 
                      "rel": "bookmark"
                  }
              ]
          }
      ]
  }

状态码

• 正常

  200

错误码

请参考错误码。