閱讀322 返回首頁    go 魔獸

查詢快照__快照相關接口_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

  上一篇：go 擴容磁盤__磁盤相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 釋放自動快照策略__快照相關接口_API 參考_雲服務器 ECS-阿裏雲