ModifyCacheSubnetGroup - 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).


Modifies an existing cache subnet group.

Request Parameters

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


The name for the cache subnet group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens.

Example: mysubnetgroup

Type: String

Required: Yes


A description of the cache subnet group.

Type: String

Required: No


The EC2 subnet IDs for the cache subnet group.

Type: Array of strings

Required: No

Response Elements

The following element is returned by the service.


Represents the output of one of the following operations:

  • CreateCacheSubnetGroup

  • ModifyCacheSubnetGroup

Type: CacheSubnetGroup object


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


The requested cache subnet group name does not refer to an existing cache subnet group.

HTTP Status Code: 400


The request cannot be processed because it would exceed the allowed number of subnets in a cache subnet group.

HTTP Status Code: 400


An invalid subnet identifier was specified.

HTTP Status Code: 400


The requested subnet is being used by another cache subnet group.

HTTP Status Code: 400


At least one subnet ID does not match the other subnet IDs. This mismatch typically occurs when a user sets one subnet ID to a regional Availability Zone and a different one to an outpost. Or when a user sets the subnet ID to an Outpost when not subscribed on this service.

HTTP Status Code: 400



This example illustrates one usage of ModifyCacheSubnetGroup.

Sample Request ?Action=ModifyCacheSubnetGroup &CacheSubnetGroupName=myCachesubnetgroup &CacheSubnetGroupDescription=My%20modified%20CacheSubnetGroup &Version=2015-02-02 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &X-Amz-Credential=<credential>

Sample Response

<ModifyCacheSubnetGroupResponse xmlns=""> <ModifyCacheSubnetGroupResult> <CacheSubnetGroup> <VpcId>990524496922</VpcId> <CacheSubnetGroupDescription>My modified CacheSubnetGroup</CacheSubnetGroupDescription> <CacheSubnetGroupName>myCachesubnetgroup</CacheSubnetGroupName> <Subnets> <Subnet> <SubnetStatus>Active</SubnetStatus> <SubnetIdentifier>subnet-7c5b4115</SubnetIdentifier> <SubnetAvailabilityZone> <Name>us-west-2c</Name> </SubnetAvailabilityZone> </Subnet> <Subnet> <SubnetStatus>Active</SubnetStatus> <SubnetIdentifier>subnet-7b5b4112</SubnetIdentifier> <SubnetAvailabilityZone> <Name>us-west-2b</Name> </SubnetAvailabilityZone> </Subnet> <Subnet> <SubnetStatus>Active</SubnetStatus> <SubnetIdentifier>subnet-3ea6bd57</SubnetIdentifier> <SubnetAvailabilityZone> <Name>us-west-2c</Name> </SubnetAvailabilityZone> </Subnet> </Subnets> </CacheSubnetGroup> </ModifyCacheSubnetGroupResult> <ResponseMetadata> <RequestId>ed662948-a57b-11df-9e38-7ffab86c801f</RequestId> </ResponseMetadata> </ModifyCacheSubnetGroupResponse>

See Also

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