

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

# リソースのタグ付け
<a name="tagging"></a>

タグは、Amazon Translate リソースに関連付けることができるメタデータです。タグは、キーと値のペアから構成されます。タグは **[並列データ]** リソースと **[カスタム用語]** リソースに追加できます。

タグには主に 2 つの機能があります。1 つ目はリソースを整理することと、2 つ目はタグベースのアクセス制御を行うことです。リソースにタグを追加し、そのタグに基づいてリソースへのアクセスを許可または制限する IAM ポリシーを作成できます。

ポリシーでは、リクエストで指定されたタグ (request-tags) または呼び出すリソースに関連するタグ (resource-tags) に基づいてオペレーションを許可または禁止できます。IAM でタグを使用する方法については、「**IAM ユーザーガイド」の「[タグを使用してアクセスを制御する](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)」を参照してください。

Amazon Translate でタグを使用する際の考慮事項:
+ リソースごとに最大 50 個のユーザータグを追加できます。
+ リソースの作成時または作成後いつでもタグを追加できます。
+  タグ**キーは必須フィールドですが、タグ**値はオプションです。
+ タグはリソース間で一意である必要はありませんが、特定のリソースのタグには一意のキーが必要です。
+ タグのキーと値では、大文字と小文字が区別されます。
+ タグキーは最大 128 文字、タグ値は最大 256 文字です。
+ AWS システムタグは、タグキーまたは値のプレフィックス`aws:`で始まります。このプレフィックスが含まれるタグの名前や値は、編集または削除できません。システムタグは、リソースごとのタグクォータには含まれません。

**注記**  
複数の AWS サービスやリソースでタグ付けスキーマを使用する場合は、他のサービスで許可される文字の要件が異なる場合があることに注意してください。

**Topics**
+ [新しいリソースへのタグ付け](tagging-newtags.md)
+ [リソースに関連付けられたタグの表示、更新、削除](tagging-existingtags.md)

# 新しいリソースへのタグ付け
<a name="tagging-newtags"></a>

**ParallelData** リソースまたは **カスタム用語** リソースを作成する際に、タグを追加できます。

**新しいリソースにタグを追加する (コンソール)**

1. [Amazon Translate コンソール](https://console.aws.amazon.com/translate/) にサインインします。

1. 左のナビゲーションペインから、作成するリソース (`Parallel data` または `Custom terminology`) を選択します。

1. **[並列データの作成]** または **[用語の作成]** を選択します。コンソールに、リソース作成のメインページが表示されます。このページの最後に **[タグ - **オプション]** パネルがあります。  
![\[空のタグパネルを示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/add-tags-1.png)

1. **[新しいタグを追加]** を選択してリソースのタグを追加します。タグキーおよびタグ値 (オプション) を入力します。  
![\[1 つのタグが定義されたタグパネルを示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/add-tags-2.png)

1. ステップ 4 を繰り返して、すべてのタグを追加します。各キーは、このリソースに一意である必要があります。  
![\[新しいタグを追加するための空のフィールドを示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/add-tags-3.png)

1. **[並列データの作成]** または **[用語の作成]** を選択してリソースを作成します。

Amazon Translate の [CreateParallelData](https://docs.aws.amazon.com/translate/latest/APIReference/API_CreateParallelData.html) API オペレーションを使用してタグを追加することもできます。次の例では、create-parallel-data CLI コマンドでタグを追加する方法を示しています。

```
aws translate create-parallel-data \
--name "myTest" \
--parallel-data-config "{\"format\": \"CSV\",  \
             "S3Uri\": \"s3://test-input/TEST.csv\"}" \
--tags "[{\"Key\": \"color\",\"Value\": \"orange\"}]"
```

# リソースに関連付けられたタグの表示、更新、削除
<a name="tagging-existingtags"></a>

`Parallel data` または `Custom terminology` リソースに関連付けられているタグを表示、更新、削除できます。

**既存のリソースのタグを更新する方法 (コンソール)**

1. [Amazon Translate コンソール](https://console.aws.amazon.com/translate/) にサインインします。

1. 左のナビゲーションペインで `Parallel data` または `Custom terminology` を選択します。

1. 表示、更新、または削除するタグを含むリソースを選択します。コンソールにリソースの詳細ページが表示されます。

1. **[タグ]** パネルが表示されるまで下にスクロールします。ここには、選択したリソースに関連付けられているすべてのタグが表示されます。  
![\[タグパネルと 2 つのタグ (色とタイプ) を示すスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/translate/latest/dg/images/modify-tags-2.png)

   **[タグを管理]** を選択して、リソースからタグを編集または削除します。

1. 変更するテキストを選択し、タグを編集します。**[削除]** を選択してタグを削除することもできます。

1. 新しいタグを追加するには、**[新しいタグを追加]** を選択し、空白のフィールドにキーと値を入力します。

1. タグの変更が完了したら、**[保存]** を選択します。