调用DescribeSnapshots接口查询指定文件系统所有的快照列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeSnapshots

接口名称。

固定取值:DescribeSnapshots

FileSystemType String extreme

文件系统类型。

取值:extreme(极速型NAS)

FileSystemId String extreme-22f****

指定文件系统ID。

SnapshotIds String s-extreme-67pxwk9aevrkr****,s-extreme-snapsho****,s-extreme-6tmsbas6ljhwh****

快照标识编码。

可以由多个快照ID组成,多个ID用半角逗号(,)隔开,最多支持100个ID。

SnapshotName String FinanceJoshua

快照名称。

SnapshotType String all

快照类型。

取值:

  • auto:自动快照
  • user:手动创建的快照
  • all(默认值):所有快照类型
Status String all

快照状态。

取值:

  • progressing:正在创建的快照
  • accomplished:创建成功的快照
  • failed:创建失败的快照
  • all(默认):所有快照状态
PageSize Integer 10

分页查询时设置的每页行数。

取值范围:1~100

默认值:10

PageNumber Integer 1

快照列表的页码。

起始值(默认值):1

返回数据

名称 类型 示例值 描述
PageNumber Integer 1

快照列表的页码。

PageSize Integer 10

查询结果每页行数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID。

Snapshots Array of Snapshot

快照详情集合。

Snapshot
CreateTime String 2014-07-24T13:00:52Z

创建时间。

按照ISO 8601标准表示,并使用UTC时间。格式为:yyyy-MM-ddThh:mmZ

Description String FinanceDept

接口说明信息。

EncryptType Integer 1

加密类型。

包括:

  • 0:不加密
  • 1:加密
Progress String 100

创建快照的进度。以百分比表示。

RemainTime Integer 38

正在创建的快照任务剩余完成时间。

单位:秒。

RetentionDays Integer 30

自动快照保留天数。

单位:天。

包括:

  • -1:永久保存,当快照数量达到额度上限后被自动删除。
  • 1~65536:指定保存天数,保留时间到期后快照会被自动释放。
SnapshotId String s-extreme-snapsho****

快照ID。

SnapshotName String FinanceJoshua

快照名称。

创建快照时指定了快照名称,则返回快照名称。创建快照时未指定快照名称,则不返回此参数。

SourceFileSystemId String extreme-012****

源文件系统ID。

如果快照的源文件系统已经被删除,该字段仍旧保留。

SourceFileSystemSize Long 2000

源文件系统容量。

单位:GiB。

SourceFileSystemVersion String 1

源文件系统版本号。

Status String accomplished

快照状态。

包括:

  • progressing:正在创建的快照
  • accomplished:创建成功的快照
  • failed:创建失败的快照
TotalCount Integer 36

快照总个数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSnapshots
&FileSystemType=extreme
&<公共请求参数>

正常返回示例

XML 格式

<TotalCount>36</TotalCount>
<PageSize>10</PageSize>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<PageNumber>1</PageNumber>
<Snapshots>
    <Snapshot>
        <Status>accomplished</Status>
        <Progress>100</Progress>
        <Description>FinanceDept</Description>
        <SourceFileSystemVersion>1</SourceFileSystemVersion>
        <CreateTime>2014-07-24T13:00:52Z</CreateTime>
        <SourceFileSystemId>extreme-012****</SourceFileSystemId>
        <RetentionDays>30</RetentionDays>
        <SnapshotName>FinanceJoshua</SnapshotName>
        <SnapshotId>s-extreme-snapsho****</SnapshotId>
        <SourceFileSystemSize>2000</SourceFileSystemSize>
        <EncryptType>1</EncryptType>
        <RemainTime>38</RemainTime>
    </Snapshot>
</Snapshots>

JSON 格式

{
    "TotalCount": 36,
    "PageSize": 10,
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
    "PageNumber": 1,
    "Snapshots": {
        "Snapshot": {
            "Status": "accomplished",
            "Progress": 100,
            "Description": "FinanceDept",
            "SourceFileSystemVersion": 1,
            "CreateTime": "2014-07-24T13:00:52Z",
            "SourceFileSystemId": "extreme-012****",
            "RetentionDays": 30,
            "SnapshotName": "FinanceJoshua",
            "SnapshotId": "s-extreme-snapsho****",
            "SourceFileSystemSize": 2000,
            "EncryptType": 1,
            "RemainTime": 38
        }
    }
}

错误码

访问错误中心查看更多错误码。