Updated on 2023-08-28 GMT+08:00

Incremental Hosting

You can configure incremental hosting for each bucket to synchronize new media files in the bucket to VOD so that you can manage these files.

Prerequisites

  • An OBS bucket to be hosted has been authorized. For details, see Bucket Authorization.
  • If you need to transcode media files or use a workflow to process these files in the OBS bucket, you can create a transcoding template by referring to Transcoding Settings or create a workflow by referring to Workflow Settings.

Notes

  • If incremental hosting is enabled, VOD only hosts new files in the bucket. Files already in the bucket will not be hosted.
  • If a file is added to an authorized OBS bucket, you can use SMN to get notifications about this. Enabling this function will incur fees. For details, see SMN Pricing Details.
  • Incremental hosting is not available for IAM users. You are advised to use a Huawei Cloud account for incremental hosting.

Creating a Hosting Configuration

  1. Log in to the VOD console.
  2. In the navigation pane, choose Audio and Video Hosting > Incremental Hosting.
  3. Click Create Hosting Configuration.

    Figure 1 Creating an incremental hosting task

  4. Configure related parameters by referring to Table 1.

    Table 1 Incremental hosting parameters

    Parameter

    Description

    Name

    Configuration name of incremental hosting. Enter a maximum of 128 characters, including letters, underscores (_), and digits.

    Input Bucket

    Bucket to be hosted

    File Type

    Types of files to be hosted in the OBS bucket

    Template/Workflow

    Select a transcoding template or workflow to process hosted media files.

    Storage Location

    The following storage locations are supported:
    • VOD: Output files are stored in VOD.
    • OBS bucket: Output files are stored in an OBS bucket.
    • OBS bucket (same as input files): Output files are stored in an OBS bucket (which cannot be the input bucket) and their storage directory is named the same as the storage directory of input files.

    If Storage Location is set to OBS bucket (same as input files), the storage path of the generated file varies depending on the service type.

    Suppose the input file storage path is vod1/input/video.mp4 and the output bucket is vod2. Table 2 describes the paths for storing outputs.
    Table 2 Storage path parameters

    Media Processing

    Output Path

    Transcoding

    • HLS format
      • One-in one-out template: vod2/input/index.m3u8
      • One-in multiple-out template: vod2/input/video_0.m3u8, vod2/input/video_1.m3u8, ...
    • MP4 format
      • One-in one-out template: vod2/input/video.mp4
      • One-in multiple-out template: vod2/input/video_0.mp4, vod2/input/video_1.mp4, ...
    • DASH format: vod2/input/video.mpd

    Snapshot capturing

    vod2/input/video{timestamp}.jpg

    In which:

    timestamp indicates the timestamp of the snapshot.

    Packaging

    • HLS format: vod2/input/video.m3u8
    • MP4 format: vod2/input/video.mp4

    Thumbnailing

    vod2/input/video_Cover0.jpg

    Subtitling

    vod2/input/cc_1.srt

    Audio extraction

    vod2/input/{newasset_id}/audioName.mp3

    In which:
    • newasset_id indicates the ID of the extracted audio file.
    • audioName indicates the name of the extracted audio file, which is randomly generated.

  5. Click OK.
  6. Wait until the configuration status becomes Enabled.

    Figure 2 Hosting status

Other Operations

You can perform the following operations on an existing configuration:
  • Edit: Modify a configuration.
  • Enable: Enable a configuration in the Disabled state. After this function is enabled, if new media files are added to the OBS bucket in the hosting configuration, the files will be hosted by VOD. You can view the files on the Audio and Video Management page of the VOD console.
  • Disable: Disable a configuration in the Enabled state. After this function is disabled, new media files in the OBS bucket in the hosting configuration will not be hosted by VOD.
  • Delete: If an incremental hosting configuration is deleted, the relationship between an OBS bucket and VOD is also removed.