Buat Berbagi
Operasi membuat Create Share berbagi Azure Files baru di bawah akun yang ditentukan. Meskipun API ini didukung penuh, ini adalah API manajemen warisan. Kami menyarankan agar Anda menggunakan Berbagi File - Buat, yang disediakan oleh penyedia sumber daya Azure Storage (Microsoft.Storage). Untuk mempelajari selengkapnya tentang cara berinteraksi secara terprogram dengan sumber daya dengan FileShare menggunakan penyedia sumber daya Azure Storage, lihat Operasi di FileShares.
Jika berbagi dengan nama yang sama sudah ada, operasi gagal. Sumber daya berbagi mencakup metadata dan properti untuk berbagi tersebut. Ini tidak menyertakan daftar file yang terkandung dalam berbagi.
Ketersediaan protokol
| Mengaktifkan protokol berbagi file | Tersedia |
|---|---|
| Server Message Block (SMB) |  |
| Sistem File Jaringan (NFS) | |
Minta
Anda dapat membuat permintaan seperti yang Create Share ditunjukkan di sini. Kami menyarankan agar Anda menggunakan HTTPS.
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Ganti komponen jalur yang ditampilkan dalam URI permintaan dengan milik Anda sendiri, sebagai berikut:
| Komponen jalur | Deskripsi |
|---|---|
myaccount |
Nama akun penyimpanan Anda. |
myshare |
Nama berbagi file Anda. Nama hanya boleh berisi karakter huruf kecil. |
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 permintaan URI:
| Parameter | Deskripsi |
|---|---|
timeout |
Opsional. Parameter batas waktu dinyatakan dalam detik. Untuk informasi selengkapnya, lihat Mengatur waktu habis untuk operasi layanan File. |
Header permintaan
Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:
| Meminta kop | 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. Pasangan nama-nilai untuk dikaitkan dengan berbagi sebagai metadata. Nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C#. |
x-ms-share-quota |
Opsional. Didukung dalam versi 2015-02-21 dan yang lebih baru. Menentukan ukuran maksimum berbagi, dalam gibibyte (GiB). |
x-ms-access-tier |
Pilihan. Didukung dalam versi 2019-12-12 dan yang lebih baru. Menentukan tingkat akses berbagi. Nilai yang valid adalah TransactionOptimized, Hot, dan Cool. Untuk informasi mendetail tentang tingkat berbagi file, lihat Azure Files tingkat penyimpanan. |
x-ms-enabled-protocols: <SMB \| NFS> |
Pilihan. Didukung dalam versi 2019-07-07 dan yang lebih baru. Menentukan protokol yang diaktifkan pada berbagi. Jika tidak ditentukan, defaultnya adalah SMB. - SMB: Berbagi dapat diakses oleh SMBv3.0, SMBv2.1, dan REST.- NFS: Berbagi dapat diakses oleh NFSv4.1. Akun premium diperlukan untuk opsi ini. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Pilihan. Hanya NFS. Didukung dalam versi 2019-07-07 dan yang lebih baru. Menentukan perilaku root squashing pada berbagi saat NFS diaktifkan. Jika tidak ditentukan, defaultnya adalah NoRootSquash. - NoRootSquash: Matikan root squashing.- RootSquash: Memetakan permintaan dari uid/gid 0 ke uid/gid anonim.- AllSquash: Petakan semua uid dan gid ke pengguna anonim. |
x-ms-client-request-id |
Pilihan. 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. |
Isi permintaan
Tidak ada.
Contoh permintaan
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
x-ms-meta-Name: StorageSample
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
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, lihat Status dan kode kesalahan.
Header respons
Respons untuk operasi ini mencakup header berikut. Respons mungkin juga menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.
| Header respons | Deskripsi |
|---|---|
ETag |
Berisi nilai yang mewakili versi berbagi, diapit dalam tanda kutip. |
Last-Modified |
Mengembalikan tanggal dan waktu saat berbagi terakhir diubah. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Mewakili nilai tanggal/waktu di header. Setiap operasi yang memodifikasi berbagi atau properti atau metadatanya memperbarui waktu modifikasi terakhir. Operasi pada file tidak memengaruhi waktu terakhir berbagi yang dimodifikasi. |
x-ms-request-id |
Mengidentifikasi permintaan secara unik, dan Anda dapat menggunakannya 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-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 nilai berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header tidak ada dalam respons. |
Isi Respons
Tidak ada.
Respons sampel
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
x-ms-version: 2020-02-10
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Authorization
Hanya pemilik akun yang dapat memanggil operasi ini.
Keterangan
Berbagi dibuat segera di dalam akun penyimpanan. Tidak dimungkinkan untuk menumpuk satu berbagi dalam berbagi lain.
Anda dapat menentukan metadata untuk berbagi saat membuatnya dengan menyertakan satu atau beberapa header metadata pada permintaan. Format untuk header metadata adalah x-ms-meta-name:value.
Jika berbagi dengan nama yang sama sedang dihapus saat Anda memanggil Create Share, server mengembalikan kode status 409 (Konflik), dan informasi kesalahan tambahan menunjukkan bahwa berbagi sedang dihapus.
Anda dapat menggunakan kuota ukuran berbagi untuk membatasi ukuran file yang disimpan di berbagi. Kuota tidak membatasi ukuran rekam jepret. Overhead yang terkait dengan file dan digunakan untuk menghitung ukuran penagihan untuk akun penyimpanan tidak diperhitungkan dalam kuota.
Ketika jumlah ukuran file pada berbagi melebihi kuota yang ditetapkan pada berbagi, upaya untuk meningkatkan ukuran file akan gagal, dan membuat file baru yang tidak kosong (melalui REST) akan gagal. Anda masih dapat membuat file kosong.
Mengubah atau mengatur kuota tidak berpengaruh pada penagihan. Anda masih ditagih untuk ukuran file ditambah overhead.