本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用標籤建立一般用途儲存貯體
<a name="bucket-create-tag"></a>

您可以在建立 Amazon S3 一般用途儲存貯體時為其加上標籤。在超過標準 S3 API 請求率的儲存貯體上使用標籤不會產生額外費用。如需詳細資訊，請參閱 [Simple Storage Service (Amazon S3) 定價](https://docs.aws.amazon.com/s3/pricing/)。如需標記儲存貯體的詳細資訊，請參閱 [搭配 S3 一般用途儲存貯體使用標籤](buckets-tagging.md)。

## 許可
<a name="bucket-create-tag-permissions"></a>

若要建立具有標籤的儲存貯體，您必須具有下列許可：
+ `s3:CreateBucket`
+ `s3:TagResource`

Amazon S3 主控台和 CloudFormation 現在使用此功能來建立具有標籤的儲存貯體。

## 故障診斷錯誤
<a name="bucket-create-tag-troubleshooting"></a>

如果您在嘗試使用標籤建立儲存貯體時遇到錯誤，您可以執行下列動作：
+ 確認您擁有建立儲存貯體並新增標籤[許可](#bucket-create-tag-permissions)所需的 。
+ 檢查您的 IAM 政策是否有 `aws:TagKeys`或 `aws:RequestTag/key-name`條件索引鍵。您可能需要只使用特定的標籤索引鍵和值來標記儲存貯體。如需詳細資訊，請參閱[使用屬性型存取控制 (ABAC) 的標籤](tagging.md#using-tags-for-abac)。

**注意**  
Amazon S3 和 CloudFormation 現在使用此功能來建立具有標籤的儲存貯體。建立具有標籤的儲存貯體時，請注意，使用 `aws:ResourceTag`和 `s3:BucketTag`條件索引鍵存取儲存貯體的標籤型條件僅適用於在儲存貯體上啟用 ABAC 之後。如需詳細資訊，請參閱 [在一般用途儲存貯體中啟用 ABAC](buckets-tagging-enable-abac.md)。

## 步驟
<a name="bucket-create-tag-steps"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs建立套用標籤的儲存貯體。

## 使用 S3 主控台
<a name="bucket-create-tag-console"></a>

若要使用 Amazon S3 主控台建立具有標籤的儲存貯體：

1. 從 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 登入 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**儲存貯**體。

1. 選擇**建立儲存貯**體以建立新的儲存貯體。

1. 像平常一樣建立一般用途儲存貯體的儲存貯體；請參閱[建立一般用途儲存貯體](create-bucket-overview.md)。

1. 在**建立儲存貯**體頁面上，**標籤**是建立新儲存貯體時的選項。

1. 輸入儲存貯體的名稱。如需詳細資訊，請參閱[一般用途儲存貯體命名規則](bucketnamingrules.md)。

1. 選擇**新增標籤**以開啟標籤編輯器，然後輸入標籤鍵值對。標籤鍵為必要項，但標籤是選用的。

1. 若要新增另一個標籤，請再次選擇**新增標籤**。您最多能輸入 50 個鍵值對。

1. 完成指定新儲存貯體的選項後，請選擇**建立儲存貯**體。

## 使用 AWS SDKs
<a name="bucket-create-tag-sdks"></a>

------
#### [ SDK for Java 2.x ]

此範例說明如何使用 建立具有標籤的一般用途儲存貯體 AWS SDK for Java 2.x。若要使用此命令，請以您自己的資訊取代*使用者輸入預留位置*。

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.BucketLocationConstraint;
import software.amazon.awssdk.services.s3.model.CreateBucketConfiguration;
import software.amazon.awssdk.services.s3.model.CreateBucketRequest;
import software.amazon.awssdk.services.s3.model.CreateBucketResponse;
import software.amazon.awssdk.services.s3.model.Tag;

public class CreateBucketWithTagsExample {
    public static void createBucketWithTagsExample() {
        S3Client s3 = S3Client.builder().region(Region.US_WEST_2).build();

        CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder()
                .locationConstraint(BucketLocationConstraint.US_WEST_2)
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("mybucket")
                .createBucketConfiguration(bucketConfiguration)
                .build();

        CreateBucketResponse response = s3.createBucket(createBucketRequest);
        System.out.println("Status code (should be 200):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}
```

------

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

如需使用標籤建立一般用途儲存貯體的 Amazon S3 REST API 支援相關資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的下列章節：
+ [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)

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

若要安裝 AWS CLI，請參閱《 [AWS 使用者指南》中的安裝 CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。 *AWS Command Line Interface *

下列 CLI 範例示範如何使用 建立具有標籤的儲存貯體 AWS CLI。若要使用此命令，請以您自己的資訊取代*使用者輸入預留位置*。

建立儲存貯體時，您必須提供組態詳細資訊，並使用下列命名慣例： `amzn-s3-demo-bucket`

**要求:**

```
aws s3api create-bucket \
--bucket mybucket \
--create-bucket-configuration 'LocationConstraint=us-west-2,Tags=[{Key=MyTagKey,Value=MyTagValue}]' --region us-west-2"
```

**回應：**

```
{
  "Location": "http://mybuckets3.amazonaws.com/"
}
```