

# 向现有批量操作任务添加任务标签
<a name="put-job-tags"></a>

可以使用 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutJobTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutJobTagging.html) API 操作向现有 Amazon S3 批量操作任务添加任务标签。有关更多信息，请参阅以下示例。

## 使用 AWS CLI
<a name="batch-ops-example-cli-job-tags-put-job-tagging"></a>

以下是使用 AWS CLI 通过 `s3control put-job-tagging` 向 S3 批量操作任务添加任务标签的示例。要使用这些示例，请将 {{`user input placeholders`}} 替换为您自己的信息。

**注意**  
如果您发送带有空标签集的此请求，批量操作将删除对象上的现有标签集。但是，如果您使用此方法，则需为套餐 1 请求 (`PUT`) 付费。有关更多信息，请参阅 [Amazon S3 定价](https://aws.amazon.com/s3/pricing)。  
相反，要删除批量操作任务的现有标签，建议使用 `DeleteJobTagging` 操作，因为该操作可在不产生费用的情况下实现相同的结果。

1. 确定您需要用于此任务的任务 `TAGS`。在这种情况下，您应用两个标签 `{{department}}` 和 `{{FiscalYear}}`，值分别为 `{{Marketing}}` 和 `{{2020}}`。

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

1. 使用所需参数运行以下 `put-job-tagging` 命令：

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

## 使用适用于 Java 的 AWS SDK
<a name="batch-ops-examples-java-job-with-tags-put"></a>

要使用适用于 Java 的 AWS SDK 在 S3 批量操作任务上放置标签，可以使用 S3Control 客户端来添加或更新带有键值对的标签，以用于整理和跟踪目的。

有关如何使用适用于 Java 的 AWS SDK 放置任务标签的示例，请参阅《Amazon S3 API Reference》**中的 [Add tags to a batch job](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_PutJobTagging_section.html)。