Dynamically updates a watermark.

Usage note

Dynamically updating a watermark means replacing the watermark template ID during live streaming.

Before you call this operation to update a watermark, you must prepare the watermark template ID that is used for replacement. The watermark template ID is specified by the TemplateId parameter of this operation.

QPS limit

You can call this operation up to 60 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 limit on an API operation in ApsaraVideo Live.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DynamicUpdateWaterMarkStreamRule

The operation that you want to perform. Set the value to DynamicUpdateWaterMarkStreamRule.

App String Yes liveApp****

The name of the application to which the live stream belongs.

Domain String Yes pull.aliyundoc.com

The main streaming domain.

Stream String Yes liveStream****

The name of the stream that contains the watermark.

TemplateId String Yes 749b7594-86d6-37b1-513b-e1e19845****

The watermark template ID.

Note The TemplateId parameter is used to replace the watermark template ID during live streaming.

Response parameters

Parameter Type Example Description
RequestId String BE9407FF-F897-4DBD-338D-98A750AD805F

The ID of the request.

Examples

Sample requests

http(s)://live.aliyuncs.com/?Action=DynamicUpdateWaterMarkStreamRule
&App=liveApp****
&Domain=pull.aliyundoc.com
&Stream=liveStream****
&TemplateId=749b7594-86d6-37b1-513b-e1e19845****
&<Common request parameters>

Sample success responses

XML format 

<DynamicUpdateWaterMarkStreamRuleResponse>
  <RequestId>BE9407FF-F897-4DBD-338D-98A750AD805F</RequestId>
</DynamicUpdateWaterMarkStreamRuleResponse>

JSON format 

{
    "RequestId": "BE9407FF-F897-4DBD-338D-98A750AD805F"
}

Error codes

For a list of error codes, visit the API Error Center.