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