All Products
Search
Document Center

Intelligent Media Services:CreateVodPackagingConfiguration

Last Updated:Dec 23, 2025

Creates a VOD packaging configuration.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
ice:CreateVodPackagingConfigurationcreate
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
GroupNamestringNo

The name of the packaging group. The name can be up to 128 characters in length. Letters, digits, underscores (_), and hyphens (-) are supported.

vod_hls
ConfigurationNamestringNo

The name of the packaging configuration. The name must be unique in an account and can be up to 128 characters in length. Letters, digits, underscores (_), and hyphens (-) are supported.

hls_3s
ProtocolstringNo

The package type.

  • HLS: packages content into TS segments for delivery over the HLS protocol.
  • HLS_CMAF: packages content into CMAF segments for delivery over the HLS protocol.
  • DASH: packages content for delivery over the DASH protocol.
HLS
DescriptionstringNo

The description of the packaging configuration.

HLS 3s vod packaging
PackageConfigobjectNo

The packaging configuration.

ManifestNamestringNo

The manifest name. The name can be up to 128 characters in length. Letters, digits, underscores (_), and hyphens (-) are supported.

index
SegmentDurationlongNo

The duration of each segment in a packaged stream. Unit: seconds. MediaPackage rounds segments to the nearest multiple of the input segment duration. Valid values: 1 to 30.

6
StreamSelectionobjectNo

The settings of stream selection.

MinVideoBitsPerSecondlongNo

The minimum bitrate of the video stream. Unit: bit/s.

100000
MaxVideoBitsPerSecondlongNo

The maximum bitrate of the video stream. Unit: bit/s.

1000000000
StreamOrderstringNo

The order of manifest files in the master playlist. Valid values:

  • ORIGINAL: sorts the manifest files in the same order as the source.
  • VIDEO_BITRATE_ASCENDING: sorts the manifest files in ascending order of bitrates, from lowest to highest.
  • VIDEO_BITRATE_DESCENDING: sorts the manifest files in descending order of bitrates, from highest to lowest.
ORIGINAL
DrmProviderobjectNo

The settings of digital rights management (DRM) encryption.

EncryptionMethodstringNo

The encryption method. Valid values:

  • AES_128: Advanced Encryption Standard (AES) with 128-bit key length.
  • SAMPLE_AES: an encryption method that encrypts individual media samples.
AES_128
IVstringNo

A 128-bit, 16-byte hex value represented by a 32-character string that is used with the key for encrypting data blocks. If you leave this parameter empty, MediaPackage creates a constant initialization vector (IV). If it is specified, the value is passed to the DRM service.

00001111222233334444555566667777
SystemIdsarrayNo

The ID of the DRM system. The maximum number of system IDs allowed is determined by the protocol type. Limits:

  • DASH: 2
  • HLS: 1
  • HLS_CMAF: 2

Apple FairPlay, Google Widevine, and Microsoft PlayReady are supported. Their system IDs are as follows:

  • Apple FairPlay: 94ce86fb-07ff-4f43-adb8-93d2fa968ca2
  • Google Widevine: edef8ba9-79d6-4ace-a3c8-27dcd51d21e
  • Microsoft PlayReady: 9a04f079-9840-4286-ab92-e65be0885f95
stringNo

The ID of the DRM system.

94ce86fb-07ff-4f43-adb8-93d2fa968ca2
UrlstringNo

The URL of the DRM key provider.

https://***drm***/getcontent

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The ID of the request.

******11-DB8D-4A9A-875B-275798******
PackagingConfigurationVodPackagingConfiguration

The packaging configuration.

Examples

Sample success responses

JSONformat

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "PackagingConfiguration": {
    "GroupName": "",
    "Description": "",
    "CreateTime": "",
    "ConfigurationName": "",
    "Protocol": "",
    "PackageConfig": {
      "ManifestName": "",
      "StreamSelection": {
        "MinVideoBitsPerSecond": 0,
        "StreamOrder": "",
        "MaxVideoBitsPerSecond": 0
      },
      "DrmProvider": {
        "SystemIds": [
          ""
        ],
        "EncryptionMethod": "",
        "IV": "",
        "Url": ""
      },
      "SegmentDuration": 0
    }
  }
}

Error codes

For a list of error codes, visit the Service error codes.