Set callback events

更新时间:
复制 MD 格式

Intelligent Media Services supports callbacks through HTTP requests and MNS queues. You can configure callback events to receive real-time updates on task progress and status.

Background information

When you use Intelligent Media Services for media asset uploads, ApsaraVideo Media Processing, or online editing, you can set callback events to track task progress and status in real time. For more information about callback methods and events, see Overview of callback events.

Prerequisites

If the callback method is MNS Queue, you must first grant MNS access permissions. For more information, see Activate Simple Message Queue (formerly MNS) and grant permissions.

Set callback events in the console

  1. Log on to the Intelligent Media Services console.

  2. In the navigation pane on the left, choose Configuration Management > Callback Settings.

  3. In the upper-left corner of the page, select a region as needed.

  4. Click Modify Configuration.

    Parameter

    Description

    Callback method

    The callback method. Set this parameter to HTTP Request (HTTPS compatible) or MNS Queue.

    Callback URL

    Required when the callback method is HTTP Request.

    The URL that receives callback notifications. When a callback event occurs, the server sends an HTTP POST request to this URL.

    Queue name

    Required when the callback method is MNS Queue.

    The name of the MNS queue that receives callback notifications. Use a queue whose name starts with `ice-callback`. If no active queue is available, create one in the MNS console. For more information, see Create a queue.

    Callback event

    Select the callback events that you want to subscribe to.

    Callback authentication

    If Callback method is set to HTTP Request, enable callback authentication so the receiving server can verify the signature of callback messages and reject unauthorized requests. For more information, see Callback authentication.

Set callback events using OpenAPI

Call the SetEventCallback operation to set callback events. For a list of supported callback events, see Event list.

API reference