Nama kunci untuk ember penyimpanan objek Lightsail - Amazon Lightsail
Nama kunciPanduan penamaan kunci objekXMLkendala kunci objek terkait

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

Nama kunci untuk ember penyimpanan objek Lightsail

File yang Anda unggah ke bucket disimpan sebagai objek di layanan penyimpanan objek Amazon Lightsail. Sebuah kunci objek (atau nama kunci) secara unik mengidentifikasi objek yang disimpan dalam sebuah bucket. Panduan ini menjelaskan konsep nama kunci dan awalan nama kunci yang membentuk struktur folder bucket yang dilihat melalui konsol Lightsail. Untuk informasi selengkapnya tentang bucket, lihat Penyimpanan objek.

Nama kunci

Model data layanan penyimpanan objek Lightsail menggunakan struktur datar alih-alih struktur hierarkis seperti yang akan Anda lihat dalam sistem file. Tidak ada hierarki folder dan sub-folder. Akan tetapi, Anda dapat menyimpulkan hierarki logis dengan menggunakan prefiks dan pembatas nama kunci. Konsol Lightsail menggunakan awalan nama kunci untuk menampilkan objek Anda dalam struktur folder.

Misalkan bucket Anda memiliki empat objek dengan kunci objek berikut:

  • Development/Projects.xls

  • Finance/statement1.pdf

  • Private/taxdocument.pdf

  • to-dos.doc

Konsol Lightsail menggunakan awalan nama kunci Development/ (Finance/,, Private/ and) dan delimiter / () untuk menyajikan struktur folder. Nama kunci to-dos.doc tidak memiliki prefiks, sehingga objeknya muncul langsung pada tingkat akar bucket Anda. Jika Anda menelusuri Development/ folder di konsol Lightsail, Anda melihat objek. Projects.xls Di folder Finance/, Anda melihat objek statement1.pdf, dan dalam folder Private/, Anda melihat objek taxdocument.pdf.

Konsol Lightsail memungkinkan pembuatan folder dengan membuat objek zero-byte dengan awalan nama kunci dan nilai pembatas sebagai nama kunci. Objek folder ini tidak akan muncul dalam konsol. Namun demikian, mereka berperilaku seperti objek lainnya. Anda dapat melihat dan memanipulasinya menggunakan Amazon API S3 AWS Command Line Interface ,AWS CLI(), atau. AWS SDKs

Panduan penamaan kunci objek

Anda dapat menggunakan karakter UTF -8 apa saja 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 terhadapDNS, karakter web-safe, XML parser, dan lainnya. APIs

Karakter aman

Set karakter berikut umumnya aman untuk digunakan dalam nama kunci.

  • Karakter alfanumerik

    • 0-9

    • a-z

    • A-Z

  • Karakter-karakter khusus

    • Garis miring (/)

    • Tanda seru (!)

    • Tanda hubung (-)

    • Garis bawah (_)

    • Titik (.)

    • Tanda bintang (*)

    • Tanda petik tunggal (')

    • Tanda kurung buka (()

    • Tanda kurung tutup ())

Berikut ini adalah contoh nama kunci objek yang valid:

  • 4my-organization

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

  • videos/2014/birthday/video1.wmv

penting

Jika nama kunci objek diakhiri dengan satu periode (.), atau dua periode (..), Anda tidak dapat mengunduh objek menggunakan konsol Lightsail. Untuk mengunduh objek dengan nama kunci yang diakhiri dengan satu atau dua periode, Anda harus menggunakan Amazon S3API, AWS CLI, dan. AWS SDKs Untuk informasi selengkapnya, lihat Mengunduh objek bucket.

Karakter yang memerlukan penanganan khusus

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

  • Ampersan ("&")

  • Dolar (” $ “)

  • ASCIIrentang karakter 00—1F hex (0—31 desimal) dan 7F (127 desimal)

  • Simbol 'At' (” “@)

  • Sama dengan (” = “)

  • Titik koma (” “) ;

  • Usus besar (” : “)

  • Ditambah (” + “)

  • Spasi–Urutan spasi yang signifikan dapat dihilangkan dalam beberapa penggunaan (khususnya spasi ganda)

  • Koma (” , “)

  • Tanda tanya (” ? “)

Karakter-karakter yang harus dihindari

Hindari karakter-karakter berikut ini dalam nama kunci oleh karena adanya penanganan khusus yang signifikan terkait konsistensi di semua aplikasi.

  • Garis miring terbalik (” “\)

  • Penjepit keriting kiri (” “{)

  • Karakter yang tidak dapat dicetak (ASCII128-255 karakter desimal)

  • Karet (” ^ “)

  • Penjepit keriting kanan (” “})

  • Persen karakter (” % “)

  • Aksen kubur/centang belakang (” “`)

  • Braket persegi kanan (” ] “)

  • Tanda petik

  • Simbol 'Lebih Besar Dari' (">")

  • Braket persegi kiri (” [ “)

  • Tilde (” ~ “)

  • Simbol 'Kurang Dari' ("<")

  • Karakter 'Pound' (” “) #

  • Batang/pipa vertikal (” | “)

XMLkendala kunci objek terkait

Seperti yang ditentukan oleh XMLstandar end-of-line penanganan, semua XML teks dinormalisasi sehingga pengembalian carriage tunggal (ASCIIkode 13) dan carriage return segera diikuti oleh umpan baris (ASCIIkode 10) diganti dengan karakter umpan baris tunggal. Untuk memastikan penguraian kunci objek yang benar dalam XML permintaan, pengembalian carriage dan karakter khusus lainnya harus diganti dengan kode XML entitas yang setara ketika dimasukkan ke dalam XML tag. Berikut ini adalah daftar karakter khusus tersebut, serta kode entitas yang setara:

  • 'sebagai &apos;

  • ”sebagai &quot;

  • &sebagai &amp;

  • <sebagai &lt;

  • <sebagai &gt;

  • \r sebagai &#13; atau &#x0D;

  • \n sebagai &#10; atau &#x0A;

Contoh berikut menggambarkan penggunaan kode XML entitas sebagai substitusi untuk carriage return. Permintaan DeleteObjects ini menghapus sebuah objek dengan parameter kunci /some/prefix/objectwith\rcarriagereturn (dimana \r adalah carriage return).

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