：UpdateTemplateScratch

In this topic, the ts-7f7a704cf71c49a6**** scenario that is created in the China (Hangzhou) region is updated. In this scenario, the ID of the virtual private cloud (VPC) is updated to ts-7f7a704cf71c49a6****.

Request parameters

Additional description of request parameters

For more information about common request parameters, see Common parameters.

In request parameters, the values of ParameterKey and ParameterValue vary based on the scenario types.

• The following table describes the values of ParameterKey and ParameterValue in the resource replication scenario.

  ParameterKey	ParameterValue
  DeletionPolicy	The resource deletion policy. Valid values: Retain: retains resources. If you delete a stack after you replicate resources to the stack, the resources are retained. Delete: deletes resources. If you delete a stack after you replicate resources to the stack, all the resources are deleted by default. If you retain some resources when you delete the stack, the resources that you no longer need are deleted.
  RegionId	The destination region to which you want to replicate the resource. If you do not specify a destination region, the resource is replicated to the region where the source resource resides. Example: cn-shanghai.
  ZoneId	The destination zone to which you want to replicate the resource. If you replicate the resource in the same region but you do not specify the destination zone, the resource is replicated to the zone where the source resource resides. If you replicate the resource across zones, the resource is replicated to the zone that all resources support. Example: cn-shanghai-b.
  VpcId	The destination VPC to which you want to replicate the resource. If you replicate the resource in the same region but you do not specify the destination VPC, the resource is replicated to the VPC to which the source resource belongs. If you replicate the resource across regions, a new VPC is created in the destination region. Example: vpc-bp1hye0s8b69xokfu****.
  VSwitchId	The destination vSwitch. If you replicate the resource in the same region but you do not specify the destination vSwitch, the vSwitch that is associated with the source resource is used. If you replicate the resource across regions, a new vSwitch is created in the destination region. Example: vsw-bp11ufkwqwggtm1cj****.
  InstanceDataReplication	Specifies whether to replicate the Elastic Compute Service (ECS) instance data. Valid values: true: replicates ECS instance data. If you replicate the resource in the same region, a custom image is created for the source instance and new instances are created based on the custom image. If you replicate the resource across regions, a custom image is created for the source instance and replicated to the destination region. New instances are created based on the custom image. false: does not replicate ECS instance data.

  Note If you set ParameterKey to InstanceDataReplication and ParameterValue to true, you must stop the source instance before you replicate the resource to ensure data consistency.
• The following table describes the values of ParameterKey and ParameterValue in the resource management scenario.

  Note In the resource management scenario, you must set ParameterKey to DeletionPolicy.

  ParameterKey

  ParameterValue

  DeletionPolicy

  The resource deletion policy. Valid values: Retain: retains resources. If you delete a stack that you use to manage resources, all the resources in the stack are automatically retained. Delete: deletes resources. If you delete a stack that you use to manage resources, all the resources in the stack are automatically deleted. If you want to retain some resources when you delete the stack, only the resources that you no longer need are deleted.

Response parameters

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdateTemplateScratch
&RegionId=cn-hangzhou
&TemplateScratchId=ts-7f7a704cf71c49a6****
&SourceResources=[{"ResourceId":"vpc-bp1m6fww66xbntjyc****","ResourceType":"ALIYUN::ECS::VPC"}]
&<Common request parameters>

Sample success responses

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****"
}

Error codes

For a list of error codes, visit the API Error Center.