翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS DataSync タスクのタグ付け
<a name="tagging-tasks"></a>

*タグ*は、 AWS DataSync リソースの管理、フィルタリング、検索に役立つキーと値のペアです。DataSync タスクとタスク実行ごとに最大 50 個のタグを追加できます。

たとえば、大規模なデータ移行用のタスクを作成し、そのタスクにキー **Project** と値 **Large Migration** のタグを付けることができます。移行をさらに整理するには、1 回のタスクの実行にキー **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://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 リソースネーム (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://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/) で AWS DataSync コンソールを開きます。

1. 左側のナビゲーションペインで **[データ転送]** を展開し、**[タスク]** を選択します。

1. タスクを選択します。

1. **[Start (開始)]** を選択し、次のいずれかのオプションを選択します。
   + **[デフォルトで開始]** – タスクに関連付けられたタグをすべて適用します。
   + **[上書きオプションで開始]** – この特定のタスク実行に関するタグを追加、編集、または削除できます。

### の使用 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) コマンドを使用できます。