Vynutit zavření úchytů
Operace Force Close Handles zavře popisovač nebo úchyty otevřené v adresáři nebo souboru. Podporuje zavření jednoho popisovače určeného ID popisovače v souboru nebo adresáři. Podporuje také zavření všech popisovačů otevřených v daném prostředku. Volitelně podporuje rekurzivní uzavírací popisovače u dílčích zdrojů, pokud je prostředkem adresář.
Tuto operaci použijete společně s popisovači seznamu k vynucení zavření popisovačů, které blokují operace, jako je přejmenování adresáře. Klienti SMB můžou tyto popisovače prozradit nebo je ztratit. Operace má vliv na popisovač, který zavíráte, na straně klienta, včetně chyb viditelných uživatelem kvůli neúspěšným pokusům o čtení nebo zápis souborů. Tato operace není určena jako náhrada ani alternativa k uzavření relace SMB.
Tato operace je k dispozici ve verzi 2018-11-09 a novější.
Dostupnost protokolu
| Povolený protokol sdílených složek | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Žádost
Požadavek můžete vytvořit Force Close Handles následujícím způsobem. Doporučujeme HTTPS.
| Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:
| Komponenta Cesta | Description |
|---|---|
myaccount |
Název vašeho účtu úložiště. |
myshare |
Název sdílené složky. |
mydirectorypath |
Nepovinný parametr. Cesta k adresáři. |
myfileordirectory |
Název souboru nebo adresáře. |
Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.
Parametry identifikátoru URI
V identifikátoru URI můžete zadat následující další parametry:
| Parametr | Popis |
|---|---|
timeout |
Nepovinný parametr. Vyjádřeno v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace souborové služby. |
marker |
Nepovinný parametr. Řetězcová hodnota, která identifikuje pozici popisovačů, které budou uzavřeny při další Force Close Handles operaci. Operace vrátí hodnotu značky v těle odpovědi, pokud je potřeba zavřít více popisovačů. Hodnota značky se pak dá použít v následném volání k zavření další sady popisovačů.Hodnota značky je pro klienta neprůselná. |
sharesnapshot |
Nepovinný parametr. Neprůselná hodnota data a času. Když je k dispozici, určuje snímek sdílené složky, který se má dotazovat na seznam popisovačů. |
Hlavičky požadavku
Následující tabulka popisuje požadované a volitelné hlavičky požadavků:
| Hlavička požadavku | Popis |
|---|---|
Authorization |
Povinná hodnota. Určuje autorizační schéma, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage. |
Date nebo x-ms-date |
Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage. |
x-ms-version |
Povinné pro všechny autorizované žádosti, ale volitelné pro anonymní žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
x-ms-client-request-id |
Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. |
x-ms-handle-id |
Povinná hodnota. Určuje ID popisovače, které se má zavřít. K zadání všech popisovačů použijte hvězdičku (*) jako řetězec se zástupnými znaky. |
x-ms-recursive |
Nepovinný parametr. Logická hodnota, která určuje, jestli má operace platit také pro soubory a podadresáře adresáře zadaného v identifikátoru URI. |
x-ms-file-request-intent |
Vyžaduje se, pokud Authorization hlavička určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action by se měly udělit nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action , pokud jsou zahrnuté v zásadách RBAC přiřazených k identitě, která je autorizována pomocí hlavičky Authorization . K dispozici pro verzi 2022-11-02 a novější. |
x-ms-allow-trailing-dot: { <Boolean> } |
Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má v adrese URL požadavku oříznout koncová tečka, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich. |
Text požadavku
Žádné
Odpověď
Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a text odpovědi ve formátu XML.
Stavový kód
Úspěšná operace vrátí stavový kód 200 (OK).
Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.
Hlavičky odpovědi
Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.
| Hlavička odpovědi | Description |
|---|---|
x-ms-request-id |
Jedinečně identifikuje požadavek, který byl proveden. Můžete ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API. |
x-ms-version |
Označuje verzi Azure Files, která se používá ke spuštění požadavku. |
Date |
Hodnota data a času UTC, která označuje čas, kdy služba odeslala odpověď. |
x-ms-marker |
Popisuje další popisovač, který se má zavřít. Tento řetězec se vrátí, když je potřeba zavřít více popisovačů, aby bylo možné požadavek dokončit. Řetězec se používá v následných požadavcích k vynucení zavření zbývajících popisovačů. Absence znamená x-ms-marker , že všechny relevantní popisovače byly uzavřeny. |
x-ms-number-of-handles-closed |
Označuje počet uzavřených popisovačů. |
x-ms-number-of-handles-failed |
Označuje počet popisovačů, které se nepodařilo zavřít. |
x-ms-client-request-id |
Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky, pokud je v požadavku a hodnota je maximálně 1 024 viditelných x-ms-client-request-id znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude tato hlavička v odpovědi. |
Text odpovědi
Prázdné.
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Pokud se během zpracování požadavků nezavře žádné popisovače (například zadaná x-ms-handle-id hodnota určuje neplatný popisovač nebo se v zadaném souboru nebo adresáři nenašly žádné otevřené popisovače), zobrazí se odpověď na stav 200 (OK) s x-ms-number-of-handles-closed=0.
Hlavička x-ms-recursive je platná pouze pro adresáře. Pokud ho zadáte pro soubor, dostanete odpověď 400 (Chybný požadavek).
Vynucené zavření popisovače otevřeného pomocí FILE_FLAG_DELETE_ON_CLOSE nemusí způsobit odstranění souboru.
Popisovače seznamu vrátí x-ms-handle-id ID popisovače na straně služby. Toto ID popisovače se liší od odpovídajícího popisovače na straně klienta, který udržuje protokol SMB nebo aplikace.