Skip to content

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

applicationautoscaling_tag_resource(ResourceARN, Tags)

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

svc$tag_resource(
  ResourceARN = "string",
  Tags = list(
    "string"
  )
)

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)