Forza handle di chiusura
L'operazione Force Close Handles chiude un handle o handle aperto in una directory o in un file. Supporta la chiusura di un singolo handle specificato dall'ID handle in un file o in una directory. Supporta anche la chiusura di tutti gli handle aperti su tale risorsa. Supporta facoltativamente handle di chiusura ricorsiva nelle sottorisorse quando la risorsa è una directory.
Questa operazione viene usata insieme a List Handle per chiudere gli handle che bloccano le operazioni, ad esempio rinominando una directory. I client SMB potrebbero avere perso o perdere traccia di questi handle. L'operazione ha un impatto sul lato client sull'handle che si sta chiudendo, inclusi errori visibili dall'utente a causa di tentativi non riusciti di leggere o scrivere file. Questa operazione non è prevista come sostituzione o alternativa per chiudere una sessione SMB.
Questa operazione è disponibile nella versione 2018-11-09 e versioni successive.
Disponibilità del protocollo
| Protocollo di condivisione file abilitato | Disponibile |
|---|---|
| SMB |  |
| NFS |  |
Richiesta
È possibile costruire la Force Close Handles richiesta come indicato di seguito. È consigliabile HTTPS.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles |
HTTP/1.1 |
Sostituire i componenti del percorso mostrati nell'URI di richiesta con valori personalizzati, come illustrato di seguito:
| Componente percorso | Descrizione |
|---|---|
myaccount |
nome dell'account di archiviazione. |
myshare |
Nome della condivisione file. |
mydirectorypath |
Facoltativa. Percorso della directory. |
myfileordirectory |
Nome del file o della directory. |
Per informazioni dettagliate sulle restrizioni di denominazione del percorso, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.
Parametri URI
È possibile specificare i parametri aggiuntivi seguenti nell'URI:
| Parametro | Descrizione |
|---|---|
timeout |
Facoltativa. Espresso in secondi. Per altre informazioni, vedere Impostare timeout per le operazioni del servizio file. |
marker |
Facoltativa. Valore stringa che identifica la posizione degli handle che verranno chiusi con l'operazione successiva Force Close Handles . L'operazione restituisce un valore di marcatore all'interno del corpo della risposta se sono presenti più handle da chiudere. Il valore del marcatore può quindi essere usato in una chiamata successiva per chiudere il set successivo di handle.Il valore marcatore risulta opaco al client. |
sharesnapshot |
Facoltativa. Valore di data/ora opaco. Quando è presente, specifica lo snapshot di condivisione per eseguire query per l'elenco di handle. |
Intestazioni della richiesta
Nella tabella seguente vengono descritte le intestazioni richieste e facoltative:
| Intestazione della richiesta | Descrizione |
|---|---|
Authorization |
Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
Date o x-ms-date |
Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
x-ms-version |
Obbligatorio per tutte le richieste autorizzate, ma facoltativo per le richieste anonime. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-client-request-id |
Facoltativa. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando la registrazione è configurata. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server. |
x-ms-handle-id |
Obbligatorio. Specifica l'ID handle da chiudere. Usare un asterisco (*) come stringa jolly per specificare tutti gli handle. |
x-ms-recursive |
Facoltativa. Valore booleano che specifica se l'operazione deve essere applicata anche ai file e alle sottodirectory della directory specificata nell'URI. |
x-ms-file-request-intent |
Obbligatorio se Authorization l'intestazione specifica un token OAuth. Il valore accettabile è backup. Questa intestazione specifica che l'oggetto Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action o Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action deve essere concesso se sono inclusi nei criteri di controllo degli accessi in base al ruolo assegnati all'identità autorizzata usando l'intestazione Authorization . Disponibile per la versione 2022-11-02 e versioni successive. |
x-ms-allow-trailing-dot: { <Boolean> } |
Facoltativa. Versione 2022-11-02 e versioni successive. Il valore booleano specifica se un punto finale presente nell'URL della richiesta deve essere tagliato o meno. Per altre informazioni, vedere Denominazione e riferimenti a condivisioni, directory, file e metadati. |
Testo della richiesta
Nessuno.
Risposta
Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni di risposta e il corpo della risposta nel formato XML.
Codice stato
Un'operazione completata correttamente restituisce 200 (OK).
Per informazioni sui codici di stato, vedere Codici di stato e di errore.
Intestazioni di risposta
Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta potrebbe includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.
| Intestazione risposta | Descrizione |
|---|---|
x-ms-request-id |
Identifica in modo univoco la richiesta effettuata. È possibile usarlo per risolvere la risoluzione dei problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api. |
x-ms-version |
Indica la versione di File di Azure usata per eseguire la richiesta. |
Date |
Valore di data/ora UTC che indica l'ora in cui il servizio ha inviato la risposta. |
x-ms-marker |
Descrive l'handle successivo da chiudere. Questa stringa viene restituita quando è necessario chiudere più handle per completare la richiesta. La stringa viene usata nelle richieste successive per forzare gli handle rimanenti. L'assenza di x-ms-marker indica che tutti gli handle pertinenti sono stati chiusi. |
x-ms-number-of-handles-closed |
Indica il numero di handle chiusi. |
x-ms-number-of-handles-failed |
Indica il numero di handle che non sono stati chiusi. |
x-ms-client-request-id |
Può essere usato per risolvere le richieste e le risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id , se presente nella richiesta e il valore è al massimo 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non sarà presente nella risposta. |
Corpo della risposta
Vuoto.
Autorizzazione
Solo il proprietario dell'account può chiamare questa operazione.
Commenti
Se non vengono chiusi handle durante l'elaborazione delle richieste, ad esempio, il valore fornito x-ms-handle-id specifica un handle non valido o nessun handle aperto trovato nel file o nella directory specificata, si otterrà una risposta di stato 200 (OK) con x-ms-number-of-handles-closed=0.
L'intestazione x-ms-recursive è valida solo per le directory. Se lo si specifica per un file, si otterrà una risposta di 400 (richiesta non valida).
La chiusura forzata di un handle aperto con FILE_FLAG_DELETE_ON_CLOSE potrebbe non causare l'eliminazione del file.
Handle elenco restituisce l'ID x-ms-handle-id handle lato servizio. Questo ID handle è diverso dall'handle lato client corrispondente gestito da SMB o da un'applicazione.