CreateCacheSecurityGroup - Amazon ElastiCache
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).


Creates a new cache security group. Use a cache security group to control access to one or more clusters.

Cache security groups are only used when you are creating a cluster outside of an Amazon Virtual Private Cloud (Amazon VPC). If you are creating a cluster inside of a VPC, use a cache subnet group instead. For more information, see CreateCacheSubnetGroup.

Request Parameters

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


A name for the cache security group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters. Cannot be the word "Default".

Example: mysecuritygroup

Type: String

Required: Yes


A description for the cache security group.

Type: String

Required: Yes


A list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.

Type: Array of Tag objects

Required: No

Response Elements

The following element is returned by the service.


Represents the output of one of the following operations:

  • AuthorizeCacheSecurityGroupIngress

  • CreateCacheSecurityGroup

  • RevokeCacheSecurityGroupIngress

Type: CacheSecurityGroup object


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


A cache security group with the specified name already exists.

HTTP Status Code: 400


Two or more incompatible parameters were specified.

HTTP Status Code: 400


The value for a parameter is invalid.

HTTP Status Code: 400


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

HTTP Status Code: 400


The request cannot be processed because it would cause the resource to have more than the allowed number of tags. The maximum number of tags permitted on a resource is 50.

HTTP Status Code: 400



This example illustrates one usage of CreateCacheSecurityGroup.

Sample Request ?Action=CreateCacheSecurityGroup &CacheSecurityGroupName=mycachesecuritygroup &Description=My%20cache%20security%20group &Version=2015-02-02 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &X-Amz-Credential=<credential>

Sample Response

<CreateCacheSecurityGroupResponse xmlns=""> <CreateCacheSecurityGroupResult> <CacheSecurityGroup> <EC2SecurityGroups/> <CacheSecurityGroupName>mycachesecuritygroup</CacheSecurityGroupName> <OwnerId>123456789012</OwnerId> <Description>My cache security group</Description> </CacheSecurityGroup> </CreateCacheSecurityGroupResult> <ResponseMetadata> <RequestId>2b1c8035-b7fa-11e0-9326-b7275b9d4a6c</RequestId> </ResponseMetadata> </CreateCacheSecurityGroupResponse>

See Also

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