All Products
Search
Document Center

ApsaraVideo Media Processing:Add media buckets

Last Updated:Jul 17, 2026

Bind Object Storage Service (OSS) buckets to ApsaraVideo Media Processing (MPS) as input and output media buckets. This allows MPS to monitor file uploads and automatically trigger workflow execution.

Prerequisites

OSS is activated. Activate OSS.

Step 1: Add media buckets

  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 Workflows > Media Bucket. The page displays tabs for Input Buckets and Output Bucket.

  4. On the Input Buckets tab, click Add Bucket.

  5. In the Add Input Bucket dialog box, OSS buckets in the current region are listed. You can:

    • Select an existing bucket and click OK to add the input bucket.

      Note

      If your bucket is not listed, verify that the correct region is selected in the top navigation bar.

    • Click Create Bucket, enter a bucket name, and click OK. Select the new bucket and click OK to add it as the input bucket.

      Note
      • If the message "The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again." appears, the bucket name is already in use. Bucket names must be globally unique.

      • Buckets created without a specified ACL default to private. Bucket ACL.

  6. Select the Output Bucket tab and click Add Bucket. Follow the same steps as for the Input Buckets.

Step 2: Create bucket storage paths

Important

After adding the Input Buckets and Output Bucket, you must create storage paths for them in the OSS console. Without storage paths, media processing jobs fail.

  1. Log on to the OSS console.

  2. In the left-side navigation pane, click Bucket List.

  3. Next to Create Bucket, enter the name of the Input Buckets that you added in MPS. The matching bucket appears in the list.

  4. Click the bucket name in the list.

  5. Click Create Folder.

  6. In the Folder Name field, enter a folder name and click OK. This creates the storage path for the Input Buckets.

    Important

    Each workflow must have a unique input path prefix. Overlapping prefixes cause a single upload to trigger multiple workflows. For example, test and test1 as input paths for separate workflows means a file in test1 also matches test, triggering both. File matching rules for workflows.

  7. Click Object Storage Service in the upper-left corner to return to the Bucket List page.

  8. In the Bucket Name field, enter the name of the Output Bucket you added in MPS. Follow the same steps as for the input bucket.

    Note

    After creating the Input Bucket and Output Bucket storage paths, bind them to a workflow to automatically trigger media processing on file upload. Upload files to OSS.

(Optional) Step 3: Configure hotlink protection

Important

If the source OSS bucket has hotlink protection enabled, add a Referer to the input bucket's whitelist in MPS so that MPS can access the source file. MPS hotlink protection settings do not affect your OSS bucket configuration. Skip this step if hotlink protection is not enabled on your bucket. Hotlink protection.

  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 Workflows > Media Bucket.

  4. On the Input Buckets tab, find the desired input bucket and click Configure Hotlink Protection in the Actions column.

  5. In the Referer Whitelist text box, enter the desired Referer.

    Note
    • The Referer must match an entry in the bucket's referer whitelist in OSS. Hotlink protection.

    • If the bucket has multiple Referers in OSS, add only one in MPS.

Next steps

  1. Create a workflow. In the left-side navigation pane, choose Workflows > Workflow Orchestration and configure the parameters. Create a workflow.

  2. Upload a file from the MPS or OSS console. We recommend the OSS console. Upload videos.

API reference