Amazon Relational Database Service
API Reference (API Version 2014-10-31)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.

AddTagsToResource

Adds metadata tags to an Amazon RDS resource. These tags can also be used with cost allocation reporting to track cost associated with Amazon RDS resources, or used in a Condition statement in an IAM policy for Amazon RDS.

For an overview on tagging Amazon RDS resources, see Tagging Amazon RDS Resources.

Request Parameters

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

ResourceName

The Amazon RDS resource the tags will be added to. This value is an Amazon Resource Name (ARN). For information about creating an ARN, see Constructing an RDS Amazon Resource Name (ARN).

Type: String

Required: Yes

Tags.member.N

The tags to be assigned to the Amazon RDS resource.

Type: Tag list

Required: Yes

Errors

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

DBInstanceNotFound

DBInstanceIdentifier does not refer to an existing DB instance.

HTTP Status Code: 404

DBSnapshotNotFound

DBSnapshotIdentifier does not refer to an existing DB snapshot.

HTTP Status Code: 404

Examples

Sample Request

https://rds.us-west-2.amazonaws.com/
    ?Action=AddTagsToResource&
    ResourceName=arn:aws:rds:us-west-2:123456781234:db:mysqlexampledb
    &SignatureMethod=HmacSHA256
    &SignatureVersion=4
    &Tags.member.1.Key=InstanceType
    &Tags.member.1.Value=Development
    &Version=2014-10-31
    &X-Amz-Algorithm=AWS4-HMAC-SHA256
    &X-Amz-Credential=AKIADQKE4SARGYLE/20150409/us-west-2/rds/aws4_request
    &X-Amz-Date=20150409T172745Z
    &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
    &X-Amz-Signature=fe5e7a55ea37c634f1726dafd54251675c8656ccb4198c3f2cd6cad24281eb2f

Sample Response

<AddTagsToResourceResponse xmlns="http://rds.amazonaws.com/doc/2014-10-31/">
  <ResponseMetadata>
    <RequestId>aa2aaf6e-dedd-11e4-85e7-8d4cb03f150f</RequestId>
  </ResponseMetadata>
</AddTagsToResourceResponse>