Construct Resource Tagger (AWS CDK V2)

AWS CDK aspect that applies tags to L1 (CfnResource) resources during synthesis.

Features

• Tag L1 resources that match one or more CloudFormation resource type names
• Apply multiple key-value tags in a single aspect registration
• Optionally restrict tagging to constructs whose path includes a substring (pathFilter)
• Control whether existing tag keys are overwritten (overwrite)
• Register once on a scope with Aspects.of(scope).add(...)

Installation

npm install construct-resource-tagger

yarn add construct-resource-tagger

aws-cdk-lib and constructs are peer dependencies and must be installed in your project.

Usage

import { App, Aspects, Stack } from 'aws-cdk-lib';
import { CfnBucket } from 'aws-cdk-lib/aws-s3';
import { ConstructResourceTagger } from 'construct-resource-tagger';

const app = new App();
const stack = new Stack(app, 'MyStack');

Aspects.of(stack).add(
  new ConstructResourceTagger({
    resourceTypes: [CfnBucket.CFN_RESOURCE_TYPE_NAME],
    tags: {
      env: 'prod',
      team: 'platform',
    },
  }),
);

new CfnBucket(stack, 'Bucket', {
  bucketName: 'my-example-bucket',
});

Multiple resource types

Pass multiple CloudFormation type names when the same tags should apply to several L1 resource types:

import { CfnTable } from 'aws-cdk-lib/aws-dynamodb';
import { CfnBucket } from 'aws-cdk-lib/aws-s3';
import { CfnQueue } from 'aws-cdk-lib/aws-sqs';

Aspects.of(stack).add(
  new ConstructResourceTagger({
    resourceTypes: [
      CfnBucket.CFN_RESOURCE_TYPE_NAME,
      CfnTable.CFN_RESOURCE_TYPE_NAME,
      CfnQueue.CFN_RESOURCE_TYPE_NAME,
    ],
    tags: {
      env: 'prod',
      team: 'platform',
    },
  }),
);

Scoped tagging with pathFilter

When you only want to tag resources under a specific part of the construct tree, set pathFilter to a substring of node.path:

import { CfnBucket } from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

const nested = new Construct(stack, 'DataPlane');

Aspects.of(stack).add(
  new ConstructResourceTagger({
    resourceTypes: [CfnBucket.CFN_RESOURCE_TYPE_NAME],
    tags: { tier: 'data' },
    pathFilter: 'DataPlane',
  }),
);

new CfnBucket(stack, 'Outside', { bucketName: 'outside-bucket' }); // not tagged
new CfnBucket(nested, 'Inside', { bucketName: 'inside-bucket' }); // tagged

Respecting existing tags

By default, configured tags overwrite existing keys with the same name. Set overwrite: false to keep manually defined tags and add only missing keys:

import { CfnBucket } from 'aws-cdk-lib/aws-s3';

new CfnBucket(stack, 'Bucket', {
  bucketName: 'my-example-bucket',
  tags: [{ key: 'env', value: 'staging' }],
});

Aspects.of(stack).add(
  new ConstructResourceTagger({
    resourceTypes: [CfnBucket.CFN_RESOURCE_TYPE_NAME],
    tags: { env: 'prod', team: 'platform' },
    overwrite: false,
  }),
);

// env stays "staging"; team is added as "platform"

Options

| Option | Type | Required | Description | |--------|------|----------|-------------| | resourceTypes | string[] | Yes | CloudFormation type names (for example CfnBucket.CFN_RESOURCE_TYPE_NAME). Must contain at least one entry. | | tags | Record<string, string> | Yes | Tag key-value pairs applied to each matching resource | | pathFilter | string | No | When set, only resources whose construct path includes this substring are tagged | | overwrite | boolean | No | When false, skip tag keys that already exist on the resource (default: true) |

Requirements

• Node.js >= 20.0.0
• aws-cdk-lib ^2.232.0
• constructs ^10.5.1

License

This project is licensed under the Apache-2.0 License.