華為云計(jì)算 云知識(shí) 查詢單個(gè)云硬盤過戶記錄詳情CinderShowVolumeTransfer
查詢單個(gè)云硬盤過戶記錄詳情CinderShowVolumeTransfer

 

功能介紹

查詢單個(gè) 云硬盤 的過戶記錄詳情,比如過戶記錄創(chuàng)建時(shí)間、ID以及名稱等信息。

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。 獲取方法請(qǐng)參見"獲取項(xiàng)目ID"。

transfer_id

String

云硬盤過戶記錄ID

請(qǐng)求參數(shù)

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲取(響應(yīng)消息頭中X-Subject-Token的值)。

響應(yīng)參數(shù)

狀態(tài)碼: 200

表3 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

transfer

VolumeTransfer object

云硬盤過戶記錄詳情。

表4 VolumeTransfer

參數(shù)

參數(shù)類型

描述

created_at

String

云硬盤過戶記錄的創(chuàng)建時(shí)間。

時(shí)間格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX

id

String

云硬盤過戶記錄的ID。

links

Array of Link objects

云硬盤過戶記錄的鏈接。

name

String

云硬盤過戶記錄的名稱。

volume_id

String

云硬盤ID。

狀態(tài)碼: 400

表6 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤信息。

表7 Error

參數(shù)

參數(shù)類型

描述

code

String

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤碼。錯(cuò)誤碼和其對(duì)應(yīng)的含義請(qǐng)參考錯(cuò)誤碼說明。

message

String

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤消息。

請(qǐng)求示例

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

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

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "transfer" : {
    "id" : "cac5c677-73a9-4288-bb9c-b2ebfb547377",
    "created_at" : "2015-02-25T03:56:53.081642",
    "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"
    } ]
  }
}

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

錯(cuò)誤碼

請(qǐng)參見錯(cuò)誤碼。