華為云計(jì)算 云知識(shí) 接受云硬盤過(guò)戶CinderAcceptVolumeTransfer
接受云硬盤過(guò)戶CinderAcceptVolumeTransfer

 

功能介紹

通過(guò) 云硬盤 過(guò)戶記錄ID以及身份認(rèn)證密鑰來(lái)接受云硬盤過(guò)戶。

接口約束

  • 包周期的云硬盤不支持過(guò)戶。

  • 凍結(jié)的云硬盤不支持過(guò)戶。

  • 加密的云硬盤不支持過(guò)戶。

  • 云硬盤有對(duì)應(yīng)的備份和快照時(shí)不支持過(guò)戶。

  • 云硬盤有備份策略時(shí)不支持過(guò)戶。

  • DSS專屬存儲(chǔ)的云硬盤不支持過(guò)戶。

  • DESS專屬存儲(chǔ)的云硬盤不支持過(guò)戶。

URI

POST /v2/{project_id}/os-volume-transfer/{transfer_id}/accept

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

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

transfer_id

String

云硬盤過(guò)戶記錄的ID。

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

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

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

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

表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

accept

CinderAcceptVolumeTransferOption object

標(biāo)記接受云硬盤過(guò)戶操作

表4 CinderAcceptVolumeTransferOption

參數(shù)

是否必選

參數(shù)類型

描述

auth_key

String

云硬盤過(guò)戶的身份認(rèn)證密鑰。

創(chuàng)建云硬盤過(guò)戶時(shí)會(huì)返回該身份認(rèn)證密鑰。

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

狀態(tài)碼: 202

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

參數(shù)

參數(shù)類型

描述

transfer

VolumeTransferSummary object

云硬盤過(guò)戶信息。

表6 VolumeTransferSummary

參數(shù)

參數(shù)類型

描述

id

String

云硬盤過(guò)戶記錄的ID。

links

Array of Link objects

云硬盤過(guò)戶記錄的鏈接

name

String

云硬盤過(guò)戶記錄的名稱

volume_id

String

云硬盤ID。

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

表9 Error

參數(shù)

參數(shù)類型

描述

code

String

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

message

String

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

請(qǐng)求示例

接受云硬盤過(guò)戶:使用云硬盤過(guò)戶的身份認(rèn)證密鑰接受云硬盤過(guò)戶。

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

{
  "accept" : {
    "auth_key" : "9266c59563c84664"
  }
}

響應(yīng)示例

狀態(tài)碼: 202

Accepted

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

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

202

Accepted

400

Bad Request

錯(cuò)誤碼

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