# S3 バケットタグでのコスト配分タグの使用
個々のプロジェクトまたはプロジェクトのグループのストレージコストや他の基準を追跡するには、コスト配分タグを使用して Amazon S3 バケットにラベルを付けます。*コスト割り当てタグ*はキーと値のペアで、ユーザーが S3 バケットに関連付けます。コスト配分タグを有効にすると、AWS はコスト配分レポートでリソースのコストの整理にタグを使用します。コスト割り当てタグは、バケットにラベルを付けるためだけに使用できます。オブジェクトにラベルを付けるために使用されるタグについては、「[タグを使用したオブジェクトの分類](object-tagging.md)」を参照してください。
*コスト配分レポート*には、アカウントの AWS 使用状況が製品カテゴリ別およびリンクされたアカウントユーザー別に表示されます。レポートには、同じ明細項目が詳細な請求レポートとして含まれ (「[Amazon S3 の AWS 請求および使用状況レポートを理解する](aws-usage-report-understand.md)」を参照)、タグキーは追加列に含まれます。
AWS には、AWS が生成するタグとユーザー定義タグの 2 種類のコスト配分タグが用意されています。AWS は、Amazon S3 の CreateBucket イベントの後に、AWS が生成する `createdBy` タグを定義、作成、適用します。ユーザーは S3 バケットの*ユーザー定義*タグを、定義、作成、適用します。
請求レポートに表示するには、請求およびコスト管理コンソールで両方の種類のタグを個別に有効化する必要があります。AWS が生成するタグの詳細については、「[AWS 生成コスト配分タグ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html)」を参照してください。
タグの有効化の詳細については、*AWS Billing ユーザーガイド*の[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)を参照してください。
**ユーザー定義のコスト配分タグ**
ユーザー定義コスト配分タグには以下のコンポーネントがあります。
+ タグキー。タグキーは、タグ名です。たとえば、project/Trinity タグでは project がキーです。タグキーは大文字小文字を区別する文字列で、1 ～ 128 個の Unicode 文字を含めることができます。
+ タグ値。タグ値は必須文字列です。たとえば、project/Trinity タグでは Trinity が値です。タグ値は大文字小文字を区別する文字列で、0 ～ 256 個の Unicode 文字を含めることができます。
ユーザー定義タグで使用できる文字や他の制限の詳細については、*AWS Billing ユーザーガイド*の[ユーザー定義タグの制限](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html)を参照してください。ユーザー定義タグの詳細については、*AWS Billing ユーザーガイド*の[ユーザー定義のコスト配分タグ](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html)を参照してください。
**S3 バケットのタグ**
各 S3 バケットはタグセットがあります。*タグセット*には、そのバケットに割り当てられているすべてのタグが含まれています。タグセットには最大 50 個のタグを含めることができ、空にすることもできます。キーはタグセット内で一意にする必要がありますが、タグセット内の値は一意である必要はありません。たとえば、同じ値を持つタグ project/Trinity と cost-center/Trinity を、同じタグセット内に持つことができます。
既存のタグと同じキーを持つタグをバケットに追加した場合、古い値は新しい値によって上書きされます。
AWS はタグに意味論的意味を適用しません。単なる文字列としてタグを解釈します。
タグを追加、一覧表示、編集、削除するには、Amazon S3 コンソール、AWS Command Line Interface (AWS CLI)、または Amazon S3 API を使用します。
## 汎用バケットのタグの管理
Amazon S3 コンソール、AWS コマンドラインインターフェイス (CLI)、 AWS SDK、または S3 API を使用して、汎用バケットのタグを追加または管理できます。詳細については、以下を参照してください。
**Amazon S3 コンソールの使用**
コンソールでタグを作成するときは、以下を参照してください。
+ [S3 汎用バケットのプロパティの表示](view-bucket-properties.md).
**API を使用する**
Amazon S3 API を使用してタグを管理するには、「*Amazon Simple Storage Service API リファレンス*」の以下の API ページを参照してください。
+ [PutBucketTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html)
+ [GetBucketTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html)
+ [DeleteBucketTagging](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html)
**注記**
ABAC を有効にすると、`PutBucketTagging` または `DeleteBucketTagging` オペレーションは機能しなくなります。代わりに、`TagResource` および `UntagResource` API を使用して、バケットにタグを追加または削除します。バケットで ABAC を有効にする前に、`TagResource` および `UntagResource` API を使用してタグ付けを管理することをお勧めします。ABAC の詳細については、「[汎用バケットでの ABAC の有効化](buckets-tagging-enable-abac.md)」を参照してください。
**CLI の使用**
AWS CLI を使用してタグを管理するには、「AWS CLI コマンドリファレンス」の以下のページを参照してください。
+ [put-bucket-tagging](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-bucket-tagging.html)
+ [get-bucket-tagging](https://docs.aws.amazon.com/cli/latest/reference/s3api/get-bucket-tagging.html)
+ [delete-bucket-tagging](https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-bucket-tagging.html)
## 詳細
+ *AWS Billing ユーザーガイド*の「[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」
+ [Amazon S3 の AWS 請求および使用状況レポートを理解する](aws-usage-report-understand.md)
+ [Amazon S3 の AWS Billing レポート](aws-billing-reports.md)