software.amazon.awscdk.core

Class TagManager

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.TagManager

@Generated(value="jsii-pacmak/1.71.0 (build f1f58ae)",
           date="2022-11-29T04:32:13.806Z")
public class TagManager
extends software.amazon.jsii.JsiiObject

TagManager facilitates a common implementation of tagging for Constructs.

Normally, you do not need to use this class, as the CloudFormation specification will indicate which resources are taggable. However, sometimes you will need this to make custom resources taggable. Used tagManager.renderedTags to obtain a value that will resolve to the tags at synthesis time.

Example:

 import software.amazon.awscdk.core.*;
 public class MyConstruct extends Resource implements ITaggable {
     public final Object tags;
     public MyConstruct(Construct scope, String id) {
         super(scope, id);
         CfnResource.Builder.create(this, "Resource")
                 .type("Whatever::The::Type")
                 .properties(Map.of(
                         // ...
                         "Tags", this.tags.getRenderedTags()))
                 .build();
     }
 }
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TagManager.Builder A fluent builder for TagManager.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TagManager(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	TagManager(software.amazon.jsii.JsiiObjectRef objRef)
	TagManager(TagType tagType, java.lang.String resourceTypeName)
	TagManager(TagType tagType, java.lang.String resourceTypeName, java.lang.Object tagStructure)
	TagManager(TagType tagType, java.lang.String resourceTypeName, java.lang.Object tagStructure, TagManagerOptions options)

Method Summary

Modifier and Type	Method and Description
java.lang.Boolean	applyTagAspectHere() Determine if the aspect applies here.
java.lang.Boolean	applyTagAspectHere(java.util.List<java.lang.String> include) Determine if the aspect applies here.
java.lang.Boolean	applyTagAspectHere(java.util.List<java.lang.String> include, java.util.List<java.lang.String> exclude) Determine if the aspect applies here.
IResolvable	getRenderedTags() A lazy value that represents the rendered tags at synthesis time.
java.lang.String	getTagPropertyName() The property name for tag values.
java.lang.Boolean	hasTags() Returns true if there are any tags defined.
static java.lang.Boolean	isTaggable(java.lang.Object construct) Check whether the given construct is Taggable.
void	removeTag(java.lang.String key, java.lang.Number priority) Removes the specified tag from the array if it exists.
java.lang.Object	renderTags() Renders tags into the proper format based on TagType.
void	setTag(java.lang.String key, java.lang.String value) Adds the specified tag to the array of tags.
void	setTag(java.lang.String key, java.lang.String value, java.lang.Number priority) Adds the specified tag to the array of tags.
void	setTag(java.lang.String key, java.lang.String value, java.lang.Number priority, java.lang.Boolean applyToLaunchedInstances) Adds the specified tag to the array of tags.
java.util.Map<java.lang.String,java.lang.String>	tagValues() Render the tags in a readable format.

Methods inherited from class java.lang.Object

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

Constructor Detail

TagManager

protected TagManager(software.amazon.jsii.JsiiObjectRef objRef)

TagManager

protected TagManager(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

TagManager

public TagManager(TagType tagType,
                  java.lang.String resourceTypeName,
                  java.lang.Object tagStructure,
                  TagManagerOptions options)

Parameters:

tagType - This parameter is required.

resourceTypeName - This parameter is required.

tagStructure -

options -

TagManager

public TagManager(TagType tagType,
                  java.lang.String resourceTypeName,
                  java.lang.Object tagStructure)

Parameters:

tagType - This parameter is required.

resourceTypeName - This parameter is required.

tagStructure -

TagManager

public TagManager(TagType tagType,
                  java.lang.String resourceTypeName)

Parameters:

tagType - This parameter is required.

resourceTypeName - This parameter is required.

Method Detail

isTaggable

public static java.lang.Boolean isTaggable(java.lang.Object construct)

Check whether the given construct is Taggable.

Parameters:

construct - This parameter is required.

applyTagAspectHere

public java.lang.Boolean applyTagAspectHere(java.util.List<java.lang.String> include,
                                            java.util.List<java.lang.String> exclude)

Determine if the aspect applies here.

Looks at the include and exclude resourceTypeName arrays to determine if the aspect applies here

Parameters:

include -

exclude -

applyTagAspectHere

public java.lang.Boolean applyTagAspectHere(java.util.List<java.lang.String> include)

Determine if the aspect applies here.

Looks at the include and exclude resourceTypeName arrays to determine if the aspect applies here

Parameters:

include -

applyTagAspectHere

public java.lang.Boolean applyTagAspectHere()

Determine if the aspect applies here.

Looks at the include and exclude resourceTypeName arrays to determine if the aspect applies here

hasTags

public java.lang.Boolean hasTags()

Returns true if there are any tags defined.

removeTag

public void removeTag(java.lang.String key,
                      java.lang.Number priority)

Removes the specified tag from the array if it exists.

Parameters:

key - The tag to remove. This parameter is required.

priority - The priority of the remove operation. This parameter is required.

renderTags

public java.lang.Object renderTags()

Renders tags into the proper format based on TagType.

This method will eagerly render the tags currently applied. In most cases, you should be using tagManager.renderedTags instead, which will return a Lazy value that will resolve to the correct tags at synthesis time.

setTag

public void setTag(java.lang.String key,
                   java.lang.String value,
                   java.lang.Number priority,
                   java.lang.Boolean applyToLaunchedInstances)

Adds the specified tag to the array of tags.

Parameters:

key - This parameter is required.

value - This parameter is required.

priority -

applyToLaunchedInstances -

setTag

public void setTag(java.lang.String key,
                   java.lang.String value,
                   java.lang.Number priority)

Adds the specified tag to the array of tags.

Parameters:

key - This parameter is required.

value - This parameter is required.

priority -

setTag

public void setTag(java.lang.String key,
                   java.lang.String value)

Adds the specified tag to the array of tags.

Parameters:

key - This parameter is required.

value - This parameter is required.

tagValues

public java.util.Map<java.lang.String,java.lang.String> tagValues()

Render the tags in a readable format.

getRenderedTags

public IResolvable getRenderedTags()

A lazy value that represents the rendered tags at synthesis time.

If you need to make a custom construct taggable, use the value of this property to pass to the tags property of the underlying construct.

getTagPropertyName

public java.lang.String getTagPropertyName()

The property name for tag values.

Normally this is tags but some resources choose a different name. Cognito UserPool uses UserPoolTags