All Products
Search
Document Center

ApsaraVideo VOD:Manage VOD storage

Last Updated:Aug 22, 2023

ApsaraVideo VOD allows you to store VOD resources in Object Storage Service (OSS) buckets without the need to activate OSS. You can quickly and easily 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 that are 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 comparison between VOD buckets and OSS buckets, see Manage VOD storage.

Note
  • Media resources in ApsaraVideo VOD are region-bound. You cannot access media resources across 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 message The bucket is enabled 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: Enter *.

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

  • Allowed Headers: Enter *.

  • Exposed Headers: Enter 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.

  • Newly uploaded resources: You can use features such as transcoding, snapshot capture, and playback on the media resources once you upload them to an OSS bucket that has been 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 OSS buckets to ApsaraVideo VOD in each region.

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

Prerequisites

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

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

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 your destination 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 or public read and write for a storage address, the address is permanently valid but is exposed to hotlinking and illegal downloads. If you specify private read and write for a storage address, the address is valid for 3,600 seconds by default. You can call the GetPlayInfo operation to modify the validity period of the storage 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 leakage of data in your bucket and unexpectedly high costs. Exercise caution when you set your bucket access control list (ACL) 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.