バケットにタグを追加する - Amazon Simple Storage Service

バケットにタグを追加する

Amazon S3 バケットにタグを追加し、これらのタグを変更できます。バケットでタグを使用することによる追加料金は、標準の S3 API リクエスト料金を超えて発生しません。詳細については、「Amazon S3 の料金」を参照してください。バケットのタグ付けの詳細については、「S3 汎用バケットでタグを使用する」を参照してください。

アクセス許可

バケットにタグを追加するには、次のアクセス許可が必要です。

  • s3:TagResource

エラーのトラブルシューティング

バケットにタグを追加しようとしたときにエラーが発生した場合は、以下を実行できます。

  • バケットにタグを追加するために必要な アクセス許可 があることを確認します。

  • AWS 予約済みプレフィックス aws: で始まるタグキーを追加しようとした場合は、タグキーを変更して再試行してください。

Steps

Amazon S3 コンソール、AWS コマンドラインインターフェイス (AWS CLI)、Amazon S3 REST API、AWS SDK を使用して、バケットにタグを追加できます。

Amazon S3 コンソールを使用してバケットにタグを追加するには。

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

  2. 左側のナビゲーションペインで、[バケット] を選択します。

  3. バケット名を選択します。

  4. [プロパティ] タブを選択します。

  5. [タグ] セクションにスクロールして、[新しいタグを追加する] を選択します。

  6. [タグの追加] ページが開きます。最大 50 個のタグのキーと値のペアを入力できます。

  7. 既存のタグとキー名が同じ新しいタグを追加すると、既存のタグの値は新しいタグの値で上書きされます。

  8. このページで、既存のタグの値を編集することもできます。

  9. タグを追加したら、[変更の保存] を選択します。

SDK for Java 2.x

この例では、AWS SDK for Java 2.x を使用してタグを汎用バケットに追加する方法を示します。このコマンドを使用する際は、ユーザー入力用プレースホルダーを独自の情報に置き換えます。

import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.s3control.S3ControlClient; import software.amazon.awssdk.services.s3control.model.Tag; import software.amazon.awssdk.services.s3control.model.TagResourceRequest; import software.amazon.awssdk.services.s3control.model.TagResourceResponse; public class TagResourceExample { public static void tagResourceExample() { S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build(); TagResourceRequest tagResourceRequest = TagResourceRequest.builder() .resourceArn("arn:aws::s3:::bucket/my-bucket") .accountId("111122223333") .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build()) .build(); TagResourceResponse response = s3Control.tagResource(tagResourceRequest); System.out.println("Status code (should be 204):"); System.out.println(response.sdkHttpResponse().statusCode()); } }

Amazon S3 REST API での汎用バケットへのタグの追加のサポートの詳細については、「Amazon Simple Storage Service API リファレンス」の次のセクションを参照してください。

AWS CLI をインストールする方法については、「AWS Command Line Interface ユーザーガイド」の「AWS CLI のインストール」を参照してください。

以下の CLI の例は、AWS CLI を使用して汎用バケットにタグを追加する方法を示しています。このコマンドを使用する際は、ユーザー入力用プレースホルダーを独自の情報に置き換えます。

リクエスト]

aws s3control tag-resource --resource-arn arn:aws:s3:::amzn-s3-demo-bucket --region us-east-2 --account-id 444455556666 --tags '[{"Key":"mykey","Value":"myvalue"}]'