Penamaan dan referensi berbagi, direktori, file, dan metadata

  • Artikel
  • 5 menit untuk membaca

Akun penyimpanan dapat berisi nol atau beberapa berbagi File Azure. Berbagi berisi properti, metadata, dan nol atau beberapa file atau direktori. Direktori berisi properti dan nol atau beberapa file atau direktori. File adalah entitas tunggal yang terdiri dari data biner, properti, dan metadata.

Nama sumber daya

URI untuk mereferensikan berbagi, direktori, atau file harus unik. Dalam akun penyimpanan tertentu, setiap berbagi harus memiliki nama yang unik. Setiap file dalam berbagi atau direktori tertentu juga harus memiliki nama unik dalam berbagi atau direktori tersebut.

Jika Anda mencoba membuat berbagi, direktori, atau file dengan nama yang melanggar aturan penamaan, permintaan akan gagal dengan kode status 400 (Permintaan Buruk).

Nama berbagi

Aturan untuk nama berbagi layanan File lebih ketat daripada yang ditentukan oleh protokol SMB untuk nama berbagi SMB, sehingga layanan Blob dan File dapat berbagi konvensi penamaan serupa untuk kontainer dan berbagi. Pembatasan penamaan untuk berbagi adalah sebagai berikut:

  • Nama berbagi harus berupa nama DNS yang valid.
  • Nama berbagi harus dimulai dengan huruf atau angka, dan hanya boleh berisi huruf, angka, dan karakter tanda hubung (-).
  • Setiap karakter garis putus-putus (-) harus segera didahului dan diikuti dengan huruf atau angka; tanda hubung berturut-turut tidak diizinkan dalam nama berbagi.
  • Semua huruf dalam nama berbagi harus huruf kecil.
  • Nama berbagi harus panjangnya 3 hingga 63 karakter.

Tabel berikut membandingkan pembatasan penamaan untuk Azure Files dan penyimpanan Azure Blob:

Penamaan dan Referensi Kontainer, Blob, dan Metadata Pembatasan Nama Berbagi SMB
• Nama kontainer harus berupa nama DNS yang valid.
• Nama kontainer harus dimulai dengan huruf atau angka, dan hanya boleh berisi huruf, angka, dan karakter tanda hubung (-).
• Setiap karakter garis putus-putus (-) harus segera didahului dan diikuti dengan huruf atau angka; tanda hubung berturut-turut tidak diizinkan dalam nama kontainer.
• Semua huruf dalam nama kontainer harus huruf kecil.
• Panjang nama kontainer harus 3 hingga 63 karakter.		 • Nama berbagi tidak boleh lebih dari 80 karakter.
• Karakter berikut ilegal dalam nama berbagi: \ / [ ] : &#124; < > + = ; , * ? "
• Mengontrol karakter dalam rentang 0x00 melalui 0x1F, inklusif, ilegal dalam nama berbagi.
• Semua karakter Unicode lainnya bersifat legal.
• Nama adalah pertahankan kasus dan tidak peka huruf besar/kecil.

Nama direktori dan file

Azure Files memberlakukan aturan penamaan berikut untuk nama direktori dan file:

  • Nama direktori dan file mempertahankan huruf besar/kecil dan tidak peka huruf besar/kecil.
  • Panjang nama komponen direktori dan file tidak boleh lebih dari 255 karakter.
  • Nama direktori tidak dapat diakhbungkan dengan karakter garis miring (/). Jika disediakan, akan dihapus secara otomatis.
  • Nama file tidak boleh diakhir dengan karakter garis miring ke depan (/).
  • Karakter URL yang dipesan harus benar-benar lolos.
  • Karakter berikut ini tidak diperbolehkan: " \ / : | < > * ?
  • Karakter jalur URL ilegal tidak diperbolehkan. Titik kode seperti \uE000, sementara valid dalam nama file NTFS, bukan karakter Unicode yang valid. Selain itu, beberapa karakter ASCII atau Unicode, seperti karakter kontrol (0x00 ke 0x1F, , \u0081dll.), juga tidak diizinkan. Untuk aturan yang mengatur string Unicode di HTTP/1.1 lihat RFC 2616, Bagian 2.2: Aturan Dasar dan RFC 3987.
  • Nama file berikut tidak diizinkan: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, karakter titik (.), dan karakter dua titik (..).

Tabel berikut membandingkan pembatasan penamaan untuk Azure Files dan penyimpanan Azure Blob:

Penamaan dan Referensi Kontainer, Blob, dan Metadata Pembatasan Nama Protokol SMB
• Nama blob harus panjangnya minimal satu karakter dan panjangnya tidak boleh lebih dari 1.024 karakter.
• Nama blob peka huruf besar/kecil.
• Karakter URL yang dicadangkan harus diloloskan dengan benar.
• Nama blob dapat berakhir dengan pemisah direktori virtual, seperti garis miring (/)
• Karakter jalur URL ilegal tidak diizinkan: Titik kode seperti \uE000, sementara valid dalam nama file NTFS, bukan karakter Unicode yang valid. Selain itu, beberapa karakter ASCII atau Unicode, seperti karakter kontrol (0x00 ke 0x1F, \u0081, dll.), juga tidak diizinkan. Untuk aturan yang mengatur string Unicode di HTTP/1.1 lihat RFC 2616, Bagian 2.2: Aturan Dasar dan RFC 3987.		 • Nama jalur tidak boleh lebih dari 32.760 karakter.
• Setiap komponen nama jalur (file / direktori) tidak boleh lebih dari 255 karakter panjangnya.
• Nama jalur terdiri dari satu atau beberapa komponen nama jalur yang dipisahkan oleh karakter garis miring mundur (\).
• Nama jalur adalah pertahankan kasus dan tidak peka huruf besar/kecil (dua nama yang berbeda hanya jika tidak diizinkan).
• Tidak dapat memiliki jalur direktori yang sama dengan jalur file.
• Karakter berikut ilegal dalam nama komponen: \ / : &#124; < > * ? "
• Mengontrol karakter dalam rentang 0x00 melalui 0x1F, inklusif, ilegal dalam nama berbagi.

Nama jalur

Nama jalur terdiri dari satu atau beberapa komponen nama jalur (direktori atau nama file) yang dipisahkan oleh karakter garis miring (/). Semua komponen nama jalur selain komponen nama jalur terakhir menunjukkan direktori. Komponen nama jalur terakhir menunjukkan direktori atau file. Aturan penamaan berikut berlaku:

  • Panjang nama jalur tidak boleh lebih dari 2.048 karakter. Komponen individual dalam jalur dapat memiliki panjang maksimal 255 karakter.
  • Nama jalur terdiri dari satu atau beberapa komponen nama jalur yang dipisahkan oleh karakter garis miring (/).
  • Kedalaman subdirektori dalam jalur tidak boleh melebihi 250.
  • Nama yang sama tidak dapat digunakan untuk file dan direktori yang memiliki direktori induk yang sama. Misalnya, file dan direktori yang masing-masing bernama data tidak boleh ada di bawah jalur induk yang sama.

Nama metadata

Metadata untuk sumber daya berbagi atau file disimpan sebagai pasangan nama-nilai yang terkait dengan sumber daya. Nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C#.

Perhatikan bahwa nama metadata mempertahankan huruf besar/kecil seperti saat dibuat, tetapi tidak peka huruf besar/kecil saat diatur atau dibaca. Jika dua atau beberapa header metadata dengan nama yang sama dikirimkan untuk sumber daya, layanan File Azure mengembalikan kode status 400 (Permintaan Buruk).

Sintaks URI sumber daya

Setiap sumber daya memiliki URI dasar yang sesuai, yang mengacu pada sumber daya itu sendiri. Untuk akun penyimpanan, URI dasar hanya menyertakan nama akun:

https://myaccount.file.core.windows.net

Untuk berbagi, URI dasar menyertakan nama akun dan nama berbagi:

https://myaccount.file.core.windows.net/myshare

Untuk direktori, URI dasar menyertakan nama akun, nama berbagi, dan jalur direktori:

https://myaccount.file.core.windows.net/myshare/myparentdir/mydir

Untuk file, URI dasar menyertakan nama akun, nama berbagi, dan jalur file:

https://myaccount.file.core.windows.net/myshare/myfile  
https://myaccount.file.core.windows.net/myshare/mydir/myfile  
https://myaccount.file.core.windows.net/myshare/myparentdir/mydir/myfile

Lihat juga