すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:SetMessageCallback

    ドキュメントセンター

    ApsaraVideo VOD:SetMessageCallback

    最終更新日:Jul 21, 2026

    イベント通知のコールバックメソッド、コールバック URL、およびイベントタイプを設定します。

    操作説明

    HTTP コールバックおよびメッセージキュー (旧 MNS) コールバックがサポートされています。詳細については、「イベント通知」を参照してください。

    QPS 制限

    この操作の単一ユーザー QPS 制限は、1 秒あたり 15 回の呼び出しです。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。詳細については、「QPS 制限」を参照してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vod:SetMessageCallback

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    CallbackType

    string

    任意

    コールバックメソッド。有効な値:

    • HTTP

    • Simple Message Queue (formerly MNS)

    HTTP。
    CallbackURL

    string

    任意

    コールバック URL。コールバックメソッドが HTTP に設定されている場合、このパラメーターは必須です。 コールバック URL の長さは 256 バイトを超えることはできません。複数のコールバック URL はサポートされていません。

    http://developer.aliyundoc.com。
    EventTypeList

    string

    任意

    コールバックのイベントタイプ。このパラメーターが空の場合、すべての通知が無効になります。このパラメーターが ALL に設定されている場合、すべての通知が有効になります。特定のイベントタイプをカンマ (,) で区切って指定することもできます。有効なイベントタイプについては、「イベントタイプ」を参照してください。

    FileUploadComplete。
    AuthSwitch

    string

    任意

    HTTP コールバックの認証スイッチ。このパラメーターは、コールバックメソッドが HTTP に設定されている場合にのみ効果があります。有効な値:

    • on: 有効。

    • off: 無効。

    on
    AuthKey

    string

    任意

    認証キー。キーの長さは最大 32 文字で、大文字、小文字、数字を含む必要があります。このパラメーターは、コールバックメソッドが HTTP の場合に設定できます。

    Dsf346dvet。
    MnsEndpoint

    string

    任意

    メッセージキュー (旧 MNS) のパブリックエンドポイント。コールバックメソッドが Simple Message Queue (formerly MNS) に設定されている場合、このパラメーターは必須です。メッセージキュー (旧 MNS) コンソール にログインし、右上隅の [エンドポイントの取得] ボタンをクリックしてエンドポイントを取得します。詳細については、「エンドポイント」を参照してください。

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

    string

    任意

    メッセージキューの名前。メッセージキュー (旧 MNS) コンソール にログインし、[キューリスト] でキューを表示します。コールバックメソッドが Simple Message Queue (formerly MNS) に設定されている場合、このパラメーターは必須です。

    quene_name。
    AppId

    string

    任意

    アプリケーション ID。このパラメーターが指定されていない場合、既定のアプリケーションの ID が使用されます。固定値は app-1000000 です。

    app-1000000

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

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

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。