调用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) 匹配所有后缀为t1或t2的流 (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****"
}

错误码

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