UpdateWaterMarkTemplate - - Centre de documentation Alibaba Cloud

Met à jour le nom et les configurations d'un modèle de filigrane spécifié.

Description de l'opération

Vous pouvez appeler cette opération pour mettre à jour les informations d'un modèle de filigrane en fonction de l'identifiant du modèle de filigrane. Par exemple, vous pouvez mettre à jour le nom et les configurations d'un modèle de filigrane.
Un modèle de filigrane ne peut pas être mis à jour s'il est utilisé par une tâche qui a été soumise.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde et par compte. Les requêtes qui dépassent cette limite sont rejetées et vous subirez des interruptions de service. Nous vous recommandons de prendre en compte cette limite lors de l'appel de cette opération. Pour plus d'informations, consultez Limite de QPS.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

mts:UpdateWaterMarkTemplate

update

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
WaterMarkTemplateId	string	Oui	L'identifiant du modèle de filigrane que vous souhaitez mettre à jour. Pour obtenir l'identifiant du modèle de filigrane, vous pouvez vous connecter à la console ApsaraVideo Media Processing (MPS) et choisir Paramètres globaux > Modèles de filigrane dans le volet de navigation de gauche.	3780bd69b2b74540bc7b1096f564****
Name	string	Oui	Le nouveau nom du modèle de filigrane. La valeur peut contenir des lettres et des chiffres et sa taille peut atteindre 128 octets.	example-watermark-****
Config	string	Oui	La configuration mise à jour du modèle de filigrane. La valeur est un objet JSON. Pour plus d'informations, consultez Détails des paramètres.	{"Width":"10","Height":"30","Dx":"10","Dy":"5","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
WaterMarkTemplate	object	Les détails du modèle de filigrane.
Type	string	Le type de filigrane. Valeurs valides : Image : un filigrane image. Text : un filigrane texte. Remarque Seuls les filigranes de type Image sont pris en charge.	Image
RatioRefer	object	Les valeurs des paramètres Height, Width, Dx et Dy par rapport aux bords de référence. Si les valeurs des paramètres Height, Width, Dx et Dy sont des décimales comprises entre 0 et 1, les valeurs sont calculées en se référant aux bords suivants dans l'ordre : Width : le bord de la largeur. Height : le bord de la hauteur. Long : le bord long. Short : le bord court.
Dx	string	The horizontal offset of the watermark relative to the output video image. Default value: 0. The default value indicates no offset. The value can be an integer or a decimal. Integer: the vertical offset. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the horizontal offset to the width of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.51
Width	string	The width of the watermark image in the output video. The value can be an integer or a decimal. Integer: the width of the watermark image. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the width of the watermark image to the width of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.36
Height	string	The height of the watermark image in the output video. The value can be an integer or a decimal. Integer: the height of the watermark image. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the height of the watermark image to the height of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.33
Dy	string	The vertical offset of the watermark relative to the output video image. Default value: 0. The default value indicates no offset. The value can be an integer or a decimal. Integer: the vertical offset. This indicates the absolute position. Unit: pixel. Decimal: the ratio of the vertical offset to the height of the output video. The ratio varies based on the size of the video. Four decimal places are supported, such as 0.9999. More decimal places are discarded.	0.28
ReferPos	string	La position du filigrane. Valeurs valides : TopRight : le coin supérieur droit. TopLeft : le coin supérieur gauche. BottomRight : le coin inférieur droit. BottomLeft : le coin inférieur gauche.	TopRight
State	string	L'état du modèle de filigrane. Valeur par défaut : Normal.	Normal
Dx	string	Le décalage horizontal. Unité : pixel.	10
Width	string	La largeur de l'image du filigrane. Unité : pixel.	10
Height	string	La hauteur de l'image du filigrane. Unité : pixel.	30
Timeline	object	La chronologie du filigrane.
Start	string	The beginning of the time range during which the watermark is displayed. Unit: seconds. Default value: 0.	0
Duration	string	The display duration of the watermark. Default value: ToEND. The default value indicates that the watermark is displayed until the video ends.	10
Name	string	Le nom du modèle de filigrane.	example-watermark-****
Dy	string	Le décalage vertical. Unité : pixel.	5
Id	string	L'identifiant du modèle de filigrane. Nous vous recommandons de conserver cet identifiant pour les appels d'opérations ultérieurs.	3780bd69b2b74540bc7b1096f564****
RequestId	string	L'identifiant de la requête.	E558894E-40D9-57C6-B5CC-0F5CDF23614E

Exemples

JSON format

{
  "WaterMarkTemplate": {
    "Type": "Image",
    "RatioRefer": {
      "Dx": "0.51",
      "Width": "0.36",
      "Height": "0.33",
      "Dy": "0.28"
    },
    "ReferPos": "TopRight",
    "State": "Normal",
    "Dx": "10",
    "Width": "10",
    "Height": "30",
    "Timeline": {
      "Start": "0",
      "Duration": "10"
    },
    "Name": "example-watermark-****",
    "Dy": "5",
    "Id": "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId": "E558894E-40D9-57C6-B5CC-0F5CDF23614E"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.