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


Creates a new DB security group. DB security groups control access to a DB instance.

Request Parameters

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


The description for the DB security group.

Type: String

Required: Yes


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


  • Must be 1 to 255 letters, numbers, or hyphens.

  • First character must be a letter

  • Cannot end with a hyphen or contain two consecutive hyphens

  • Must not be "Default"

Example: mysecuritygroup

Type: String

Required: Yes


A list of tags.

Type: Array of Tag objects

Required: No

Response Elements

The following element is returned by the service.


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

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

Type: DBSecurityGroup object


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


A DB security group with the name specified in DBSecurityGroupName already exists.

HTTP Status Code: 400


A DB security group is not allowed for this action.

HTTP Status Code: 400


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

HTTP Status Code: 400


Sample Request

Sample Response

<CreateDBSecurityGroupResponse xmlns="">
      <DBSecurityGroupDescription>My new DB Security Group</DBSecurityGroupDescription>

See Also

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