All Products
Search

This Product

    ApsaraVideo Media Processing:Create an MPS queue

    Document Center

    ApsaraVideo Media Processing:Create an MPS queue

    Last Updated:May 14, 2026

    To process media jobs sequentially based on priority and submission order, create an MPS queue. You can then assign a priority (if the job type supports it) and an MPS queue when you create a job.

    Limitations

    The creation limits, applicable features, and concurrency capabilities depend on the MPS queue type. If you submit a job to an unsupported MPS queue type, the job fails. If the number of jobs exceeds the concurrency limit, MPS queues them for later processing. For more information, see Overview of MPS queues.

    Create an MPS queue in the console

    1. Log on to the MPS console.

    2. In the top navigation bar, select a region from the drop-down list.Region

    3. In the left-side navigation pane, choose Global Settings > > MPS Queue and Callback.

    4. Click Create MPS Queue.

    5. In the Create MPS Queue dialog box, configure the following parameters.

      Parameter

      Description

      MPS Queue Name

      Enter a name for the MPS queue. The name can contain Chinese characters, letters, digits, and hyphens (-). It cannot start with a special character and cannot exceed 128 bytes in length.

      MPS Queue Type

      Select an MPS queue type based on the feature you need. If you select a type that is not supported in the current region, submitted jobs will fail.

    6. Click OK.

      Note

      By default, MPS creates queues in the Active state. You can stop an MPS queue to suspend job execution.

    7. (Optional) Configure notifications for an MPS queue.

      1. To enable notifications for an MPS queue, find the queue and click Set Notifications in the Actions column.

        Note

        MPS integrates with Message Service (MNS) to bind a topic or queue to an MPS queue for notifications. When a job in the MPS queue completes, MNS pushes a notification to your specified endpoint. For more information, see Set up notifications.

        Parameter

        Description

        Notifications

        Turn on the Notifications switch.

        Message Type

        Select Queue or Topic.

        Queue Name or Topic Name

        Based on your selected Message Type, select an existing instance from the Queue Name or Message Name drop-down list.

      2. Click OK to complete the configuration.

    Manage MPS queues in the console

    Important

    • If you submit a job to a deleted or stopped MPS queue, MPS does not schedule or run the job, and it fails.

    • Deleting or stopping an MPS queue does not affect jobs that were submitted beforehand. However, you cannot cancel jobs already in the processing queue. These jobs will run to completion and incur charges.

    • Submit a job

      1. When you create a single job or a workflow, select an MPS queue from the MPS Queues drop-down list in the Input settings.

    • Activate or stop an MPS queue

      1. Sign in to the MPS console. In the left-side navigation pane, choose Global Settings > > MPS Queue and Callback.

      2. In the Actions column for the MPS queue, click Activate or Stop to activate or stop the queue.

    • Delete an MPS queue

      1. Sign in to the MPS console. In the left-side navigation pane, choose Global Settings > > MPS Queue and Callback.

      2. In the Actions column for the MPS queue, click Stop. After the queue stops, click Delete MPS Queue.

    • Edit the name of an MPS queue

      1. Sign in to the MPS console. In the left-side navigation pane, choose Global Settings > > MPS Queue and Callback.

      2. Click the edit icon to the right of the MPS queue name and update the name.

    API reference