UpdateLiveStreamMonitor - ApsaraVideo Live - Alibaba Cloud Documentation Center

Updates the configurations of a monitoring session.

Operation description

This operation updates the configuration of a monitoring session. If the monitoring session is running, updates to the input source configuration take effect in real time.

QPS limit

The queries per second (QPS) limit for a single user is 10. API calls that exceed this limit are throttled. Throttling can affect your business, so we recommend that you plan your calls accordingly.

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

live:UpdateLiveStreamMonitor

update

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	No	The region ID.	cn-shanghai
MonitorId	string	Yes	The ID of the monitoring session. Note Obtain the MonitorId value from the response parameters of the CreateLiveStreamMonitor operation.	445409ec-7eaa-461d-8f29-4bec2eb9****
MonitorName	string	No	The name of the monitoring session.	liveMonitor****
Domain	string	No	The output domain name for the monitoring session.	demo.aliyundoc.com
App	string	No	The application name for the output stream of the monitoring session. You can specify a custom name. If you do not specify this parameter, monitor is used as the AppName.	monitor****
Stream	string	No	The name of the output stream for the monitoring session.	monitorStream****
OutputTemplate	string	No	The output template for the monitoring session. Valid values: lp_ld: low definition. lp_sd: standard definition. lp_hd: high definition. lp_ud: ultra-high definition.	lp_ud
InputList	string	Yes	The list of input streams to monitor. For more information, see the InputConfig table below.	InputConfig
MonitorConfig	string	No	The settings for alert thresholds. The value is a JSON string. For more information, see the MonitorConfig table below.	"{\"fpsLowThres\": 0.6,\"brLowThres\": 1.1,\"eofDurationThresSec\": 10}"
CallbackUrl	string	No	The webhook address. HTTP and HTTPS are supported.	http://guide.aliyundoc.com/notify
DingTalkWebHookUrl	string	No	The webhook URL of the DingTalk chatbot. Monitoring alerts are sent to a DingTalk group using a chatbot. Set up a chatbot and enter its webhook URL, which must be an HTTP or HTTPS address. For more information, see Custom robot access. Note Set the custom keyword of the DingTalk chatbot to "Alerting". Otherwise, messages cannot be received.	https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa****

InputConfig

Name	Type	Description	Example
Index	Integer	The index. This parameter is used by the frontend.	1
LayoutId	Integer	The layout ID. The value must start from 1.	1
StreamName	String	The display name of the monitored stream.	monitorStream****
InputUrl	String	The URL of the input stream.	demo.aliyundoc.com
LayoutConfig	LayoutConfig	The layout information.	For more information, see the LayoutConfig table below.
PlayConfig	PlayConfig	The playback configuration.	For more information, see the PlayConfig table below.

LayoutConfig

Name	Type	Description	Example
FillMode	String	The fill mode. Set this parameter to none for the frontend.	none
PositionRefer	String	The reference point for the position of the element. Valid values: TopLeft, TopRight, BottomLeft, and BottomRight.	TopLeft
PositionNormalized	Float	The normalized position of the fill area for the layer element. The value is in the [x,y] format. The values of x and y range from 0 to 1. For example, [0.1, 0.1] indicates a horizontal offset of 10% and a vertical offset of 10% from the top-left corner.	[0.1, 0.1]
SizeNormalized	Float	The size of the fill area for the layer element. The value is in the [w,h] format. The values of w and h range from 0 to 1. Both the width and height are normalized. For example, [0.2, 0.3] indicates a horizontal proportion of 20% and a vertical proportion of 30%.	[0.2, 0.3]

PlayConfig

Name	Type	Description	Example
VolumeRate	Float	The volume. The value ranges from 0 to 1, accurate to two decimal places.	0.50

MonitorConfig

Name	Type	Description	Example
fpsLowThres	Float	The alert threshold for the video frame rate. This threshold is a coefficient. The value must be in the (0.0, 1.0] range. The default value is 0.7. An alert is triggered if the video frame rate of the monitored stream is less than (alert threshold × original frame rate of the live stream).	0.7
brHighThres	Float	The alert threshold for the audio and video bitrate. This threshold is a coefficient. The value must be in the (0.0, 100] range. The default value is 1.0. An alert is triggered if the audio and video bitrate of the monitored stream is greater than (alert threshold × original bitrate of the live stream).	1.0
eofDurationThresSec	Float	The threshold for stream interruption detection, in seconds. An alert is triggered if the monitored stream is interrupted for a duration longer than this threshold. The value must be in the (0, 65535] range. The default value is 0. After a stream is interrupted, the connection remains active. The system determines that the stream is interrupted if a packet receipt timeout of 5 s occurs. Therefore, if you set this parameter to a value less than or equal to 5 s, the actual detection time is 5 s. If you set this parameter to a value greater than 5 s, the actual detection time is the value you set. The first 5 s are for the internal packet receipt timeout, and the remaining time is the duration for which the system waits for the stream to resume. If the stream resumes before the timeout period expires, no alert is triggered. If you change the monitoring address before the stream times out, the system stops detecting the timeout and does not trigger an alert for the previous stream.	10

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	5c6a2a0d-f228-4a64-af62-20e91b9676b3

Examples

Success response

JSON format

{
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b9676b3"
}

Error codes

HTTP status code	Error code	Error message
400	InvalidUserId.Malformed	%s
400	InvalidParameter.Malformed	%s
400	MissingParameter	%s
400	InvalidMonitorId.Malformed	%s
401	IllegalOperation	%s
500	InternalError	%s
404	InvalidDomainName.NotFound	%s
404	StreamMonitorNotExist	%s

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.