官方公告
了解金山云最新公告
公告 >
產(chǎn)品公告 >
【公告】關(guān)于 DescribeSnapshots 接口請求與返回參數(shù)收斂的公告
【公告】關(guān)于 DescribeSnapshots 接口請求與返回參數(shù)收斂的公告
2026-04-13 11:41:39
尊敬的客戶，
為了更好地提升接口性能、簡化調(diào)用邏輯，并降低冗余數(shù)據(jù)對業(yè)務(wù)處理的干擾，EBS云硬盤將對 DescribeSnapshots（查詢快照信息）接口的請求參數(shù)與返回字段進(jìn)行收斂優(yōu)化?，F(xiàn)將相關(guān)事項(xiàng)通知如下：
一、優(yōu)化說明
- 當(dāng)前
DescribeSnapshots接口存在部分請求參數(shù)使用率低、返回字段冗余的情況，影響接口響應(yīng)效率與調(diào)用體驗(yàn) - 平臺(tái)將對部分入?yún)⑴c返回字段進(jìn)行收斂，不再支持無效或低效的查詢過濾與信息返回
二、收斂內(nèi)容
請求參數(shù)（入?yún)ⅲ┦諗?/strong>
以下參數(shù)將不再支持高級搜索或過濾查詢：
注：上述參數(shù)仍可傳入，但不會(huì)作為過濾條件生效。
返回參數(shù)（返回信息）收斂
以下返回字段將不再返回相關(guān)信息：
三、影響范圍
- 調(diào)用
DescribeSnapshots接口的系統(tǒng)、腳本、運(yùn)維工具、自定義控制臺(tái)等 - 依賴上述被收斂字段進(jìn)行業(yè)務(wù)判斷或展示的邏輯
四、建議方案
建議您盡快對依賴該接口的業(yè)務(wù)邏輯進(jìn)行自查與調(diào)整：
- 停止使用將被收斂的入?yún)⒆鳛檫^濾條件
- 移除對將被收斂的返回字段的解析與依賴
- 如確有替代需求，請聯(lián)系產(chǎn)品團(tuán)隊(duì)獲取替代查詢方式或新接口能力
五、接口當(dāng)前支持的推薦使用方式
DescribeSnapshots 推薦使用以下高效入?yún)⑦M(jìn)行查詢：
VolumeId：根據(jù)云盤 ID 獲取對應(yīng)快照SnapshotId：獲取指定快照詳情VolumeCategory：按系統(tǒng)盤 / 數(shù)據(jù)盤類型過濾SnapshotName：按快照名稱進(jìn)行查詢PageNumber/PageSize：分頁查詢
返回信息中仍保留 RequestId、SnapshotId、SnapshotName、VolumeId、Size、CreateTime、SnapshotStatus、Progress、VolumeType、AvailabilityZone、SnapshotType 等核心字段。
六、生效時(shí)間
本次收斂將自 2026年5月28日22:00 起正式生效。屆時(shí)，上述入?yún)⑴c返回字段將按公告說明收斂。
感謝您對平臺(tái)優(yōu)化工作的理解與支持！