Amazon Relational Database Service
API Reference (API Version 2012-04-23)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

DeleteDBSubnetGroup

Description

Deletes a DB subnet group.

[Note]Note
The specified database subnet group must not be associated with any DB instances.

Request Parameters

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

Name Description Required
DBSubnetGroupName

The name of the database subnet group to delete.

[Note]Note
You cannot delete the default subnet group.

Constraints:

  • Must be 1 to 255 alphanumeric characters
  • First character must be a letter
  • Cannot end with a hyphen or contain two consecutive hyphens

Type: String

Yes

Errors

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

Error Description HTTP Status Code
DBSubnetGroupNotFound

DBSubnetGroupName does not refer to an existing DB Subnet Group.

400
InvalidDBSubnetGroupState

The DB Subnet Group cannot be deleted because it is in use.

400
InvalidDBSubnetState  400

Examples

Sample Request

https://rds.amazonaws.com/
     ?Action=DeleteDBSubnetGroup
     &DBSubnetGroupName=mysubnetgroup
     &Version=2012-04-23
     &SignatureVersion=2
     &SignatureMethod=HmacSHA256
     &Timestamp=2011-02-15T17%3A48%3A21.746Z
     &AWSAccessKeyId=<AWS Access Key ID>
     &Signature=<Signature>

Sample Response

<DeleteDBSubnetGroupResponse xmlns="http://rds.amazonaws.com/doc/2012-04-23/">
      <ResponseMetadata>
        <RequestId>5d013245-4172-11df-8520-e7e1e602a915</RequestId>
      </ResponseMetadata>
    </DeleteDBSubnetGroupResponse>