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

# Amazon Connect でリソースにタグを追加する
<a name="tagging"></a>

*タグ* は、リソースに追加して識別、整理、検索を容易にするための、カスタムなメタデータラベルです。各タグは、2 つの部分 (タグキーとタグ値) で構成されます。これは、*キーと値のペア*と呼ばれます。

通常、*タグキー*はカテゴリの大枠を表し、タグ値はそのカテゴリのサブセットを表します。例えば、*タグキー = Color* そして*タグ値 = Blue*とすると、キーと値のペアとしては `Color:Blue` が構成されます。タグの値を空の文字列に設定することはできますが、タグの値を null には設定できないことに注意してください。タグ値を省略すると、空の文字列を使用した場合と同じになります。



タグキーには最大 128 文字、タグ値には最大 256 文字を使用でき、どちらも大文字と小文字が区別されます。詳細については、以下を参照してください。
+  [Amazon Connect TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+  [Amazon Connect Customer Profiles TagResource](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_TagResource.html) 
+  [Amazon Connect Voice ID TagResource](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_TagResource.html): Voice ID ドメインにタグを追加できます。
+  [Amazon AppIntegrations TagResource](https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_TagResource.html) 

Amazon Connect サービスでは、リソースごとに最大 50 個のタグを使用できます。リソースごとに、各タグキーは一意である必要があり、1 つの値のみを与えることができます。

**注記**  
はシステム生成タグ用にこのプレフィックス AWS を予約`aws:`するため、タグは で始めることはできません。`aws:*` タグを追加、変更、削除することはできません。このタグは、リソースあたりの上限タグ数のためのカウントに含まれません。

次の表は、 AWS CLI または AWS SDK を使用してタグ付けできる Amazon Connect リソースを示しています。


**Amazon Connect リソースのタグ付けサポート**  

| [リソース]  |  Connect Customer 管理ウェブサイトを使用したタグ付けをサポート | CLI/SDK を使用してタグ付けをサポート | 作成時のタグ付けをサポート | 
| --- | --- | --- | --- | 
| [エージェント] | はい  | はい | はい | 
| エージェントグループ | いいえ | はい | はい | 
| エージェントグループレベル | いいえ | なし | はい | 
| エージェントの状態 | いいえ | はい | はい | 
| ケース | はい  | はい | はい | 
| 問い合わせ | いいえ | いいえ | いいえ | 
| 連絡先評価 | いいえ | はい | はい | 
| [E メールアドレス] | はい  | はい | はい | 
| 評価フォーム | はい  | はい | はい | 
| フロー | はい  | はい | はい | 
| フローモジュール | はい  | はい | はい | 
| オペレーション時間 | はい  | はい | はい | 
| インスタンス | はい | はい | はい | 
| 統合の関連付け | いいえ | はい | はい | 
| アウトバウンドキャンペーン | いいえ | はい | はい | 
| Phone number (電話番号) | いいえ | はい | はい | 
| プロンプト | はい  | はい | はい | 
| キューエージェント | いいえ | なし | はい | 
| [キュー] | はい  | はい | はい | 
| クイック接続 | いいえ | はい | はい | 
| [ルーティングプロファイル] | はい  | はい | はい | 
| セキュリティプロファイル | はい  | はい | はい | 
| タスクテンプレート | いいえ | なし | はい | 
| トラフィック分散グループ | いいえ | はい | はい | 
| 転送先 | いいえ | はい | はい | 
| ユースケース | いいえ | はい | はい | 
| 語彙 | いいえ | はい | はい | 

ベストプラクティスを含むタグ付けの詳細については、*AWS 「 全般のリファレンス*」の[AWS 「リソースのタグ付け](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)」を参照してください。

## タグメタデータは、Amazon Connect インスタンスが削除された場合にのみ削除されます。
<a name="tag-retention"></a>

Amazon Connect は、リソースが削除された後でも、リソースのタグメタデータを保持します。Amazon Connect インスタンスがアクティブである限り、メタデータは保持されます。

この設計は、履歴レポートとアクセスコントロール (TBAC) のユースケースをサポートします。具体的には、Amazon Connect は履歴メトリクスにタグベースのアクセスコントロールを使用します。リソースが削除された直後にタグが削除された場合、以前それらのリソースにアクセスできなかったユーザーが、それらのリソースに関連する履歴メトリクスへのアクセスを誤って得てしまう可能性があります。タグを保持すると、アクセス境界は時間が経過しても一貫して維持されます。

タグは、Amazon Connect インスタンス全体が削除された後にのみ削除されます。この時点では、履歴データアクセスは適用されません。

## タグベースのアクセス制御
<a name="tagging-access-control"></a>

タグを使用して AWS アカウント内のリソースへのアクセスを制御するには、IAM ポリシーの条件要素でタグ情報を指定する必要があります。例えば、Voice ID ドメインに割り当てたタグに基づいてそのドメインへのアクセスを制御するには、`aws:ResourceTag/key-name` 条件キーを使用して、ドメインにアタッチする必要があるタグのキーと値のペアを指定します。これにより必要なアクションを許可します。

Amazon Connect コンソールでのタグベースのアクセスコントロールの詳細については、「[Amazon Connect でタグベースのアクセスコントロールを適用する](tag-based-access-control.md)」を参照してください。

IAM でのタグベースのアクセスコントロールの詳細については、*「IAM ユーザーガイド*[」の「タグを使用した AWS リソースへのアクセスの制御](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)」を参照してください。