CreateTags
Adds tags to a cluster.
A resource can have up to 50 tags. If you try to create more than 50 tags for a resource, you will receive an error and the attempt will fail.
If you specify a key that already exists for the resource, the value for that key will be updated with the new value.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- ResourceName
-
The Amazon Resource Name (ARN) to which you want to add the tag or tags. For example,
arn:aws:redshift:us-east-2:123456789:cluster:t1
.Type: String
Length Constraints: Maximum length of 2147483647.
Required: Yes
- Tags.Tag.N
-
One or more name/value pairs to add as tags to the specified resource. Each tag name is passed in with the parameter
Key
and the corresponding value is passed in with the parameterValue
. TheKey
andValue
parameters are separated by a comma (,). Separate multiple tags with a space. For example,--tags "Key"="owner","Value"="admin" "Key"="environment","Value"="test" "Key"="version","Value"="1.0"
.Type: Array of Tag objects
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidClusterState
-
The specified cluster is not in the
available
state.HTTP Status Code: 400
- InvalidTagFault
-
The tag is invalid.
HTTP Status Code: 400
- ResourceNotFoundFault
-
The resource could not be found.
HTTP Status Code: 404
- TagLimitExceededFault
-
You have exceeded the number of tags allowed.
HTTP Status Code: 400
Examples
Example
This example illustrates one usage of CreateTags.
Sample Request
https://redshift.us-east-2.amazonaws.com/
?Action=CreateTags
&ResourceName=arn%3Aaws%3Aredshift%3Aus-east-2%3A123456789012%3Acluster%3Amycluster
&Tags.Tag.1.Key=mytag
&Tags.Tag.1.Value=newtag
&SignatureMethod=HmacSHA256&SignatureVersion=4
&Version=2012-12-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20190817/us-east-2/redshift/aws4_request
&X-Amz-Date=20190825T160000Z
&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
&X-Amz-Signature=0aa1234bb5cc678ddddd901ee2ff3aa45678b90c12d345e6ff789012345a6b7b
Sample Response
<CreateTagsResponse xmlns="http://redshift.amazonaws.com/doc/2012-12-01/">
<ResponseMetadata>
<RequestId>bf5cbe2f-2837-11ea-9467-b9a67a99da45</RequestId>
</ResponseMetadata>
</CreateTagsResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: