Configure VOD Packaging for Multi-Protocol Streaming via API - Intelligent Media Services - Alibaba Cloud - Intelligent Media Services

Creates a VOD packaging configuration.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ice:CreateVodPackagingConfiguration

create

*All Resource

*

None

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
GroupName	string	No	The name of the packaging group, up to 128 characters in length. Letters, digits, underscores (_), and hyphens (-) are supported.	vod_hls
ConfigurationName	string	No	The name of the packaging configuration. Must be unique within an account and up to 128 characters in length. Letters, digits, underscores (_), and hyphens (-) are supported.	hls_3s
Protocol	string	No	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
Description	string	No	The description of the packaging configuration.	HLS 3s vod packaging
PackageConfig	object	No	The packaging configuration.
ManifestName	string	No	The manifest name, up to 128 characters in length. Letters, digits, underscores (_), and hyphens (-) are supported.	index
SegmentDuration	integer	No	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
StreamSelection	object	No	The stream selection settings.
MinVideoBitsPerSecond	integer	No	The minimum bitrate of the video stream. Unit: bit/s.	100000
MaxVideoBitsPerSecond	integer	No	The maximum bitrate of the video stream. Unit: bit/s.	1000000000
StreamOrder	string	No	The order of manifest files in the master playlist. Valid values: ORIGINAL: maintains the source order. VIDEO_BITRATE_ASCENDING: sorts manifest files by bitrate in ascending order. VIDEO_BITRATE_DESCENDING: sorts manifest files by bitrate in descending order.	ORIGINAL
DrmProvider	object	No	The digital rights management (DRM) encryption settings.
EncryptionMethod	string	No	The encryption method. Valid values: AES_128: Advanced Encryption Standard (AES) with 128-bit key length. SAMPLE_AES: encrypts individual media samples.	AES_128
IV	string	No	A 128-bit, 16-byte hex value represented by a 32-character string, used with the key for encrypting data blocks. If not specified, MediaPackage creates a constant initialization vector (IV). If specified, the value is passed to the DRM service.	00001111222233334444555566667777
SystemIds	array	No	The DRM system ID. The maximum number of system IDs depends on the protocol type: 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
	string	No	The ID of the DRM system.	94ce86fb-07ff-4f43-adb8-93d2fa968ca2
Url	string	No	The URL of the DRM key provider.	https://*drm*/getcontent

Response elements

Element	Type	Description	Example
	object	The response schema.
RequestId	string	The ID of the request.	****11-DB8D-4A9A-875B-275798****
PackagingConfiguration	VodPackagingConfiguration	The packaging configuration.

Examples

Success response

JSON format

{
  "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

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.