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

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-Konsole, die AWS Command Line Interface (AWS CLI), die Amazon S3 REST-API und AWS SDKs verwenden.

So erstellen Sie einen Verzeichnis-Bucket mit Tags über die Amazon-S3-Konsole:

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

  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.xerstellen können. Um den Befehl zu verwenden, ersetzen Sie den Platzhaltertext des Benutzers 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 CLIerstellen können. Um den Befehl zu verwenden, ersetzen Sie den Platzhaltertext des Benutzers 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

Anforderung:

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