UpdateTemplateScratch - - Centre de documentation Alibaba Cloud

Met à jour un scénario.

Description de l'opération

Scénario de réplication de ressources

Resource Orchestration Service (ROS) vous permet de mettre à jour un scénario de réplication de ressources. Les mises à jour apportées à un scénario de réplication de ressources n'affectent pas la pile générée à l'aide du scénario de ressources. Vous pouvez appeler l'opération GenerateTemplateByScratch pour générer un modèle pour le scénario de ressources.

Scénario de migration de ressources

Si vous souhaitez mettre à jour un scénario de migration de ressources dans lequel les ressources source migrées sont conservées, vous pouvez supprimer les ressources source pour gérer le scénario de migration de ressources mis à jour. Vous pouvez également appeler l'opération GenerateTemplateByScratch pour générer un modèle pour le scénario de ressources.

**

Remarque Assurez-vous que les ressources source que vous souhaitez supprimer d'un scénario de migration de ressources sont associées uniquement au scénario de ressources. Sinon, la suppression des ressources source échoue.
Si vous souhaitez mettre à jour un scénario de migration de ressources dans lequel les ressources source migrées sont supprimées, vous pouvez uniquement appeler l'opération GenerateTemplateByScratch pour générer un modèle pour le scénario de ressources.

Scénario de gestion des ressources

Si vous souhaitez mettre à jour un scénario de gestion des ressources après avoir utilisé le scénario de ressources pour gérer des ressources, vous pouvez uniquement appeler l'opération GenerateTemplateByScratch pour générer un modèle pour le scénario de ressources.

Scénario de détection de ressources

Après la mise à jour d'un scénario de détection de ressources, ROS obtient les données les plus récentes depuis Resource Center et génère le diagramme d'architecture.

Cette rubrique fournit un exemple de mise à jour d'un scénario de ressources. Dans cet exemple, l'identifiant d'un cloud privé virtuel (VPC) dans un scénario de ressources dont l'identifiant est ts-7f7a704cf71c49a6**** est mis à jour vers vpc-bp1m6fww66xbntjyc****.

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.

ros:UpdateTemplateScratch

update

*TemplateScratch

acs:ros:{#regionId}:{#accountId}:templatescratch/{#templatescratchId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région du scénario. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.	cn-hangzhou
TemplateScratchId	string	Oui	L'identifiant du scénario de ressources. Les valeurs valides des paramètres de requête ParameterKey et ParameterValue varient en fonction des identifiants des différents types de scénarios de ressources. Pour plus d'informations, consultez la section « Informations supplémentaires sur les paramètres de requête » de cette rubrique. Remarque Vous pouvez appeler l'opération ListTemplateScratches pour interroger l'identifiant d'un scénario de ressources.	ts-7f7a704cf71c49a6****
Description	string	Non	La description du scénario.	Copier les ressources VPC
SourceResources	array<object>	Non	Les ressources source. Remarque Vous ne devez spécifier qu'un seul des paramètres suivants : SourceResources, SourceTag et SourceResourceGroup.
	object	Non	La ressource source.
ResourceId	string	Oui	L'identifiant de la ressource.	vpc-bp1m6fww66xbntjyc****
ResourceType	string	Oui	Le type de ressource.	ALIYUN::ECS::VPC
SourceTag	object	Non	La balise source. Remarque Vous ne devez spécifier qu'un seul des paramètres suivants : SourceResources, SourceTag et SourceResourceGroup.
ResourceTags	object	Oui	Les balises source. Une balise contient une clé de balise et une valeur de balise. Si vous souhaitez spécifier uniquement la clé de balise, vous devez laisser la valeur de balise vide. Exemple : {"TagKey": ""}. Si vous définissez TemplateScratchType sur ArchitectureDetection, vous pouvez ajouter jusqu'à 5 balises source. Dans les autres cas, vous pouvez ajouter jusqu'à 10 balises source.	{"a": "b"}
ResourceTypeFilter	array	Non	Les types de ressources pour le filtrage des ressources.
	string	Non	Le type de ressource pour le filtrage des ressources. Si vous spécifiez les types de ressources, ROS analyse uniquement les ressources qui sont des types spécifiés et qui possèdent les balises spécifiées. Si vous ne spécifiez pas les types de ressources, ROS analyse toutes les ressources qui possèdent les balises spécifiées. Vous pouvez spécifier jusqu'à 20 types de ressources.	ALIYUN::ECS::VPC
SourceResourceGroup	object	Non	Le groupe de ressources source. Remarque Vous ne devez spécifier qu'un seul des paramètres suivants : SourceResources, SourceTag et SourceResourceGroup.
ResourceGroupId	string	Oui	L'identifiant du groupe de ressources source.	rg-acfmzawhxxc****
ResourceTypeFilter	array	Non	Les types de ressources pour le filtrage des ressources.
	string	Non	Le type de ressource pour le filtrage des ressources. Si vous spécifiez les types de ressources, ROS analyse uniquement les ressources qui sont des types spécifiés et qui appartiennent au groupe de ressources spécifié. Si vous ne spécifiez pas les types de ressources, ROS analyse toutes les ressources qui appartiennent au groupe de ressources spécifié. Vous pouvez spécifier jusqu'à 20 types de ressources.	ALIYUN::ECS::VPC
PreferenceParameters	array<object>	Non	Les paramètres de préférence du scénario de ressources.
	object	Non	Le paramètre de préférence du scénario.
ParameterKey	string	Oui	Le nom du paramètre. Pour plus d'informations sur les valeurs valides de ParameterKey, consultez la section « Informations supplémentaires sur les paramètres de requête » de cette rubrique. Remarque PreferenceParameters est facultatif. Si vous spécifiez PreferenceParameters, vous devez spécifier à la fois ParameterKey et ParameterValue. Si vous définissez TemplateScratchType sur ResourceImport, vous devez définir ParameterKey sur DeletionPolicy.	DeletionPolicy
ParameterValue	string	Oui	La valeur du paramètre. La valeur de ParameterValue varie en fonction de la valeur de ParameterKey. Pour plus d'informations sur les valeurs valides de ParameterKey, consultez la section « Informations supplémentaires sur les paramètres de requête » de cette rubrique. Remarque PreferenceParameters est facultatif. Si vous spécifiez PreferenceParameters, vous devez spécifier à la fois ParameterKey et ParameterValue.	Retain
LogicalIdStrategy	string	Non	La stratégie basée sur laquelle l'identifiant logique est généré. Valeurs valides : LongTypePrefixAndIndexSuffix : préfixe de type long + suffixe de type index LongTypePrefixAndHashSuffix : préfixe de type long + suffixe de type hachage ShortTypePrefixAndHashSuffix : préfixe de type court + suffixe de type hachage Remarque Si vous définissez TemplateScratchType sur ArchitectureDetection, la valeur par défaut de LogicalIdStrategy est LongTypePrefixAndHashSuffix. Dans les autres cas, la valeur par défaut de LogicalIdStrategy est LongTypePrefixAndIndexSuffix.	LongTypePrefixAndIndexSuffix
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	123e4567-e89b-12d3-a456-42665544****
ExecutionMode	string	Non	Le mode d'exécution. Valeurs valides : Async (par défaut) Sync Remarque Si vous avez un large périmètre de ressources, Sync prend plus de temps. Si vous définissez ExecutionMode sur Sync, nous vous recommandons de spécifier ClientToken pour éviter le délai d'expiration de l'exécution.	Sync
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfmxazb4ph6aiy****

Informations supplémentaires sur les paramètres de requête

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

Les valeurs valides des paramètres de requête ParameterKey et ParameterValue varient en fonction des types de scénarios de ressources.

Scénario de réplication de ressources

Le tableau suivant décrit les valeurs valides des paramètres de requête ParameterKey et ParameterValue lorsque vous définissez TemplateScratchId sur l'identifiant d'un scénario de réplication de ressources.

ParameterKey	ParameterValue
DeletionPolicy	La stratégie de suppression des ressources. Valeurs valides : Retain : conserve les ressources lorsque vous supprimez la pile vers laquelle les ressources sont répliquées.Delete : supprime les ressources par défaut lorsque vous supprimez la pile vers laquelle les ressources sont répliquées. Si vous conservez des ressources spécifiques lorsque la boîte de dialogue Supprimer la pile s'affiche, les ressources sont conservées.
RegionId	L'identifiant de la région de destination vers laquelle vous souhaitez répliquer les ressources. Si vous laissez ce paramètre vide, la région des ressources source est utilisée pour les ressources répliquées.Exemple : cn-shanghai.
ZoneId	L'identifiant de la zone de destination vers laquelle vous souhaitez répliquer les ressources. Si vous répliquez des ressources dans la même région et que vous laissez ce paramètre vide, la zone des ressources source est utilisée pour les ressources répliquées. Si vous répliquez des ressources entre régions et que vous laissez ce paramètre vide, le système filtre les zones prises en charge par toutes les ressources.Exemple : cn-shanghai-b.
VpcId	L'identifiant du VPC de destination vers lequel vous souhaitez répliquer les ressources. Si vous répliquez des ressources dans la même région et que vous laissez ce paramètre vide, le VPC des ressources source est utilisé pour les ressources répliquées. Si vous répliquez des ressources entre régions et que vous laissez ce paramètre vide, le système crée automatiquement un VPC dans la région de destination.Exemple : vpc-bp1hye0s8b69xokfu****.
VSwitchId	L'identifiant du vSwitch de destination vers lequel vous souhaitez répliquer les ressources. Si vous répliquez des ressources dans la même région et que vous laissez ce paramètre vide, le vSwitch des ressources source est utilisé pour les ressources répliquées. Si vous répliquez des ressources entre régions et que vous laissez ce paramètre vide, le système crée automatiquement un vSwitch dans la région de destination.Exemple : vsw-bp11ufkwqwggtm1cj****.
InstanceDataReplication	Indique si les données d'instance Elastic Compute Service (ECS) doivent être répliquées. Valeurs valides :true : réplique les données d'instance ECS. Si vous répliquez les données dans la même région, le système crée une image personnalisée pour l'instance source et crée une instance basée sur l'image. Si vous répliquez les données entre régions, le système crée une image personnalisée pour l'instance source, réplique l'image vers la région de destination, puis crée une instance basée sur l'image.false : ne réplique pas les données d'instance ECS.

Remarque Si vous définissez ParameterKey sur InstanceDataReplication et ParameterValue sur true, nous vous recommandons de répliquer les ressources après l'arrêt de l'instance source. Cela garantit la cohérence des données.

Scénario de gestion des ressources

Remarque Pour un scénario de gestion des ressources, vous devez définir ParameterKey sur DeletionPolicy.

ParameterKey

ParameterValue

DeletionPolicy

La stratégie de suppression des ressources. Valeurs valides : Retain : conserve les ressources lorsque vous supprimez la pile que vous utilisez pour gérer les ressources.Delete : supprime les ressources par défaut lorsque vous supprimez la pile que vous utilisez pour gérer les ressources. Si vous conservez des ressources spécifiques lorsque la boîte de dialogue Supprimer la pile s'affiche, les ressources sont conservées.

Scénario de détection de ressources

ParameterKey	ParameterValue
RegionIds	Un ou plusieurs identifiants de région. Séparez plusieurs identifiants de région par des virgules (,). Si vous laissez ce paramètre vide, la région du scénario de ressources est utilisée. Vous ne pouvez pas spécifier à la fois RegionIds et SourceResources.

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	221DA822-B8CF-50DF-A9D2-BA197BF97BD5
TemplateScratchId	string	L'identifiant du scénario.	ts-7f7a704cf71c49a6****

Exemples

JSON format

{
  "RequestId": "221DA822-B8CF-50DF-A9D2-BA197BF97BD5",
  "TemplateScratchId": "ts-7f7a704cf71c49a6****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.