本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 標記您的 AWS DataSync 任務
<a name="tagging-tasks"></a>

*標籤*是索引鍵/值對，可協助您管理、篩選和搜尋 AWS DataSync 資源。每個 DataSync 任務和任務執行最多可新增 50 個標籤。

例如，您可以為大型資料遷移建立任務，並使用索引鍵 **Project** 和值 標記任務**Large Migration**。若要進一步組織遷移，您可以使用金鑰**Transfer Date**和值來標記任務的一個執行 **May 2021**（後續任務執行可能會標記 **June 2021**、 **July 2021**等）。

## 標記 DataSync 任務
<a name="tagging-tasks-console"></a>

您只能在建立任務時標記 DataSync 任務。

### 使用 DataSync 主控台
<a name="tagging-tasks-console-steps"></a>

1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。

1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**任務**，然後選擇**建立任務**。

1. 設定任務的來源和目的地位置。

   如需詳細資訊，請參閱[我可以將資料傳輸到哪裡 AWS DataSync？](working-with-locations.md)

1. 在**設定設定**頁面上，選擇**新增標籤**以標記您的任務。

### 使用 AWS CLI
<a name="tagging-tasks-cli-steps"></a>

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 Resource Name (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 任務執行
<a name="tagging-task-executions-console"></a>

您可以標記 DataSync 任務的每個執行。

如果您的任務已有標籤，請記住下列有關搭配任務執行使用標籤的事項：
+ 如果您使用 主控台啟動任務，其使用者建立的標籤會自動套用至任務執行。不過，`aws:`不會套用以 開頭的系統建立標籤。
+ 如果您使用 DataSync API 或 啟動任務 AWS CLI，其標籤不會自動套用至任務執行。

### 使用 DataSync 主控台
<a name="tagging-task-executions-console"></a>

若要從任務執行新增、編輯或移除標籤，您必須使用覆寫選項啟動任務。

1. 在 https：//[https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) 開啟 AWS DataSync 主控台。

1. 在左側導覽窗格中，展開**資料傳輸**，然後選擇**任務**。

1. 選擇對應任務。

1. 選擇**開始**，然後選擇下列其中一個選項：
   + 從**預設值開始** – 套用與您的任務相關聯的任何標籤。
   + 從**覆寫選項開始** – 可讓您新增、編輯或移除此特定任務執行的標籤。

### 使用 AWS CLI
<a name="tagging-task-executions-cli"></a>

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) 命令。