Buat Berbagi

Operasi Create Share membuat berbagi Azure Files baru di bawah akun yang ditentukan. Meskipun API ini didukung penuh, ini adalah API manajemen warisan. Sebaiknya gunakan berbagi file - Buat, yang disediakan oleh penyedia sumber daya Azure Storage (Microsoft.Storage). Untuk mempelajari selengkapnya tentang cara berinteraksi secara terprogram dengan sumber daya FileShare dengan 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

Protokol berbagi file yang diaktifkan	Tersedia
Blok Pesan Server (SMB)
Sistem File Jaringan (NFS)

Minta

Anda dapat membuat permintaan Create Share seperti yang 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 Nama dan berbagi referensi, direktori, file, dan metadata.

Parameter URI

Anda dapat menentukan parameter tambahan berikut pada URI permintaan:

Parameter	Deskripsi
timeout	Fakultatif. Parameter batas waktu dinyatakan dalam detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi layanan file.

Header permintaan

Header permintaan yang diperlukan dan opsional dijelaskan dalam tabel berikut:

Header permintaan	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. Pasangan nama-nilai untuk dikaitkan dengan berbagi sebagai metadata. Nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C# .
x-ms-share-quota	Fakultatif. Didukung dalam versi 2015-02-21 dan yang lebih baru. Menentukan ukuran maksimum berbagi, dalam gibibyte (GiB).
x-ms-access-tier	Fakultatif. 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 tingkat penyimpanan Azure Files.
x-ms-enabled-protocols: <SMB \| NFS>	Fakultatif. 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>	Fakultatif. 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-enable-snapshot-virtual-directory-access: <true \| false>	Fakultatif. Didukung dalam versi 2024-08-04 dan yang lebih baru. Menentukan apakah direktori virtual rekam jepret harus dapat diakses di akar titik pemasangan berbagi saat NFS diaktifkan. Jika tidak ditentukan, defaultnya adalah true.
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-share-paid-bursting-enabled: <true \| false>	Fakultatif. Didukung dalam versi 2024-11-04 dan yang lebih baru. Hanya diizinkan untuk berbagi file premium (berbagi file dalam jenis akun penyimpanan FileStorage). Properti ini memungkinkan bursting berbayar. Jika properti tidak ditentukan, nilai defaultnya adalah false.
x-ms-share-paid-bursting-max-iops	Fakultatif. Didukung dalam versi 2024-11-04 dan yang lebih baru. Hanya diizinkan untuk berbagi file premium. Bilangan bulat yang mewakili operasi input/output bursting berbayar maksimum per detik (IOPS) yang diizinkan untuk berbagi. Default jika tidak ditentukan adalah IOPS maksimum yang diizinkan untuk berbagi. Jika header ini diatur, x-ms-share-paid-bursting-enabled juga harus diatur ke true.
x-ms-share-paid-bursting-max-bandwidth-mibps	Fakultatif. Didukung dalam versi 2024-11-04 dan yang lebih baru. Hanya diizinkan untuk berbagi file premium. Bilangan bulat yang mewakili mebibyte bursting berbayar maksimum per detik (MiB/dtk) yang diizinkan untuk berbagi. Default jika tidak ditentukan adalah MiB/dtk maksimum yang diizinkan untuk berbagi. Jika header ini diatur, x-ms-share-paid-bursting-enabled juga harus diatur ke true.

Isi permintaan

Tidak.

Permintaan sampel

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=  

Jawaban

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 terakhir yang dimodifikasi. 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 header x-ms-client-request-id jika ada dalam permintaan dan nilai berisi tidak lebih dari 1.024 karakter ASCII yang terlihat. Jika header x-ms-client-request-id tidak ada dalam permintaan, header tersebut tidak ada dalam respons.

Isi respons

Tidak.

Sampel respons

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  

Otorisasi

Hanya pemilik akun yang dapat memanggil operasi ini.

Komentar

Berbagi dibuat segera dalam akun penyimpanan. Tidak dimungkinkan untuk menumpuk satu berbagi dalam berbagi lainnya.

Anda dapat menentukan metadata untuk berbagi saat membuatnya dengan menyertakan satu atau beberapa header metadata pada permintaan. Format untuk header metadata 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.

Lihat juga

Operasi pada berbagi Azure Files