UpdateWatermark - - Centre de documentation Alibaba Cloud

Modifie un filigrane.

Remarque

Vous ne pouvez modifier que le nom et la configuration d'un filigrane.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	UpdateWatermark	Opération à effectuer. Définissez la valeur sur UpdateWatermark.
Name	String	Oui	test	Nom du filigrane. Seuls les lettres et les chiffres sont acceptés. La longueur du nom ne peut pas dépasser 128 octets. La valeur doit être encodée en UTF-8.
WatermarkConfig	String	Oui	{"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}	Configuration telle que la position et l'effet du filigrane textuel ou image. La valeur est une chaîne au format JSON. Remarque La valeur de ce paramètre varie selon le type de filigrane. Pour plus d'informations sur la structure des données, consultez la section « WatermarkConfig » de la rubrique Paramètres de traitement multimédia.
WatermarkId	String	Oui	af2afe4761992c*****bd947dae97337	ID du filigrane.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID de la requête.
WatermarkInfo	Struct		Informations relatives au filigrane.
CreationTime	String	2018-11-06T08:03:17Z	Heure d'ajout du filigrane. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
FileUrl	String	https://outin-32**9f4b3e7.oss-cn-shanghai.aliyuncs.com/image/cover/E6C3448CC8B715E6F8A72EC6B-6-2.png?Expires=1541600583&OSSAccessKeyId=&Signature=gmf1eYMoDVg%2BHQCb4UGozBW**	URL Object Storage Service (OSS) ou Content Delivery Network (CDN) du fichier de filigrane. Un filigrane textuel ne possède pas d'URL de fichier.
IsDefault	String	NotDefault	Indique si le filigrane est celui par défaut. Valeurs possibles : Default : le filigrane est celui par défaut. NotDefault : le filigrane n'est pas celui par défaut.
Name	String	Image watermark test	Nom du filigrane.
Type	String	Text	Type de filigrane. Valeurs possibles : Image : il s'agit de la valeur par défaut. Text
WatermarkConfig	String	{"Width":"55","Height":"55","Dx":"9","Dy":"9","ReferPos":"BottonLeft","Type":"Image"}	Configuration telle que la position et l'effet du filigrane textuel ou image. La valeur est une chaîne au format JSON. Remarque La valeur de ce paramètre varie selon le type de filigrane. Pour plus d'informations sur la structure des données, consultez la section « WatermarkConfig » de la rubrique Paramètres de traitement multimédia.
WatermarkId	String	505e2e287ea*****ecfddd386d384	ID du filigrane.

Exemples

Exemple de requête

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
&<Common request parameters>

Exemple de réponse réussie

Format XML

<UpdateWatermarkResponse>
  <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
  <WatermarkInfo>
        <Name>Image watermark test</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>

Format JSON

{
 "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
 "WatermarkInfo":{
    "Name": "Image watermark test",
    "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"
    }
  }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.

Exemples de SDK

Nous vous recommandons d'utiliser les SDK côté serveur pour appeler cette opération. Cliquez sur les liens suivants pour consulter des exemples de code dans différents langages :