AWS Elastic Beanstalk
API Reference (API Version 2010-12-01)
AWS services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with AWS services in China.


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.

Elastic Beanstalk supports tagging of all of its resources. For details about resource tagging, see Tagging Application Resources.

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 resource.

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: