AddTags
Adds the specified tags to the specified Elastic Load Balancing resource. You can tag your Application Load Balancers, Network Load Balancers, Gateway Load Balancers, target groups, trust stores, listeners, and rules.
Each tag consists of a key and an optional value. If a resource already has a tag with the
same key, AddTags
updates its value.
To list the current tags for your resources, use DescribeTags. To remove tags from your resources, use RemoveTags.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- ResourceArns.member.N
-
The Amazon Resource Name (ARN) of the resource.
Type: Array of strings
Required: Yes
- Tags.member.N
-
The tags.
Type: Array of Tag objects
Array Members: Minimum number of 1 item.
Required: Yes
Errors
For information about the errors that are common to all actions, see Common Errors.
- DuplicateTagKeys
-
A tag key was specified more than once.
HTTP Status Code: 400
- ListenerNotFound
-
The specified listener does not exist.
HTTP Status Code: 400
- LoadBalancerNotFound
-
The specified load balancer does not exist.
HTTP Status Code: 400
- RuleNotFound
-
The specified rule does not exist.
HTTP Status Code: 400
- TargetGroupNotFound
-
The specified target group does not exist.
HTTP Status Code: 400
- TooManyTags
-
You've reached the limit on the number of tags for this resource.
HTTP Status Code: 400
- TrustStoreNotFound
-
The specified trust store does not exist.
HTTP Status Code: 400
Examples
Add tags to a load balancer
This example adds the specified tags to the specified load balancer.
Sample Request
https://elasticloadbalancing.amazonaws.com/?Action=AddTags
&ResourceArns.member.1=arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188
&Tags.member.1.Key=project
&Tags.member.1.Value=lima
&Tags.member.2.Key=department
&Tags.member.2.Value=digital-media
&Version=2015-12-01
&AUTHPARAMS
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: