Skip to content

CloudFormation  >  Operations  >  update_generated_template

update_generated_template

Operation

update_generated_template async

update_generated_template(input: UpdateGeneratedTemplateInput, plugins: list[Plugin] | None = None) -> UpdateGeneratedTemplateOutput

Updates a generated template. This can be used to change the name, add and remove resources, refresh resources, and change the DeletionPolicy and UpdateReplacePolicy settings. You can check the status of the update to the generated template using the DescribeGeneratedTemplate API action.

Parameters:

Name Type Description Default
input UpdateGeneratedTemplateInput

An instance of UpdateGeneratedTemplateInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
UpdateGeneratedTemplateOutput

An instance of UpdateGeneratedTemplateOutput.

Input

UpdateGeneratedTemplateInput dataclass

Bases: _SerdeShape

Dataclass for UpdateGeneratedTemplateInput structure.

Attributes

add_resources class-attribute instance-attribute
add_resources: list[ResourceDefinition] | None = ...

An optional list of resources to be added to the generated template.

generated_template_name class-attribute instance-attribute
generated_template_name: str | None = ...

The name or Amazon Resource Name (ARN) of a generated template.

new_generated_template_name class-attribute instance-attribute
new_generated_template_name: str | None = ...

An optional new name to assign to the generated template.

refresh_all_resources class-attribute instance-attribute
refresh_all_resources: bool | None = ...

If true, update the resource properties in the generated template with their current live state. This feature is useful when the resource properties in your generated a template does not reflect the live state of the resource properties. This happens when a user update the resource properties after generating a template.

remove_resources class-attribute instance-attribute
remove_resources: list[str] | None = ...

A list of logical ids for resources to remove from the generated template.

template_configuration class-attribute instance-attribute
template_configuration: TemplateConfiguration | None = ...

The configuration details of the generated template, including the DeletionPolicy and UpdateReplacePolicy.

Output

UpdateGeneratedTemplateOutput dataclass

Bases: _SerdeShape

Dataclass for UpdateGeneratedTemplateOutput structure.

Attributes

generated_template_id class-attribute instance-attribute
generated_template_id: str | None = ...

The Amazon Resource Name (ARN) of the generated template. The format is arn:${Partition}:cloudformation:${Region}:${Account}:generatedtemplate/${Id}. For example, arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/2e8465c1-9a80-43ea-a3a3-4f2d692fe6dc.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.