Tag Resource
applicationautoscaling_tag_resource | R Documentation |
Adds or edits tags on an Application Auto Scaling scalable target¶
Description¶
Adds or edits tags on an Application Auto Scaling scalable target.
Each tag consists of a tag key and a tag value, which are both case-sensitive strings. To add a tag, specify a new tag key and a tag value. To edit a tag, specify an existing tag key and a new tag value.
You can use this operation to tag an Application Auto Scaling scalable target, but you cannot tag a scaling policy or scheduled action.
You can also add tags to an Application Auto Scaling scalable target
while creating it (register_scalable_target
).
For general information about tags, including the format and syntax, see Tagging your Amazon Web Services resources in the Amazon Web Services General Reference.
Use tags to control access to a scalable target. For more information, see Tagging support for Application Auto Scaling in the Application Auto Scaling User Guide.
Usage¶
Arguments¶
ResourceARN
[required] Identifies the Application Auto Scaling scalable target that you want to apply tags to.
For example:
arn:aws:application-autoscaling:us-east-1:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123
To get the ARN for a scalable target, use
describe_scalable_targets
.Tags
[required] The tags assigned to the resource. A tag is a label that you assign to an Amazon Web Services resource.
Each tag consists of a tag key and a tag value.
You cannot have more than one tag on an Application Auto Scaling scalable target with the same tag key. If you specify an existing tag key with a different tag value, Application Auto Scaling replaces the current tag value with the specified one.
For information about the rules that apply to tag keys and tag values, see User-defined tag restrictions in the Amazon Web Services Billing User Guide.
Value¶
An empty list.
Request syntax¶
Examples¶
## Not run:
# This example adds a tag with the key name "environment" and the value
# "production" to the scalable target specified by its ARN.
svc$tag_resource(
ResourceARN = "arn:aws:application-autoscaling:us-west-2:123456789012:sca...",
Tags = list(
environment = "production"
)
)
## End(Not run)