Handgrepen geforceerd sluiten
Met Force Close Handles de bewerking wordt een of meer ingangen gesloten die zijn geopend in een map of een bestand. Het ondersteunt het sluiten van één ingang die is opgegeven door handle-id in een bestand of map. Het biedt ook ondersteuning voor het sluiten van alle ingangen die voor die resource zijn geopend. Het biedt optioneel ondersteuning voor recursief sluiten van ingangen op subresources wanneer de resource een map is.
U gebruikt deze bewerking naast List Handles om ingangen af te dwingen die bewerkingen blokkeren, zoals het wijzigen van de naam van een map. SMB-clients hebben deze ingangen mogelijk gelekt of uit het oog verloren. De bewerking heeft invloed op de clientzijde op de ingang die u sluit, waaronder gebruikers zichtbare fouten vanwege mislukte pogingen om bestanden te lezen of te schrijven. Deze bewerking is niet bedoeld als vervanging of alternatief voor het sluiten van een SMB-sessie.
Deze bewerking is beschikbaar in versie 2018-11-09 en hoger.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| SMB |
|
| NFS |
|
Aanvraag
U kunt de Force Close Handles aanvraag als volgt samenstellen. We raden HTTPS aan.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Vervang de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen, als volgt:
| Padonderdeel | Description |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. |
mydirectorypath |
Optioneel. Het pad naar de map. |
myfileordirectory |
De naam van het bestand of de map. |
Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens voor meer informatie over padnaambeperkingen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven voor de URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. Uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingen voor meer informatie. |
marker |
Optioneel. Een tekenreekswaarde die de positie aangeeft van ingangen die bij de volgende Force Close Handles bewerking worden gesloten. De bewerking retourneert een markeringswaarde in de hoofdtekst van het antwoord als er meer ingangen moeten worden gesloten. De markeringswaarde kan vervolgens in een volgende aanroep worden gebruikt om de volgende set ingangen te sluiten.De markeringswaarde is ondoorzichtig voor de client. |
sharesnapshot |
Optioneel. Een ondoorzichtige datum/tijd-waarde. Wanneer deze aanwezig is, wordt de momentopname van de share opgegeven die moet worden opgevraagd voor de lijst met ingangen. |
Aanvraagheaders
In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven:
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
Date of x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen, maar optioneel voor anonieme aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. |
x-ms-handle-id |
Vereist. Hiermee geeft u de handle-id die moet worden gesloten. Gebruik een sterretje (*) als jokertekenreeks om alle ingangen op te geven. |
x-ms-recursive |
Optioneel. Een Booleaanse waarde die aangeeft of de bewerking ook van toepassing moet zijn op de bestanden en submappen van de map die is opgegeven in de URI. |
x-ms-file-request-intent |
Vereist als Authorization header een OAuth-token opgeeft. Acceptabele waarde is backup. Deze header geeft aan dat de Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action of Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action moet worden verleend als deze zijn opgenomen in het RBAC-beleid dat is toegewezen aan de identiteit die is geautoriseerd met behulp van de Authorization header. Beschikbaar voor versie 2022-11-02 en hoger. |
x-ms-allow-trailing-dot: { <Boolean> } |
Optioneel. Versie 2022-11-02 en hoger. De Booleaanse waarde geeft aan of een afsluitende punt die aanwezig is in de aanvraag-URL moet worden ingekort of niet. Zie Naamgeving en verwijzingen naar shares, mappen, bestanden en metagegevens voor meer informatie. |
Aanvraagbody
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst in XML-indeling.
Statuscode
Een geslaagde bewerking retourneert statuscode 200 (OK).
Zie Status- en foutcodes voor meer informatie over statuscodes.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan. U kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Geeft de versie van Azure Files aan die wordt gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijd-waarde die het tijdstip aangeeft waarop de service het antwoord heeft verzonden. |
x-ms-marker |
Beschrijft de volgende ingang die moet worden gesloten. Deze tekenreeks wordt geretourneerd wanneer meer ingangen moeten worden gesloten om de aanvraag te voltooien. De tekenreeks wordt gebruikt in volgende aanvragen om resterende ingangen geforceerd te sluiten. De afwezigheid van x-ms-marker geeft aan dat alle relevante ingangen zijn gesloten. |
x-ms-number-of-handles-closed |
Geeft het aantal gesloten grepen aan. |
x-ms-number-of-handles-failed |
Geeft het aantal ingangen aan dat niet kan worden gesloten. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header, als deze aanwezig is in de aanvraag en de waarde maximaal 1024 zichtbare ASCII-tekens is. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
Lege.
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Als er geen ingangen zijn gesloten tijdens de verwerking van aanvragen (de opgegeven x-ms-handle-id waarde geeft bijvoorbeeld een ongeldige ingang aan of als er geen geopende ingangen zijn gevonden in het opgegeven bestand of de opgegeven map), krijgt u een 200 -statusantwoord (OK) met x-ms-number-of-handles-closed=0.
De x-ms-recursive header is alleen geldig voor mappen. Als u dit opgeeft voor een bestand, krijgt u een 400-antwoord (Ongeldige aanvraag).
Het geforceerd sluiten van een ingang die is geopend met FILE_FLAG_DELETE_ON_CLOSE , zorgt er mogelijk niet voor dat het bestand wordt verwijderd.
List Handles retourneert de handle-id aan de x-ms-handle-id servicezijde. Deze handle-id verschilt van de bijbehorende ingang aan de clientzijde die door SMB of een toepassing wordt onderhouden.