Walkthrough: Creating custom Amazon AppConfig extensions - Amazon AppConfig
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Walkthrough: Creating custom Amazon AppConfig extensions

To create a custom Amazon AppConfig extension, complete the following tasks. Each task is described in more detail in later topics.

Note

You can view samples of custom Amazon AppConfig extensions on GitHub:

1. Create an Amazon Lambda function

For most use cases, to create a custom extension, you must create an Amazon Lambda function to perform any computation and processing defined in the extension. An exception to this rule is if you create custom versions of the Amazon authored notification extensions to add or remove action points. For more details about this exception, see Step 3: Create a custom Amazon AppConfig extension.

2. Configure permissions for your custom extension

To configure permissions for your custom extension, you can do one of the following:

  • Create an Amazon Identity and Access Management (IAM) service role that includes InvokeFunction permissions.

  • Create a resource policy by using the Lambda AddPermission API action.

This walkthrough describes how to create the IAM service role.

3. Create an extension

You can create an extension by using the Amazon AppConfig console or by calling the CreateExtension API action from the Amazon CLI, Amazon Tools for PowerShell, or the SDK. The walkthrough uses the console.

4. Create an extension association

You can create an extension association by using the Amazon AppConfig console or by calling the CreateExtensionAssociation API action from the Amazon CLI, Amazon Tools for PowerShell, or the SDK. The walkthrough uses the console.

5. Perform an action that invokes the extension

After you create the association, Amazon AppConfig invokes the extension when the action points defined by the extension occur for that resource. For example, if you associate an extension that contains a PRE_CREATE_HOSTED_CONFIGURATION_VERSION action, the extension is invoked every time you create a new hosted configuration version.

The topics in this section describe each task involved in creating a custom Amazon AppConfig extension. Each task is described in the context of a use case where a customer wants to create an extension that automatically backs up a configuration to an Amazon Simple Storage Service (Amazon S3) bucket. The extension runs whenever a hosted configuration is created (PRE_CREATE_HOSTED_CONFIGURATION_VERSION) or deployed (PRE_START_DEPLOYMENT).

Topics