Erstellen von Verzeichnis-Buckets mit Tags - Amazon Simple Storage Service
BerechtigungenBehebung von FehlernSchritte

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.

Erstellen von Verzeichnis-Buckets mit Tags

Sie können Amazon S3-Verzeichnis-Buckets bei deren Erstellung mit Tags versehen. Es fallen keine zusätzlichen Kosten für die Verwendung von Tags in Verzeichnis-Buckets an, die über die Standard-S3-API-Anforderungsgebühren hinausgehen. Weitere Informationen finden Sie unter Amazon S3 – Preise. Weitere Information zu Verzeichnis-Buckets finden Sie unter Verwendung von Tags mit S3-Verzeichnis-Buckets.

Berechtigungen

Um einen Verzeichnis-Bucket mit Tags zu erstellen, müssen Sie über die folgenden Berechtigungen verfügen:

  • s3express:CreateBucket

  • s3express:TagResource

Behebung von Fehlern

Wenn Sie beim Versuch, einen Verzeichnis-Bucket mit Tags zu erstellen, auf einen Fehler stoßen, können Sie wie folgt vorgehen:

  • Stellen Sie sicher, dass Sie über das erforderliche Berechtigungen verfügen, um das Verzeichnis-Bucket zu erstellen und ihm ein Tag hinzuzufügen.

  • Überprüfen Sie Ihre IAM-Benutzerrichtlinie auf alle Bedingungen der attributbasierten Zugriffskontrolle (ABAC). Es kann erforderlich sein, Ihre Verzeichnis-Buckets nur mit bestimmten Tag-Schlüsseln und -Werten zu versehen. Weitere Informationen finden Sie unter Verwendung von Tags für 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 einen Verzeichnis-Bucket mit Tags über die Amazon-S3-Konsole:

  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 Verzeichnis-Buckets aus.

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

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

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

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

  5. Für beide Arten von Verzeichnis-Buckets steht auf der Seite Bucket erstellen die Option Tags zur Verfügung, wenn ein neuer Verzeichnis-Bucket erstellt wird.

  6. Geben Sie einen Namen für den Bucket ein. Weitere Informationen finden Sie unter Regeln für die Benennung von Verzeichnis-Buckets.

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

  8. Zum Hinzufügen eines weiteren Tags wählen Sie Neues Tag hinzufügen erneut aus. Sie können bis zu 50 Schlüssel-Wert-Paare taggen.

  9. Nachdem Sie die Optionen für Ihren neuen Verzeichnis-Bucket festgelegt haben, wählen Sie Bucket erstellen.

SDK for Java 2.x

In diesem Beispiel wird gezeigt, wie Sie einen Verzeichnis-Bucket mit Tags unter Verwendung von AWS SDK for Java 2.x erstellen können. Um den Befehl zu verwenden, ersetzen Sie die 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-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 Ihnen, wie Sie einen Verzeichnis-Bucket mit Tags unter Verwendung von AWS CLI erstellen können. 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/"
}