CreateDBSecurityGroup - Amazon Relational Database Service

Description

Creates a new DB Security Group. DB Security Groups control access to a DB Instance.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Name Description Required

Name	Description	Required
`DBSecurityGroupDescription`	The description for the DB Security Group. Type: String	Yes
`DBSecurityGroupName`	The name for the DB Security Group. This value is stored as a lowercase string. Constraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be "Default". Example: `mysecuritygroup` Type: String	Yes
`EC2VpcId`	The Id of VPC. Indicates which VPC this DB Security Group should belong to. Must be specified to create a DB Security Group for a VPC; may not be specified otherwise. Type: String	No

DBSecurityGroupDescription

The description for the DB Security Group.

Type: String

Yes

DBSecurityGroupName

The name for the DB Security Group. This value is stored as a lowercase string.

Constraints: Must contain no more than 255 alphanumeric characters or hyphens. Must not be "Default".

Example: mysecuritygroup

Type: String

Yes

EC2VpcId

The Id of VPC. Indicates which VPC this DB Security Group should belong to. Must be specified to create a DB Security Group for a VPC; may not be specified otherwise.

Type: String

No

Response Elements

The following elements come wrapped in a DBSecurityGroup structure.

Name	Description
`DBSecurityGroupDescription`	Provides the description of the DB Security Group. Type: String
`DBSecurityGroupName`	Specifies the name of the DB Security Group. Type: String
`EC2SecurityGroups`	Contains a list of EC2SecurityGroup elements. Type: EC2SecurityGroup list
`IPRanges`	Contains a list of IPRange elements. Type: IPRange list
`OwnerId`	Provides the AWS ID of the owner of a specific DB Security Group. Type: String
`VpcId`	Provides the VpcId of the DB Security Group. Type: String

Errors

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

Error	Description	HTTP Status Code
`DBSecurityGroupAlreadyExists`	A database security group with the name specified in DBSecurityGroupName already exists.	400
`DBSecurityGroupQuotaExceeded`	Request would result in user exceeding the allowed number of DB Security Groups.	400

Examples

Sample Request

https://rds.amazonaws.com/
    ?Action=CreateDBSecurityGroup
    &DBSecurityGroupName=mydbsecuritygroup
    &DBSecurityGroupDescription=My%20new%20DBSecurityGroup
    &EC2VpcId=vpc-1a2b3c4d
    &Version=2012-04-23
    &SignatureVersion=2
    &SignatureMethod=HmacSHA256
    &Timestamp=2011-02-15T18%3A14%3A49.482Z
    &AWSAccessKeyId=<AWS Access Key ID>
    &Signature=<Signature>

Sample Response

<CreateDBSecurityGroupResponse xmlns="http://rds.amazonaws.com/doc/2012-04-23/">
    <CreateDBSecurityGroupResult>
        <DBSecurityGroup>
            <EC2SecurityGroups/>
            <DBSecurityGroupDescription>My new DBSecurityGroup</DBSecurityGroupDescription>
            <IPRanges/>
            <OwnerId>565419523791</OwnerId>
            <DBSecurityGroupName>mydbsecuritygroup</DBSecurityGroupName>
            <VpcId>vpc-1a2b3c4d</VpcId>
        </DBSecurityGroup>
    </CreateDBSecurityGroupResult>
    <ResponseMetadata>
        <RequestId>ed662948-a57b-11df-9e38-7ffab86c801f</RequestId>
    </ResponseMetadata>
</CreateDBSecurityGroupResponse>