All Products
Search
Document Center

UpdateWatermark

Last Updated: Jul 11, 2019

Description

You can call this operation to modify a watermark.

Note: Currently, you can only modify the name and configuration of a watermark.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set this parameter to UpdateWatermark.
WatermarkId String Yes The ID of the watermark.
WatermarkConfig WatermarkConfig Yes The watermark configurations, such as the display position and effects. The value is a JSON-formatted string. The value of WatermarkConfig varies, depending on the value of the Type parameter.
Name String No The name of the watermark. You can only enter English letters and digits.
  • Length constraint: Maximum length of 128 bytes.
  • Encoding: UTF-8.

Response parameters

Parameter Type Description
RequestId String The ID of the request.
WatermarkInfo WatermarkInfo The watermark information.

API examples

Sample request

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"}

Sample response

JSON format

  • Text watermark
{
    "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
      "WatermarkInfo": {
          "Name": "Text watermark test",
          "CreationTime": "2018-11-07T09:05:52Z",
          "IsDefault": "NotDefault",
          "Type": "Text",
          "WatermarkId": "9bcc8bfadb843f475c109a2671d0df97",
          "WatermarkConfig": {
            "FontColor": "Blue",
            "FontSize": 80,
            "Content": "Watermark test"
          }
      }
 }
  • Image watermark
{
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "WatermarkInfo":{
     "Name": "Image watermark test",
     "CreationTime": "2018-11-06T08:03:17Z",
     "WatermarkId": "505e2e287ea49c40f8cecfddd386d384",
     "FileUrl": "https://outin-3262681cdde111e89f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=XXXXXX&Signature=gmf1eYMoDVg%2BHQCb4UGozBW4xZo%3D",
     "IsDefault": "NotDefault",
     "Type": "Image",
     "WatermarkConfig": {
       "ReferPos": "BottomRight",
       "Height": "55",
       "Width": "55",
       "Dx": "8",
       "Dy": "8"
     }
   }
 }

Error codes

This operation also returns common errors. For more information about errors common to all operations, see common errors.

Error code Error message HTTP status code Description
NoSuchResource The specified resource %s does not exist. 404 The error message returned because the user-related resource data does not exist, where %s indicates the specific resource information.

SDK examples

We recommend that you use a server SDK to call this operation. For more information about the sample code used to call this operation in various languages, see the following topics: