# バケットにタグを追加する
<a name="bucket-tag-add"></a>



Amazon S3 バケットにタグを追加し、これらのタグを変更できます。バケットでタグを使用することによる追加料金は、標準の S3 API リクエスト料金を超えて発生しません。詳細については、「[Amazon S3 の料金](https://docs.aws.amazon.com/s3/pricing/)」を参照してください。バケットのタグ付けの詳細については、「[S3 汎用バケットでタグを使用する](buckets-tagging.md)」を参照してください。

## アクセス許可
<a name="bucket-tag-add-permissions"></a>

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

## エラーのトラブルシューティング
<a name="bucket-tag-add-troubleshooting"></a>

バケットにタグを追加しようとしたときにエラーが発生した場合は、以下を実行できます。
+ バケットにタグを追加するために必要な [アクセス許可](#bucket-tag-add-permissions) があることを確認します。
+ AWS 予約済みプレフィックス `aws:` で始まるタグキーを追加しようとした場合は、タグキーを変更して再試行してください。

## Steps
<a name="bucket-tag-add-steps"></a>

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

## S3 コンソールの使用
<a name="bucket-tag-add-console"></a>

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

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

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

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

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

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

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

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

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

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

## AWS SDK の使用
<a name="bucket-tag-add-sdks"></a>

------
#### [ 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());
    }
}
```

------

## REST API の使用
<a name="bucket-tag-add-api"></a>

Amazon S3 REST API での汎用バケットへのタグの追加のサポートの詳細については、「*Amazon Simple Storage Service API リファレンス*」の次のセクションを参照してください。
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

## の使用AWS CLI
<a name="bucket-tag-add-cli"></a>

AWS CLI をインストールする方法については、「*AWS Command Line Interface ユーザーガイド*」の「[AWS CLI のインストール](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。

以下の 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"}]'
```