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

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

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

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

**注意**  
如果您发送带有空标签集的此请求，批量操作将删除对象上的现有标签集。但是，如果您使用此方法，则需为套餐 1 请求 (`PUT`) 付费。有关更多信息，请参阅 [Amazon S3 定价](https://www.amazonaws.cn/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 的 Amazon SDK
<a name="batch-ops-examples-java-job-with-tags-put"></a>

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

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