DescribeSnapshots分页
查询云盘的快照列表信息。例如快照状态、正在创建的快照剩余完成时间、自动快照保留天数等
服务地址：
华东1 金融云
输入参数
只看必填
InstanceId指定的实例ID
DiskId指定的云盘设备ID
SnapshotLinkId快照链ID
RegionId云盘所属于的地域ID
SnapshotIds快照标识编码
PageNumber该参数即将下线
PageSize该参数即将下线
NextToken查询起始标志
MaxResults分页查询时每页行数
SnapshotName快照名称
Status快照状态
SnapshotType快照创建类型
Filter.1.Key查询资源时的筛选键
Filter.2.Key查询资源时的筛选键
Filter.1.Value查询资源时的筛选值
Filter.2.Value查询资源时的筛选值
Usage快照是否被用作创建镜像或云盘
SourceDiskType快照源云盘的云盘类型
Encrypted是否过滤加密快照
请选择布尔值
ResourceGroupId资源组ID
DryRun是否只预检此次请求
请选择布尔值
KMSKeyId数据盘对应的KMS密钥ID
Category快照类型
Tag标签列表
0
key资源的标签键
Key快照的标签键
Value快照的标签值
value资源的标签值
添加
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

InstanceId、DiskId和SnapshotIds不是必需的请求参数，但是可以构建过滤器逻辑，参数之间为逻辑与（And）关系。

通过阿里云 CLI 调用 API 时，不同数据类型的请求参数取值必须遵循一定的格式要求，详情请参见 CLI 参数格式说明。

请求示例：

查询杭州地域下 ECS 实例所有云盘的快照信息列表
RegionId:  cn-hangzhou,   //设置华东 1（杭州）地域。
InstanceId:  i-bp1fh7by6d9mw7zr****   //设置待查询的实例 ID。
查询杭州地域下某一云盘的快照信息
RegionId:  cn-hangzhou,   //设置华东 1（杭州）地域。
DiskId:   d-bp10e7ej8z743dmu****   //设置待查询的云盘 ID。
根据快照 ID 查询杭州地域下两个快照的信息
RegionId:  cn-hangzhou,   //设置华东 1（杭州）地域。
SnapshotIds:   ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"]   //设置待查询的快照 ID 数组。
查询杭州地域下某一时间节点后创建的快照信息
RegionId:  cn-hangzhou,   //设置华东 1（杭州）地域。
Filter.1.Key:   CreationStartTime,   //设置待查询的快照 ID 数组。
Filter.1.Value:   2024-11-27T00:00Z

请求参数

字段名称字段详情
InstanceIdstring

指定的实例 ID，即需要查询实例下云盘的快照信息。

示例值:i-bp67acfmxazb4p****参考取值来源:
    RunInstances
    StopInstances
    CreateInstance
    StartInstances
    RebootInstances
    DescribeInstances
    ModifyManagedInstance
    RenewReservedInstances
    AttachInstanceRamRole
    DetachInstanceRamRole
    DeregisterManagedInstance
    PurchaseReservedInstancesOffering
DiskIdstring

指定的云盘设备 ID。

示例值:d-bp67acfmxazb4p****参考取值来源:
    CreateDisk
    DescribeDisks
SnapshotLinkIdstring

快照链 ID。

示例值:sl-bp1grgphbcc9brb5****参考取值来源:
    DescribeSnapshotLinks
RegionIdstring

云盘所属于的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
SnapshotIdsstring

快照标识编码。取值可以由多个快照 ID 组成一个 JSON 数组，最多支持 100 个 ID，ID 之间用半角逗号（,）隔开。

示例值:["s-bp67acfmxazb4p****", "s-bp67acfmxazb5p****", … "s-bp67acfmxazb6p****"]参考取值来源:
    CopySnapshot
    CreateSnapshot
    DescribeSnapshotGroups
PageNumberinteger<int32>
说明 该参数即将下线，推荐您使用参数 NextToken 与 MaxResults 完成分页查询操作。
示例值:1取值 >= 1
PageSizeinteger<int32>
说明 该参数即将下线，推荐您使用 NextToken 与 MaxResults 完成分页查询操作。
示例值:10取值 <= 100
NextTokenstring

查询起始标志。由上一次的请求结果中获取。

示例值:caeba0bbb2be03f84eb48b699f0a4883
MaxResultsinteger<int32>

分页查询时每页行数。最大值：100。展开详情

示例值:10取值 <= 100
SnapshotNamestring

快照名称。

示例值:testSnapshotName参考取值来源:
    CopySnapshot
Statusstring

快照状态。取值范围： 展开详情

示例值:all
SnapshotTypestring

快照创建类型。取值范围： 展开详情

示例值:all
Filter.1.Keystring

查询资源时的筛选键，取值必须为CreationStartTime。同时设置Filter.1.Key和Filter.1.Value可以查询在指定时间点后创建的资源信息。

示例值:CreationStartTime
Filter.2.Keystring

查询资源时的筛选键，取值必须为CreationEndTime。同时设置Filter.2.Key和Filter.2.Value可以查询在指定时间点前创建的资源信息。

示例值:CreationEndTime
Filter.1.Valuestring

查询资源时的筛选值。指定该参数时必须同时指定Filter.1.Key参数，格式为：yyyy-MM-ddTHH:mmZ，采用 UTC +0 时区。

示例值:2019-12-13T17:00Z
Filter.2.Valuestring

查询资源时的筛选值。指定该参数时必须同时指定Filter.2.Key参数，格式为：yyyy-MM-ddTHH:mmZ，采用 UTC +0 时区。

示例值:2019-12-13T22:00Z
Usagestring

快照是否被用作创建镜像或云盘。取值范围： 展开详情

示例值:none
SourceDiskTypestring

快照源云盘的云盘类型。取值范围： 展开详情

示例值:system
Encryptedboolean

是否过滤加密快照。默认值：false 。

示例值:false
ResourceGroupIdstring

资源组 ID。使用该参数过滤资源时，资源数量不能超过 1000 个。展开详情

示例值:rg-bp67acfmxazb4p****参考取值来源:
    DescribeSnapshotGroups
DryRunboolean

是否只预检此次请求。展开详情

示例值:false
KMSKeyIdstring

数据盘对应的 KMS 密钥 ID。

示例值:0e478b7a-4262-4802-b8cb-00d3fb40****参考取值来源:
    DescribeDiskDefaultKMSKeyId
Categorystring

快照类型。取值范围：展开详情

示例值:Standard
Tagarray<object>

标签列表。

子级条数 <= 20

返回参数

字段名称字段详情
NextTokenstring

下一个查询起始标志。

示例值:caeba0bbb2be03f84eb48b699f0a4883
PageSizeinteger<int32>
说明 该参数即将下线，推荐您使用 NextToken 与 MaxResults 完成分页查询操作。
示例值:10
PageNumberinteger<int32>
说明 该参数即将下线，推荐您使用 NextToken 与 MaxResults 完成分页查询操作。
示例值:1
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCountinteger<int32>

快照总个数。

示例值:1
Snapshotsobject
变更历史
暂无变更历史