322
windows
查詢快照__快照相關接口_API 參考_雲服務器 ECS-阿裏雲
描述
查詢針對雲服務器的某個磁盤設備所有的快照列表。
InstanceId
,DiskId
和 SnapshotIds
不再作為必選參數,而是作為 Filter 進行使用,為邏輯與關係。
請求參數
名稱 | 類型 | 是否必須 | 描述 |
---|---|---|---|
Action | String | 是 | 係統規定參數,取值:DescribeSnapshots |
RegionId | String | 是 | 磁盤所屬於的 Region ID |
InstanceId | String | 否 | 指定的實例 ID |
DiskId | String | 否 | 指定的磁盤設備 ID |
SnapshotIds | String | 否 |
快照標識編碼 一個帶有格式的 Json Array:[“s-xxxxxxxxx”, ”s-yyyyyyyyy”, … “s-zzzzzzzzz”],最多 100 個 Id,用半角逗號字符隔開 |
SnapshotName | String | 否 | 快照名稱 |
Status | String | 否 | 快照狀態,progressing | accomplished | failed | all |
SnapshotType | String | 否 | 快照類型,auto | user | all |
SourceDiskType | String | 否 | 快照源磁盤的磁盤類型,System | Data |
Usage | String | 否 | 有引用關係的資源類型,image | disk | image_disk | none |
Tag.n.Key | String | 否 |
標簽 key,n 從 1 開始,最大為 5。 不允許為空字符串。 |
Tag.n.Value | String | 否 |
標簽 value,n 從 1 開始,最大為 5。 允許為空字符串。 |
PageNumber | Integer | 否 | 磁盤狀態列表的頁碼,起始值為 1,默認值為 1 |
PageSize | Integer | 否 | 分頁查詢時設置的每頁行數,最大值 100 行,默認為 10 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
RegionId | String | 鏡像所屬地域 Id |
TotalCount | Integer | 快照總個數 |
PageNumber | Integer | 快照列表的頁碼 |
PageSize | Integer | 輸入時設置的每頁行數 |
Snapshots | SnapshotType | 快照詳情 SnapshotType 組成的集合 |
錯誤碼
錯誤代碼 | 描述 | Http 狀態碼 | 語義 |
---|---|---|---|
MissingParameter | The input parameter "RegionId" that is mandatory for processing this request is not supplied. | 400 | RegionId 參數未指定 |
InvalidParameter | The specified parameter "PageNumber" is not valid. | 400 | 指定的 PageNumber 參數不合法 |
InvalidParameter | The specified parameter "PageSize" is not valid. | 400 | 指定的 PageSize 參數不合法 |
InvalidSnapshotIds.Malformed | The amount of specified specified snapshot Ids exceeds the limit. | 403 | SnapshotIds 參數格式不正確 |
InvalidUsage | The specified Usage is not valid | 404 | 指定的 Usage 不合法 |
InvalidSourceDiskType | The specified SourceDiskType is not valid | 404 | 指定的 SourceDiskType 不合法 |
InvalidStatus.NotFound | The specified Status is not found | 404 | 指定的 Status 不存在 |
InvalidSnapshotType.NotFound | The specfied SnapshotType is not found | 404 | 指定的 SnapshotType 不存在 |
示例
請求示例
https://ecs.aliyuncs.com/?Action=DescribeSnapshots
&RegionId=cn-hangzhou
&<公共請求參數>
返回示例
XML
格式
<DescribeSnapshotsResponse>
<Snapshots>
<Snapshot>
<CreationTime>2014-07-24T13:00:52Z</CreationTime>
<Description></Description>
<SourceDiskId>d-23x0r79qy</SourceDiskId>
<SourceDiskType>DATA</SourceDiskType>
<ProductCode></ProductCode>
<SnapshotName>auto_20140724_2</SnapshotName>
<Progress>100%</Progress>
<SourceDiskSize>50</SourceDiskSize>
<Status>accomplished</Status>
<SnapshotId>s-23f2i9s4t</SnapshotId>
<Usage>none</Usage>
</Snapshot>
<Snapshot>
<CreationTime>2014-07-24T13:00:42Z</CreationTime>
<Description></Description>
<SourceDiskId>101-70105379</SourceDiskId>
<SourceDiskType>DATA</SourceDiskType>
<ProductCode></ProductCode>
<SnapshotName>auto_20140724_2</SnapshotName>
<Progress>100%</Progress>
<SourceDiskSize>5</SourceDiskSize>
<Status>accomplished</Status>
<SnapshotId>s-23izto5qm</SnapshotId>
<Usage>none</Usage>
</Snapshot>
</Snapshots>
<PageNumber>1</PageNumber>
<PageSize>2</PageSize>
<TotalCount>36</TotalCount>
<RequestId>2F409D67-329A-4405-B924-2FC28566B366</RequestId>
</DescribeSnapshotsResponse>
JSON
格式
{
"PageNumber": 1,
"PageSize": 2,
"RequestId": "659F91C6-1949-43B0-90C4-B6342CA757D5",
"Snapshots": {
"Snapshot": [
{
"CreationTime": "2015-07-30T05:00:14Z",
"Progress": "100%",
"SnapshotId": "s-943ypfgic",
"SnapshotName": "auto_20150730_3",
"SourceDiskId": "d-944qyqjfa",
"SourceDiskSize": 20,
"SourceDiskType": "system",
"Status": "accomplished",
"Usage": "none"
},
{
"CreationTime": "2015-07-30T05:00:14Z",
"Progress": "100%",
"SnapshotId": "s-94osg320e",
"SnapshotName": "auto_20150730_3",
"SourceDiskId": "d-94j355jsq",
"SourceDiskSize": 20,
"SourceDiskType": "system",
"Status": "accomplished",
"Usage": "none"
}
]
},
"TotalCount": 36
}
最後更新:2016-11-23 17:16:02
上一篇:
擴容磁盤__磁盤相關接口_API 參考_雲服務器 ECS-阿裏雲
下一篇:
釋放自動快照策略__快照相關接口_API 參考_雲服務器 ECS-阿裏雲
添加刪除用戶__快速開始_大數據計算服務-阿裏雲
SDK快速入門__數據訂閱_用戶指南_數據傳輸-阿裏雲
測試監控__性能測試技術體係_性能測試體係_性能測試-阿裏雲
提交媒體信息作業__媒體信息接口_API使用手冊_媒體轉碼-阿裏雲
經典網絡IPSecVPN接入__使用金融雲產品_金融雲-阿裏雲
LookupEvents__查詢相關接口_API參考_操作審計-阿裏雲
如何創建數加項目__快速開始_大數據開發套件-阿裏雲
防盜鏈__存儲空間管理_最佳實踐_對象存儲 OSS-阿裏雲
備份恢複服務__係統架構_產品簡介_雲數據庫 RDS 版-阿裏雲
配置監控報警__實時同步_用戶指南_數據傳輸-阿裏雲
相關內容
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲