VOD provides a subapplication feature to enable you to isolate resources in it. This feature is an internal concept in VOD with respect to how resources are divided. A subapplication is similar to an independent VOD account. After a subapplication is created, the ownership of VOD resources will be as shown below:
Note:
Resources mentioned in this document include media files in VOD and their attributes, derivative files, configurations, CDN domain names, and statistics of VOD service usage.
Below are some typical use cases for VOD subapplication:
Roles in the VOD subapplication system include admin, primary application, and subapplication. Their definitions are as shown below.
APPID
, which can be viewed in Account Info in the console.Note:
Unless otherwise specified, the primary application and subapplications will not be distinguished in the following sections and will be collectively referred to as subapplication.
The VOD subapplication system provides the following capabilities:
The VOD subapplication system has the following limits:
Note:
If the subapplication feature has already been enabled, Enable Subapplication on the left sidebar will be invisible.
After the subapplication feature is enabled, a drop-down list will be displayed in the top-left corner of the VOD console where you can select a role. If you have just enabled the subapplication feature, there are only two roles in the drop-down list: admin and primary application. After you create a subapplication, it will be displayed as a role in the drop-down list.
Under the admin role, the left sidebar displays the following entries: Service Overview, Application Management, and UGSV License.
Under the subapplication role, usage of the VOD console is basically the same as that before the subapplication feature is enabled, and you can view and manipulate the subapplication's VOD resources. The main difference lies in that the subapplication itself has no separate billing configuration.
After enabling the subapplication feature, you must specify the subapplication whose resources you want to access when using VOD server APIs.
Specifying-subapplication-in-server-API">
VOD server API has been upgraded to TencentCloud API 3.0. You can use the SubAppId
parameter in each API to specify the subapplication you want to access. If you want to access the primary application, you can enter the primary application ID or leave this parameter empty.
Server API 2017 also supports subapplications. When using it, you need to add the SubAppId
parameter (case-sensitive) to the request. This parameter is at the same level as common request parameters of server API 2017, and its value is the subapplication ID. If you want to access the primary application, you can enter the primary application ID or leave this parameter empty.
Note:
- Server API 2017 documentation does not disclose the
SubAppId
parameter, which will not affect the use of it though.- The
SubAppId
parameter is also involved in signature calculation for server APIs in the same calculation rule.
After enabling the VOD subapplication feature, you must specify the subapplication to which you want to upload your media files.
LVB recording allows you to generate recording files in the specified subapplication by adding vod_sub_app_id=xxx
(xxx
refers to the subapplication ID) to the LVB push parameters. If you want to generate recording files in the primary application, simply leave this parameter empty.
Upload from server supports file upload to the specified subapplication. For more information on how to set the parameters, please visit the link below. If you want to upload files to the primary application, you can enter the primary application ID or leave the corresponding parameter empty.
The ApplyUpload and CommitUpload APIs will be used for upload. For more information, please see Specifying a Subapplication in a Server API.
We strongly recommend you use the SDK for upload.
Upload from client allows you to upload files to the specified subapplication by adding vodSubAppId=xxx
(xxx
refers to the subapplication ID) to the signature for upload from client. If you want to upload files to the primary application, you can enter the primary application ID or leave this parameter empty.
Note:
The
vodSubAppId
parameter is also involved in calculation of the signature for upload from client in the same calculation rule.
Upload from URL allows you to upload files to the specified subapplication.
VOD has been connected to CAM and supports authorization at subapplication level. For more information, please see Access Management.
No. The subapplication system is designed with compatibility in mind. If the subapplication ID is not specified, all server APIs will manipulate the primary application by default.
The subapplication feature itself is free of charge; however, resources consumed by each subapplication will be billed under the VOD account according to the VOD billing rules.
As described in Limits above, VOD only generates one aggregated bill for the entire account. If you have multiple businesses that require cost allocation, you can define and calculate the allocated costs based on the subapplication-level statistics provided by VOD.
If your VOD service is suspended due to arrears, all subapplications under your account will be disabled.
Resources of different subapplications are isolated, so resources of one subapplication cannot be migrated to another.
Was this page helpful?