Creating an Amazon AppConfig freeform configuration profile (console) - 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).

Creating an Amazon AppConfig freeform configuration profile (console)

Use the following procedure to create an Amazon AppConfig freeform configuration profile and (optionally) a freeform-configuration by using the Amazon Systems Manager console.

To create a freeform configuration profile
  1. Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/appconfig/.

  2. In the navigation pane, choose Applications, and then choose an application you created in Creating a namespace for your application in Amazon AppConfig.

  3. Choose the Configuration profiles and feature flags tab, and then choose Create configuration.

  4. In the Configuration options section, choose Freeform configuration.

  5. For Configuration profile name, enter a name for the configuration profile.

  6. (Optional) Expand Description and enter a description.

  7. (Optional) Expand Additional options and complete the following, as necessary.

    1. In the Associate extensions section, choose an extension from the list.

    2. In the Tags section, choose Add new tag, and then specify a key and optional value.

  8. Choose Next.

  9. On the Specify configuration data page, in the Configuration definition section, choose an option.

  10. Complete the fields for the option you selected, as described in the following table.

    Option selected Details

    Amazon AppConfig hosted configuration

    Choose either Text, JSON, or YAML, and enter your configuration in the field. Go to Step 12 in this procedure.

    Amazon S3 object

    Enter the object URI in the S3 object source field and go to Step 11 in this procedure.

    Amazon CodePipeline

    Choose Next and go to Step 12 in this procedure.

    Secrets Manager secret

    Choose the secret from the list go to Step 11 in this procedure.

    Amazon Systems Manager parameter

    Choose the parameter from the list and go to Step 11 in this procedure.

    Amazon Systems Manager document

    1. Choose a document from the list or choose Create new document.

    2. If you choose Create new document, for Document name, enter a name. Optionally, expand Version name and enter a name for the document version.

    3. For Application configuration schema, either choose the JSON schema from the list or choose Create schema. If you choose Create schema, Systems Manager opens the Create schema page. Enter the schema details, and then choose Create application configuration schema.

    4. In the Content section, choose either YAML or JSON and then enter the configuration data in the field.

  11. In the Service role section, choose New service role to have Amazon AppConfig create the IAM role that provides access to the configuration data. Amazon AppConfig automatically populates the Role name field based on the name you entered earlier. Or, choose Existing service role. Choose the role by using the Role ARN list.

  12. Optionally, on the Add validators page, choose either JSON Schema or Amazon Lambda. If you choose JSON Schema, enter the JSON Schema in the field. If you choose Amazon Lambda, choose the function Amazon Resource Name (ARN) and the version from the list.

    Important

    Configuration data stored in SSM documents must validate against an associated JSON Schema before you can add the configuration to the system. SSM parameters do not require a validation method, but we recommend that you create a validation check for new or updated SSM parameter configurations by using Amazon Lambda.

  13. Choose Next.

  14. On the Review and save page, choose Save and continue to deploy.

Important

If you created a configuration profile for Amazon CodePipeline, then you must create a pipeline in CodePipeline that specifies Amazon AppConfig as the deploy provider. You don't need to perform Deploying feature flags and configuration data in Amazon AppConfig. However, you must configure a client to receive application configuration updates as described in Retrieving configurations by directly calling APIs. For information about creating a pipeline that specifies Amazon AppConfig as the deploy provider, see Tutorial: Create a Pipeline that Uses Amazon AppConfig as a Deployment Provider in the Amazon CodePipeline User Guide.

Proceed to Deploying feature flags and configuration data in Amazon AppConfig.