AddTagsToResource - Amazon Relational Database Service

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 your relational database resources, see Tagging Amazon RDS Resources or Tagging Amazon Aurora and Amazon RDS Resources.

Request Parameters

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

ResourceName

The Amazon RDS resource that the tags are 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.Tag.N

The tags to be assigned to the Amazon RDS resource.

Type: Array of Tag objects

Required: Yes

Errors

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

BlueGreenDeploymentNotFoundFault

BlueGreenDeploymentIdentifier doesn't refer to an existing blue/green deployment.

HTTP Status Code: 404

DBClusterNotFoundFault

DBClusterIdentifier doesn't refer to an existing DB cluster.

HTTP Status Code: 404

DBInstanceNotFound

DBInstanceIdentifier doesn't refer to an existing DB instance.

HTTP Status Code: 404

DBProxyNotFoundFault

The specified proxy name doesn't correspond to a proxy owned by your AWS account in the specified AWS Region.

HTTP Status Code: 404

DBProxyTargetGroupNotFoundFault

The specified target group isn't available for a proxy owned by your AWS account in the specified AWS Region.

HTTP Status Code: 404

DBSnapshotNotFound

DBSnapshotIdentifier doesn't refer to an existing DB snapshot.

HTTP Status Code: 404

DBSnapshotTenantDatabaseNotFoundFault

The specified snapshot tenant database wasn't found.

HTTP Status Code: 404

IntegrationNotFoundFault

The specified integration could not be found.

HTTP Status Code: 404

TenantDatabaseNotFound

The specified tenant database wasn't found in the DB instance.

HTTP Status Code: 404

Examples

Example

This example illustrates one usage of AddTagsToResource.

Sample Request

https://rds.us-west-2.amazonaws.com/ ?Action=AddTagsToResource &ResourceName=arn%3Aaws%3Ards%3Aus-west-2%3A123456789012%3Adb%3Asample &SignatureMethod=HmacSHA256 &SignatureVersion=4 &Tags.member.1.Key=InstanceType &Tags.member.1.Value=Development &Tags.member.2.Key=Owner &Tags.member.2.Value=Admin123 &Version=2014-10-31 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIADQKE4SARGYLE/20160913/us-west-2/rds/aws4_request &X-Amz-Date=20160913T173915Z &X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date &X-Amz-Signature=90a257aa949fab364b7db0964a255986922f933f2e55e7b582ce6f9ccca2a4e0

Sample Response

<AddTagsToResourceResponse xmlns="http://rds.amazonaws.com/doc/2014-10-31/"> <ResponseMetadata> <RequestId>fd9cd844-79d8-11e6-956c-915ad715fa2f</RequestId> </ResponseMetadata> </AddTagsToResourceResponse>

See Also

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