建立具有標籤的目錄儲存貯體 - Amazon Simple Storage Service
許可故障診斷錯誤步驟

建立具有標籤的目錄儲存貯體

您可以在建立 Amazon S3 目錄儲存貯體時為其加上標籤。對於目錄儲存貯體使用標籤，除了標準的 S3 API 請求費率之外，不會收取額外費用。如需詳細資訊，請參閱 Simple Storage Service (Amazon S3) 定價。如需有關標記目錄儲存貯體的詳細資訊，請參閱 搭配使用標籤和 S3 目錄儲存貯體。

許可

若要建立具有標籤的目錄儲存貯體，您必須具有下列許可權：

  • s3express:CreateBucket

  • s3express:TagResource

故障診斷錯誤

如果您在嘗試建立具有標籤的目錄儲存貯體時遇到錯誤，您可以執行下列動作：

  • 確認您擁有建立目錄儲存貯體，並為其新增標籤時所需的 許可。

  • 檢查您的 IAM 使用者政策是否具備任何屬性型存取控制 (ABAC) 條件。您可能需要使用特定的標籤索引鍵和值，才能標記目錄儲存貯體。如需更多詳細資訊，請參閱 使用屬性型存取控制 (ABAC) 的標籤。

步驟

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

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

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

  2. 在左側導覽窗格中，選擇目錄儲存貯體。

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

  4. 您可以建立兩種類型的目錄儲存貯體：

    在可用區域中，為高效能工作負載建立目錄儲存貯體。如需更多詳細資訊，請參閱 高效能工作負載。

    在本地區域中，為資料落地工作負載建立目錄儲存貯體。如需更多詳細資訊，請參閱 資料落地工作負載。

  5. 對於這兩種類型的目錄儲存貯體，在建立儲存貯體頁面上，在建立新目錄儲存貯體時可採用標籤選項。

  6. 輸入儲存貯體的名稱。如需更多詳細資訊，請參閱 目錄儲存貯體命名規則。

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

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

  9. 完成指定新目錄儲存貯體的選項後，選擇建立儲存貯體。

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.BucketInfo;
import software.amazon.awssdk.services.s3.model.BucketType;
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.DataRedundancy;
import software.amazon.awssdk.services.s3.model.LocationInfo;
import software.amazon.awssdk.services.s3.model.LocationType;
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()
                .location(LocationInfo.builder()
                        .type(LocationType.AVAILABILITY_ZONE)
                        .name("usw2-az1").build())
                .bucket(BucketInfo.builder()
                        .type(BucketType.DIRECTORY)
                        .dataRedundancy(DataRedundancy.SINGLE_AVAILABILITY_ZONE)
                        .build())
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("amzn-s3-demo-bucket--usw2-az1--x-s3--usw2-az1--x-s3")
                .createBucketConfiguration(bucketConfiguration)
                .build();

        CreateBucketResponse response = s3.createBucket(createBucketRequest);
        System.out.println("Status code (should be 200):");
        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 建立具有標籤的目錄儲存貯體。若要使用此命令，請以您自己的資訊取代使用者輸入預留位置。

建立目錄儲存貯體時，您必須提供組態詳細資訊，並使用下列命名慣例：bucket-base-name--zone-id--x-s3

要求:

aws s3api create-bucket \
--bucket bucket-base-name--zone-id--x-s3 \
--create-bucket-configuration "Location={Type=AvailabilityZone,Name=zone-id},Bucket={DataRedundancy=SingleAvailabilityZone,Type=Directory},Tags=[{Key=mykey1,Value=myvalue1}, {Key=mykey2,Value=myvalue2}]"

回應：

{
  "Location": "http://bucket--use1-az4--x-s3.s3express-use1-az4.us-east-1.amazonaws.com/"
}