All Products
Search
Document Center

ApsaraVideo VOD:Manage storage buckets

Last Updated:Nov 08, 2023

ApsaraVideo VOD allows you to store VOD resources in Object Storage Service (OSS) buckets without the need to activate OSS. You can build a VOD environment by using features such as video collection, upload, storage, transcoding, editing, production, distribution, and playback.

ApsaraVideo VOD supports resource storage in VOD buckets and OSS buckets. All features provided by ApsaraVideo VOD can be used on all media resources that are stored in VOD buckets and OSS buckets. Examples of these features include media upload, transcoding (encrypted transcoding included), snapshot capture, playback, and AI processing such as content moderation and media fingerprinting.

For more information about the differences between VOD buckets and OSS buckets, see Storage overview.

Note
  • Media resources in ApsaraVideo VOD are region-bound. You cannot access media resources across multiple regions. For example, if you activate ApsaraVideo VOD within an Alibaba Cloud account in the China (Shanghai) region, you cannot process media files stored in the China (Beijing) region.

  • We recommend that you use your Alibaba Cloud account to store and manage media files. If you want to perform these operations as a RAM user, you must attach the AliyunVODFullAccess policy to the RAM user in advance. For more information, see Create and grant permissions to a RAM user.

Enable VOD buckets

After you activate ApsaraVideo VOD, you are assigned an independent VOD bucket in each region. You must enable the bucket before you can upload and manage media resources in a region. Other configurations are not required.

  1. Log on to the ApsaraVideo VOD console.

  2. In the upper-left corner of the page, select the region in which you want to enable the VOD bucket.

  3. In the left-side navigation pane, choose Configuration Management > Media Management > Storage.

  4. Find the VOD bucket that you want to enable and click Enable.

    Wait until the bucket is enabled. You can use the bucket only after the system returns the The bucket is enabled message and the status of the bucket is Normal.

Add user-created OSS buckets

Note

When you add an OSS bucket to ApsaraVideo VOD, the system automatically configures cross-origin resource sharing (CORS) for the bucket. The following content describes the default configurations:

  • Origin: *

  • Allow Methods: GET, POST, PUT, DELETE, and HEAD

  • Allowed Headers: *

  • Exposed Headers: ETag and x-oss-request-id

You can modify the CORS configurations in the Object Storage Service (OSS). For more information, see CORS.

If you have a large number of media files stored in an OSS bucket and these media files cannot be migrated to a VOD bucket, you can add the OSS bucket to ApsaraVideo VOD. This way, you can perform transcoding, snapshot capture, and playback operations on these media files.

  • Existing resources: If the OSS bucket that you added to ApsaraVideo VOD contains existing media resources, you need to register these resources by calling the RegisterMedia operation. Then, you can use the transcoding, snapshot capture, and playback features provided by ApsaraVideo VOD.

  • New resources: You can directly use features such as transcoding, snapshot capture, and playback on the media resources after you upload the resources to an OSS bucket that is added to ApsaraVideo VOD. No additional configurations are required.

Limits

  • You cannot add OSS buckets in the China (Hong Kong) region. For more information about the regions in which you can add OSS buckets, see Regions.

  • You can add up to 10 user-created OSS buckets to each region.

  • You can only add OSS buckets whose storage class is Standard to ApsaraVideo VOD.

Prerequisites

  • At least one user-created OSS bucket exists in your desired region.

  • Permissions are granted to allow ApsaraVideo VOD to access your OSS resources. You can go to the Cloud Resource Access Authorization page to authorize access.

Procedure

  1. Log on to the ApsaraVideo VOD console.

  2. In the upper-left corner of the page, select the region in which you want to add an OSS bucket.

  3. In the left-side navigation pane, choose Configuration Management > Media Management > Storage.

  4. Click Add User-created Bucket and select an OSS bucket in the desired region.

  5. Click OK.

    Wait until the bucket is added. You can use the bucket only after the system returns the The bucket is added message and the status of the bucket is Normal.

Specify a default bucket

If multiple buckets are available in a region, you can set one as the default bucket. All media resources uploaded to ApsaraVideo VOD will be stored in the default bucket unless specified otherwise.

  1. Log on to the ApsaraVideo VOD console and select the desired region. In the left-side navigation pane, choose Configuration Management > Media Management > Storage.

  2. Find the bucket that you want to set as the default one and click Set as Default in the Actions column.

Manage buckets

In the ApsaraVideo VOD console, you can view buckets, modify permissions, and delete or set default origin domain names for buckets.

In the ApsaraVideo VOD console, select the desired region, choose Configuration Management > Media Management > Storage. On the Storage page, click Manage in the Actions column.

  • In the Basics section, view basic information about the bucket, such as the region and type.

  • In the Permissions section, click Modify to modify the read and write permissions on the bucket.

    Note
    • If you specify Public Read and Private Write for a bucket, its address is permanently valid but is exposed to hotlinking and illegal downloads. By default, if you specify Private Read and Write for a bucket, its address is valid for 3,600 seconds. You can call the GetPlayInfo operation to modify the validity period of the address.

    • By default, Read-write permission is set to Private Read and Write for the VOD bucket. This ensures the security of your VOD resources. You can configure this parameter based on your business requirements.

    Buckets are provided by OSS. For more information, see What is OSS?

    The following table describes the values of the Read-write permission parameter.

    Value

    Description

    Private Read and Write

    Only the bucket owner and authorized RAM users can read, write, and delete the objects in the bucket. Other users cannot access the objects in the bucket without authorization.

    Public Read and Private Write

    Only the bucket owner and authorized RAM users can write and delete the objects in the bucket. Everyone (including anonymous users) can read the objects in the bucket.

    Warning

    All users can access objects in the bucket over the Internet. This may result in data leaks in your bucket and unexpectedly high costs. Exercise caution when you set Read-write permission to this value.

  • In the Origin Domain Name section, specify the default origin domain name.

    If multiple origin domain names point to the bucket, click Set as Default next to one of the domain names. Then, playback callbacks are sent to the default domain.

    For information about how to configure origin domain names, see Domain management.

    回源到此存储地址的域名

Delete buckets

In the ApsaraVideo VOD console, select the desired region, choose Configuration Management > Media Management > Storage. On the Storage page, click Delete in the Actions column to delete buckets that are no longer needed.

Note

You cannot delete buckets whose type is VOD Bucket.