AWS Data Pipeline
Developer Guide (API Version 2012-10-29)

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 console

  1. Open the AWS Data Pipeline console at https://console.aws.amazon.com/datapipeline/.

  2. On the List Pipelines page, in the Pipeline ID column, click the expand arrow next to your pipeline, and then click View all/Edit under Tags.

  3. In the View all / Edit dialog box, do the following:

    1. Specify a key and a value for each tag that you'd like to add.

    2. Click the remove icon of any tags that you'd like to remove.

    3. Click Save.

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