Forza handle di chiusura

  • Articolo

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 Sì
NFS No

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.

Vedi anche