全部产品
云市场

修改水印

更新时间:2019-05-15 18:02:04

描述

更新水印数据。

注意:目前只支持水印名称、水印配置的更新。

请求参数

参数名称 参数类型 必填项 描述
Action String 接口名称,取值:UpdateWatermark
WatermarkId String 水印ID
WatermarkConfig WatermarkConfig 水印显示位置、效果等配置(JSON字符串)。不同的水印类型对应不同的WatermarkConfig内容。
Name String 水印名称。只支持中英文、数字。
  • 长度不超过128个字节。
  • UTF-8编码。

返回参数

参数名称 参数类型 描述
RequestId String 请求ID
WatermarkInfo WatermarkInfo 水印信息

API示例

请求示例

  1. https://vod.cn-shanghai.aliyuncs.com?Action=UpdateWatermark&Type=Image&Name=test&WatermarkId=aasaassa&WatermarkConfig={"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}

返回示例

JSON格式

  • 文字水印
  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "WatermarkInfo": {
  4. "Name": "文字水印测试",
  5. "CreationTime": "2018-11-07T09:05:52Z",
  6. "IsDefault": "NotDefault",
  7. "Type": "Text",
  8. "WatermarkId": "9bcc8bfadb843f475c109a2671d0df97",
  9. "WatermarkConfig": {
  10. "FontColor": "Blue",
  11. "FontSize": 80,
  12. "Content": "水印测试"
  13. }
  14. }
  15. }
  • 图片水印

    1. {
    2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
    3. "WatermarkInfo":{
    4. "Name": "图片水印测试",
    5. "CreationTime": "2018-11-06T08:03:17Z",
    6. "WatermarkId": "505e2e287ea49c40f8cecfddd386d384",
    7. "FileUrl": "https://outin-3262681cdde111e89f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=XXXXXX&Signature=gmf1eYMoDVg%2BHQCb4UGozBW4xZo%3D",
    8. "IsDefault": "NotDefault",
    9. "Type": "Image",
    10. "WatermarkConfig": {
    11. "ReferPos": "BottomRight",
    12. "Height": "55",
    13. "Width": "55",
    14. "Dx": "8",
    15. "Dy": "8"
    16. }
    17. }
    18. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码表

错误代码 错误信息 HTTP 状态码 说明
NoSuchResource The specified resource %s does not exist. 404 用户相关的资源数据不存在, %s表示具体资源信息。

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: