Menu
Amazon ElastiCache
User Guide (API Version 2015-02-02)

Creating a Parameter Group

You need to create a new parameter group if there is one or more parameter values that you want changed from the default values. You can create a parameter group using the ElastiCache console, the AWS CLI, or the ElastiCache API.

Creating a Parameter Group (Console)

The following procedure shows how to create a parameter group using the ElastiCache console.

To create a parameter group using the ElastiCache console

  1. Sign in to the AWS Management Console and open the ElastiCache console at https://console.aws.amazon.com/elasticache/.

  2. In the left hand navigation pane, select Parameter Groups.

    The Parameter Groups screen will appear with a list of all available parameter groups.

  3. To create a parameter group, select Create Parameter Group.

    The Create Parameter Group screen will appear.

  4. From the Family list, select the parameter group family that will be the template for your parameter group.

    The parameter group family, such as redis2.8, defines the actual parameters in your parameter group and their initial values. The parameter group family must coincide with the cluster's engine and version. For example, you cannot create a parameter group with the family redis2.8 and use it with clusters running Redis version 2.6.

  5. In the Name box, type in a unique name for this parameter group.

    When creating a cluster or modifying a cluster's parameter group, you will select the parameter group by its name. Therefore, we recommend that the name be informative and somehow identify the parameter group's family. For example, Redis2-8-24-Custom.

    Parameter Group naming constraints

    • Must begin with an ASCII letter.

    • Can only contain ASCII letters, digits, and hyphens.

    • Must be between 1 and 255 characters long.

    • Cannot contain two consecutive hyphens.

    • Cannot end with a hyphen.

  6. In the Description box, type in a description for the parameter group.

  7. To create the parameter group, select Create.

    To terminate the process without creating the parameter group, select Cancel.

  8. When the parameter group is created, it will have the family's default values. To change the default values you must modify the parameter group. For more information, see Modifying a Parameter Group.

Creating a Parameter Group (AWS CLI)

To create a parameter group using the AWS CLI, use the command create-cache-parameter-group with these parameters.

  • --cache-parameter-group-name — The name of the parameter group.

    Parameter Group naming constraints

    • Must begin with an ASCII letter.

    • Can only contain ASCII letters, digits, and hyphens.

    • Must be between 1 and 255 characters long.

    • Cannot contain two consecutive hyphens.

    • Cannot end with a hyphen.

  • --cache-parameter-group-family — The engine and version family for the parameter group. For example, redis2.8.

  • --description — A user supplied description for the parameter group.

The following example creates a parameter group named myRedis28 using the redis2.8 family as the template.

For Linux, macOS, or Unix:

Copy
aws elasticache create-cache-parameter-group \ --cache-parameter-group-name myRedis28 \ --cache-parameter-group-family redis2.8 \ --description "My first parameter group"

For Windows:

Copy
aws elasticache create-cache-parameter-group ^ --cache-parameter-group-name myRedis28 ^ --cache-parameter-group-family redis2.8 ^ --description "My first parameter group"

The output from this command should look something like this.

Copy
CACHEPARAMETERGROUP myRedis28 redis2.8 My first parameter group

When the parameter group is created, it will have the family's default values. To change the default values you must modify the parameter group. For more information, see Modifying a Parameter Group.

For more information, see create-cache-parameter-group.

Creating a Parameter Group (ElastiCache API)

To create a parameter group using the ElastiCache API, use the CreateCacheParameterGroup action with these parameters.

  • ParameterGroupName — The name of the parameter group.

    Parameter Group naming constraints

    • Must begin with an ASCII letter.

    • Can only contain ASCII letters, digits, and hyphens.

    • Must be between 1 and 255 characters long.

    • Cannot contain two consecutive hyphens.

    • Cannot end with a hyphen.

  • CacheParameterGroupFamily — The engine and version family for the parameter group. For example, redis2.8.

  • Description — A user supplied description for the parameter group.

The following example creates a parameter group named myRedis28 using the redis2.8 family as the template.

Copy
https://elasticache.us-west-2.amazonaws.com/ ?Action=CreateCacheParameterGroup &CacheParameterGroupFamily=redis2.8 &CacheParameterGroupName=myRedis28 &Description=My%20first%20parameter%20group &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &Version=2015-02-02 &X-Amz-Credential=<credential>

The response from this action should look something like this.

Copy
<CreateCacheParameterGroupResponse xmlns="http://elasticache.amazonaws.com/doc/2013-06-15/"> <CreateCacheParameterGroupResult> <CacheParameterGroup> <CacheParameterGroupName>myRedis28</CacheParameterGroupName> <CacheParameterGroupFamily>redis2.8</CacheParameterGroupFamily> <Description>My first parameter group</Description> </CacheParameterGroup> </CreateCacheParameterGroupResult> <ResponseMetadata> <RequestId>d8465952-af48-11e0-8d36-859edca6f4b8</RequestId> </ResponseMetadata> </CreateCacheParameterGroupResponse>

When the parameter group is created, it will have the family's default values. To change the default values you must modify the parameter group. For more information, see Modifying a Parameter Group.

For more information, see CreateCacheParameterGroup.