AWS Elastic Beanstalk
API Reference (API Version 2010-12-01)


Update the list of tags applied to an AWS Elastic Beanstalk resource. Two lists can be passed: TagsToAdd for tags to add or update, and TagsToRemove.

Currently, Elastic Beanstalk only supports tagging of Elastic Beanstalk environments. For details about environment tagging, see Tagging Resources in Your Elastic Beanstalk Environment.

If you create a custom IAM user policy to control permission to this operation, specify one of the following two virtual actions (or both) instead of the API operation name:


Controls permission to call UpdateTagsForResource and pass a list of tags to add in the TagsToAdd parameter.


Controls permission to call UpdateTagsForResource and pass a list of tag keys to remove in the TagsToRemove parameter.

For details about creating a custom user policy, see Creating a Custom User Policy.

Request Parameters

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


The Amazon Resource Name (ARN) of the resouce to be updated.

Must be the ARN of an Elastic Beanstalk environment.

Type: String

Required: Yes


A list of tags to add or update.

If a key of an existing tag is added, the tag's value is updated.

Type: Array of Tag objects

Required: No


A list of tag keys to remove.

If a tag key doesn't exist, it is silently ignored.

Type: Array of strings

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: No


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


The specified account does not have sufficient privileges for one or more AWS services.

HTTP Status Code: 403


Unable to perform the specified operation because another operation that effects an element in this activity is already in progress.

HTTP Status Code: 400


A resource doesn't exist for the specified Amazon Resource Name (ARN).

HTTP Status Code: 400


The type of the specified Amazon Resource Name (ARN) isn't supported for this operation.

HTTP Status Code: 400


The number of tags in the resource would exceed the number of tags that each resource can have.

To calculate this, the operation considers both the number of tags the resource already has and the tags this operation would add if it succeeded.

HTTP Status Code: 400

See Also

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