Tutup Paksa Handel
Operasi Force Close Handles menutup handel atau handel yang dibuka pada direktori atau file. Ini mendukung penutupan satu handel yang ditentukan dengan menangani ID pada file atau direktori. Ini juga mendukung penutupan semua handel yang dibuka pada sumber daya tersebut. Ini secara opsional mendukung handel penutupan rekursif pada sub sumber daya saat sumber daya adalah direktori.
Anda menggunakan operasi ini bersama Daftar Handel untuk menutup paksa penanganan operasi blok tersebut, seperti mengganti nama direktori. Klien SMB mungkin telah bocor atau kehilangan jejak handel ini. Operasi ini memiliki dampak sisi klien pada handel yang Anda tutup, termasuk kesalahan yang terlihat pengguna karena upaya gagal membaca atau menulis file. Operasi ini tidak dimaksudkan sebagai pengganti atau alternatif untuk menutup sesi SMB.
Operasi ini tersedia dalam versi 2018-11-09 dan yang lebih baru.
Ketersediaan protokol
| Protokol berbagi file yang diaktifkan | Tersedia |
|---|---|
| SMB |
|
| NFS |
|
Minta
Permintaan Force Close Handles dibangun sebagai berikut. Kami menyarankan agar Anda menggunakan HTTPS.
| Metode | Meminta URI | Versi HTTP |
|---|---|---|
| MELETAKKAN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
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. |
mydirectorypath |
Fakultatif. Jalur ke direktori. |
myfileordirectory |
Nama file atau direktori. |
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:
| Parameter | Deskripsi |
|---|---|
timeout |
Fakultatif. Dinyatakan dalam detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi layanan file. |
marker |
Fakultatif. Nilai string yang mengidentifikasi posisi handel yang akan ditutup dengan operasi Force Close Handles berikutnya. Operasi mengembalikan nilai penanda dalam isi respons jika ada lebih banyak handel untuk ditutup. Nilai penanda kemudian dapat digunakan dalam panggilan berikutnya untuk menutup set handel berikutnya.Nilai penanda buram untuk klien. |
sharesnapshot |
Fakultatif. Nilai tanggal/waktu buram. Saat ada, ini menentukan salinan bayangan berbagi untuk dikueri untuk daftar handel. |
Header permintaan
Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional:
| 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 Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage. |
x-ms-version |
Diperlukan untuk semua permintaan resmi, tetapi opsional untuk permintaan anonim. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan Versi untuk layanan Azure Storage. |
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. |
x-ms-handle-id |
Diperlukan. Menentukan ID handel yang akan ditutup. Gunakan tanda bintang (*) sebagai string kartubebas untuk menentukan semua handel. |
x-ms-recursive |
Fakultatif. Nilai Boolean yang menentukan apakah operasi juga harus berlaku untuk file dan subdirektori direktori yang ditentukan dalam URI. |
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. |
Isi permintaan
Tidak.
Jawaban
Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons dalam format XML.
Kode status
Operasi yang berhasil mengembalikan kode status 200 (OK). Untuk informasi tentang kode status, lihat Status dan kode kesalahan.
Header respons
Respons untuk operasi ini menyertakan header dalam tabel berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1 .
Header umum
| Header respons | Deskripsi |
|---|---|
x-ms-request-id |
Mengidentifikasi permintaan yang dibuat secara unik. 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 menunjukkan waktu layanan mengirim respons. |
x-ms-marker |
Menjelaskan handel berikutnya yang akan ditutup. String ini dikembalikan ketika lebih banyak handel perlu ditutup untuk menyelesaikan permintaan. String digunakan dalam permintaan berikutnya untuk menutup paksa handel yang tersisa. Tidak adanya x-ms-marker menunjukkan bahwa semua handel yang relevan ditutup. |
x-ms-number-of-handles-closed |
Menunjukkan jumlah handel tertutup. |
x-ms-number-of-handles-failed |
Menunjukkan jumlah handel yang gagal ditutup. |
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 nilainya paling banyak 1.024 karakter ASCII yang terlihat. Jika header x-ms-client-request-id tidak ada dalam permintaan, header ini tidak akan ada dalam respons. |
Isi respons
Kosong.
Otorisasi
Hanya pemilik akun yang dapat memanggil operasi ini.
Komentar
Jika tidak ada handel yang ditutup selama pemrosesan permintaan (misalnya, nilai x-ms-handle-id yang disediakan menentukan handel yang tidak valid, atau tidak ada handel terbuka yang ditemukan dalam file atau direktori yang disediakan) Anda akan mendapatkan respons status 200 (OK) dengan x-ms-number-of-handles-closed=0.
Header x-ms-recursive hanya valid untuk direktori. Jika Anda menentukannya untuk file, Anda akan mendapatkan respons 400 (Permintaan Buruk).
Menutup paksa handel yang dibuka dengan FILE_FLAG_DELETE_ON_CLOSE mungkin tidak menyebabkan file dihapus.
Handel Daftar mengembalikan ID handel sisi layanan x-ms-handle-id. ID handel ini berbeda dari handel sisi klien yang sesuai yang dipertahankan SMB atau aplikasi.