華為云計(jì)算 云知識(shí) 回滾快照到云硬盤RollbackSnapshot
回滾快照到云硬盤RollbackSnapshot

 

功能介紹

將快照數(shù)據(jù)回滾到 云硬盤 。支持企業(yè)項(xiàng)目授權(quán)功能。

接口約束

  • 只支持快照回滾到源云硬盤,不支持快照回滾到其它指定云硬盤。

  • 只有云硬盤狀態(tài)處于“available”或“error_rollbacking”狀態(tài)才允許快照回滾到源云硬盤。

  • 名稱以autobk_snapshot_為前綴的快照是創(chuàng)建 云硬盤備份 時(shí)系統(tǒng)自動(dòng)創(chuàng)建的,請(qǐng)不要進(jìn)行“回滾快照到云硬盤”操作。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

POST /v2/{project_id}/cloudsnapshots/{snapshot_id}/rollback

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

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

snapshot_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的值)。

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

參數(shù)

是否必選

參數(shù)類型

描述

rollback

RollbackSnapshotOption object

快照回滾信息。

表4 RollbackSnapshotOption

參數(shù)

是否必選

參數(shù)類型

描述

name

String

回滾的目標(biāo)云硬盤名稱。

volume_id

String

回滾的目標(biāo)云硬盤UUID。

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

狀態(tài)碼: 202

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

參數(shù)

參數(shù)類型

描述

rollback

RollbackInfo object

快照回滾信息。

表6 RollbackInfo

參數(shù)

參數(shù)類型

描述

volume_id

String

回滾的目標(biāo)云硬盤UUID。

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤信息,具體請(qǐng)參見 error參數(shù)說明。

表8 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)求示例

回滾快照到云硬盤,目標(biāo)云硬盤的名稱為test-001,UUID為5aa119a8-d25b-45a7-8d1b-88e127885635。

POST https://{endpoint}/v2/{project_id}/cloudsnapshots/{snapshot_id}/rollback

{
  "rollback" : {
    "name" : "test-001",
    "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
  }
}

響應(yīng)示例

狀態(tài)碼: 202

Accepted

{
  "rollback" : {
    "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
  }
}

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

202

Accepted

400

Bad Request

錯(cuò)誤碼

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