華為云計算 云知識 接受云硬盤過戶CinderAcceptVolumeTransfer
接受云硬盤過戶CinderAcceptVolumeTransfer

 

功能介紹

通過 云硬盤 過戶記錄ID以及身份認證密鑰來接受云硬盤過戶。

接口約束

  • 包周期的云硬盤不支持過戶。

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

  • 加密的云硬盤不支持過戶。

  • 云硬盤有對應的備份和快照時不支持過戶。

  • 云硬盤有備份策略時不支持過戶。

  • DSS專屬存儲的云硬盤不支持過戶。

  • DESS專屬存儲的云硬盤不支持過戶。

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

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

transfer_id

String

云硬盤過戶記錄的ID。

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值)。

表3 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

accept

CinderAcceptVolumeTransferOption object

標記接受云硬盤過戶操作

表4 CinderAcceptVolumeTransferOption

參數(shù)

是否必選

參數(shù)類型

描述

auth_key

String

云硬盤過戶的身份認證密鑰。

創(chuàng)建云硬盤過戶時會返回該身份認證密鑰。

響應參數(shù)

狀態(tài)碼: 202

表5 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

transfer

VolumeTransferSummary object

云硬盤過戶信息。

表6 VolumeTransferSummary

參數(shù)

參數(shù)類型

描述

id

String

云硬盤過戶記錄的ID。

links

Array of Link objects

云硬盤過戶記錄的鏈接

name

String

云硬盤過戶記錄的名稱

volume_id

String

云硬盤ID。

狀態(tài)碼: 400

表8 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

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

表9 Error

參數(shù)

參數(shù)類型

描述

code

String

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

message

String

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

請求示例

接受云硬盤過戶:使用云硬盤過戶的身份認證密鑰接受云硬盤過戶。

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

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

響應示例

狀態(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

錯誤碼

請參見錯誤碼