華為云計(jì)算 云知識(shí) 查詢單個(gè)云硬盤快照詳情ShowSnapshot
查詢單個(gè)云硬盤快照詳情ShowSnapshot

 

功能介紹

查詢單個(gè) 云硬盤 快照信息。支持企業(yè)項(xiàng)目授權(quán)功能。

調(diào)試

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

URI

GET /v2/{project_id}/cloudsnapshots/{snapshot_id}

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

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

snapshot

SnapshotDetails object

快照信息

表4 SnapshotDetails

參數(shù)

參數(shù)類型

描述

id

String

云硬盤快照ID。

status

String

云硬盤快照狀態(tài)。

name

String

云硬盤快照名稱。

description

String

云硬盤快照描述信息。

created_at

String

云硬盤快照創(chuàng)建時(shí)間。 時(shí)間格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX

updated_at

String

快照更新時(shí)間。 時(shí)間格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX

metadata

Object

云硬盤快照的元數(shù)據(jù)信息。

volume_id

String

快照所屬的云硬盤ID。

size

Integer

云硬盤快照大小,單位為GiB。

os-extended-snapshot-attributes:project_id

String

預(yù)留屬性。

os-extended-snapshot-attributes:progress

String

預(yù)留屬性。

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

Error object

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

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

GET https://{endpoint}/v2/{project_id}/cloudsnapshots/{snapshot_id}

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "snapshot" : {
    "status" : "available",
    "os-extended-snapshot-attributes:progress" : "100%",
    "description" : "daily backup",
    "created_at" : "2013-02-25t04:13:17.000000",
    "metadata" : { },
    "volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635",
    "os-extended-snapshot-attributes:project_id" : "0c2eba2c5af04d3f9e9d0d410b371fde",
    "size" : 1,
    "id" : "2bb856e1-b3d8-4432-a858-09e4ce939389",
    "name" : "snap-001"
  }
}

狀態(tài)碼: 400

Bad Request

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

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

錯(cuò)誤碼

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