功能介紹
查詢單個 云硬盤 快照信息。支持企業(yè)項目授權功能。
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
GET /v2/{project_id}/cloudsnapshots/{snapshot_id}
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目ID。 獲取方法請參見"獲取項目ID"。 |
|
snapshot_id |
是 |
String |
快照ID。 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。 通過調(diào)用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值）。 |
響應參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
id |
String |
云硬盤快照ID。 |
|
status |
String |
云硬盤快照狀態(tài)。 |
|
name |
String |
云硬盤快照名稱。 |
|
description |
String |
云硬盤快照描述信息。 |
|
created_at |
String |
云硬盤快照創(chuàng)建時間。 時間格式：UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
|
updated_at |
String |
快照更新時間。 時間格式：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 |
預留屬性。 |
|
os-extended-snapshot-attributes:progress |
String |
預留屬性。 |
狀態(tài)碼： 400
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
error |
出現(xiàn)錯誤時，返回的錯誤信息，具體請參見 error參數(shù)說明。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
code |
String |
出現(xiàn)錯誤時，返回的錯誤碼。錯誤碼和其對應的含義請參考錯誤碼說明。 |
|
message |
String |
出現(xiàn)錯誤時，返回的錯誤消息。 |
請求示例
GET https://{endpoint}/v2/{project_id}/cloudsnapshots/{snapshot_id}
響應示例
狀態(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 |
錯誤碼
請參見錯誤碼。
