本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为你的 Amazon DataSync 任务加标签
标记您的任务

*标签*是键值对，可帮助您管理、筛选和搜索 Amazon DataSync 资源。您最多可以为每个 DataSync 任务和任务执行添加 50 个标签。

例如，您可以为大型数据迁移创建任务，并使用密钥**Project**和值标记任务**Large Migration**。若要进一步组织迁移，您可以使用密钥**Transfer Date**和值**May 2021**标记任务的一次运行（后续任务执行可能会被标记**June 2021**、**July 2021**等）。

## 给你的 DataSync 任务加标签


只有在创建 DataSync 任务时才能为任务添加标签。

### 使用控制 DataSync 台


1. 打开 Amazon DataSync 控制台，网址为[https://console.aws.amazon.com/datasync/](https://console.amazonaws.cn/datasync/)。

1. 在左侧导航窗格中，展开**数据传输**，然后选择**任务**，然后选择**创建任务**。

1. 配置您任务的源位置和目标位置。

   有关更多信息，请参阅 [我可以在哪里传输我的数据 Amazon DataSync？](working-with-locations.md)。

1. 在**配置设置**页面，选择**添加新标签**来标记您的任务。

### 使用 Amazon CLI


1. 复制以下 `create-task` 命令：

   ```
   aws datasync create-task \
       --source-location-arn 'arn:aws:datasync:region:account-id:location/source-location-id' \
       --destination-location-arn 'arn:aws:datasync:region:account-id:location/destination-location-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. 指定命令中的以下参数：
   + `--source-location-arn` – 指定传输中源位置的 Amazon 资源名称（ARN）。
   + `--destination-location-arn` – 请指定传输中目标位置的 ARN。
   + `--tags` – 指定要应用于任务的标签。

     对于多个标签，请用空格分隔密钥值对。

1. （可选）指定适用于您传输场景的其他参数。

   有关`--options`列表，请参阅 [create-task](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/create-task.html)命令。

1. 运行 `create-task` 命令。

   您会收到一条回复，表明您刚刚创建的任务。

   ```
   {
       "TaskArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

要查看您为此任务添加的标签，可以使用[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)命令。

## 为 DataSync 任务执行添加标签


您可以为 DataSync 任务的每一次运行添加标签。

如果您的任务已有标签，请记住以下有关任务执行中使用标签的信息：
+ 如果您使用控制台启动任务，其用户创建的标签将自动应用于任务执行。但是，系统创建的以开头的标签 `aws:`不适用。
+ 如果您使用 DataSync API 或启动任务 Amazon CLI，则其标签不会自动应用于任务执行。

### 使用控制 DataSync 台


要在任务执行中添加、编辑或移除标签，必须通过覆盖选项启动任务。

1. 打开 Amazon DataSync 控制台，网址为[https://console.aws.amazon.com/datasync/](https://console.amazonaws.cn/datasync/)。

1. 在左侧导航窗格中，展开**数据传输**，然后选择**任务**。

1. 选择任务。

1. 选择**开始**，然后选择下列选项之一：
   + **从默认值开始**-应用与您的任务关联的所有标签。
   + 从@@ **覆盖选项开始** — 允许您添加、编辑或删除此特定任务执行的标签。

### 使用 Amazon CLI


1. 复制以下 `start-task-execution` 命令：

   ```
   aws datasync start-task-execution \
       --task-arn 'arn:aws:datasync:region:account-id:task/task-id' \
       --tags Key=tag-key,Value=tag-value
   ```

1. 指定命令中的以下参数：
   + `--task-arn` – 指定要启动的任务的 ARN。
   + `--tags` – 指定要应用于此特定任务运行的标签。

     对于多个标签，请用空格分隔密钥值对。

1. （可选）指定对您有意义的其他参数。

   有关更多信息，请参阅 [start-task-execution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/start-task-execution.html) 命令。

1. 运行 `start-task-execution` 命令。

   您会收到一条回复，其中显示了您刚刚开始的任务执行情况。

   ```
   {
       "TaskExecutionArn": "arn:aws:datasync:us-east-2:123456789012:task/task-abcdef01234567890"
   }
   ```

要查看您为此任务添加的标签，可以使用[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/list-tags-for-resource.html)命令。