Creating a parameter group - Amazon ElastiCache for Redis
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.

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 Amazon 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 Amazon Web Services Management Console and open the ElastiCache console at https://console.amazonaws.cn/elasticache/.

  2. To see a list of all available parameter groups, in the left hand navigation pane choose Parameter Groups.

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

    The Create Parameter Group screen appears.

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

    The parameter group family, such as redis3.2, 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.

  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 choose the parameter group by its name. Therefore, we recommend that the name be informative and somehow identify the parameter group's family.

    Parameter group naming constraints are as follows:

    • Must begin with an ASCII letter.

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

    • Must be 1–255 characters long.

    • Can't contain two consecutive hyphens.

    • Can't end with a hyphen.

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

  7. To create the parameter group, choose Create.

    To terminate the process without creating the parameter group, choose 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 (Amazon CLI)

To create a parameter group using the Amazon 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 are as follows:

    • Must begin with an ASCII letter.

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

    • Must be 1–255 characters long.

    • Can't contain two consecutive hyphens.

    • Can't end with a hyphen.

  • --cache-parameter-group-family — The engine and version family for the parameter group.

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

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

For Linux, OS X, or Unix:

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

For Windows:

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

The output from this command should look something like this.

{ "CacheParameterGroup": { "CacheParameterGroupName": "myRed28", "CacheParameterGroupFamily": "redis2.8", "Description": "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 are as follows:

    • Must begin with an ASCII letter.

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

    • Must be 1–255 characters long.

    • Can't contain two consecutive hyphens.

    • Can't 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 myRed28 using the redis2.8 family as the template.

https://elasticache.us-west-2.amazonaws.com/ ?Action=CreateCacheParameterGroup &CacheParameterGroupFamily=redis2.8 &CacheParameterGroupName=myRed28 &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.

<CreateCacheParameterGroupResponse xmlns="http://elasticache.amazonaws.com/doc/2013-06-15/"> <CreateCacheParameterGroupResult> <CacheParameterGroup> <CacheParameterGroupName>myRed28</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.