尊敬的客户，

为了更好地提升接口性能、简化调用逻辑，并降低冗余数据对业务处理的干扰，EBS云硬盘将对 DescribeSnapshots（查询快照信息）接口的请求参数与返回字段进行收敛优化。现将相关事项通知如下：

一、优化说明

• 当前 DescribeSnapshots 接口存在部分请求参数使用率低、返回字段冗余的情况，影响接口响应效率与调用体验
• 平台将对部分入参与返回字段进行收敛，不再支持无效或低效的查询过滤与信息返回

二、收敛内容

请求参数（入参）收敛

以下参数将不再支持高级搜索或过滤查询：

注：上述参数仍可传入，但不会作为过滤条件生效。

返回参数（返回信息）收敛

以下返回字段将不再返回相关信息：

三、影响范围

• 调用 DescribeSnapshots 接口的系统、脚本、运维工具、自定义控制台等
• 依赖上述被收敛字段进行业务判断或展示的逻辑

四、建议方案

建议您尽快对依赖该接口的业务逻辑进行自查与调整：

• 停止使用将被收敛的入参作为过滤条件
• 移除对将被收敛的返回字段的解析与依赖
• 如确有替代需求，请联系产品团队获取替代查询方式或新接口能力

五、接口当前支持的推荐使用方式

DescribeSnapshots 推荐使用以下高效入参进行查询：

• VolumeId：根据云盘 ID 获取对应快照
• SnapshotId：获取指定快照详情
• VolumeCategory：按系统盘 / 数据盘类型过滤
• SnapshotName：按快照名称进行查询
• PageNumber / PageSize：分页查询

返回信息中仍保留 RequestId、SnapshotId、SnapshotName、VolumeId、Size、CreateTime、SnapshotStatus、Progress、VolumeType、AvailabilityZone、SnapshotType 等核心字段。

六、生效时间

本次收敛将自 2026年5月28日22:00 起正式生效。届时，上述入参与返回字段将按公告说明收敛。

感谢您对平台优化工作的理解与支持！