Buat Direktori
Operasi Create Directory
membuat direktori baru di bawah direktori berbagi atau induk yang ditentukan. Sumber daya direktori mencakup properti untuk direktori tersebut. Ini tidak menyertakan daftar file atau subdirektori yang dimuat oleh direktori.
Ketersediaan protokol
Mengaktifkan protokol berbagi file | Tersedia |
---|---|
SMB | |
NFS |
Minta
Anda dapat membuat Create Directory
permintaan 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 milik Anda sendiri, seperti yang diperlihatkan dalam tabel berikut:
Komponen jalur | Deskripsi |
---|---|
myaccount |
Nama akun penyimpanan Anda. |
myshare |
Nama berbagi file Anda. |
myparentdirectorypath |
Opsional. 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 Berbagi nama dan referensi, direktori, file, dan metadata.
Parameter URI
Anda dapat menentukan parameter tambahan berikut pada URI permintaan.
Parameter | Deskripsi |
---|---|
timeout |
Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi layanan File. |
Isi permintaan
Tidak ada.
Header permintaan
Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:
Parameter | Deskripsi |
---|---|
Authorization |
Wajib diisi. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
Date atau x-ms-date |
Wajib diisi. 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 |
Opsional. 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> } |
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 Bahasa Definisi Deskriptor Keamanan (SDDL). 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 mewarisi dari direktori induk.Catatan: Anda dapat menentukan atau x-ms-file-permission x-ms-file-permission-key . Jika tidak ada header yang ditentukan, nilai default digunakan inherit . |
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 Create-Permission API.Catatan: Anda dapat menentukan atau x-ms-file-permission x-ms-file-permission-key . Jika tidak ada header yang ditentukan, nilai inherit default digunakan untuk x-ms-file-permission header. |
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 yang 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 tulis 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 |
Opsional. 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> } |
Pilihan. 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 Authorization header menentukan token OAuth. Nilai yang dapat diterima adalah 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 Authorization header . Tersedia untuk versi 2022-11-02 dan yang lebih baru. |
x-ms-allow-trailing-dot: { <Boolean> } |
Pilihan. Versi 2022-11-02 dan yang lebih baru. Nilai Boolean menentukan apakah titik berikutnya yang ada di url permintaan harus dipangkas atau tidak. Untuk informasi selengkapnya, lihat Penamaan dan referensi berbagi, direktori, file, dan metadata. |
Contoh permintaan
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=
Respons
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 Kode status dan kesalahan.
Header respons
Respons untuk operasi ini mencakup header yang dijelaskan dalam tabel berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.
Header respons | Deskripsi |
---|---|
ETag |
Berisi nilai yang mewakili versi direktori, yang diapit 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. Operasi apa pun yang memodifikasi direktori atau propertinya memperbarui waktu terakhir yang dimodifikasi. 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 saat 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 yang 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 yang menunjukkan 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 x-ms-client-request-id header jika ada dalam permintaan dan nilainya berisi tidak lebih dari 1024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header ini tidak ada dalam respons. |
Isi Respons
Tidak ada.
Respons sampel
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
Authorization
Hanya pemilik akun yang dapat memanggil operasi ini.
Atribut sistem file
Atribut | Atribut file Win32 | Definisi |
---|---|---|
Baca Saja | FILE_ATTRIBUTE_READONLY | Direktori yang bersifat baca-saja. |
Tersembunyi | FILE_ATTRIBUTE_HIDDEN | Direktori disembunyikan. Ini tidak termasuk dalam daftar direktori biasa. |
Sistem | FILE_ATTRIBUTE_SYSTEM | Direktori yang digunakan oleh sistem operasi, atau digunakan secara eksklusif. |
Tidak ada | FILE_ATTRIBUTE_NORMAL | Direktori yang tidak memiliki atribut lain yang ditetapkan. Atribut ini hanya valid ketika digunakan sendiri. |
Directory | FILE_ATTRIBUTE_DIRECTORY | Handel yang mengidentifikasi direktori. |
Arsipkan | FILE_ATTRIBUTE_ARCHIVE | Direktori yang merupakan direktori arsip. Aplikasi biasanya menggunakan atribut ini untuk menandai file untuk pencadangan atau penghapusan. |
Offline | 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 dapat dibaca oleh pemindai integritas data latar belakang. Atribut sistem file ini disajikan terutama untuk memberikan kompatibilitas dengan Windows. |
Keterangan
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 Create Directory
operasi. 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 salinan bayangan berbagi, yang merupakan salinan berbagi baca-saja. Upaya untuk melakukan operasi ini pada salinan bayangan berbagi akan gagal dengan 400 (InvalidQueryParameterValue)