Framtvinga stängningshandtag
Åtgärden Force Close Handles stänger ett handtag eller referenser som öppnas i en katalog eller en fil. Den stöder stängning av ett enda handtag som anges av referens-ID i en fil eller katalog. Den stöder även 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 att byta namn på en katalog. SMB-klienter kan ha läckt eller tappat bort dessa referenser. Åtgärden har en inverkan 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ängligt |
|---|---|
| SMB |
|
| NFS |
|
Förfrågan
Du kan skapa begäran på Force Close Handles följande sätt. Vi rekommenderar HTTPS.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
PUT |
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 | Description |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfritt. Sökvägen till katalogen. |
myfileordirectory |
Namnet på filen eller katalogen. |
Mer information om namngivningsbegränsningar för sökvägar finns i Namnge och referera till resurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar för URI:n:
| Parameter | Beskrivning |
|---|---|
timeout |
Valfritt. Uttryckt i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder. |
marker |
Valfritt. 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 handtag 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 |
Valfritt. 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 Coordinated Universal Time (UTC) 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 |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. 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 |
Valfritt. Ett booleskt värde som anger om åtgärden också ska gälla för filerna och underkatalogerna för katalogen som anges i URI:n. |
x-ms-file-request-intent |
Krävs om Authorization huvudet 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 har behörighet med huvudet Authorization . Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfritt. 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 Namnge och referera till resurser, kataloger, filer och metadata. |
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext i XML-format.
Statuskod
En lyckad åtgärd returnerar statuskoden 200 (OK).
Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
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. Frånvaron av x-ms-marker indikerar att alla relevanta referenser stängdes. |
x-ms-number-of-handles-closed |
Anger antalet stängda handtag. |
x-ms-number-of-handles-failed |
Anger antalet handtag 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 x-ms-client-request-id för huvudet, om det finns i begäran och värdet är högst 1 024 synliga ASCII-tecken.
x-ms-client-request-id Om rubriken inte finns i begäran visas inte det här huvudet i svaret. |
Själva svaret
Tom.
Auktorisering
Endast kontoägaren kan anropa den här åtgärden.
Kommentarer
Om inga referenser stängs under bearbetningen av begäranden (till exempel anger det angivna x-ms-handle-id värdet 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.
Rubriken x-ms-recursive är endast giltig för kataloger. Om du anger den för en fil får du svaret 400 (felaktig begäran).
Att tvinga fram stängning av ett handtag som öppnades med FILE_FLAG_DELETE_ON_CLOSE kanske inte gör att filen tas bort.
Listreferenser returnerarx-ms-handle-id handtagets 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.