Tanıtıcıları Kapatmaya Zorla
Force Close Handles işlemi bir dizinde veya dosyada açılan tanıtıcıyı veya tanıtıcıları kapatır. Dosya veya dizindeki tanıtıcı kimliği tarafından belirtilen tek bir tanıtıcının kapatılmasını destekler. Ayrıca bu kaynakta açılan tüm tanıtıcıların kapatılmasını da destekler. İsteğe bağlı olarak, kaynak bir dizin olduğunda alt kaynaklardaki tanıtıcıları özyinelemeli olarak kapatmayı destekler.
Dizini yeniden adlandırma gibi işlemleri engelleyen tanıtıcıları zorlamak için bu işlemi Liste Tanıtıcıları birlikte kullanırsınız. SMB istemcileri bu tanıtıcıların izini sızdırmış veya kaybetmiş olabilir. İşlemin kapattığınız tanıtıcı üzerinde istemci tarafı etkisi vardır ve bu, dosyaları okuma veya yazma girişimlerinin başarısız olması nedeniyle kullanıcı tarafından görünen hatalar da dahil olmak üzere. Bu işlem, SMB oturumlarını kapatmak için bir değiştirme veya alternatif olarak tasarlanmamıştır.
Bu işlem 2018-11-09 ve sonraki sürümlerde kullanılabilir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Mevcut |
|---|---|
| SMB |
|
| NFS |
Yok |
İstek
Force Close Handles isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
| KOYMAK | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:
| Yol bileşeni | Açıklama |
|---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
Opsiyonel. Dizinin yolu. |
myfileordirectory |
Dosyanın veya dizinin adı. |
Yol adlandırma kısıtlamaları hakkında ayrıntılı bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma.
URI parametreleri
URI'de aşağıdaki ek parametreleri belirtebilirsiniz:
| Parametre | Açıklama |
|---|---|
timeout |
Opsiyonel. Saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Dosya hizmeti işlemleri için zaman aşımlarını ayarlama. |
marker |
Opsiyonel. Sonraki Force Close Handles işlemiyle kapatılacak tanıtıcıların konumunu tanımlayan dize değeri. Kapatacak daha fazla tanıtıcı varsa, işlem yanıt gövdesi içinde bir işaretçi değeri döndürür. İşaretçi değeri sonraki tanıtıcı kümesini kapatmak için sonraki bir çağrıda kullanılabilir.İşaretçi değeri istemciye göre opaktır. |
sharesnapshot |
Opsiyonel. Opak bir tarih/saat değeri. Mevcut olduğunda, tanıtıcı listesini sorgulamak için paylaşım anlık görüntüsünü belirtir. |
İstek üst bilgileri
Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır:
| İstek üst bilgisi | Açıklama |
|---|---|
Authorization |
Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme. |
Date veya x-ms-date |
Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme. |
x-ms-version |
Tüm yetkili istekler için gereklidir, ancak anonim istekler için isteğe bağlıdır. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-client-request-id |
Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. |
x-ms-handle-id |
Gerekli. Kapatılacak tanıtıcı kimliğini belirtir. Tüm tanıtıcıları belirtmek için joker karakter dizesi olarak yıldız işareti (*) kullanın. |
x-ms-recursive |
Opsiyonel. İşlemin URI'de belirtilen dizinin dosyalarına ve alt dizinlerine de uygulanıp uygulanacağını belirten boole değeri. |
x-ms-file-request-intent |
Authorization üst bilgisi bir OAuth belirteci belirtiyorsa gereklidir. Kabul edilebilir değer backup. Bu üst bilgi, Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action, Authorization üst bilgisi kullanılarak yetkilendirilmiş kimliğe atanan RBAC ilkesine eklenmişse verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opsiyonel. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde bulunan sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma. |
İstek gövdesi
Hiç kimse.
Yanıt
Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve XML biçiminde bir yanıt gövdesi içerir.
Durum kodu
Başarılı bir işlem 200 durum kodunu döndürür (Tamam). Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki tabloda yer alan üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.
Ortak üst bilgiler
Yanıt gövdesi
Boş.
İzin
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
İsteklerin işlenmesi sırasında hiçbir tanıtıcı kapatılırsa (örneğin, sağlanan x-ms-handle-id değeri geçersiz bir tanıtıcı belirtir veya sağlanan dosyada veya dizinde açık tanıtıcı bulunamadıysa) x-ms-number-of-handles-closed=0ile 200 (Tamam) durum yanıtı alırsınız.
x-ms-recursive üst bilgisi yalnızca dizinler için geçerlidir. Bir dosya için belirtirseniz 400 (Hatalı İstek) yanıtı alırsınız.
FILE_FLAG_DELETE_ON_CLOSE ile açılmış bir tanıtıcıyı zorla kapatma, dosyanın silinmesine neden olmayabilir.
Liste Tanıtıcılarıx-ms-handle-id hizmet tarafı tanıtıcı kimliğini döndürür. Bu tanıtıcı kimliği, SMB'nin veya uygulamanın koruduğu ilgili istemci tarafı tanıtıcısından farklıdır.