Met à jour un scénario.
Cette rubrique explique comment mettre à jour le scénario ts-7f7a704cf71c49a6**** créé dans la région Chine (Hangzhou). Dans cet exemple, l'ID du réseau privé virtuel (VPC) est mis à jour vers ts-7f7a704cf71c49a6****.
Débogage
Paramètres de requête
| Paramètre | Type | Obligatoire | Exemple | Description |
| Action | String | Oui | UpdateTemplateScratch | L'opération que vous souhaitez effectuer. Définissez la valeur sur UpdateTemplateScratch. |
| RegionId | String | Oui | cn-hangzhou | L'ID de la région où le scénario est créé. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes. |
| TemplateScratchId | String | Oui | ts-7f7a704cf71c49a6**** | L'ID du scénario. |
| Description | String | Non | Réplique un VPC. | La description du scénario. |
| SourceResources | Array | Non | La ressource source. | |
| ResourceId | String | Oui | vpc-bp1m6fww66xbntjyc**** | L'ID de la ressource. |
| ResourceType | String | Oui | ALIYUN::ECS::VPC | Le type de la ressource. |
| SourceTag | Object | Non | Le tag source. | |
| ResourceTags | Map | Oui | {"a": "b"} | Les tags sources constitués de paires clé-valeur. Pour spécifier uniquement la clé du tag, définissez sa valeur sur une chaîne vide. Exemple : {"TagKey": ""}. Vous pouvez configurer jusqu'à 10 tags sources. |
| ResourceTypeFilter | Array of String | Non | ALIYUN::ECS::VPC | Le filtre pour les types de ressources. Si vous spécifiez ce paramètre, seules les ressources des types spécifiés et portant les tags indiqués sont analysées. Sinon, toutes les ressources portant les tags spécifiés sont analysées. Vous pouvez spécifier jusqu'à 20 types de ressources. |
| SourceResourceGroup | Object | Non | Le groupe de ressources source. | |
| ResourceGroupId | String | Oui | rg-acfmzawhxxc**** | L'ID du groupe de ressources source. |
| ResourceTypeFilter | Array of String | Non | ALIYUN::ECS::VPC | Le filtre pour les types de ressources. Si vous spécifiez ce paramètre, seules les ressources des types spécifiés et appartenant aux groupes de ressources indiqués sont analysées. Sinon, toutes les ressources des groupes de ressources spécifiés sont analysées. Vous pouvez spécifier jusqu'à 20 types de ressources. |
| PreferenceParameters | Array | Non | Les paramètres configurés dans le scénario. | |
| ParameterKey | String | Oui | DeletionPolicy | Le nom d'un paramètre de requête. Pour plus d'informations sur ParameterKey, consultez Description supplémentaire des paramètres de requête. Remarque
|
| ParameterValue | String | Oui | Retain | La valeur d'un paramètre de requête. La valeur de ParameterValue varie en fonction de celle de ParameterKey. Pour plus d'informations sur ParameterValue, consultez Description supplémentaire des paramètres de requête. Remarque PreferenceParameters est facultatif. Si vous définissez PreferenceParameters, vous devez spécifier à la fois ParameterKey et ParameterValue. |
| LogicalIdStrategy | String | Non | LongTypePrefixAndIndexSuffix | La stratégie de génération de l'ID logique. Valeur par défaut : LongTypePrefixAndIndexSuffix. Valeurs valides :
|
| ClientToken | String | Non | 123e4567-e89b-12d3-a456-42665544**** | Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais assurez-vous qu'elle est unique parmi les différentes requêtes. Le jeton peut contenir jusqu'à 64 caractères, y compris des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_). Pour plus d'informations, consultez Comment garantir l'idempotence. |
| ExecutionMode | String | Non | Sync | Le mode d'exécution. Valeur par défaut : Async. Valeurs valides :
Remarque Si votre périmètre de ressources est large, le mode Sync prend plus de temps. Si vous définissez ExecutionMode sur Sync, nous vous recommandons de définir ClientToken pour éviter les dépassements de délai d'exécution. |
Description supplémentaire des paramètres de requête
Pour plus d'informations sur les paramètres de requête communs, consultez Paramètres communs.
Dans les paramètres de requête, les valeurs de ParameterKey et ParameterValue varient en fonction des types de scénarios.
-
Le tableau suivant décrit les valeurs de ParameterKey et ParameterValue dans le scénario de réplication de ressources.
ParameterKey
ParameterValue
DeletionPolicy
La politique de suppression des ressources. Valeurs valides :
- Retain : conserve les ressources. Si vous supprimez une pile après avoir répliqué des ressources vers celle-ci, les ressources sont conservées.
- Delete : supprime les ressources. Si vous supprimez une pile après avoir répliqué des ressources vers celle-ci, toutes les ressources sont supprimées par défaut. Si vous conservez certaines ressources lors de la suppression de la pile, seules les ressources dont vous n'avez plus besoin sont supprimées.
RegionId
La région de destination vers laquelle vous souhaitez répliquer la ressource. Si vous ne spécifiez pas de région de destination, la ressource est répliquée dans la région où se trouve la ressource source.
Exemple : cn-shanghai.
ZoneId
La zone de destination vers laquelle vous souhaitez répliquer la ressource. Si vous répliquez la ressource dans la même région mais ne spécifiez pas la zone de destination, la ressource est répliquée dans la zone où se trouve la ressource source. Si vous répliquez la ressource entre différentes zones, elle est répliquée dans une zone prise en charge par toutes les ressources.
Exemple : cn-shanghai-b.
VpcId
Le VPC de destination vers lequel vous souhaitez répliquer la ressource. Si vous répliquez la ressource dans la même région mais ne spécifiez pas le VPC de destination, la ressource est répliquée dans le VPC auquel appartient la ressource source. Si vous répliquez la ressource entre différentes régions, un nouveau VPC est créé dans la région de destination.
Exemple : vpc-bp1hye0s8b69xokfu****.
VSwitchId
Le vSwitch de destination. Si vous répliquez la ressource dans la même région mais ne spécifiez pas le vSwitch de destination, le vSwitch associé à la ressource source est utilisé. Si vous répliquez la ressource entre différentes régions, un nouveau vSwitch est créé dans la région de destination.
Exemple : vsw-bp11ufkwqwggtm1cj****.
InstanceDataReplication
Indique si les données de l'instance Elastic Compute Service (ECS) doivent être répliquées. Valeurs valides :
- true : réplique les données de l'instance ECS. Si vous répliquez la ressource dans la même région, une image personnalisée est créée pour l'instance source et de nouvelles instances sont créées à partir de cette image. Si vous répliquez la ressource entre différentes régions, une image personnalisée est créée pour l'instance source et répliquée vers la région de destination. De nouvelles instances sont ensuite créées à partir de cette image.
- false : ne réplique pas les données de l'instance ECS.
RemarqueSi vous définissez ParameterKey sur InstanceDataReplication et ParameterValue sur true, arrêtez l'instance source avant de répliquer la ressource afin de garantir la cohérence des données.
-
Le tableau suivant décrit les valeurs de ParameterKey et ParameterValue dans le scénario de gestion des ressources.
RemarqueDans le scénario de gestion des ressources, vous devez définir ParameterKey sur DeletionPolicy.
ParameterKey
ParameterValue
DeletionPolicy
La politique de suppression des ressources. Valeurs valides :
- Retain : conserve les ressources. Si vous supprimez une pile utilisée pour gérer des ressources, toutes les ressources de la pile sont automatiquement conservées.
- Delete : supprime les ressources. Si vous supprimez une pile utilisée pour gérer des ressources, toutes les ressources de la pile sont automatiquement supprimées. Si vous souhaitez conserver certaines ressources lors de la suppression de la pile, seules les ressources dont vous n'avez plus besoin sont supprimées.
Paramètres de réponse
| Paramètre | Type | Exemple | Description |
| RequestId | String | 221DA822-B8CF-50DF-A9D2-BA197BF97BD5 |
L'ID de la requête.
|
| TemplateScratchId | String | ts-7f7a704cf71c49a6**** |
L'ID du scénario.
|
Exemples
Exemples de requêtes
http(s)://[Endpoint]/?Action=UpdateTemplateScratch
&RegionId=cn-hangzhou
&TemplateScratchId=ts-7f7a704cf71c49a6****
&SourceResources=[{"ResourceId":"vpc-bp1m6fww66xbntjyc****","ResourceType":"ALIYUN::ECS::VPC"}]
&<Common request parameters>
Exemples de réponses réussies
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateTemplateScratchResponse>
<RequestId>221DA822-B8CF-50DF-A9D2-BA197BF97BD5</RequestId>
<TemplateScratchId>ts-7f7a704cf71c49a6****</TemplateScratchId>
</UpdateTemplateScratchResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "221DA822-B8CF-50DF-A9D2-BA197BF97BD5",
"TemplateScratchId" : "ts-7f7a704cf71c49a6****"
}
Codes d'erreur
Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs de l'API.