DeleteImage - 刪除圖片或視頻截圖 -

介面說明

調用本介面刪除圖片時，會真正刪除源檔案，且無法復原，一旦刪除，圖片無法找回，請謹慎操作。
當 DeleteImageType 取值為 VideoId 時，VideoId、ImageType 才可用且必須傳入。
當 DeleteImageType 取值為 ImageURL 時，ImageIds、ImageURLs 才可用且必須傳入。
調用本介面刪除圖片後，某些情況存在 CDN 緩衝，可能出現圖片 URL 不會立即失效的現象。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:DeleteImage

delete

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
DeleteImageType	string	是	圖片刪除操作類型。取值： ImageURL：根據圖片 URL 刪除指定圖片。 ImageId：根據圖片 ID 刪除指定圖片。 VideoId：根據視頻 ID 刪除其關聯的圖片。	VideoId
ImageURLs	string	否	圖片地址，為 CreateUploadImage 介面返回參數`ImageURL`的值。支援傳入多個 URL，多個 URL 之間使用半形逗號（,）分隔，最多支援傳入 20 個 URL。說明當 DeleteImageType 取值為 ImageURL 時，本參數才可用且必須傳入。	https://example.aliyundoc.com/image/default/41AE7ADABBE*****.png
ImageIds	string	否	圖片 ID。支援傳入多個 ID，多個圖片 ID 之間請使用半形逗號（,）分隔，最多支援傳入 20 個 ID。可通過以下方式擷取圖片 ID：可登入點播控制台，選擇媒資庫 > 圖片查看 ID。調用 CreateUploadImage 介面擷取上傳地址和憑證時會返回。調用 SearchMedia 介面查詢圖片時會返回。說明當 DeleteImageType 取值為 ImageId 時，本參數才可用且必須傳入。	bbc65bba53fed90de118a7849**,594228cdd14b4d069fc17a8c4a**
VideoId	string	否	視頻 ID，僅支援傳入單個視頻 ID。可通過以下方式擷取：可登入點播控制台，選擇媒資庫 > 音/視頻查看視頻 ID。調用 CreateUploadVideo 介面擷取上傳地址和憑證時會返回。調用 SearchMedia 介面查詢視頻時會返回。說明當 DeleteImageType 取值為 VideoId 時，本參數才可用且必須傳入。	eb1861d2c9a8842340e989dd56****
ImageType	string	否	要刪除的視頻關聯的圖片類型。取值： CoverSnapshot：封面截圖。 NormalSnapshot：普通截圖。 SpriteSnapshot：雪碧截圖。 SpriteOriginSnapshot：雪碧圖原始圖。 All：以上所有類型的圖片。取值為非`All`時，支援選擇以上多個圖片類型，多個取值之間使用半形逗號（,）分隔。說明當 DeleteImageType 取值為 VideoId 時，本參數才可用且必須傳入。	All

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	25818875-5F78-4AF6-D7393642CA58****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。