UpdateCustomLiveStreamTranscode - ApsaraVideo Live - Alibaba Cloud Documentation Center

Updates a custom transcoding configuration.

Operation description

This operation supports the following types of custom transcoding templates:

h264: custom H.264 standard transcoding.
h264-nbhd: custom H.264 Narrowband HD™ transcoding.
h265: custom H.265 standard transcoding.
h265-nbhd: custom H.265 Narrowband HD™ transcoding.
audio: audio-only transcoding.

QPS limit

You can call this operation up to 6,000 times per minute per account.

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.

Debug

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:
- The required resource types are displayed in bold characters.
- 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.

Operation	Access level	Resource type	Condition key	Associated operation
live:UpdateCustomLiveStreamTranscode	create	Domain `acs:cdn::{#accountId}:domain/{#DomainName}`	none	none

Request parameters

Parameter	Type	Required	Description	Example
Lazy	string	No	Specifies whether to enable triggered transcoding. Valid values: yes: enables triggered transcoding. no: disables triggered transcoding.	yes
ResWithSource	string	No	The source-based resolution settings. This parameter takes precedence over other resolution settings. The following fields must be included: Type: You can set this field to short, long, or screen. short specifies that the resolution of the output video is adapted to the shorter side, long specifies that the resolution of the output video is adapted to the longer side, and screen specifies that the output video has an adaptive resolution. Value: Set this field to 360, 480, 540, 720, or 1080 if the Type field is set to short. Set this field to 640, 848, 960, 1280, or 1920 if the Type field is set to long. Set this field to 640360, 848480, 960540, 1280720, or 1920*1080 if the Type field is set to screen.	{\"Type\":\"short\",\"Value\":\"1080\"}
FpsWithSource	string	No	The source-based frame rate settings. This parameter takes precedence over other frame rate settings. The following fields must be included: UpLimit: the maximum frame rate. Set this field to an integer from 1 to 60. The value must be greater than the minimum frame rate. LowerLimit: the minimum frame rate. Set this field to an integer from 1 to 60. The value must be smaller than the maximum frame rate.	{\"UpLimit\":60,\"LowerLimit\":1}
BitrateWithSource	string	No	The source-based bitrate settings. This parameter takes precedence over other bitrate settings. The following fields must be included: UpLimit: the maximum bitrate. Set this field to an integer from 128 to 10000. The value must be greater than the minimum bitrate. LowerLimit: the minimum bitrate. Set this field to an integer from 128 to 10000. The value must be smaller than the maximum bitrate. Factor: the ratio of the output bitrate to the source bitrate. Valid values: 0.1 to 1. The value is accurate to one decimal place. A value of 1 indicates that the output video has the same bitrate as the source video.	{\"UpLimit\":2500,\"LowerLimit\":800,\"Factor\":1}
ExtWithSource	string	No	Other source-based settings. The following fields are included: KeyFrameOpen: Valid values: yes and no. Copyts: Valid values: yes and no. SeiMode: Valid values: 0, 1, and 2. 0 specifies that no supplemental enhancement information (SEI) messages are passed through, 1 specifies that part of SEI messages are passed through, and 2 specifies that all SEI messages are passed through.	{\"KeyFrameOpen\":\"yes\",\"Copyts\":\"yes\",\"SeiMode\":1}

Response parameters

Parameter	Type	Description	Example

The current API has no return parameters

Examples

Sample success responses

JSONformat

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Error codes

HTTP status code	Error code	Error message
400	InvalidParameters	%s
400	ConfigAlreadyExists	%s
400	TemplateLimit	%s

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