Berbagi Rekam Jepret
Dimulai dengan versi 2017-04-17, Snapshot Share operasi membuat rekam jepret baca-saja dari berbagi.
Ketersediaan protokol
| Mengaktifkan protokol berbagi file | Tersedia | Status |
|---|---|---|
| SMB |  |
GA |
| NFS | |
GA |
Minta
Anda dapat membuat Snapshot Share permintaan sebagai berikut. HTTPS disarankan.
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot |
HTTP/1.1 |
Ganti komponen jalur yang ditunjukkan dalam URI permintaan dengan milik Anda sendiri, sebagai berikut:
| Komponen jalur | Deskripsi |
|---|---|
myaccount |
Nama akun penyimpanan Anda. |
myshare |
Nama berbagi file Anda. |
Untuk detail tentang pembatasan penamaan jalur, lihat Penamaan dan referensi berbagi, 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 batas waktu untuk operasi Azure Files. |
Header permintaan
Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.
| 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 |
Pilihan. Menentukan pasangan nama-nilai yang ditentukan pengguna, yang terkait dengan salinan bayangan berbagi. Jika Anda tidak menentukan pasangan nama-nilai apa pun, operasi menyalin metadata berbagi dasar ke rekam jepret. Jika Anda menentukan satu atau beberapa pasangan nilai nama, salinan bayangan berbagi dibuat dengan metadata yang ditentukan. Dalam hal ini, metadata tidak disalin dari berbagi dasar. Nama metadata harus mematuhi aturan penamaan untuk pengidentifikasi C#. |
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 Blob Storage. |
Isi permintaan
Tidak ada.
Contoh permintaan
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1
Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
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 tentang kode status, lihat Kode status dan kesalahan.
Header respons
Respons untuk operasi ini mencakup header 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 rekam jepret berbagi, dalam tanda kutip. Salinan bayangan berbagi tidak dapat dimodifikasi, sehingga ETag salinan bayangan berbagi tertentu tidak pernah berubah. Namun, jika Anda menyediakan metadata baru dengan Snapshot Share permintaan, maka ETag salinan bayangan berbagi berbeda dari berbagi dasar. Jika Anda tidak menentukan metadata apa pun dengan permintaan, ETag salinan bayangan berbagi identik dengan berbagi dasar, pada saat salinan bayangan berbagi diambil. |
Last-Modified |
Mengembalikan tanggal dan waktu berbagi terakhir diubah. Untuk informasi selengkapnya, lihat Representasi nilai tanggal-waktu di header. Rekam jepret berbagi tidak dapat dimodifikasi, sehingga waktu terakhir yang dimodifikasi dari salinan bayangan berbagi tertentu tidak pernah berubah. Namun, jika Anda menyediakan metadata baru dengan Snapshot Share permintaan, waktu terakhir yang dimodifikasi dari rekam jepret berbagi berbeda dari berbagi dasar. Jika Anda tidak menentukan metadata apa pun dengan permintaan, waktu terakhir yang dimodifikasi dari rekam jepret berbagi identik dengan berbagi dasar, pada saat salinan bayangan berbagi diambil. |
x-ms-request-id |
Secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Pemecahan masalah operasi API. |
x-ms-version |
Menunjukkan versi Azure Files yang digunakan untuk menjalankan permintaan. |
Date atau x-ms-date |
Nilai tanggal/waktu UTC yang menunjukkan waktu di mana respons dimulai. Layanan menghasilkan nilai ini. |
x-ms-snapshot |
DateTime Nilai yang secara unik mengidentifikasi salinan bayangan berbagi. Anda dapat menggunakan nilai header ini dalam permintaan berikutnya untuk mengakses salinan bayangan berbagi. Nilai ini buram. |
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. Nilainya paling banyak 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header tidak akan ada dalam respons. |
Isi Respons
Tidak ada.
Respons sampel
Response Status:
HTTP/1.1 201 Created
Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Authorization
Hanya pemilik akun yang dapat memanggil operasi ini.
Keterangan
Rekam jepret berbagi menyediakan versi berbagi baca-saja. Setelah membuat salinan bayangan berbagi, Anda tidak dapat memodifikasinya. Salinan bayangan berbagi menyediakan cara mudah untuk membuat cadangan yang konsisten dari semua file pada berbagi.
Setiap kali Anda memanggil Snapshot Share operasi, salinan bayangan berbagi baru dibuat, dengan nilai unik DateTime yang mengidentifikasi salinan bayangan berbagi relatif terhadap berbagi dasarnya. Anda dapat menggunakan nilai ini DateTime untuk melakukan operasi lebih lanjut pada salinan bayangan berbagi dan kontennya. Anda harus memperlakukan nilai ini DateTime sebagai buram.
Nilai DateTime mengidentifikasi salinan bayangan berbagi pada URI permintaan. Misalnya, file pada berbagi dasar dan rekam jepretnya memiliki URI yang mirip dengan contoh berikut:
- File pada berbagi:
http://myaccount.file.core.windows.net/myshare/myfile - File pada salinan bayangan berbagi:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
Berbagi dapat mendukung pembuatan 200 salinan bayangan berbagi. Jika Anda mencoba membuat lebih dari 200 salinan bayangan berbagi, layanan mengembalikan kode kesalahan 409 (Konflik). Jika Anda mencoba membuat salinan bayangan berbagi saat operasi sebelumnya Snapshot Share sedang berlangsung, layanan juga mengembalikan kode kesalahan 409 (Konflik).
Salinan bayangan berbagi yang ada tidak pernah ditimpa. Mereka harus dihapus secara eksplisit. Untuk menghapus salinan bayangan berbagi secara eksplisit, panggil Hapus Berbagi dan atur x-ms-include-snapshots header, bersama dengan sharesnapshot parameter kueri, ke nilai yang sesuai.
Anda dapat melihat rekam jepret berbagi NFS pada klien NFS menggunakan direktori virtual rekam jepret (.snapshot), yang biasanya terletak di akar titik pemasangan berbagi. Akses ke direktori ini dapat dinonaktifkan dengan mengatur x-ms-enable-snapshot-virtual-directory-access header ke false di Set Share Properties API. Anda juga dapat mengatur header ini pada saat pembuatan berbagi sebagai bagian dari operasi Buat Berbagi .