CloudConsole

S3-Bucket-Namensprüfung

Kostenlos, im Browser · jede aktuelle Benennungsregel · funktioniert offline

Bucket-Namen prüfen

Prüft die Regeln in Ihrem Browser, auch offline. Ob ein anderes Konto den Namen schon besitzt, kann es nicht erkennen: Das zeigt nur das Anlegen des Buckets.

Kurze Antwort

Der Name eines S3-Allzweck-Buckets muss 3–63 Zeichen lang sein und aus Kleinbuchstaben, Ziffern, Punkten und Bindestrichen bestehen, mit einem Buchstaben oder einer Ziffer beginnen und enden, darf keine zwei Punkte hintereinander haben, nicht wie eine IP-Adresse aussehen und muss die reservierten Präfixe xn--, sthree- und amzn-s3-demo- sowie die Suffixe -s3alias, --ol-s3, .mrap, --x-s3 und --table-s3 vermeiden. Verzichten Sie auf Punkte, es sei denn, der Bucket hostet nur eine statische Website.

Regeln für S3-Bucket-Namen

Jeder neue Allzweck-Bucket muss in jeder Region alle diese Regeln erfüllen:

  1. Zwischen 3 und 63 Zeichen lang.
  2. Nur Kleinbuchstaben, Ziffern, Punkte (.) und Bindestriche (-).
  3. Beginnt und endet mit einem Buchstaben oder einer Ziffer.
  4. Keine zwei aufeinanderfolgenden Punkte.
  5. Nicht wie eine IP-Adresse formatiert, etwa 192.168.5.4.
  6. Beginnt nicht mit xn--, sthree- oder amzn-s3-demo-.
  7. Endet nicht auf -s3alias (reserviert für Access-Point-Aliasse), --ol-s3 (Aliasse von Object Lambda Access Points), .mrap (Multi-Region Access Points), --x-s3 (Directory-Buckets) oder --table-s3 (S3-Tables-Buckets).
  8. Endet nur dann auf -an, wenn Sie ihn im regionalen Namespace Ihres Kontos anlegen (siehe unten).

Gültig: amzn-s3-demo-bucket steht in der AWS-Dokumentation, lässt sich wegen des reservierten Präfixes aber nicht anlegen; app-assets-prod-2026 oder logs-a1b2c3d4 sind in Ordnung. Ungültig: my_bucket (Unterstrich), MyBucket (Großbuchstaben), example..com (aufeinanderfolgende Punkte), my-bucket- (endet mit Bindestrich).

Vor dem 1. März 2018 konnten Buckets in USA Ost (Nord-Virginia) Namen mit bis zu 255 Zeichen, Großbuchstaben und Unterstrichen haben. Einige davon existieren noch, deshalb sehen Sie sie vielleicht in älteren Konten; neue können Sie nicht anlegen.

Punkte in Bucket-Namen und HTTPS

Punkte sind gültig, machen aber Ärger. Die URLs im Virtual-Hosted-Stil von S3 setzen den Bucket-Namen in den Hostnamen, https://bucket-name.s3.region-code.amazonaws.com, und die Zertifikate, die S3 für Virtual Hosting nutzt, funktionieren nicht für Bucket-Namen mit Punkten. Eine Anfrage an https://logs.example.com.s3.amazonaws.com scheitert also an der Zertifikatsprüfung, sofern Sie das Zertifikat nicht selbst prüfen. Buckets mit Punkten können außerdem kein Transfer Acceleration nutzen.

AWS empfiehlt Punkte nur für Buckets, die ausschließlich statisches Website-Hosting über HTTP bereitstellen. Für eine eigene Domain über HTTPS stellen Sie CloudFront vor den Bucket; dann muss der Bucket-Name gar nicht zur Domain passen.

Globale Namen und der regionale Namespace des Kontos

Namen von Allzweck-Buckets liegen in einem Namespace, den sich alle AWS-Konten einer Partition teilen: aws, aws-cn (China), aws-us-gov (GovCloud US) und aws-eusc (European Sovereign Cloud). Hat irgendjemand den Namen, können Sie ihn nicht anlegen und erhalten BucketAlreadyExists. Wird ein Bucket gelöscht, kann sein Name wieder frei werden, aber nicht unbedingt sofort oder überhaupt, und ein anderes Konto könnte ihn übernehmen und Anfragen erhalten, die für den alten Bucket gedacht waren. AWS rät, einen nicht mehr benötigten Bucket zu leeren statt zu löschen, wenn das eine Rolle spielt.

Kollisionen vermeiden Sie, indem Sie den Bucket im regionalen Namespace Ihres Kontos anlegen, einem reservierten Teil des globalen Namespace, in dem nur Ihr Konto Buckets anlegen kann. Diese Namen folgen einem festen Muster: Ihr eigenes Präfix, dann Ihre 12-stellige Konto-ID, die Region und -an:

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

Ersetzen Sie das Beispielpräfix (es ist reserviert) und verwenden Sie Ihre eigene Konto-ID und Region. Die Prüfung oben erkennt Namen in diesem Format und erinnert Sie, zu welchem Konto und welcher Region sie gehören.

Einen guten Bucket-Namen wählen

  • Schwer zu erraten. Wenn Ihr Code Buckets anlegt, hängen Sie ein eindeutiges Suffix an, etwa eine GUID: uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' liefert 32 Kleinbuchstaben, und der Code sollte mit einem bereits vergebenen Namen umgehen können.
  • Keine Geheimnisse. Der Name erscheint in URLs, im DNS und in Logs. Verwenden Sie keine Kundennamen oder anderes Sensibles.
  • „AWS“ und „Amazon“ vermeiden. AWS empfiehlt einen Namen, der zu Ihnen passt und nicht mit anderen in Verbindung gebracht wird.
  • Gleich richtig wählen. Einen Bucket können Sie weder umbenennen noch in eine andere Region verschieben. Der einzige Weg ist ein neuer Bucket und eine Kopie, zum Beispiel mit aws s3 sync s3://old-bucket s3://new-bucket.

Quellen

Häufige Fragen

Welche Regeln gelten für S3-Bucket-Namen?

3 bis 63 Zeichen; nur Kleinbuchstaben, Ziffern, Punkte und Bindestriche; Beginn und Ende mit Buchstabe oder Ziffer; keine zwei aufeinanderfolgenden Punkte; nicht wie eine IP-Adresse formatiert; kein Beginn mit xn--, sthree- oder amzn-s3-demo-; und kein Ende auf -s3alias, --ol-s3, .mrap, --x-s3 oder --table-s3. Namen auf -an sind nur für Buckets im regionalen Namespace Ihres Kontos.

Dürfen S3-Bucket-Namen Großbuchstaben oder Unterstriche enthalten?

Nicht mehr. Vor dem 1. März 2018 konnten Buckets in USA Ost (Nord-Virginia) Namen mit bis zu 255 Zeichen, Großbuchstaben und Unterstrichen haben, und einige davon existieren noch, aber jeder neue Bucket in jeder Region folgt den aktuellen Regeln.

Sollte ich Punkte in einem Bucket-Namen verwenden?

Nur für einen Bucket, der ausschließlich statisches Website-Hosting bereitstellt. Mit einem Punkt im Namen scheitern HTTPS-Anfragen im Virtual-Hosted-Stil an der Zertifikatsprüfung, sofern Sie das Zertifikat nicht selbst prüfen, und der Bucket kann kein Transfer Acceleration nutzen.

Warum ist mein Bucket-Name schon vergeben?

Namen von Allzweck-Buckets teilen sich einen Namespace über alle AWS-Konten der Partition, jemand anderes besitzt ihn also vielleicht. Der Name eines gelöschten Buckets wird möglicherweise nicht sofort oder überhaupt nicht wieder frei. Fügen Sie etwas Eindeutiges wie ein zufälliges Suffix hinzu oder legen Sie den Bucket im regionalen Namespace Ihres Kontos an.

Kann ich einen S3-Bucket umbenennen?

Nein. Name und Region eines Buckets stehen beim Anlegen fest. Legen Sie einen neuen Bucket mit dem gewünschten Namen an, kopieren Sie die Objekte hinüber (zum Beispiel mit aws s3 sync) und löschen Sie dann den alten Bucket.

Prüft dieses Tool, ob der Name frei ist?

Nein. Es prüft die Benennungsregeln in Ihrem Browser und sendet nichts, kann also die Buckets anderer Konten nicht sehen. Nur das Anlegen des Buckets zeigt zuverlässig, ob ein Name verfügbar ist.

Ihre Buckets auf dem Handy

S3 hat in CloudConsole einen eigenen Bildschirm: Buckets und Objekte durchsuchen und Dateien in der Vorschau ansehen, über alle Konten und Regionen hinweg, auf iPhone und Android, mit Zugangsdaten, die auf dem Handy bleiben.

Über die App →