Aturan penamaan bucket tujuan umum - Amazon Simple Storage Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Aturan penamaan bucket tujuan umum

Saat Anda membuat ember tujuan umum, Anda memilih namanya dan Wilayah AWS untuk membuatnya. Setelah membuat bucket tujuan umum, Anda tidak dapat mengubah nama atau Region. Bagian berikut memberikan informasi tentang penamaan bucket tujuan umum, termasuk aturan penamaan, praktik terbaik, dan contoh untuk membuat bucket tujuan umum dengan nama yang menyertakan pengenal unik global (GUID).

Untuk aturan penamaan bucket direktori, lihatAturan penamaan bucket direktori.

Untuk informasi tentang nama kunci objek, lihat Membuat nama kunci objek.

Aturan penamaan bucket tujuan umum

Aturan penamaan berikut berlaku untuk bucket tujuan umum.

  • Panjang nama bucket harus antara 3 (menit) dan 63 (maks) karakter.

  • Nama bucket hanya dapat terdiri dari huruf kecil, angka, titik (.), dan tanda hubung (). -

  • Nama bucket harus diawali dan juga diakhiri dengan huruf atau, nomor.

  • Nama bucket tidak boleh berisi dua periode yang berdekatan.

  • Nama bucket tidak boleh diformat sebagai alamat IP (misalnya,192.168.5.4).

  • Nama bucket tidak boleh dimulai dengan prefiks xn--.

  • Nama bucket tidak boleh dimulai dengan prefiks sthree-.

  • Nama bucket tidak boleh dimulai dengan prefiks amzn-s3-demo-.

  • Nama bucket tidak boleh diakhiri dengan sufiks -s3alias. Sufiks ini dicadangkan untuk nama alias titik akses. Untuk informasi selengkapnya, lihat Alias titik akses.

  • Nama bucket tidak boleh diakhiri dengan sufiks --ol-s3. Sufiks ini dicadangkan untuk nama alias Titik Akses Lambda Objek. Untuk informasi selengkapnya, lihat Cara menggunakan alias gaya bucket untuk bucket S3 Anda Titik Akses Lambda Objek.

  • Nama bucket tidak boleh diakhiri dengan sufiks .mrap. Akhiran ini dicadangkan untuk nama Titik Akses Multi-Wilayah. Untuk informasi selengkapnya, lihat Aturan penamaan Titik Akses Multi-Wilayah Amazon S3.

  • Nama bucket tidak boleh diakhiri dengan sufiks --x-s3. Akhiran ini dicadangkan untuk ember direktori. Untuk informasi selengkapnya, lihat Aturan penamaan bucket direktori.

  • Bucket yang digunakan dengan Amazon S3 Transfer Acceleration tidak dapat memiliki period . () dalam namanya. Untuk informasi lebih lanjut tentang Transfer Acceleration, lihat Mengonfigurasi transfer file yang cepat dan aman menggunakan Amazon S3 Transfer Acceleration.

penting
  • Nama bucket harus unik Akun AWS di semua bagian Wilayah AWS dalam partisi. Partisi adalah pengelompokan Wilayah. AWS Saat ini memiliki tiga partisi: aws (Kawasan komersial), aws-cn (Wilayah Tiongkok), dan aws-us-gov (AWS GovCloud (US) Wilayah).

  • Nama bucket tidak dapat digunakan oleh orang lain Akun AWS di partisi yang sama sampai bucket dihapus. Setelah Anda menghapus bucket, ketahuilah bahwa bucket lain Akun AWS di partisi yang sama dapat menggunakan nama bucket yang sama untuk bucket baru dan karenanya berpotensi menerima permintaan yang ditujukan untuk bucket yang dihapus. Jika Anda ingin mencegah hal ini, atau jika Anda ingin terus menggunakan nama bucket yang sama, jangan hapus bucket. Kami menyarankan Anda mengosongkan ember dan menyimpannya, dan sebagai gantinya, memblokir permintaan bucket apa pun sesuai kebutuhan.

catatan

Sebelum 1 Maret 2018, bucket yang dibuat di Wilayah AS Timur (Virginia Utara) dapat memiliki nama hingga mencapai 255 karakter, dan menyertakan huruf besar dan garis bawah. Mulai 1 Maret 2018, bucket baru di AS Timur (Virginia Utara) harus mematuhi aturan yang sama yang berlaku di semua Wilayah lainnya.

Contoh nama bucket tujuan umum

Nama bucket berikut menunjukkan contoh karakter mana yang diizinkan dalam nama bucket tujuan umum: a-z, 0-9, dan tanda hubung (). - Awalan amzn-s3-demo- cadangan digunakan di sini hanya untuk ilustrasi. Karena ini adalah awalan cadangan, Anda tidak dapat membuat nama bucket yang dimulai denganamzn-s3-demo-.

  • amzn-s3-demo-bucket1-a1b2c3d4-5678-90ab-cdef-example11111

  • amzn-s3-demo-bucket

Contoh nama bucket berikut valid tetapi tidak direkomendasikan untuk penggunaan selain hosting situs web statis karena mengandung periode (.):

  • example.com

  • www.example.com

  • my.example.s3.bucket

Contoh nama bucket berikut bersifat tidak valid:

  • amzn_s3_demo_bucket (mengandung garis bawah)

  • AmznS3DemoBucket (mengandung huruf besar)

  • amzn-s3-demo-bucket-(dimulai dengan amzn-s3-demo- awalan dan diakhiri dengan tanda hubung)

  • example..com(berisi dua periode berturut-turut)

  • 192.168.5.4(cocok dengan format alamat IP)

Praktik terbaik

Saat menamai ember Anda, pertimbangkan praktik terbaik penamaan bucket berikut.

Pilih skema penamaan ember yang tidak mungkin menyebabkan konflik penamaan

Jika aplikasi Anda secara otomatis membuat bucket, pilih skema penamaan bucket yang tidak mungkin menyebabkan konflik penamaan. Pastikan bahwa logika aplikasi Anda akan memilih nama bucket yang berbeda jika nama bucket-nya sudah diambil.

Tambahkan pengidentifikasi unik global (GUIDs) ke nama bucket

Kami menyarankan Anda membuat nama bucket yang tidak dapat diprediksi. Jangan menulis kode dengan asumsi nama bucket pilihan Anda tersedia kecuali Anda telah membuat bucket. Salah satu metode untuk membuat nama bucket yang tidak dapat diprediksi adalah dengan menambahkan Globally Unique Identifier (GUID) ke nama bucket Anda, misalnya,. amzn-s3-demo-bucket-a1b2c3d4-5678-90ab-cdef-example11111 Untuk informasi selengkapnya, lihat Membuat bucket yang menggunakan GUID dalam nama bucket.

Hindari menggunakan period (.) dalam nama bucket

Untuk kompatibilitas terbaik, sebaiknya hindari penggunaan period (.) dalam nama bucket, kecuali bucket yang hanya digunakan untuk hosting situs statis. Jika menyertakan periode dalam nama bucket, Anda tidak dapat menggunakan virtual-host-style pengalamatan melalui HTTPS, kecuali Anda melakukan validasi sertifikat sendiri. Sertifikat keamanan yang digunakan untuk hosting virtual bucket tidak berfungsi untuk ember dengan titik dalam nama mereka.

Keterbatasan ini tidak memengaruhi bucket yang digunakan untuk hosting situs web statis, karena hosting situs web statis hanya tersedia melalui HTTP. Untuk informasi lebih lanjut tentang virtual-host-style pengalamatan, lihatBucket dengan hosting virtual. Untuk informasi tentang hosting situs web, lihat Hosting situs web statis menggunakan Amazon S3.

Pilih nama yang relevan

Saat Anda memberi nama ember, kami sarankan Anda memilih nama yang relevan dengan Anda atau bisnis Anda. Hindari menggunakan nama yang terkait dengan orang lain. Misalnya, hindari menggunakan AWS atau Amazon dalam nama bucket Anda.

Jangan hapus bucket sehingga Anda dapat menggunakan kembali nama bucket

Jika sebuah bucket kosong, Anda dapat menghapusnya. Setelah Anda menghapus bucket, namanya akan tersedia untuk digunakan kembali. Namun, Anda tidak dijamin dapat menggunakan kembali nama itu segera, atau sama sekali. Setelah Anda menghapus bucket, beberapa waktu mungkin berlalu sebelum Anda dapat menggunakan kembali nama tersebut. Selain itu, yang lain Akun AWS mungkin membuat ember dengan nama yang sama sebelum Anda dapat menggunakan kembali nama tersebut.

Setelah Anda menghapus bucket, ketahuilah bahwa bucket lain Akun AWS di partisi yang sama dapat menggunakan nama bucket yang sama untuk bucket baru dan karenanya berpotensi menerima permintaan yang ditujukan untuk bucket yang dihapus. Jika Anda ingin mencegah hal ini, atau jika Anda ingin terus menggunakan nama bucket yang sama, jangan hapus bucket. Kami menyarankan Anda mengosongkan ember dan menyimpannya, dan sebagai gantinya, memblokir permintaan bucket apa pun sesuai kebutuhan.

Membuat bucket yang menggunakan GUID dalam nama bucket

Contoh berikut menunjukkan cara membuat bucket tujuan umum yang menggunakan GUID di akhir nama bucket.

AWS CLI Contoh berikut membuat bucket di Wilayah Region () AS West (Californiaus-west-1) dengan contoh nama bucket yang menggunakan global unique identifier (GUID). Untuk menggunakan contoh perintah ini, ganti user input placeholders dengan informasi Anda sendiri.

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

Contoh berikut menunjukkan cara membuat bucket dengan GUID di akhir nama bucket di US East (Virginia N.) Region (us-east-1) dengan menggunakan. AWS SDK for Java Untuk menggunakan contoh ini, ganti user input placeholders dengan informasi Anda sendiri. Untuk informasi tentang lainnya AWS SDKs, lihat Alat untuk Dibangun AWS.

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