使用UpdateMediaPublishState更新媒體發布狀態-ApsaraVideo for Media Processing-阿里雲

介面說明

本介面中所指發布的含義是媒體播放資源、截圖檔案的存取權限設定為繼承所屬 Bucket 的存取權限。不發布的含義是將媒體播放資源、截圖檔案的存取權限設定為私人。

本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:UpdateMediaPublishState

update

*全部資源

*

無

名稱	類型	必填	描述	樣本值
MediaId	string	是	需更新發布狀態的媒體 ID。可以從新增媒體的返回參數中擷取，也可以登入ApsaraVideo for Media Processing控制台，通過媒體管理 > 媒體列表找到目標視頻，單擊管理，從目標視頻的基礎資訊頁簽擷取。	3e6149d5a8c944c09b1a8d2dc3e4****
Publish	boolean	否	發布狀態。預設值：Initialed（初始）。可選範圍： true：發布。 false：不發布。	true

媒體發布預設狀態與遷移規則

預設狀態：

媒體發布狀態的預設值是 Initialed（初始）。有兩種媒體類型處於這種狀態：

新的媒體：第一次產生一個媒體（第一次觸發媒體工作流程執行）時，工作流程還處於執行中，這個時候媒體就處於“初始“狀態。只要媒體工作流程執行完成，就會變更為一個確切狀態（根據媒體工作流程的配置來設定）。
刪除後的媒體：媒體刪除後，發布狀態就沒有意義了，這個時候也是處於“初始”狀態。如果把刪除的媒體重新添加回媒體庫，就從“新的媒體”開始重新執行。

遷移規則：

說明

遷移指媒體發布狀態在初始、發布、不發布三種狀態之間的遷移。通過 API 呼叫和通過工作流程執行調用的媒體遷移規則不同。

正常返回樣本

JSON格式

{
  "RequestId": "91B6CAB9-034C-4E4E-A40B-E7F5C81E688C"
}

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

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