All Products
Search
Document Center

ApsaraVideo Live:UpdateRtcMPUEventSub

Last Updated:Nov 14, 2024

Updates a subscription to mixed-stream relay events.

Operation description

Usage notes

  • You can call this operation to update a subscription to mixed-stream relay events. You can update parameters such as callback URLs and channel information.
  • Before you call this operation, make sure that you have called the CreateRtcMPUEventSub operation to create the subscription.

QPS limit

You can call this operation up to 50 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.

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

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
AppIdstringYes

The ID of the application.

Note The ID can be up to 64 characters in length and can contain letters, digits, underscores (_), and hyphens (-).
yourAppId
ChannelIdsstringNo

The ID of the channel to which you want to send mixed-stream relay event callbacks. Separate multiple channel IDs with commas (,).

Note
  • If you leave this parameter empty, you are subscribed to all mixed-stream relay events submitted in the application.

  • You cannot specify duplicate channel IDs. You can specify up to 20 channel IDs in each call.

  • The ID can be up to 64 characters in length and contain letters, digits, underscores (_), and hyphens (-).

yourChannelIds
CallbackUrlstringNo

The callback URL.

Note You can use headers such as HTTP and HTTPS in callback URLs. The URL can be up to 2,083 characters and contain letters, digits, and the following special characters: - _ ? % = # . / +
http://****.com/callback

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

******3B-0E1A-586A-AC29-742247******

Examples

Sample success responses

JSONformat

{
  "RequestId": "******3B-0E1A-586A-AC29-742247******"
}

Error codes

HTTP status codeError codeError message
400InvalidParam%s
400InvalidAppId%s
403OperationDeniedYour account has not enabled the Live service
403Forbidden%s
404MissingParam%s
500InternalErrorInternalError

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

Change history

Change timeSummary of changesOperation
2024-07-04The Error code has changedView Change Details