UpdateTemplate - - Centre de documentation Alibaba Cloud

Prenez note des points suivants :

Si vous spécifiez le paramètre TemplateBody ou TemplateURL, le numéro de version est automatiquement incrémenté de 1 après la mise à jour du modèle. Par exemple, la version passe de v1 à v2.
Si vous ne spécifiez ni le paramètre TemplateBody ni le paramètre TemplateURL, le numéro de version reste inchangé.
Un modèle peut comporter jusqu'à 100 versions. Si cette limite est atteinte, la mise à jour du modèle échoue. Vous devez créer un autre modèle.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. 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	UpdateTemplate	Opération à effectuer. Définissez la valeur sur UpdateTemplate.
TemplateId	String	Oui	5ecd1e10-b0e9-4389-a565-e4c15efc****	ID du modèle. Ce paramètre s'applique aux modèles partagés et privés.
TemplateURL	String	Non	oss://ros/template/demo	URL du fichier contenant le corps du modèle. L'URL doit pointer vers un modèle hébergé sur un serveur web HTTP ou HTTPS, ou dans un compartiment OSS Alibaba Cloud. Exemples : oss://ros/template/demo et oss://ros/template/demo?RegionId=cn-hangzhou. La taille du modèle ne doit pas dépasser 524 288 octets et celle de l'URL 1 024 octets. Remarque Si la région du compartiment OSS n'est pas spécifiée, la valeur RegionId est utilisée par défaut. Vous ne pouvez spécifier qu'un seul des paramètres TemplateBody ou TemplateURL.
TemplateName	String	Non	MyTemplate	Nom du modèle. Le nom peut contenir jusqu'à 255 caractères, y compris des chiffres, des lettres, des traits d'union (-) et des traits de soulignement (_). Il doit commencer par un chiffre ou une lettre.
Description	String	Non	It is a demo.	Description du modèle. Elle peut contenir jusqu'à 256 caractères.
TemplateBody	String	Non	{"ROSTemplateFormatVersion":"2015-09-01"}	Structure contenant le corps du modèle. La taille du corps du modèle doit être comprise entre 1 et 524 288 octets. Si la taille du corps du modèle dépasse la limite autorisée, nous vous recommandons d'ajouter les paramètres au corps de la requête HTTP POST pour éviter les échecs dus à une URL trop longue. Vous ne pouvez spécifier qu'un seul des paramètres TemplateBody ou TemplateURL.

Pour plus d'informations sur les paramètres de requête communs, consultez la rubrique Paramètres communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	8C5D90E1-66B6-496C-9371-3807F8DA80A8	ID de la requête.
TemplateId	String	5ecd1e10-b0e9-4389-a565-e4c15efc****	ID du modèle.

Exemples

Exemples de requêtes

http(s)://ros.aliyuncs.com/? Action=UpdateTemplate
&TemplateId=5ecd1e10-b0e9-4389-a565-e4c15efc****
&<Common request parameters>

Exemples de réponses

Format XML

<UpdateTemplateResponse>
		  <RequestId>8C5D90E1-66B6-496C-9371-3807F8DA80A8</RequestId>
		  <TemplateId>5ecd1e10-b0e9-4389-a565-e4c15efc****</TemplateId>
</UpdateTemplateResponse>

Format JSON

{
    "RequestId": "8C5D90E1-66B6-496C-9371-3807F8DA80A8",
    "TemplateId": "5ecd1e10-b0e9-4389-a565-e4c15efc****"
}

Codes d'erreur

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

Code HTTP	Code d'erreur	Message d'erreur	Description
404	TemplateNotFound	The Tempalte ({ ID }) could not be found.	Le modèle spécifié n'existe pas.
400	InvalidSchema	{reason}.	Le format du modèle spécifié n'est pas valide. La variable reason indique la raison spécifique.
400	InvalidTemplateAttribute	The Referenced Attribute ({resource} {name}) is incorrect.	L'attribut de ressource référencé dans le modèle est incorrect. La variable resource indique le nom de la ressource et name le nom de l'attribut.
400	InvalidTemplatePropertyType	The specified value type of ({resource} {section}) is incorrect.	Le type de la section de ressource spécifiée dans le modèle est incorrect. La variable resource indique le nom de la ressource et section le nom de la section.
400	InvalidTemplateReference	The specified reference "{name}" (in {referencer}) is incorrect.	Le modèle contient une référence non valide. La variable name indique le nom de la référence et referencer le nom de l'élément référençant.
400	InvalidTemplateSection	The template section is invalid: {section}.	Le modèle contient une section non valide. La variable section indique le nom de la section.
400	InvalidTemplateVersion	The template version is invalid: {reason}.	La version du modèle est incorrecte. La variable reason indique la raison spécifique.
400	TemplateBeingProcessed	Template { ID } is being processed, retry later.	Une action est en cours sur le modèle spécifié. Réessayez ultérieurement. La variable ID indique l'ID du modèle.