Buat Direktori
Operasi Create Directory membuat direktori baru di bawah direktori berbagi atau induk yang ditentukan. Sumber daya direktori menyertakan properti untuk direktori tersebut. Ini tidak menyertakan daftar file atau subdirektori yang dimuat oleh direktori.
Ketersediaan protokol
| Protokol berbagi file yang diaktifkan | Tersedia |
|---|---|
| SMB |
|
| NFS |
|
Minta
Anda dapat membuat permintaan Create Directory sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS.
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
Ganti komponen jalur dalam URI permintaan dengan URI Anda sendiri, seperti yang diperlihatkan dalam tabel berikut:
| Komponen jalur | Deskripsi |
|---|---|
myaccount |
Nama akun penyimpanan Anda. |
myshare |
Nama berbagi file Anda. |
myparentdirectorypath |
Fakultatif. Jalur ke direktori induk tempat mydirectory akan dibuat. Jika jalur direktori induk dihilangkan, direktori akan dibuat dalam berbagi yang ditentukan. Jika direktori induk ditentukan, direktori tersebut harus sudah ada dalam berbagi sebelum Anda dapat membuat mydirectory. |
mydirectory |
Nama direktori yang akan dibuat. |
Untuk informasi selengkapnya tentang pembatasan penamaan jalur, lihat Nama dan berbagi referensi, direktori, file, dan metadata.
Parameter URI
Anda dapat menentukan parameter tambahan berikut pada URI permintaan.
| Parameter | Deskripsi |
|---|---|
timeout |
Fakultatif. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi layanan file. |
Isi permintaan
Tidak.
Header permintaan
Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:
| Parameter | Deskripsi |
|---|---|
Authorization |
Diperlukan. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
Date atau x-ms-date |
Diperlukan. Menentukan waktu Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
x-ms-version |
Diperlukan untuk semua permintaan yang diotorisasi. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan Versi untuk layanan Azure Storage. |
x-ms-meta-name:value |
Fakultatif. Versi 2015-02-21 atau yang lebih baru. Pasangan nama-nilai untuk dikaitkan dengan direktori sebagai metadata. Nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C# . |
x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> } |
Dalam versi 2019-02-02 hingga 2021-04-10, header ini diperlukan jika x-ms-file-permission-key tidak ditentukan. Pada versi 2021-06-08, kedua header bersifat opsional. Izin ini adalah deskriptor keamanan untuk direktori yang ditentukan dalam x-ms-file-permission-format. Header ini dapat digunakan jika ukuran izin lebih dari 8 kibibyte (KiB). Jika tidak, Anda dapat menggunakan x-ms-file-permission-key. Jika ditentukan, itu harus memiliki pemilik, grup, dan daftar kontrol akses diskresi (DACL). Anda dapat meneruskan nilai inherit untuk diwarisi dari direktori induk.Catatan: Anda dapat menentukan x-ms-file-permission atau x-ms-file-permission-key. Jika tidak ada header yang ditentukan, nilai default inherit digunakan. |
x-ms-file-permission-format: { sddl ¦ binary } |
Fakultatif. Versi 2024-11-04 atau yang lebih baru. Menentukan apakah nilai yang diteruskan dalam x-ms-file-permission berada dalam SDDL atau dalam format biner. Jika x-ms-file-permission-key diatur ke inherit, header ini tidak boleh diatur. Jika x-ms-file-permission-key diatur ke nilai lain selain inherit, dan jika header ini tidak diatur, nilai default sddl digunakan. |
x-ms-file-permission-key: <PermissionKey> |
Kunci izin yang akan diatur untuk direktori. Dalam versi 2019-02-02 hingga 2021-04-10, header ini diperlukan jika x-ms-file-permission tidak ditentukan. Pada versi 2021-06-08, kedua header bersifat opsional. Anda dapat membuat kunci ini dengan menggunakan API Create-Permission.Catatan: Anda dapat menentukan x-ms-file-permission atau x-ms-file-permission-key. Jika tidak ada header yang ditentukan, nilai default inherit digunakan untuk header x-ms-file-permission. |
x-ms-file-attributes |
Diperlukan: versi 2019-02-02 hingga 2021-04-10. Opsional: versi 2021-06-08 dan yang lebih baru. Atribut sistem file yang akan diatur pada direktori. Lihat daftar atribut tersedia. Nilai defaultnya adalah Direktori. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Diperlukan: versi 2019-02-02 hingga 2021-04-10. Opsional: versi 2021-06-08 dan yang lebih baru. Properti waktu pembuatan Waktu Universal Terkoordinasi (UTC) untuk direktori. Anda dapat menggunakan nilai now untuk menunjukkan waktu permintaan. Nilai defaultnya adalah now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Diperlukan: versi 2019-02-02 hingga 2021-04-10. Opsional: versi 2021-06-08 atau yang lebih baru. Properti penulisan terakhir Waktu Universal Terkoordinasi (UTC) untuk direktori. Anda dapat menggunakan nilai now untuk menunjukkan waktu permintaan. Nilai defaultnya adalah now. |
x-ms-client-request-id |
Fakultatif. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 kibibyte (KiB) yang dicatat dalam log saat pengelogan dikonfigurasi. Kami sangat menyarankan Anda menggunakan header ini untuk menghubungkan aktivitas sisi klien dengan permintaan yang diterima server. Untuk informasi selengkapnya, lihat Memantau Azure Files. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Fakultatif. Properti waktu perubahan Waktu Universal Terkoordinasi (UTC) untuk direktori, dalam format ISO 8601. Versi 2021-06-08 dan yang lebih baru. Anda dapat menggunakan nilai now untuk menunjukkan waktu permintaan. Nilai defaultnya adalah now. |
x-ms-file-request-intent |
Diperlukan jika header Authorization menentukan token OAuth. Nilai yang dapat diterima backup. Header ini menentukan bahwa Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action atau Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action harus diberikan jika disertakan dalam kebijakan RBAC yang ditetapkan ke identitas yang diotorisasi menggunakan header Authorization. Tersedia untuk versi 2022-11-02 dan yang lebih baru. |
x-ms-allow-trailing-dot: { <Boolean> } |
Fakultatif. Versi 2022-11-02 dan yang lebih baru. Nilai Boolean menentukan apakah titik berikutnya yang ada dalam url permintaan harus dipangkas atau tidak. Untuk informasi selengkapnya, lihat Penamaan dan referensi berbagi, direktori, file, dan metadata. |
Permintaan sampel
PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1
Request headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Jawaban
Respons mencakup kode status HTTP dan sekumpulan header respons.
Kode status
Operasi yang berhasil mengembalikan kode status 201 (Dibuat).
Untuk informasi selengkapnya tentang kode status, lihat Status dan kode kesalahan.
Header respons
Respons untuk operasi ini mencakup header yang dijelaskan dalam tabel berikut. Respons juga dapat menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .
| Header respons | Deskripsi |
|---|---|
ETag |
Berisi nilai yang mewakili versi direktori, diapit dalam tanda kutip. |
Last-Modified |
Mengembalikan tanggal dan waktu saat direktori terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header. Setiap operasi yang memodifikasi direktori atau propertinya memperbarui waktu modifikasi terakhir. Operasi pada file tidak memengaruhi waktu terakhir direktori yang dimodifikasi. |
x-ms-request-id |
Secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Memecahkan Masalah Operasi API. |
x-ms-version |
Menunjukkan versi Azure Files yang digunakan untuk menjalankan permintaan. |
Date |
Nilai tanggal/waktu UTC yang dihasilkan oleh layanan, yang menunjukkan waktu ketika respons dimulai. |
x-ms-request-server-encrypted: true/false |
Versi 2017-04-17 atau yang lebih baru. Nilai header ini diatur ke true jika konten permintaan berhasil dienkripsi menggunakan algoritma yang ditentukan, dan false sebaliknya. |
x-ms-file-permission-key |
Kunci izin direktori. |
x-ms-file-attributes |
Atribut sistem file pada direktori. Lihat daftar atribut tersedia. |
x-ms-file-creation-time |
Nilai tanggal/waktu UTC yang mewakili properti waktu pembuatan untuk direktori. |
x-ms-file-last-write-time |
Nilai tanggal/waktu UTC yang mewakili properti waktu tulis terakhir untuk direktori. |
x-ms-file-change-time |
Tanggal/waktu UTC nilai yang mewakili properti waktu perubahan untuk direktori. |
x-ms-file-file-id |
ID file direktori. |
x-ms-file-parent-id |
ID file induk direktori. |
x-ms-client-request-id |
Dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai header x-ms-client-request-id jika ada dalam permintaan dan nilai berisi tidak lebih dari 1024 karakter ASCII yang terlihat. Jika header x-ms-client-request-id tidak ada dalam permintaan, header ini tidak ada dalam respons. |
Isi respons
Tidak.
Sampel respons
Response status:
HTTP/1.1 201 Created
Response headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Otorisasi
Hanya pemilik akun yang dapat memanggil operasi ini.
Atribut sistem file
| Atribut | Atribut file Win32 | Definisi |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Direktori yang bersifat baca-saja. |
| Sembunyi | FILE_ATTRIBUTE_HIDDEN | Direktori disembunyikan. Ini tidak termasuk dalam daftar direktori biasa. |
| Sistem | FILE_ATTRIBUTE_SYSTEM | Direktori yang digunakan sistem operasi, atau digunakan secara eksklusif. |
| Tidak | FILE_ATTRIBUTE_NORMAL | Direktori yang tidak memiliki atribut lain yang ditetapkan. Atribut ini hanya valid saat digunakan sendiri. |
| Direktori | FILE_ATTRIBUTE_DIRECTORY | Handel yang mengidentifikasi direktori. |
| Mengarsipkan | FILE_ATTRIBUTE_ARCHIVE | Direktori yang merupakan direktori arsip. Aplikasi biasanya menggunakan atribut ini untuk menandai file untuk pencadangan atau penghapusan. |
| Luring | FILE_ATTRIBUTE_OFFLINE | Data direktori tidak segera tersedia. Atribut sistem file ini disajikan terutama untuk memberikan kompatibilitas dengan Windows. Azure Files tidak mendukungnya dengan opsi penyimpanan offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Direktori tidak akan diindeks oleh layanan pengindeksan konten. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Aliran data pengguna yang tidak dibaca oleh pemindai integritas data latar belakang. Atribut sistem file ini disajikan terutama untuk memberikan kompatibilitas dengan Windows. |
Komentar
Jika direktori dengan nama yang sama sedang dihapus saat Create Directory dipanggil, server mengembalikan kode status 409 (Konflik), dan menyediakan informasi kesalahan tambahan yang menunjukkan bahwa direktori sedang dihapus.
Jika direktori atau file dengan nama yang sama sudah ada, operasi gagal dengan kode status 409 (Konflik). Jika direktori induk tidak ada, operasi gagal dengan kode status 412 (Prasyarat Gagal).
Tidak dimungkinkan untuk membuat hierarki direktori dengan satu operasi Create Directory. Anda dapat membuat direktori hanya jika induk langsungnya sudah ada, seperti yang ditentukan di jalur. Jika direktori induk tidak ada, operasi gagal dengan kode status 412 (Prasyarat Gagal).
Create Directory tidak didukung pada rekam jepret berbagi, yang merupakan salinan berbagi baca-saja. Upaya untuk melakukan operasi ini pada rekam jepret berbagi akan gagal dengan 400 (InvalidQueryParameterValue)
Lihat juga
Operasi pada direktori