# CloudFront リソースにタグを付ける
<a name="tagging"></a>

タグは、AWS リソースを特定し、整理するために使用できる単語または語句です。各リソースには複数のタグを追加でき、各タグにはユーザーが定義したキーと値が含まれています。たとえば、キーが "domain" で値が "example.com" というタグを付けることができます。追加したタグに基づいて、リソースを検索したりフィルタ処理したりできます。タグのユースケースの詳細については、「タグ付け AWS リソースとタグエディタガイド」の「[一般的なタグ付け戦略](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html)」を参照してください。

以下の例のように、CloudFront でタグを使用できます。
+ CloudFront ディストリビューションにタグベースのアクセス許可を適用します。詳細については、「[CloudFront での ABAC](security_iam_service-with-iam.md#security_iam_service-with-iam-tags)」を参照してください。
+ さまざまなカテゴリの請求情報を追跡します。CloudFront ディストリビューションまたは AWS リソース (Amazon EC2 インスタンスや Amazon S3 バケットなど) にタグを適用してタグをアクティブ化すると、AWS がアクティブなタグごとに使用量とコストを集計したコスト配分レポートを CSV (カンマ区切り値) ファイルとして生成します。

  自社のカテゴリ、たとえばコストセンター、アプリケーション名、所有者を表すタグを適用すると、複数のサービスにわたってコストを分類することができます。タグを使ったコスト配分の詳細については、*AWS Billing ユーザーガイド*の[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)を参照してください。

**注意事項**  
ディストリビューションをタグ付けできますが、オリジンアクセスアイデンティティや無効化をタグ付けすることはできません。
[タグエディタ](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)および [リソースグループ](https://docs.aws.amazon.com/ARG/latest/userguide/resource-groups.html)は、現在、CloudFront でサポートされていません。
ディストリビューションに追加できるタグの数の現在の最大制限については、「[一般的なクォータ](cloudfront-limits.md#limits-general)」を参照してください。

**Contents**
+ [タグの制限](#tagging-restrictions)
+ [請求用のリソースのタグ付け](#tagging-billing)
+ [タグを追加、編集、削除する](#tagging-add-edit-delete)
+ [プログラムによるタグ付け](#tagging-related-information)

## タグの制限
<a name="tagging-restrictions"></a>

タグには以下のベーシックな制限があります。
+ ディストリビューションあたりのタグの最大数については、「[一般的なクォータ](cloudfront-limits.md#limits-general)」を参照してください。
+ キーの最大長 – 128 文字 (Unicode)
+ 値の最大長 – 256 文字 (Unicode)
+ キーと値の有効な値 – a～z、A～Z、0～9、スペース、特殊文字 (\_ . : / = \+ - @)
+ タグのキーと値は大文字と小文字が区別されます。
+ `aws:` をキーのプレフィックスとして使用しないでください。このプレフィックスは AWS 専用として予約されています。

## 請求用のリソースのタグ付け
<a name="tagging-billing"></a>

タグを使用して AWS 請求書を整理し、自分のコスト構造を反映できます。これを行うには、まず請求およびコスト管理コンソールでコスト配分タグを有効にする必要があります。タグによるコスト配分レポートの設定の詳細については「AWS 請求ユーザーガイド」の「[コスト配分月次レポート](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html)」を参照してください。リソースを組み合わせたコストを確認するには同じタグキー値を持つリソースに基づいて、請求情報を整理します。例えば、複数のリソースに特定のアプリケーション名のタグを付け、請求情報を整理することで、複数のサービスを利用しているアプリケーションの合計コストを確認することができます。詳細については、「AWS 請求ユーザーガイド」の「[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。

**注記**  
レポートを有効にすると、約 24 時間後に、今月のデータを表示できるようになります。

## タグを追加、編集、削除する
<a name="tagging-add-edit-delete"></a>

CloudFront コンソールを使用して、CloudFront リソースのタグを管理できます。<a name="tagging-add-edit-delete-procedure"></a>

**リソースのタグを追加、編集、または削除するには**

1. AWS マネジメントコンソールにサインインし、[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home) で CloudFront コンソールを開きます。

1. リソースに移動します。
   +  **ディストリビューションの場合:** 更新するディストリビューションの ID を選択します。
   +  **関数の場合:** [関数] を選択し、更新する関数の名前を選択します。
   +  **KeyValueStore の場合:** [関数] を選択し、[KeyValueStore] タブを選択してから、更新する KeyValueStore の名前を選択します。

1. **[タグ]** タブを選択します。

1. **[タグを管理]** を選択します。

1. **[Manage tags]** (タグの管理) ページで、次の操作を実行できます。
   + タグを追加するには、キーと、タグの値 (オプション) を入力します。タグをさらに追加するには、**[新しいタグを追加]** を選択します。
   + タグを編集するには、タグのキーまたはその値、あるいはその両方を変更します。タグの値を削除することはできますが、キーが必要です。
   + タグを削除するには、**[削除]** を選択します。

1. **[Save changes]** (変更の保存) をクリックします。

## プログラムによるタグ付け
<a name="tagging-related-information"></a>

CloudFront API、AWS Command Line Interface (AWS CLI)、AWS SDK、および AWS Tools for Windows PowerShell を使用して、リソースにタグを適用することもできます。詳細については、以下の各トピックを参照してください。
+ CloudFront API 操作:
  + [ListTagsForResource](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListTagsForResource.html) 
  + [TagResource](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_TagResource.html) 
  + [UntagResource](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UntagResource.html) 
+ AWS CLI –*AWS CLI コマンドリファレンス*の「[cloudfront](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudfront/index.html)」を参照
+ AWS SDK – 「[AWS ドキュメント](https://docs.aws.amazon.com/index.html)」ページの該当する SDK ドキュメントを参照
+ Tools for Windows PowerShell — [AWS Tools for PowerShell Cmdlet リファレンス](https://docs.aws.amazon.com/powershell/latest/reference/)にある「[Amazon CloudFront](https://docs.aws.amazon.com/powershell/latest/reference/items/CloudFront_cmdlets.html)」を参照してください