Perform custom processing on CloudFormation templates with template macros (original) (raw)

BillingMacro examplesRelated resources

With macros, you can perform custom processing on templates, from simple actions like find-and-replace operations to extensive transformations of entire templates.

To get an idea of the breadth of possibilities, consider the AWS::Include andAWS::Serverless transforms, which are macros hosted by CloudFormation:

• AWS::Include transform enables you to insert boilerplate template snippets into your templates.
• AWS::Serverless transform takes an entire template written in the AWS Serverless Application Model (AWS SAM) syntax and transforms and expands it into a compliant CloudFormation template. For more information about serverless applications and AWS SAM, see AWS Serverless Application Model Developer Guide.

Topics

• Billing
• Macro examples
• Related resources
• Overview of CloudFormation macros
• Create a CloudFormation macro definition
• Example simple string replacement macro
• Troubleshoot the processed template

Billing

When a macro runs, the owner of the Lambda function is billed for any charges related to the execution of that function.

The AWS::Serverless transform and AWS::Include transform transforms are macros hosted by CloudFormation. There is no charge for using them.

Macro examples

In addition to the examples in this section, you can find example macros, including source code and templates, in our GitHub repository. These examples are provided 'as-is' for instructional purposes.

• AWS::CloudFormation::Macro
• CloudFormation template Transform section
• Fn::Transform
• AWS::Serverless transform
• AWS::Include transform

Update request for CloudFormation custom resources

Macros overview

Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.