ApsaraVideo VOD:Manage storage buckets

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.

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

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.