功能介紹
指定 云硬盤 來創(chuàng)建云硬盤過戶記錄，創(chuàng)建成功后，會返回過戶記錄ID以及身份認(rèn)證密鑰。 云硬盤在過戶過程中的狀態(tài)變化如下：創(chuàng)建云硬盤過戶后，云硬盤狀態(tài)由“available”變?yōu)椤癮waiting-transfer”。當(dāng)云硬盤過戶被接收后，云硬盤狀態(tài)變?yōu)椤癮vailable”。
接口約束
只有當(dāng)云硬盤狀態(tài)為available時，支持創(chuàng)建過戶，其他不支持過戶的約束如下：
包周期的云硬盤不支持過戶。 凍結(jié)的云硬盤不支持過戶。 加密的云硬盤不支持過戶。 云硬盤有對應(yīng)的備份和快照時不支持過戶。 云硬盤有備份策略時不支持過戶。 DSS專屬存儲的云硬盤不支持過戶。 DESS專屬存儲的云硬盤不支持過戶。
URI
POST /v2/{project_id}/os-volume-transfer
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID。 獲取方法請參見"獲取項(xiàng)目ID"。 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值）。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
transfer |
是 |
標(biāo)記創(chuàng)建云硬盤過戶操作 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
云硬盤過戶記錄的名稱。最大支持255個字節(jié)。 |
|
volume_id |
是 |
String |
云硬盤ID。通過查詢所有云硬盤詳情獲取。 |
響應(yīng)參數(shù)
狀態(tài)碼： 202
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
auth_key |
String |
云硬盤過戶的身份認(rèn)證密鑰。 |
|
created_at |
String |
云硬盤過戶記錄的創(chuàng)建時間。 時間格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
|
id |
String |
云硬盤過戶記錄的ID。 |
|
links |
云硬盤過戶記錄的鏈接。 |
|
|
name |
String |
云硬盤過戶記錄的名稱。 |
|
volume_id |
String |
云硬盤ID。 |
狀態(tài)碼： 400
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
code |
String |
出現(xiàn)錯誤時，返回的錯誤碼。錯誤碼和其對應(yīng)的含義請參考錯誤碼說明。 |
|
message |
String |
出現(xiàn)錯誤時，返回的錯誤消息。 |
請求示例
創(chuàng)建一個云硬盤過戶，云硬盤id為c86b9af4-151d-4ead-b62c-5fb967af0e37，云硬盤過戶記錄的名稱為first volume。
POST https://{endpoint}/v2/{project_id}/os-volume-transfer
{
"transfer" : {
"volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37",
"name" : "first volume"
}
}
響應(yīng)示例
狀態(tài)碼： 202
Accepted
{
"transfer" : {
"id" : "1a7059f5-8ed7-45b7-8d05-2811e5d09f24",
"created_at" : "2015-02-25T03:56:53.081642",
"name" : "first volume",
"volume_id" : "c86b9af4-151d-4ead-b62c-5fb967af0e37",
"auth_key" : "9266c59563c84664",
"links" : [ {
"href" : "https://localhost/v2/firstproject/os-volume-transfer/3",
"rel" : "self"
}, {
"href" : "https://localhost/firstproject/os-volume-transfer/3",
"rel" : "bookmark"
} ]
}
}
狀態(tài)碼： 400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
202 |
Accepted |
|
400 |
Bad Request |
錯誤碼
請參見錯誤碼。
