Benennungsregeln für Allzweck-Buckets

Wenn Sie einen Allzweck-Bucket erstellen, achten Sie auf die Länge, die gültigen Zeichen, die Formatierung und die Eindeutigkeit der Bucket-Namen. Die folgenden Abschnitte enthalten Informationen zur Benennung von Buckets für allgemeine Zwecke, darunter Benennungsregeln und bewährte Methoden sowie ein Beispiel dafür, wie Sie Buckets im regionalen Namespace Ihres Kontos erstellen können. Ein Beispiel für die Erstellung eines Allzweck-Buckets mit einem Namen, der eine GUID (Globally Unique Identifier) enthält.

Informationen über Objektschlüsselnamen finden Sie unter Erstellen von Objektschlüsselnamen.

Um einen Allzweck-Bucket zu erstellen, siehe Erstellen eines Allzweck-Buckets.

Regeln für die Benennung von Buckets für allgemeine Zwecke

Die folgenden Regeln gelten für die Benennung von Buckets für allgemeine Zwecke.

Benennungsregeln für regionale Namespaces von Konten

Obwohl Allzweck-Buckets von Amazon S3 in einem gemeinsamen globalen Namespace existieren, können Sie optional Buckets im regionalen Namespace Ihres Kontos erstellen. Der regionale Namespace für das Konto ist eine reservierte Unterteilung des globalen Bucket-Namespace, in der nur Ihr Konto Allzweck-Buckets erstellen kann. Neue Allzweck-Buckets, die im regionalen Namespace Ihres Kontos erstellt wurden, gelten nur für Ihr Konto und können niemals von einem anderen Konto neu erstellt werden. Diese Buckets unterstützen alle S3-Funktionen und AWS -Dienste, die Allzweck-Buckets im gemeinsamen globalen Namespace bereits unterstützen. Ihre Anwendungen müssen nicht geändert werden, um mit Buckets in Ihrem regionalen Namespace zu interagieren.

Allzweck-Buckets im regionalen Namespace Ihres Kontos müssen einer bestimmten Namenskonvention folgen. Diese Buckets bestehen aus einem Bucket-Namenspräfix, das Sie erstellen, und einem Suffix, das Ihre 12-stellige AWS-Konto ID und den AWS-Region Code enthält und mit endet. -an

bucket-name-prefix-accountId-region-an

Beispielsweise ist der folgende Allzweck-Bucket im regionalen Namespace des Kontos für AWS-Konto 111122223333 in der Region us-west-2 vorhanden:

amzn-s3-demo-bucket-111122223333-us-west-2-an

Um einen Bucket im regionalen Namespace Ihres Kontos zu erstellen, stellen Sie eine CreateBucket Anfrage und geben den Anforderungsheader mit dem Wert auf an. Geben Sie x-amz-bucket-namespace außerdem einen Bucketnamen im Format eines regionalen Namespaces account-regional für das Konto an:. customer-chosen-name-AWS-Account-ID-AWS-Region-an Sie könnten beispielsweise angeben, dass ein Bucket mit dem Namen: erstellt werden soll, in dem sich das regionale amzn-s3-demo-bucket-111122223333-us-east-1-an Suffix Ihres Kontos befindet. -111122223333-us-east-1-an Weitere Informationen zu regionalen Namespaces für Konten finden Sie unter. Namespaces für Allzweck-Buckets

Beispiel für Namen von Buckets für allgemeine Zwecke

Die folgenden Bucket-Namen zeigen Beispiele dafür, welche Zeichen in Allzweck-Bucket-Namen zulässig sind: a–z, 0–9 und Bindestriche (-). Das reservierte Präfix amzn-s3-demo- wird hier nur zur Veranschaulichung verwendet. Da es sich um ein reserviertes Präfix handelt, können Sie keine Bucket-Namen erstellen, die mit amzn-s3-demo- beginnen.

Die folgenden Beispiele zeigen Bucket-Namen im regionalen Namespace Ihres Kontos. Diese Buckets müssen der spezifischen Benennungskonvention für regionale Namespaces für Konten entsprechen: customer-chosen-name-AWS-Account-ID-AWS-Region-an

Die folgenden Beispiel-Bucket-Namen sind gültig, aber nicht für andere Verwendungszwecke als statisches Website-Hosting empfohlen (.):

Die folgenden Beispiel-Bucket-Namen sind ungültig:

Best Practices

Beachten Sie bei der Benennung Ihrer Allzweck-Buckets die folgenden bewährten Verfahren zur Benennung von Buckets.

Erstellen Sie Buckets im regionalen Namespace Ihres Kontos

Wir empfehlen, Buckets im regionalen Namespace Ihres Kontos zu erstellen, um sicherzustellen, dass nur Ihr Konto diese Bucket-Namen besitzen kann. Mit regionalen Namespaces für Konten können Sie vorhersehbare Bucket-Namen für mehrere erstellen und AWS-Regionen dabei sicherstellen, dass kein anderes Konto Bucket-Namen in Ihrem Namespace erstellen kann.

Wählen Sie ein Bucket-Benennungsschema, bei dem keine Namenskonflikte zu erwarten sind.

Wenn Ihre Anwendung automatisch Buckets erstellt, wählen Sie ein Bucket-Benennungsschema, bei dem keine Namenskonflikte zu erwarten sind. Stellen Sie sicher, dass Ihre Anwendungslogik einen anderen Bucket-Namen auswählt, wenn ein Bucket-Name bereits vergeben ist.

Hängen Sie global eindeutige Identifikatoren () an Bucket-Namen an GUIDs

Wir empfehlen, Bucket-Namen zu erstellen, die nicht vorhersehbar sind. Schreiben Sie keinen Code in der Annahme, dass der von Ihnen gewählte Bucket-Name verfügbar ist, es sei denn, Sie haben den Bucket bereits erstellt. Eine Methode zum Erstellen nicht vorhersehbarer Bucket-Namen, besteht darin, einen Globally Unique Identifier (GUID) an Ihren Bucket-Namen anzuhängen, beispielsweise, amzn-s3-demo-bucket-a1b2c3d4-5678-90ab-cdef-example11111. Weitere Informationen finden Sie unter Erstellen eines Buckets, der eine GUID im Bucket-Namen verwendet.

Vermeiden Sie die Verwendung von Punkten (.) in Bucket-Namen

Aus Gründen der besten Kompatibilität empfehlen wir, Punkte (.) in Bucket-Namen zu vermeiden, mit Ausnahme von Buckets, die nur für statisches Website-Hosting verwendet werden. Wenn Sie Punkte in den Namen eines Buckets aufnehmen, können Sie die virtual-host-style Adressierung nicht über HTTPS verwenden, es sei denn, Sie führen Ihre eigene Zertifikatsvalidierung durch. Die Sicherheitszertifikate, die für das virtuelle Hosting von Buckets verwendet werden, funktionieren nicht für Buckets mit Punkten in ihren Namen.

Diese Einschränkung gilt nicht für Buckets, die für das Hosting statischer Websites verwendet werden, da das Hosting statischer Websites nur über HTTP möglich ist. Weitere Informationen virtual-host-style zur Adressierung finden Sie unterVirtuelles Hosting von Allzweck-Buckets. Weitere Hinweise zum Hosten statischer Websites finden Sie unter Hosten einer statischen Website mit Amazon S3.

Auswählen eines relevanten Namens

Wenn Sie einen Bucket benennen, empfehlen wir Ihnen, einen Namen zu wählen, der für Sie oder Ihr Unternehmen relevant ist. Vermeiden Sie die Verwendung von Namen, die mit anderen Entitäten verbunden sind. Vermeiden Sie zum Beispiel die Verwendung von AWS oder Amazon in Ihrem Bucket-Namen.

Löschen Sie keine Buckets, damit Sie Bucket-Namen wiederverwenden können.

Wenn ein Bucket leer ist, können Sie ihn löschen. Nachdem ein Bucket gelöscht wurde, wird der Name zur Wiederverwendung verfügbar. Es ist jedoch nicht garantiert, dass Sie den Namen sofort oder überhaupt wieder verwenden können. Nachdem Sie einen Bucket im gemeinsam genutzten globalen Namespace gelöscht haben, kann es einige Zeit dauern, bis Sie den Namen wiederverwenden können. Darüber hinaus erstellt ein anderer AWS-Konto Benutzer möglicherweise einen Bucket mit demselben Namen, bevor Sie den Namen wiederverwenden können.

Nachdem Sie einen Allzweck-Bucket im gemeinsamen globalen Namespace gelöscht haben, sollten Sie sich bewusst sein, dass ein anderes Bucket AWS-Konto in derselben Partition denselben Allzweck-Bucket für einen neuen Bucket verwenden kann und daher möglicherweise Anfragen empfangen kann, die für den gelöschten Allzweck-Bucket bestimmt sind. Wenn Sie dies verhindern wollen oder wenn Sie weiterhin denselben Allzweck-Bucket-Namen verwenden wollen, dürfen Sie den Allzweck-Bucket nicht löschen. Wir empfehlen, den Bucket zu leeren und beizubehalten und stattdessen alle Bucket-Anfragen nach Bedarf zu blockieren.

Erstellen eines Buckets, der eine GUID im Bucket-Namen verwendet

Die folgenden Beispiele zeigen, wie Sie einen Allzweck-Bucket erstellen, der eine GUID am Ende des Bucket-Namens verwendet.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket1$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1

import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.CreateBucketRequest;

import java.util.List;
import java.util.UUID;

public class CreateBucketWithUUID {
    public static void main(String[] args) {
        final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.US_EAST_1).build();
        String bucketName = "amzn-s3-demo-bucket" +  UUID.randomUUID().toString().replace("-", "");
        CreateBucketRequest createRequest = new CreateBucketRequest(bucketName);
        System.out.println(bucketName);
        s3.createBucket(createRequest);
    }
}                

Einen Bucket im regionalen Namespace Ihres Kontos erstellen

Die folgenden Beispiele zeigen Ihnen, wie Sie einen Allzweck-Bucket im regionalen Namespace Ihres Kontos erstellen.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket-012345678910-us-west-1-an \
    --bucket-namespace account-regional
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1