Menu
Amazon Relational Database Service
API Reference (API Version 2014-10-31)

CreateDBSubnetGroup

Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.

Request Parameters

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

DBSubnetGroupDescription

The description for the DB subnet group.

Type: String

Required: Yes

DBSubnetGroupName

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

Constraints: Must contain no more than 255 alphanumeric characters, periods, underscores, spaces, or hyphens. Must not be default.

Example: mySubnetgroup

Type: String

Required: Yes

SubnetIds.SubnetIdentifier.N

The EC2 Subnet IDs for the DB subnet group.

Type: Array of strings

Required: Yes

Tags.Tag.N

A list of tags.

Type: Array of Tag objects

Required: No

Response Elements

The following element is returned by the service.

DBSubnetGroup

Contains the result of a successful invocation of the following actions:

This data type is used as a response element in the DescribeDBSubnetGroups action.

Type: DBSubnetGroup object

Errors

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

DBSubnetGroupAlreadyExists

DBSubnetGroupName is already used by an existing DB subnet group.

HTTP Status Code: 400

DBSubnetGroupDoesNotCoverEnoughAZs

Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.

HTTP Status Code: 400

DBSubnetGroupQuotaExceeded

Request would result in user exceeding the allowed number of DB subnet groups.

HTTP Status Code: 400

DBSubnetQuotaExceededFault

Request would result in user exceeding the allowed number of subnets in a DB subnet groups.

HTTP Status Code: 400

InvalidSubnet

The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.

HTTP Status Code: 400

Example

Sample Request

Copy
https://rds.us-east-1.amazonaws.com/ ?Action=CreateDBSubnetGroup &DBSubnetGroupDescription=My%20new%20DB%20Subnet%20Group &DBSubnetGroupName=myawsuser-dbsubnetgroup &SignatureMethod=HmacSHA256 &SignatureVersion=4 &SubnetIds.member.1=subnet-e4d398a1 &SubnetIds.member.2=subnet-c2bdb6ba &Version=2014-09-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20140425/us-east-1/rds/aws4_request &X-Amz-Date=20140425T173028Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=f434cd02a766ea034637debf67996a743ca3e098efc9a5881c61e0c6859259d3

Sample Response

Copy
<CreateDBSubnetGroupResponse xmlns="http://rds.amazonaws.com/doc/2014-09-01/"> <CreateDBSubnetGroupResult> <DBSubnetGroup> <VpcId>vpc-33dc97ea</VpcId> <SubnetGroupStatus>Complete</SubnetGroupStatus> <DBSubnetGroupDescription>My new DB Subnet Group</DBSubnetGroupDescription> <DBSubnetGroupName>myawsuser-dbsubnetgroup</DBSubnetGroupName> <Subnets> <Subnet> <SubnetStatus>Active</SubnetStatus> <SubnetIdentifier>subnet-e4d398a1</SubnetIdentifier> <SubnetAvailabilityZone> <Name>us-east-1b</Name> <ProvisionedIopsCapable>false</ProvisionedIopsCapable> </SubnetAvailabilityZone> </Subnet> <Subnet> <SubnetStatus>Active</SubnetStatus> <SubnetIdentifier>subnet-c2bdb6ba</SubnetIdentifier> <SubnetAvailabilityZone> <Name>us-east-1c</Name> <ProvisionedIopsCapable>false</ProvisionedIopsCapable> </SubnetAvailabilityZone> </Subnet> </Subnets> </DBSubnetGroup> </CreateDBSubnetGroupResult> <ResponseMetadata> <RequestId>3a401b3f-bb9e-11d3-f4c6-37db295f7674</RequestId> </ResponseMetadata> </CreateDBSubnetGroupResponse>

See Also

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