Framtvinga stängningshandtag
Åtgärden Force Close Handles stänger ett handtag eller referenser som öppnas i en katalog eller en fil. Det stöder stängning av ett enda handtag som anges av referens-ID för en fil eller katalog. Den stöder också stängning av alla referenser som öppnats på den resursen. Det kan också ha stöd för rekursiv stängning av referenser på underresurser när resursen är en katalog.
Du använder den här åtgärden tillsammans med listreferenser för att tvinga nära handtag som blockerar åtgärder, till exempel byta namn på en katalog. SMB-klienter kan ha läckt eller tappat bort dessa referenser. Åtgärden har en påverkan på handtaget på klientsidan som du stänger, inklusive användar synliga fel på grund av misslyckade försök att läsa eller skriva filer. Den här åtgärden är inte avsedd som en ersättning eller ett alternativ för att stänga en SMB-session.
Den här åtgärden är tillgänglig i version 2018-11-09 och senare.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Force Close Handles begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | Begärande-URI | HTTP-version |
|---|---|---|
| STÄLLA | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna enligt följande:
| Sökvägskomponent | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfri. Sökvägen till katalogen. |
myfileordirectory |
Namnet på filen eller katalogen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namngivnings- och referensresurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar för URI:n:
| Parameter | Beskrivning |
|---|---|
timeout |
Valfri. Uttryckt i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder. |
marker |
Valfri. Ett strängvärde som identifierar positionen för referenser som ska stängas med nästa Force Close Handles åtgärd. Åtgärden returnerar ett markörvärde i svarstexten om det finns fler referenser att stänga. Markörvärdet kan sedan användas i ett efterföljande anrop för att stänga nästa uppsättning referenser.Markörvärdet är ogenomskinlig för klienten. |
sharesnapshot |
Valfri. Ett ogenomskinliga datum/tid-värde. När den finns anger den resursögonblicksbilden för att fråga efter listan över referenser. |
Begärandehuvuden
I följande tabell beskrivs obligatoriska och valfria begärandehuvuden:
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden, men valfritt för anonyma begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. |
x-ms-handle-id |
Krävs. Anger det referens-ID som ska stängas. Använd en asterisk (*) som jokerteckensträng för att ange alla referenser. |
x-ms-recursive |
Valfri. Ett booleskt värde som anger om åtgärden också ska gälla för filerna och underkatalogerna i katalogen som anges i URI:n. |
x-ms-file-request-intent |
Krävs om Authorization rubrik anger en OAuth-token. Acceptabelt värde är backup. Det här huvudet anger att Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action eller Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ska beviljas om de ingår i RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization-huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfri. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
Begärandetext
Ingen.
Svar
Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext i XML-format.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK). Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna i följande tabell. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
Vanliga rubriker
| Svarsrubrik | Beskrivning |
|---|---|
x-ms-request-id |
Identifierar unikt den begäran som gjordes. Du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger vilken version av Azure Files som används för att köra begäran. |
Date |
Ett UTC-datum/tid-värde som anger den tid då tjänsten skickade svaret. |
x-ms-marker |
Beskriver nästa handtag som ska stängas. Den här strängen returneras när fler handtag måste stängas för att slutföra begäran. Strängen används i efterföljande begäranden för att tvinga fram stängning av återstående handtag. Avsaknaden av x-ms-marker anger att alla relevanta referenser stängdes. |
x-ms-number-of-handles-closed |
Anger antalet stängda referenser. |
x-ms-number-of-handles-failed |
Anger antalet referenser som inte kunde stängas. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id-huvudet, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken. Om x-ms-client-request-id huvudet inte finns i begäran visas inte det här huvudet i svaret. |
Svarstext
Tom.
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Anmärkningar
Om inga referenser stängs under bearbetningen av begäranden (till exempel det angivna x-ms-handle-id-värdet anger ett ogiltigt handtag, eller om inga öppna referenser hittades i den angivna filen eller katalogen) får du statussvaret 200 (OK) med x-ms-number-of-handles-closed=0.
x-ms-recursive-huvudet är endast giltigt för kataloger. Om du anger den för en fil får du ett svar på 400 (felaktig begäran).
Tvinga fram stängning av ett handtag som öppnades med FILE_FLAG_DELETE_ON_CLOSE kanske inte gör att filen tas bort.
List Handles returnerar x-ms-handle-id handtags-ID på tjänstsidan. Det här referens-ID:t skiljer sig från motsvarande handtag på klientsidan som SMB eller ett program underhåller.