Pilih preferensi cookie Anda

Kami menggunakan cookie penting serta alat serupa yang diperlukan untuk menyediakan situs dan layanan. Kami menggunakan cookie performa untuk mengumpulkan statistik anonim sehingga kami dapat memahami cara pelanggan menggunakan situs dan melakukan perbaikan. Cookie penting tidak dapat dinonaktifkan, tetapi Anda dapat mengklik “Kustom” atau “Tolak” untuk menolak cookie performa.

Jika Anda setuju, AWS dan pihak ketiga yang disetujui juga akan menggunakan cookie untuk menyediakan fitur situs yang berguna, mengingat preferensi Anda, dan menampilkan konten yang relevan, termasuk iklan yang relevan. Untuk menerima atau menolak semua cookie yang tidak penting, klik “Terima” atau “Tolak”. Untuk membuat pilihan yang lebih detail, klik “Kustomisasi”.

Preferensi
Hubungi Kami
Umpan Balik
AWS Documentation
Buat Akun AWS

Menamai objek Amazon S3

PDF
RSS
Mode fokus
Menamai objek Amazon S3 - Amazon Simple Storage Service
Memilih nama kunci objekPanduan penamaan kunci objek

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

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

Sebuah kunci objek (atau nama kunci) secara unik mengidentifikasi objek dalam sebuah bucket Amazon S3. Saat Anda membuat objek, Anda menentukan nama kunci. Misalnya, di konsol Amazon S3, saat Anda memilih bucket, daftar objek di bucket akan muncul. Nama-nama ini merupakan kunci objek.

Nama kunci objek adalah urutan karakter Unicode dengan pengkodean UTF-8 hingga 1.024 byte panjang, atau 1.204 karakter Latin. Di beberapa lokal, satu karakter dapat sama dengan 2 byte. Saat memberi nama objek Anda, perhatikan hal-hal berikut:

  • Nama kunci objek peka terhadap huruf besar atau kecil.

  • Nama kunci objek mencakup awalan apa pun (dikenal sebagai folder di konsol). Misalnya, Development/Projects.xls adalah nama kunci objek lengkap dari Projects.xls objek yang terletak di dalam Development awalan (atau folder). Awalan, pembatas (/), dan nama objek termasuk dalam batasan 1.024 byte untuk nama kunci objek. Untuk informasi selengkapnya tentang awalan dan folder, lihat. Memilih nama kunci objek

  • Karakter tertentu mungkin memerlukan penanganan khusus ketika mereka digunakan dalam nama kunci objek. Untuk informasi selengkapnya, lihat Panduan penamaan kunci objek.

catatan

Nama kunci objek dengan nilai "soap" tidak didukung untuk virtual-hosted-style permintaan. Untuk nilai nama kunci objek di mana "soap" digunakan, URL gaya jalur harus digunakan sebagai gantinya.

Memilih nama kunci objek

Model data Amazon S3 bersifat struktur yang datar: Anda membuat bucket, dan bucket menyimpan objek tersebut. Tidak ada hierarki sub-bucket atau sub-folder. Namun, Anda dapat menyimpulkan hierarki logis dengan menggunakan prefiks dan pembatas nama kunci, seperti yang dilakukan oleh konsol Amazon S3. Konsol Amazon S3 menggunakan konsep folder. Untuk informasi lebih lanjut tentang cara mengedit metadata dari konsol Amazon S3, lihat Mengedit metadata objek di konsol Amazon S3.

Misalnya, bucket Anda (admin-created) memiliki empat objek dengan kunci objek berikut:

Development/Projects.xls

Finance/statement1.pdf

Private/taxdocument.pdf

s3-dg.pdf

Konsol menggunakan prefiks nama kunci (Development/,Finance/, andPrivate/) dan delimiter (/) untuk menyajikan struktur folder. s3-dg.pdfKunci tidak berisi awalan yang dibatasi garis miring, sehingga objeknya muncul langsung di tingkat root bucket. Jika Anda membuka folder Development/, Anda melihat objek Projects.xlsx di dalamnya.

  • Amazon S3 mendukung bucket dan objek, dan tidak memiliki hierarki. Namun, dengan menggunakan awalan dan pembatas dalam nama kunci objek, konsol Amazon S3 dan AWS SDKs dapat menyimpulkan hierarki dan memperkenalkan konsep folder.

  • Konsol Amazon S3 menerapkan pembuatan folder dengan menciptakan objek nol-byte dengan nilai prefiks dan pembatas folder sebagai kuncinya. Objek folder ini tidak akan muncul dalam konsol. Jika tidak, mereka berperilaku seperti objek lain dan dapat dilihat dan dimanipulasi melalui REST API, AWS CLI, dan. AWS SDKs

Panduan penamaan kunci objek

Anda dapat menggunakan karakter UTF-8 apa pun dalam nama kunci objek. Namun, penggunaan karakter tertentu dalam nama kunci dapat menimbulkan masalah pada beberapa aplikasi dan protokol. Panduan berikut membantu Anda memaksimalkan kepatuhan terhadap DNS, karakter web-safe, parser XHTML, dan lainnya. APIs

Karakter aman

Kumpulan karakter berikut umumnya aman untuk digunakan dalam nama kunci:

Karakter alfanumerik

  • 0-9

  • a-z

  • A-Z
Karakter-karakter khusus

  • Tanda seru (!)

  • Tanda hubung (-)

  • Garis bawah (_)

  • Titik (.)

  • Tanda bintang (*)

  • Tanda kutip tunggal () '

  • Tanda kurung pembuka () (

  • Tanda kurung penutup () )

Berikut ini adalah contoh nama kunci objek yang valid:

  • 4my-organization

  • my.great_photos-2014/jan/myvacation.jpg

  • videos/2014/birthday/video1.wmv

catatan

Jika Anda menggunakan konsol Amazon S3 untuk mengunduh objek yang memiliki nama kunci yang diakhiri dengan periode (.), periode akan dihapus dari ujung nama kunci objek yang diunduh. Untuk mempertahankan periode di akhir nama kunci dalam objek yang diunduh, Anda harus menggunakan AWS Command Line Interface (AWS CLI), AWS SDKs, atau Amazon S3 REST API.

Selain itu, waspadai batasan prefiks berikut ini:

  • Objek dengan awalan ./ harus diunggah atau diunduh dengan AWS CLI, AWS SDKs, atau REST API. Anda tidak dapat menggunakan konsol Amazon S3 untuk mengunggah objek ini.

  • Kunci objek yang berisi elemen jalur relatif (misalnya,../) valid jika, ketika diuraikan left-to-right, jumlah kumulatif segmen jalur relatif tidak pernah melebihi jumlah elemen jalur non-relatif yang ditemui. Aturan ini berlaku untuk semua permintaan yang dibuat menggunakan konsol Amazon S3, Amazon S3 REST API AWS CLI, dan. AWS SDKs

    Sebagai contoh:

    • videos/2014/../../video1.wmvvalid.

    • videos/../../video1.wmvtidak valid.

    • videos/../../2014/video1.wmvtidak valid.

Karakter yang memerlukan penanganan khusus

Karakter berikut dalam nama kunci mungkin memerlukan penanganan kode tambahan dan kemungkinan besar harus dikodekan URL atau direferensikan sebagai HEX. Beberapa karakter ini adalah karakter yang tidak dapat dicetak yang mungkin tidak ditangani oleh browser Anda, yang juga memerlukan penanganan khusus:

  • Ampersand () &

  • Tanda dolar ($)

  • Karakter ASCII bervariasi dengan rentang hex 00–1F (desimal 0–31) dan 7F (desimal 127)

  • Pada simbol (@)

  • Tanda sama (=)

  • Titik koma () ;

  • Garis miring (/)

  • Usus besar (:)

  • Tanda plus (+)

  • Ruang — Urutan ruang yang signifikan mungkin hilang dalam beberapa kasus (terutama beberapa ruang)

  • Koma () ,

  • Tanda tanya (?)

Karakter-karakter yang harus dihindari

Kami merekomendasikan untuk tidak menggunakan karakter berikut dalam nama kunci karena penanganan karakter khusus yang signifikan, yang tidak konsisten di semua aplikasi:

  • Backslash () \

  • Penjepit kiri () {

  • Karakter ASCII yang tidak dapat dicetak (karakter desimal 128–255)

  • Karet atau sirkumflex () ^

  • Penjepit kanan () }

  • Persen karakter (%)

  • Aksen kubur atau backtick () `

  • Braket kanan () ]

  • Tanda kutip () "

  • Lebih besar dari tanda (>)

  • Braket kiri () [

  • Tilde () ~

  • Kurang dari tanda (<)

  • Tanda pound (#)

  • Batang vertikal atau pipa (|)

Seperti yang ditentukan oleh standar XHTML pada end-of-line penanganan, semua teks XML-dinormalisasi sedemikian rupa sehingga single carriage return (ASCII code 13) dan carriage return segera diikuti oleh line feed (kode ASCII 10), juga dikenal sebagai karakter baris baru, digantikan oleh karakter feed baris tunggal. Untuk memastikan penguraian kunci objek yang benar dalam permintaan XHTML, pengembalian carriage dan karakter khusus lainnya harus diganti dengan kode entitas XMLnya yang setara saat dimasukkan ke dalam tag XMLnya.

Berikut ini adalah daftar karakter khusus tersebut dan kode entitas XMLnya yang setara:

  • Apostrof (') harus diganti dengan &apos;

  • Tanda kutip (") harus diganti dengan &quot;

  • Ampersand (&) harus diganti dengan &amp;

  • Kurang dari tanda (<) harus diganti dengan &lt;

  • Lebih besar dari tanda (>>) harus diganti dengan &gt;

  • Carriage return (\r) harus diganti dengan &#13; atau &#x0D;

  • Newline (\n) harus diganti dengan &#10; atau &#x0A;

Contoh berikut ini mengilustrasikan penggunaan kode entitas XML sebagai pengganti untuk pengangkutan kembali. DeleteObjectsPermintaan ini menghapus objek dengan key parameter /some/prefix/objectwith\rcarriagereturn (di mana \r adalah carriage return).

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Object>
    <Key>/some/prefix/objectwith&#13;carriagereturn</Key>
  </Object>
</Delete>

Di halaman ini

PrivasiSyarat situsPreferensi cookie
© 2025, Amazon Web Services, Inc. atau afiliasinya. Semua hak dilindungi undang-undang.