Adding job tags to an existing Batch Operations job - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Adding job tags to an existing Batch Operations job

You can use the PutJobTagging API operation to add job tags to your existing Amazon S3 Batch Operations jobs. For more information, see the following examples.

The following is an example of using s3control put-job-tagging to add job tags to your S3 Batch Operations job by using the Amazon CLI. To use the examples, replace the user input placeholders with your own information.

Note

If you send this request with an empty tag set, Batch Operations deletes the existing tag set on the object. However, if you use this approach, you are charged for a Tier 1 Request (PUT). For more information, see Amazon S3 pricing.

Instead, to delete existing tags for your Batch Operations job, we recommend using the DeleteJobTagging operation because it achieves the same result without incurring charges.

  1. Identify the job TAGS that you want for the job. In this case, you apply two tags, department and FiscalYear, with the values Marketing and 2020 respectively.

    read -d '' TAGS <<EOF
[
  {
    "Key": "department",
    "Value": "Marketing"
  },
  {
    "Key": "FiscalYear",
    "Value": "2020"
  }
]
EOF

  2. Run the following put-job-tagging command with the required parameters:

    aws \
    s3control put-job-tagging \
    --account-id 123456789012 \
    --tags "${TAGS//$'\n'/}" \
    --job-id Example-e25a-4ed2-8bee-7f8ed7fc2f1c \
    --region us-east-1

To put tags on an S3 Batch Operations job using the Amazon SDK for Java, you can use the S3Control client to add or update tags with key-value pairs for organization and tracking purposes.

For examples of how to put job tags with the Amazon SDK for Java, see Add tags to a batch job in the Amazon S3 API Reference.