使用標籤建立目錄儲存貯體 - 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 SDKs建立已套用標籤的目錄儲存貯體。

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

  1. 登入 Amazon S3 主控台，網址為 https：//https://console.aws.amazon.com/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 使用者指南》中的安裝 CLI。 AWS Command Line Interface

下列 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/"
}