Tutup Paksa Handel
Operasi Force Close Handles
menutup handel atau handel yang dibuka pada direktori atau file. Ini mendukung penutupan satu handel yang ditentukan oleh ID handel pada file atau direktori. Ini juga mendukung penutupan semua handel yang dibuka pada sumber daya tersebut. Ini secara opsional mendukung handel penutupan rekursif pada subsumber daya saat sumber daya adalah direktori.
Anda menggunakan operasi ini bersama Handel Daftar untuk menutup paksa handel yang memblokir operasi, 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
Mengaktifkan protokol berbagi file | Tersedia |
---|---|
SMB | |
NFS |
Minta
Anda dapat membuat Force Close Handles
permintaan sebagai berikut. Kami merekomendasikan HTTPS.
Metode | Meminta URI | Versi HTTP |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Ganti komponen jalur yang ditunjukkan dalam permintaan URI dengan milik Anda sendiri, sebagai berikut:
Komponen jalur | Deskripsi |
---|---|
myaccount |
Nama akun penyimpanan Anda. |
myshare |
Nama berbagi file Anda. |
mydirectorypath |
Pilihan. Jalur ke direktori. |
myfileordirectory |
Nama file atau direktori. |
Untuk detail tentang pembatasan penamaan jalur, lihat Menamai dan mereferensikan berbagi, direktori, file, dan metadata.
Parameter URI
Anda dapat menentukan parameter tambahan berikut pada URI:
Parameter | Deskripsi |
---|---|
timeout |
Opsional. Dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur batas waktu untuk operasi layanan file. |
marker |
Pilihan. Nilai string yang mengidentifikasi posisi handel yang akan ditutup dengan operasi berikutnya Force Close Handles . Operasi mengembalikan nilai penanda dalam isi respons jika ada lebih banyak handel untuk ditutup. Nilai penanda kemudian dapat digunakan dalam panggilan berikutnya untuk menutup kumpulan handel berikutnya.Nilai penanda buram untuk klien. |
sharesnapshot |
Pilihan. Nilai tanggal/waktu buram. Saat ada, ini menentukan rekam jepret berbagi untuk mengkueri daftar handel. |
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 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 |
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. |
x-ms-handle-id |
Wajib diisi. Menentukan ID handel yang akan ditutup. Gunakan tanda bintang (*) sebagai string kartubebas untuk menentukan semua handel. |
x-ms-recursive |
Opsional. 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 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 dalam url permintaan harus dipangkas atau tidak. Untuk informasi selengkapnya, lihat Memberi nama dan mereferensikan berbagi, direktori, file, dan metadata. |
Isi permintaan
Tidak ada.
Respons
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 mencakup header berikut. Respons mungkin juga menyertakan header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.
Header respons | Deskripsi |
---|---|
x-ms-request-id |
Secara unik mengidentifikasi permintaan yang dibuat. 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 di mana 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 x-ms-client-request-id header, jika ada dalam permintaan dan nilainya paling banyak 1.024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header ini tidak akan ada dalam respons. |
Isi Respons
Kosong.
Authorization
Hanya pemilik akun yang dapat memanggil operasi ini.
Keterangan
Jika tidak ada handel yang ditutup selama pemrosesan permintaan (misalnya, nilai yang disediakan x-ms-handle-id
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 mungkin FILE_FLAG_DELETE_ON_CLOSE
tidak menyebabkan file dihapus.
Handel Daftar mengembalikan x-ms-handle-id
ID handel sisi layanan. ID handel ini berbeda dari handel sisi klien yang sesuai yang dikelola SMB atau aplikasi.