Verzeichnis-Buckets mit Tags erstellen - Amazon Simple Storage Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verzeichnis-Buckets mit Tags erstellen

Sie können Amazon S3-Verzeichnis-Buckets kennzeichnen, wenn Sie sie erstellen. Für die Verwendung von Tags in Verzeichnis-Buckets fallen keine zusätzlichen Gebühren an, die über die standardmäßigen S3-API-Anforderungsraten hinausgehen. Weitere Informationen finden Sie unter Amazon S3 – Preise. Weitere Informationen zum Taggen von Verzeichnis-Buckets finden Sie unter. Verwenden von Tags mit S3-Verzeichnis-Buckets

Berechtigungen

Um einen Verzeichnis-Bucket mit Tags zu erstellen, benötigen Sie die folgenden Berechtigungen:

  • s3express:CreateBucket

  • s3express:TagResource

Behebung von Fehlern

Wenn beim Versuch, einen Verzeichnis-Bucket mit Tags zu erstellen, ein Fehler auftritt, können Sie wie folgt vorgehen:

  • Vergewissern Sie sich, dass Sie über die erforderlichen Berechtigungen Daten verfügen, um den Verzeichnis-Bucket zu erstellen und ihm ein Tag hinzuzufügen.

  • Überprüfen Sie Ihre IAM-Benutzerrichtlinie auf alle Bedingungen für die attributebasierte Zugriffskontrolle (ABAC). Möglicherweise müssen Sie Ihre Verzeichnis-Buckets nur mit bestimmten Tag-Schlüsseln und -Werten kennzeichnen. Weitere Informationen finden Sie unter Verwendung von Tags für die attributbasierte Zugriffskontrolle (ABAC).

Schritte

Sie können einen Verzeichnis-Bucket mit angewendeten Tags erstellen, indem Sie die Amazon S3 S3-Konsole, die AWS Command Line Interface (AWS CLI), die Amazon S3 S3-REST-API und verwenden AWS SDKs.

So erstellen Sie mithilfe der Amazon S3 S3-Konsole einen Verzeichnis-Bucket mit Tags:

  1. Melden Sie sich bei der Amazon S3 S3-Konsole an unter https://console.aws.amazon.com/s3/.

  2. Wählen Sie im linken Navigationsbereich Directory-Buckets aus.

  3. Wählen Sie Create Bucket, um einen neuen Verzeichnis-Bucket zu erstellen.

  4. Sie können zwei Arten von Verzeichnis-Buckets erstellen:

    Erstellen Sie einen Verzeichnis-Bucket in einer Availability Zone für einen Hochleistungs-Workload. Weitere Informationen finden Sie unter Leistungsintensive Workloads.

    Erstellen Sie einen Verzeichnis-Bucket in einer lokalen Zone für einen Datenresidenz-Workload. Weitere Informationen finden Sie unter Workloads mit Datenresidenz.

  5. Für beide Typen von Verzeichnis-Buckets ist auf der Seite Bucket erstellen die Option Tags eine Option, wenn ein neuer Verzeichnis-Bucket erstellt wird.

  6. Geben Sie einen Namen für den Bucket ein. Weitere Informationen finden Sie unter .

  7. Wählen Sie Neues Tag hinzufügen, um den Tags-Editor zu öffnen, und geben Sie ein Tag-Schlüssel-Wert-Paar ein. Der Tag-Schlüssel ist erforderlich, der Wert ist jedoch optional.

  8. Um ein weiteres Tag hinzuzufügen, wählen Sie erneut Neues Tag hinzufügen aus. Sie können bis zu 50 Tag-Schlüssel-Wert-Paare eingeben.

  9. Nachdem Sie die Optionen für Ihren neuen Verzeichnis-Bucket angegeben haben, wählen Sie Create Bucket aus.

SDK for Java 2.x

Dieses Beispiel zeigt, wie Sie mithilfe von einen Verzeichnis-Bucket mit Tags erstellen AWS SDK for Java 2.x. Um den Befehl zu verwenden, ersetzen Sie den user input placeholders durch Ihre eigenen Informationen.

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

Informationen zur Amazon S3 S3-REST-API-Unterstützung für die Erstellung eines Verzeichnis-Buckets mit Tags finden Sie im folgenden Abschnitt der Amazon Simple Storage Service API-Referenz:

Informationen zur Installation der AWS CLI finden Sie unter Installation der AWS CLI im AWS Command Line Interface Benutzerhandbuch.

Das folgende CLI-Beispiel zeigt, wie Sie mithilfe von einen Verzeichnis-Bucket mit Tags erstellen AWS CLI. Um den Befehl zu verwenden, ersetzen Sie den user input placeholders durch Ihre eigenen Informationen.

Wenn Sie einen Verzeichnis-Bucket erstellen, müssen Sie Konfigurationsdetails angeben und die folgende Benennungskonvention verwenden: bucket-base-name--zone-id--x-s3

Anfrage:

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}]"

Antwort:

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