ApsaraVideo VOD:Multi-application service console guide

Procedure

When the multi-application service is not enabled, the console displays the default main interface. After you enable the service, the console displays the multi-application interface.

Request activation

• Prerequisites

  The multi-application service is in public preview and is not enabled by default in the console. You can apply to enable this service if you meet the following condition:

  The peak bandwidth of accelerated traffic in the last 7 days reached 500 Mbps or higher. To view your peak bandwidth, go to the Usage page.

• Impacts

  • You cannot disable the default application, as doing so will affect your online services.

  • In the console, you cannot manage or query resources (such as the media files, review lists, or media processing configurations) for any application other than the default one.

  • For newly created applications, you must use APIs to re-create configurations such as transcoding and callback settings.

  Note

  • To test the callback feature, you can set different callback URLs for different environments during upload.

  • For media asset isolation, you can use media categories.

• Enable the feature

  If you meet the requirements to enable this service and accept the impacts described above, submit a ticket. After you submit the ticket, follow these steps to enable the feature:

  Note

  In your ticket, include the following statement: "I acknowledge and accept the impacts of enabling the multi-application service and hereby apply to enable it." You must also provide your Alibaba Cloud account ID.

  1. In the ApsaraVideo VOD console, go to the Overview page.

  2. In the upper-right corner of the Overview page, find the multi-application section and click Enable Now. After the feature is enabled, this section is no longer displayed on the Overview page.

Create and enter an application

After you enable the multi-application service, go to the ApsaraVideo VOD console and click Application Management in the navigation pane on the left.

1. Click Create Application. Enter an application name and description, and then click OK. After the application is created, you can edit, delete, or access it.

2. Click the application name or click Enter in the Actions column. This opens the application dashboard, which supports features such as media asset management, media processing, and video distribution.

Authorize an identity

Use the API to grant authorization. After authorization, the identity (RAM user or role) can manage resources within the application. For the authorization API, see AttachAppPolicyToIdentity. For information on policies, see Access policies.

Use multi-application service

Services that support the multi-application feature will include support for the AppId parameter. You can specify this parameter when creating resources or new settings. When querying data, only resources from applications you are authorized to access will be returned. Permissions are also checked when modifying or deleting resources.

Currently, only message callback and media asset services (upload, playback, and asset management) support the multi-application feature.

• Message callback

  You can set a unique callback method and webhook address for each application by calling the SetMessageCallback operation:

  • Specify an AppId to set the callback for that application.

  • If not specified, the system's default application is used.

  After configuration, event notifications for uploads of videos, images, etc., within different applications are sent to their respective callback URLs. You can also use the GetMessageCallback API to query the related configurations.

• Media asset service

  • Media upload: Upload-related APIs (such as getting video or image upload URLs and credentials) support specifying an AppId. The account identity must have permission for the specified application to upload. If no AppId is specified, the media is uploaded to the system's default application.

  • Audio/Video playback: You can only obtain playback information (such as playback credentials and URLs) for applications you are authorized to access.

  • Modification and deletion: You can only modify or delete media assets in applications for which you have permission.

  • Media asset query: The API for querying media details only retrieves information for assets in applications you have permission to access. In batch queries, only data for authorized media assets is returned. Media asset IDs for which you lack permission are placed in NonExistMediaIds (the field name may vary slightly).

  • Media search: Search results only include media assets from applications you are authorized to access. You can specify one or more AppIds in the search criteria.

Console navigation permissions