调用AddLiveStreamWatermarkRule添加水印规则。

使用说明

调用AddLiveStreamWatermark接口添加水印模板后,可使用本接口添加水印规则。

QPS限制

本接口的单用户QPS限制为60次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddLiveStreamWatermarkRule

系统规定参数。取值:AddLiveStreamWatermarkRule

Name String WatermarkRule****

自定义规则名称。

Domain String example.aliyundoc.com

播流域名。

App String liveApp****

播流所属应用名称。

Stream String liveStreamA

流名称。规则如下:

  • 直接写流名称则仅匹配该流名称。示例:liveStreamA。
  • 可进行模糊匹配,*匹配所有流。
  • 可进行前匹配和后匹配。
重要
  • 模糊匹配格式说明:模糊匹配下的*要求有且仅有一个,只能在最前或最后,且匹配项需要()包围,多个匹配项用竖线|分隔。
  • 示例:*(t1|t2) 匹配所有后缀为t1t2的流 (abc|123)*匹配所有前缀为abc或者123的流。
TemplateId String 445409ec-7eaa-461d-8f29-4bec2eb9****

水印模板ID。

说明 可查看AddLiveStreamWatermark接口返回参数值获取TemplateId。
Description String my rule

自定义规则描述信息。

返回数据

名称 类型 示例值 描述
RuleId String 445409ec-7eaa-461d-8f29-4bec2eb9****

水印规则ID。

RequestId String 5c6a2a0df228-4a64-af62-20e91b9676b3

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=AddLiveStreamWatermarkRule
&App=liveApp****
&Domain=example.aliyundoc.com
&Name=WatermarkRule****
&Stream=liveStreamA
&TemplateId=445409ec-7eaa-461d-8f29-4bec2eb9****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AddLiveStreamWatermarkRuleResponse>
<RequestId>5c6a2a0df228-4a64-af62-20e91b9676b3</RequestId>
<RuleId>445409ec-7eaa-461d-8f29-4bec2eb9****</RuleId>
</AddLiveStreamWatermarkRuleResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "5c6a2a0df228-4a64-af62-20e91b9676b3",
  "RuleId" : "445409ec-7eaa-461d-8f29-4bec2eb9****"
}

错误码

访问错误中心查看更多错误码。