華為云計算 云知識 查詢云硬盤過戶記錄列表概要CinderListVolumeTransfers
查詢云硬盤過戶記錄列表概要CinderListVolumeTransfers

 

功能介紹

查詢當前租戶下所有 云硬盤 的過戶記錄列表

URI

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

表1 路徑參數

參數

是否必選

參數類型

描述

project_id

String

項目ID。 獲取方法請參見"獲取項目ID"。

表2 Query參數

參數

是否必選

參數類型

描述

limit

Integer

返回結果個數限制,取值為大 于0的整數

offset

Integer

偏移量,偏移量為一個大于0小 于云硬盤過戶記錄總個數的整 數,表示查詢該偏移量后面的 所有的云硬盤過戶記錄

請求參數

表3 請求Header參數

參數

是否必選

參數類型

描述

X-Auth-Token

String

用戶Token。 通過調用 IAM 服務獲取用戶Token接口獲取(響應消息頭中X-Subject-Token的值)。

響應參數

狀態(tài)碼: 200

表4 響應Body參數

參數

參數類型

描述

transfers

Array of VolumeTransferSummary objects

云硬盤過戶記錄列表概要。

表5 VolumeTransferSummary

參數

參數類型

描述

id

String

云硬盤過戶記錄的ID。

links

Array of Link objects

云硬盤過戶記錄的鏈接

name

String

云硬盤過戶記錄的名稱

volume_id

String

云硬盤ID。

狀態(tài)碼: 400

表7 響應Body參數

參數

參數類型

描述

error

Error object

出現錯誤時,返回的錯誤信息。

表8 Error

參數

參數類型

描述

code

String

出現錯誤時,返回的錯誤碼。錯誤碼和其對應的含義請參考錯誤碼說明

message

String

出現錯誤時,返回的錯誤消息。

請求示例

GET https://{endpoint}/v2/{project_id}/os-volume-transfer

響應示例

狀態(tài)碼: 200

OK

{
  "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"
    } ]
  } ]
}

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

錯誤碼

請參見錯誤碼。