Menu
Amazon ElastiCache
API Reference (API Version 2015-02-02)

CreateCacheParameterGroup

Creates a new Amazon ElastiCache cache parameter group. An ElastiCache cache parameter group is a collection of parameters and their values that are applied to all of the nodes in any cache cluster or replication group using the CacheParameterGroup.

A newly created CacheParameterGroup is an exact duplicate of the default parameter group for the CacheParameterGroupFamily. To customize the newly created CacheParameterGroup you can change the values of specific parameters. For more information, see:

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

CacheParameterGroupFamily

The name of the cache parameter group family that the cache parameter group can be used with.

Valid values are: memcached1.4 | redis2.6 | redis2.8 | redis3.2

Type: String

Required: Yes

CacheParameterGroupName

A user-specified name for the cache parameter group.

Type: String

Required: Yes

Description

A user-specified description for the cache parameter group.

Type: String

Required: Yes

Response Elements

The following element is returned by the service.

CacheParameterGroup

Represents the output of a CreateCacheParameterGroup operation.

Type: CacheParameterGroup object

Errors

For information about the errors that are common to all actions, see Common Errors.

CacheParameterGroupAlreadyExists

A cache parameter group with the requested name already exists.

HTTP Status Code: 400

CacheParameterGroupQuotaExceeded

The request cannot be processed because it would exceed the maximum number of cache security groups.

HTTP Status Code: 400

InvalidCacheParameterGroupState

The current state of the cache parameter group does not allow the requested operation to occur.

HTTP Status Code: 400

InvalidParameterCombination

Two or more incompatible parameters were specified.

HTTP Status Code: 400

InvalidParameterValue

The value for a parameter is invalid.

HTTP Status Code: 400

Example

Sample Request

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

Sample Response

Copy
<CreateCacheParameterGroupResponse xmlns="http://elasticache.amazonaws.com/doc/2015-02-02/"> <CreateCacheParameterGroupResult> <CacheParameterGroup> <CacheParameterGroupName>mycacheparametergroup3</CacheParameterGroupName> <CacheParameterGroupFamily>memcached1.4</CacheParameterGroupFamily> <Description>My first cache parameter group</Description> </CacheParameterGroup> </CreateCacheParameterGroupResult> <ResponseMetadata> <RequestId>05699541-b7f9-11e0-9326-b7275b9d4a6c</RequestId> </ResponseMetadata> </CreateCacheParameterGroupResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: