首页 >视频点播 >API参考指南 >API目录 >媒体处理 >视频水印 >UpdateWatermark - 修改水印

UpdateWatermark - 修改水印

调用UpdateWatermark更新水印数据。

接口说明

说明目前仅支持水印名称、水印配置的更新。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Namestring

水印名称。只支持中英文、数字。

  • 长度不超过128个字节。
  • UTF-8编码。
test
WatermarkIdstring

水印ID。

af2afe4761992c*****bd947dae97337
WatermarkConfigstring

水印显示位置、效果等配置(JSON字符串):文字水印、图片水印。

说明不同的水印类型对应不同的WatermarkConfig内容。参数结构详情,请参见WatermarkConfig
{"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}

返回参数

名称类型描述示例值
object
RequestIdstring

请求ID。

25818875-5F78-4A*****F6-D7393642CA58
WatermarkInfoobject

水印信息。

CreationTimestring

水印创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

2018-11-06T08:03:17Z
Typestring

水印类型。

  • Image(默认):图片。
  • Text:文字。
Text
IsDefaultstring

是否是默认水印。

  • Default:默认水印。
  • NotDefault:非默认水印。
NotDefault
FileUrlstring

水印文件的URL(OSS地址或CDN地址),文字水印没有文件地址信息。

https://outin-32****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****
WatermarkConfigstring

水印显示位置、效果等配置(JSON字符串):文字水印、图片水印。

说明不同的水印类型对应不同的WatermarkConfig内容。参数结构详情,请参见WatermarkConfig
{"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}
Namestring

水印名称。

图片水印测试
WatermarkIdstring

水印ID。

505e2e287ea*****ecfddd386d384

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=UpdateWatermark
&Name=test
&WatermarkConfig={"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}
&WatermarkId=af2afe4761992c*****bd947dae97337
&<公共请求参数>

正常返回示例

JSON格式

{
 "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
 "WatermarkInfo":{
    "Name": "图片水印测试",
    "CreationTime": "2018-11-06T08:03:17Z",
    "WatermarkId": "505e2e287ea*****ecfddd386d384",
    "FileUrl": "https://outin-32****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=****&Signature=gmf1eYMoDVg%2BHQCb4UGozBW****",
    "IsDefault": "NotDefault",
    "Type": "Image",
    "WatermarkConfig": {
      "ReferPos": "BottomRight",
      "Height": "55",
      "Width": "55",
      "Dx": "8",
      "Dy": "8"
    }
  }
}

XML格式

<UpdateWatermarkResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
<WatermarkInfo>
    <Name>图片水印测试</Name>
    <CreationTime>2018-11-06T08:03:17Z</CreationTime>
    <WatermarkId>505e2e287ea*****ecfddd386d384</WatermarkId>
    <FileUrl>https://outin-32****9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&amp;OSSAccessKeyId=****&amp;Signature=gmf1eYMoDVg%2BHQCb4UGozBW****</FileUrl>
    <IsDefault>NotDefault</IsDefault>
    <Type>Image</Type>
    <WatermarkConfig>
        <ReferPos>BottomRight</ReferPos>
        <Height>55</Height>
        <Width>55</Width>
        <Dx>8</Dx>
        <Dy>8</Dy>
    </WatermarkConfig>
</WatermarkInfo>
</UpdateWatermarkResponse>

错误码

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

阿里云首页 视频点播 相关技术圈