Tanıtıcıları Kapatmaya Zorla
İşlem, Force Close Handles bir dizinde veya dosyada açılan tanıtıcıyı veya tanıtıcıları kapatır. Dosya veya dizindeki tanıtıcı kimliğiyle 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ı yinelemeli olarak kapatmayı destekler.
Bu işlemi, dizin yeniden adlandırma gibi işlemleri engelleyen tanıtıcıları zorlamak için Liste Tanıtıcıları ile birlikte kullanırsınız. SMB istemcileri bu tutamaçların sızdırılmış veya izini kaybetmiş olabilir. İşlemin kapattığınız tanıtıcı üzerinde istemci tarafı etkisi vardır. 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ü | Kullanılabilir |
|---|---|
| SMB |
|
| NFS |
|
İstek
İsteği aşağıdaki gibi oluşturabilirsiniz Force Close Handles . HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
PUT |
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 | Description |
|---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
İsteğe bağlı. 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 verileri adlandırma ve buna başvurma.
URI parametreleri
URI'de aşağıdaki ek parametreleri belirtebilirsiniz:
| Parametre | Açıklama |
|---|---|
timeout |
İsteğe bağlı. Saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Dosya hizmeti işlemleri için zaman aşımlarını ayarlama. |
marker |
İsteğe bağlı. Sonraki Force Close Handles işlemle kapatılacak tanıtıcıların konumunu tanımlayan bir 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. Bundan sonra işaretçi değeri sonraki tanıtıcı kümesini kapatmak için sonraki bir çağrıda kullanılabilir.İşaretçi değeri istemci için opaktır. |
sharesnapshot |
İsteğe bağlı. 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 |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini 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 |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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 |
Gereklidir. 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 |
İsteğe bağlı. İşlemin URI'de belirtilen dizinin dosyalarına ve alt dizinlerine de uygulanıp uygulanacağını belirten bir Boole değeri. |
x-ms-file-request-intent |
Üst bilgi bir OAuth belirteci belirtiyorsa Authorization gereklidir. Kabul edilebilir değer: backup. Bu üst bilgi, üst bilgi kullanılarak Authorization yetkilendirilen Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action kimliğe atanan RBAC ilkesine eklenmişse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir. |
x-ms-allow-trailing-dot: { <Boolean> } |
İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde 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 verileri adlandırma ve buna başvurma. |
İstek gövdesi
Yok.
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 (Tamam) durum kodunu döndürür.
Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.
Yanıt üst bilgileri
Bu işlemin yanıtı aşağıdaki ü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.
| Yanıt üst bilgisi | Description |
|---|---|
x-ms-request-id |
Yapılan isteği benzersiz olarak tanımlar. İsteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme. |
x-ms-version |
İsteği yürütmek için kullanılan Azure Dosyalar sürümünü gösterir. |
Date |
Hizmetin yanıtı gönderdiği saati gösteren utc tarih/saat değeri. |
x-ms-marker |
Kapatılacak sonraki tanıtıcıyı açıklar. İsteği tamamlamak için daha fazla tanıtıcının kapatılması gerektiğinde bu dize döndürülür. Dize, kalan tanıtıcıları kapatmaya zorlamak için sonraki isteklerde kullanılır. yokluğu x-ms-marker , tüm ilgili tanıtıcıların kapatıldığını gösterir. |
x-ms-number-of-handles-closed |
Kapalı tanıtıcı sayısını gösterir. |
x-ms-number-of-handles-failed |
Kapatılamayan tanıtıcı sayısını gösterir. |
x-ms-client-request-id |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer en fazla 1.024 görünür ASCII karakteriyse üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi mevcut olmaz. |
Yanıt gövdesi
Boş.
Yetkilendirme
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ğer geçersiz bir tanıtıcı belirtir veya sağlanan dosya veya dizinde açık tanıtıcı bulunamadıysa) ile x-ms-number-of-handles-closed=0200 (Tamam) durum yanıtı alırsınız.
Üst x-ms-recursive bilgi yalnızca dizinler için geçerlidir. Bir dosya için belirtirseniz 400 (Hatalı İstek) yanıtı alırsınız.
ile FILE_FLAG_DELETE_ON_CLOSE açılmış bir tanıtıcıyı zorla kapatma, dosyanın silinmesine neden olmayabilir.
Liste Tanıtıcıları , hizmet tarafı tanıtıcı kimliğini döndürür x-ms-handle-id . Bu tanıtıcı kimliği, SMB'nin veya uygulamanın koruduğu ilgili istemci tarafı tanıtıcısından farklıdır.