Tagging Your Pipeline

Tags are case-sensitive key-value pairs that consist of a key and an optional value, both defined by the user. You can apply up to ten tags to each pipeline. Tag keys must be unique for each pipeline. If you add a tag with a key that is already associated with the pipeline, it updates the value of that tag.

Applying a tag to a pipeline also propagates the tags to its underlying resources (for example, Amazon EMR clusters and Amazon EC2 instances). However, it does not apply these tags to resources in a FINISHED or otherwise terminated state. You can use the CLI to apply tags to these resources, if needed.

When you are finished with a tag, you can remove it from your pipeline.

To tag your pipeline using the AWS CLI

To add tags to a new pipeline, add the --tags option to your create-pipeline command. For example, the following option creates a pipeline with two tags, an environment tag with a value of production, and an owner tag with a value of sales.

--tags key=environment,value=production key=owner,value=sales

To add tags to an existing pipeline, use the add-tags command as follows:

aws datapipeline add-tags --pipeline-id df-00627471SOVYZEXAMPLE --tags key=environment,value=production key=owner,value=sales

To remove tags from an existing pipeline, use the remove-tags command as follows:

aws datapipeline remove-tags --pipeline-id df-00627471SOVYZEXAMPLE --tag-keys environment owner