Wymuś zamknięcie uchwytów
Operacja Force Close Handles zamyka uchwyt lub uchwyty otwarte w katalogu lub pliku. Obsługuje zamykanie pojedynczego uchwytu określonego przez identyfikator uchwytu w pliku lub katalogu. Obsługuje również zamykanie wszystkich dojść otwartych w tym zasobie. Opcjonalnie obsługuje cyklicznie zamykające uchwyty w podźródle, gdy zasób jest katalogiem.
Ta operacja jest używana wraz z dojściami listy , aby wymusić zamknięcie uchwytów, które blokują operacje, takie jak zmiana nazwy katalogu. Klienci SMB mogli wyciekć lub utracić śledzenie tych dojść. Operacja ma wpływ po stronie klienta na zamknięcie uchwytu, w tym błędy widoczne dla użytkownika z powodu nieudanych prób odczytu lub zapisu plików. Ta operacja nie jest przeznaczona jako zamiana ani alternatywa dla zamknięcia sesji SMB.
Ta operacja jest dostępna w wersji 2018-11-09 lub nowszej.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępne |
|---|---|
| SMB |
|
| NFS |
|
Żądanie
Żądanie można skonstruować Force Close Handles w następujący sposób. Zalecamy użycie protokołu HTTPS.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Zastąp składniki ścieżki wyświetlane we własnym identyfikatorze URI żądania, w następujący sposób:
| Składnik ścieżki | Opis |
|---|---|
myaccount |
Nazwa konta magazynu. |
myshare |
Nazwa udziału plików. |
mydirectorypath |
Opcjonalny. Ścieżka do katalogu. |
myfileordirectory |
Nazwa pliku lub katalogu. |
Aby uzyskać szczegółowe informacje na temat ograniczeń nazewnictwa ścieżek, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.
Parametry identyfikatora URI
W identyfikatorze URI można określić następujące dodatkowe parametry:
| Parametr | Opis |
|---|---|
timeout |
Opcjonalny. Wyrażone w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi plików. |
marker |
Opcjonalny. Wartość ciągu, która identyfikuje położenie uchwytów, które zostaną zamknięte przy użyciu następnej Force Close Handles operacji. Operacja zwraca wartość znacznika w treści odpowiedzi, jeśli istnieje więcej dojść do zamknięcia. Następnie można użyć wartości znacznika w kolejnym wywołaniu, aby zamknąć następny zestaw uchwytów.Wartość znacznika jest nieprzezroczysta dla klienta. |
sharesnapshot |
Opcjonalny. Nieprzezroczysta wartość daty/godziny. Gdy jest obecny, określa migawkę udziału do wykonywania zapytań dotyczących listy dojść. |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań:
| Nagłówek żądania | Opis |
|---|---|
Authorization |
Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
Date lub x-ms-date |
Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
x-ms-version |
Wymagane dla wszystkich autoryzowanych żądań, ale opcjonalnych dla żądań anonimowych. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage. |
x-ms-client-request-id |
Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. |
x-ms-handle-id |
Wymagane. Określa identyfikator uchwytu do zamknięcia. Użyj gwiazdki (*) jako ciągu wieloznacznego, aby określić wszystkie uchwyty. |
x-ms-recursive |
Opcjonalny. Wartość logiczna określająca, czy operacja powinna być również stosowana do plików i podkatalogów katalogu określonego w identyfikatorze URI. |
x-ms-file-request-intent |
Wymagane, jeśli Authorization nagłówek określa token OAuth. Akceptowalna wartość to backup. Ten nagłówek określa, że wartość Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action lub Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action powinna zostać udzielona, jeśli zostaną one uwzględnione w zasadach RBAC przypisanych do tożsamości, która jest autoryzowana przy użyciu nagłówka Authorization . Dostępne dla wersji 2022-11-02 lub nowszej. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opcjonalny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w adresie URL żądania powinna być przycinana, czy nie. Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych. |
Treść żądania
Brak.
Reakcja
Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi w formacie XML.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).
Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.
| Nagłówek odpowiedzi | Opis |
|---|---|
x-ms-request-id |
Jednoznacznie identyfikuje wykonane żądanie. Można go użyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API. |
x-ms-version |
Wskazuje wersję Azure Files, która jest używana do wykonania żądania. |
Date |
Wartość daty/godziny UTC wskazująca godzinę, w której usługa wysłała odpowiedź. |
x-ms-marker |
Opisuje następny uchwyt do zamknięcia. Ten ciąg jest zwracany po zamknięciu większej liczby dojść w celu ukończenia żądania. Ciąg jest używany w kolejnych żądaniach, aby wymusić zamknięcie pozostałych dojść. Brak x-ms-marker wskazuje, że wszystkie odpowiednie dojścia zostały zamknięte. |
x-ms-number-of-handles-closed |
Wskazuje liczbę zamkniętych dojść. |
x-ms-number-of-handles-failed |
Wskazuje liczbę dojść, których nie można zamknąć. |
x-ms-client-request-id |
Może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id , jeśli jest obecna w żądaniu, a wartość wynosi najwyżej 1024 widoczne znaki ASCII.
x-ms-client-request-id Jeśli nagłówek nie istnieje w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi. |
Treść odpowiedzi
Pusty.
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Uwagi
Jeśli żadne dojścia nie są zamykane podczas przetwarzania żądań (na przykład podana x-ms-handle-id wartość określa nieprawidłową dojście lub nie znaleziono otwartych dojść w podanym pliku lub katalogu), otrzymasz odpowiedź o stanie 200 (OK) za pomocą polecenia x-ms-number-of-handles-closed=0.
Nagłówek x-ms-recursive jest prawidłowy tylko dla katalogów. Jeśli określisz go dla pliku, otrzymasz odpowiedź 400 (nieprawidłowe żądanie).
Wymuś zamknięcie dojścia, które zostało otwarte z FILE_FLAG_DELETE_ON_CLOSE poleceniem , może nie spowodować usunięcia pliku.
Funkcja List Handles zwraca identyfikator dojścia x-ms-handle-id po stronie usługi. Ten identyfikator dojścia różni się od odpowiedniego dojścia po stronie klienta obsługiwanego przez protokół SMB lub aplikację.