aws.autoscaling.Tag

Manages an individual Autoscaling Group (ASG) tag. This resource should only be used in cases where ASGs are created outside the provider (e.g., ASGs implicitly created by EKS Node Groups).

NOTE: This tagging resource should not be combined with the resource for managing the parent resource. For example, using aws.autoscaling.Group and aws.autoscaling.Tag to manage tags of the same ASG will cause a perpetual difference where the aws.autoscaling.Group resource will try to remove the tag being added by the aws.autoscaling.Tag resource.

NOTE: This tagging resource does not use the provider ignore_tags configuration.

Create Tag Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Tag(name: string, args: TagArgs, opts?: CustomResourceOptions);

@overload
def Tag(resource_name: str,
        args: TagArgs,
        opts: Optional[ResourceOptions] = None)

@overload
def Tag(resource_name: str,
        opts: Optional[ResourceOptions] = None,
        autoscaling_group_name: Optional[str] = None,
        tag: Optional[TagTagArgs] = None)

func NewTag(ctx *Context, name string, args TagArgs, opts ...ResourceOption) (*Tag, error)

public Tag(string name, TagArgs args, CustomResourceOptions? opts = null)

public Tag(String name, TagArgs args)
public Tag(String name, TagArgs args, CustomResourceOptions options)

type: aws:autoscaling:Tag
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

Constructor example

The following reference example uses placeholder values for all input properties.

var tagResource = new Aws.AutoScaling.Tag("tagResource", new()
{
    AutoscalingGroupName = "string",
    TagDetails = new Aws.AutoScaling.Inputs.TagTagArgs
    {
        Key = "string",
        PropagateAtLaunch = false,
        Value = "string",
    },
});

example, err := autoscaling.NewTag(ctx, "tagResource", &autoscaling.TagArgs{
	AutoscalingGroupName: pulumi.String("string"),
	Tag: &autoscaling.TagTagArgs{
		Key:               pulumi.String("string"),
		PropagateAtLaunch: pulumi.Bool(false),
		Value:             pulumi.String("string"),
	},
})

var tagResource = new Tag("tagResource", TagArgs.builder()
    .autoscalingGroupName("string")
    .tag(TagTagArgs.builder()
        .key("string")
        .propagateAtLaunch(false)
        .value("string")
        .build())
    .build());

tag_resource = aws.autoscaling.Tag("tagResource",
    autoscaling_group_name="string",
    tag={
        "key": "string",
        "propagate_at_launch": False,
        "value": "string",
    })

const tagResource = new aws.autoscaling.Tag("tagResource", {
    autoscalingGroupName: "string",
    tag: {
        key: "string",
        propagateAtLaunch: false,
        value: "string",
    },
});

type: aws:autoscaling:Tag
properties:
    autoscalingGroupName: string
    tag:
        key: string
        propagateAtLaunch: false
        value: string

Tag Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The Tag resource accepts the following input properties:

Outputs

All input properties are implicitly available as output properties. Additionally, the Tag resource produces the following output properties:

Look up Existing Tag Resource

Get an existing Tag resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: TagState, opts?: CustomResourceOptions): Tag

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        autoscaling_group_name: Optional[str] = None,
        tag: Optional[TagTagArgs] = None) -> Tag

func GetTag(ctx *Context, name string, id IDInput, state *TagState, opts ...ResourceOption) (*Tag, error)

public static Tag Get(string name, Input<string> id, TagState? state, CustomResourceOptions? opts = null)

public static Tag get(String name, Output<String> id, TagState state, CustomResourceOptions options)

Resource lookup is not supported in YAML

Supporting Types

TagTag, TagTagArgs

Import

Using pulumi import, import aws_autoscaling_group_tag using the ASG name and key, separated by a comma (,). For example:

$ pulumi import aws:autoscaling/tag:Tag example asg-example,k8s.io/cluster-autoscaler/node-template/label/eks.amazonaws.com/capacityType

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository

AWS Classic pulumi/pulumi-aws

License

Apache-2.0

Notes

This Pulumi package is based on the aws Terraform Provider.