Package com.pulumi.aws.ec2

Class Tag

java.lang.Object

com.pulumi.resources.Resource

com.pulumi.resources.CustomResource

com.pulumi.aws.ec2.Tag

public class Tag
extends com.pulumi.resources.CustomResource

Manages an individual EC2 resource tag. This resource should only be used in cases where EC2 resources are created outside the provider (e.g. AMIs), being shared via Resource Access Manager (RAM), or implicitly created by other means (e.g. Transit Gateway VPN Attachments). > **NOTE:** This tagging resource should not be combined with the providers resource for managing the parent resource. For example, using `aws.ec2.Vpc` and `aws.ec2.Tag` to manage tags of the same VPC will cause a perpetual difference where the `aws.ec2.Vpc` resource will try to remove the tag being added by the `aws.ec2.Tag` resource. ## Example Usage

 
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.ec2transitgateway.TransitGateway;
 import com.pulumi.aws.ec2.CustomerGateway;
 import com.pulumi.aws.ec2.CustomerGatewayArgs;
 import com.pulumi.aws.ec2.VpnConnection;
 import com.pulumi.aws.ec2.VpnConnectionArgs;
 import com.pulumi.aws.ec2.Tag;
 import com.pulumi.aws.ec2.TagArgs;
 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Map;
 import java.io.File;
 import java.nio.file.Files;
 import java.nio.file.Paths;
 
 public class App {
     public static void main(String[] args) {
         Pulumi.run(App::stack);
     }
 
     public static void stack(Context ctx) {
         var example = new TransitGateway("example");
 
         var exampleCustomerGateway = new CustomerGateway("exampleCustomerGateway", CustomerGatewayArgs.builder()
             .bgpAsn("65000")
             .ipAddress("172.0.0.1")
             .type("ipsec.1")
             .build());
 
         var exampleVpnConnection = new VpnConnection("exampleVpnConnection", VpnConnectionArgs.builder()
             .customerGatewayId(exampleCustomerGateway.id())
             .transitGatewayId(example.id())
             .type(exampleCustomerGateway.type())
             .build());
 
         var exampleTag = new Tag("exampleTag", TagArgs.builder()
             .resourceId(exampleVpnConnection.transitGatewayAttachmentId())
             .key("Name")
             .value("Hello World")
             .build());
 
     }
 }
 
 

## Import Using `pulumi import`, import `aws.ec2.Tag` using the EC2 resource identifier and key, separated by a comma (`,`). For example: ```sh $ pulumi import aws:ec2/tag:Tag example tgw-attach-1234567890abcdef,Name ```

Nested Class Summary

Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

com.pulumi.resources.CustomResource.CustomResourceInternal

Nested classes/interfaces inherited from class com.pulumi.resources.Resource

com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

Field Summary

Fields inherited from class com.pulumi.resources.Resource

childResources, remote

Constructor Summary

Constructors

Constructor	Description
Tag(java.lang.String name)
Tag(java.lang.String name, TagArgs args)
Tag(java.lang.String name, TagArgs args, com.pulumi.resources.CustomResourceOptions options)

Method Summary

Modifier and Type	Method	Description
static Tag	get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, TagState state, com.pulumi.resources.CustomResourceOptions options)	Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
com.pulumi.core.Output<java.lang.String>	key()
com.pulumi.core.Output<java.lang.String>	region()
com.pulumi.core.Output<java.lang.String>	resourceId()
com.pulumi.core.Output<java.lang.String>	value()

Methods inherited from class com.pulumi.resources.CustomResource

getId, id, idFuture

Methods inherited from class com.pulumi.resources.Resource

getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Tag

public Tag(java.lang.String name)

Parameters:

name - The _unique_ name of the resulting resource.

Tag

public Tag(java.lang.String name,
           TagArgs args)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

Tag

public Tag(java.lang.String name,
           TagArgs args,
           @Nullable
           com.pulumi.resources.CustomResourceOptions options)

Parameters:

name - The _unique_ name of the resulting resource.

args - The arguments to use to populate this resource's properties.

options - A bag of options that control this resource's behavior.

Method Detail

key

public com.pulumi.core.Output<java.lang.String> key()

Returns:

The tag name.

region

public com.pulumi.core.Output<java.lang.String> region()

Returns:

Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.

resourceId

public com.pulumi.core.Output<java.lang.String> resourceId()

Returns:

The ID of the EC2 resource to manage the tag for.

value

public com.pulumi.core.Output<java.lang.String> value()

Returns:

The value of the tag.

get

public static Tag get(java.lang.String name,
                      com.pulumi.core.Output<java.lang.String> id,
                      @Nullable
                      TagState state,
                      @Nullable
                      com.pulumi.resources.CustomResourceOptions options)

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

Parameters:

name - The _unique_ name of the resulting resource.

id - The _unique_ provider ID of the resource to lookup.

state -

options - Optional settings to control the behavior of the CustomResource.