全部產品
Search

搜尋本產品

    ApsaraVideo VOD：SetMessageCallback

    文件中心

    ApsaraVideo VOD：SetMessageCallback

    更新時間：Jul 21, 2026

    呼叫此介面設定事件通知的回呼方式、回呼位址、事件類型。

    介面說明

    支援 HTTP 回呼和 MNS 回呼。詳細使用說明，請參閱事件通知。

    QPS 限制

    此介面的單一使用者 QPS 限制為每秒 15 次。超過限制時，API 呼叫會被限流，這可能會影響您的業務，請合理呼叫。更多資訊，請參閱 QPS 限制。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:SetMessageCallback

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    CallbackType

    string

    否

    回呼方式，取值：

    • HTTP

    • 輕量訊息佇列（原 MNS）

    HTTP
    CallbackURL

    string

    否

    回呼位址。當回呼方式為 HTTP 時，需設定此參數。 回呼位址 URL 的長度不能超過 256 個位元組，不支援設定多個回呼位址。

    http://developer.aliyundoc.com
    EventTypeList

    string

    否

    回呼事件類型，取值為空時關閉所有訊息通知，取值為 ALL 時開啟全部訊息通知。也可指定開啟某些訊息通知，多個事件類型之間使用半形逗號（,）分隔。可設定的事件類型取值範圍請參閱：事件類型。

    FileUploadComplete
    AuthSwitch

    string

    否

    HTTP 回呼的驗證開關，當回呼方式設定為 HTTP 時，此參數有效。取值：

    • on（啟用）

    • off（不啟用）

    on
    AuthKey

    string

    否

    驗證金鑰，最長 32 位元，必須同時包含大小寫字母和數字。當回呼方式為 HTTP 時，可設定此參數。

    Dsf346dvet
    MnsEndpoint

    string

    否

    訊息佇列公網 Endpoint，當回呼方式為 輕量訊息佇列（原 MNS） 時，需設定此參數。可登入訊息服務主控台，按一下右上角的取得 Endpoint 按鈕以取得。更多資訊，請參閱 Endpoint 。

    http://****.mns.cn-shanghai.aliyuncs.com/
    MnsQueueName

    string

    否

    訊息佇列名稱，可登入訊息服務主控台，在佇列清單中檢視。當回呼方式為 輕量訊息佇列（原 MNS） 時，需設定此參數。

    quene_name
    AppId

    string

    否

    應用程式 ID。未傳遞時為系統預設應用程式的 ID，取固定值：app-1000000。

    app-1000000

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    傳回結果。

    RequestId

    string

    請求 ID。

    25818875-5F78-4AF6-D7393642CA58****

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

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

    變更歷史

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