Condividi tramite

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. Facoltativamente, supporta gli handle di chiusura ricorsiva nelle sottorisorse quando la risorsa è una directory.

Questa operazione viene usata insieme handle elenco per forzare le operazioni di blocco, ad esempio la ridenominazione di una directory. I client SMB potrebbero aver perso o perso traccia di questi handle. L'operazione ha un impatto sul lato client sull'handle che si sta chiudendo, inclusi gli errori visibili dall'utente a causa di tentativi non riusciti di leggere o scrivere file. Questa operazione non è progettata come sostituzione o alternativa per la chiusura di una sessione SMB.

Questa operazione è disponibile nella versione 2018-11-09 e successive.

Disponibilità del protocollo

Protocollo di condivisione file abilitato Disponibile
SMB sì
NFS nessuna

Richiesta

La richiesta di Force Close Handles viene costruita nel modo seguente. È consigliabile usare HTTPS.

Metodo URI della richiesta Versione HTTP
METTERE https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfileordirectory?comp=forceclosehandles HTTP/1.1

Sostituire i componenti del percorso visualizzati nell'URI della richiesta con i propri, come indicato di seguito:

Componente percorso Descrizione
myaccount Nome dell'account di archiviazione.
myshare Nome della condivisione file.
mydirectorypath Opzionale. Percorso della directory.
myfileordirectory Nome del file o della directory.

Per informazioni dettagliate sulle restrizioni di denominazione dei percorsi, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.

Parametri URI

È possibile specificare i parametri aggiuntivi seguenti nell'URI:

Parametro Descrizione
timeout Opzionale. Espresso in secondi. Per altre informazioni, vedere Impostare timeout per le operazioni del servizio file.
marker Opzionale. Valore stringa che identifica la posizione degli handle che verranno chiusi con l'operazione di Force Close Handles successiva. L'operazione restituisce un valore marcatore all'interno del corpo della risposta se sono presenti più handle da chiudere. Il valore dell'indicatore può quindi essere usato in una chiamata successiva per chiudere il set successivo di handle.

Il valore dell'indicatore è opaco per il client.
sharesnapshot Opzionale. Valore di data/ora opaco. Quando è presente, specifica lo snapshot di condivisione su cui eseguire una query per l'elenco di handle.

Intestazioni della richiesta

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie 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 l'ora UTC (Coordinated Universal Time) per la richiesta. 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 utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
x-ms-client-request-id Opzionale. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando viene configurata la registrazione. È consigliabile usare questa intestazione per correlare le attività sul lato client alle richieste ricevute dal server.
x-ms-handle-id Obbligatorio. Specifica l'ID handle da chiudere. Usare un asterisco (*) come stringa con caratteri jolly per specificare tutti gli handle.
x-ms-recursive Opzionale. 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 intestazione specifica un token OAuth. Il valore accettabile è backup. Questa intestazione specifica che il 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 successive.
x-ms-allow-trailing-dot: { <Boolean> } Opzionale. Versione 2022-11-02 e 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 riferimento a condivisioni, directory, file e metadati.

Corpo della richiesta

Nessuno.

Risposta

La risposta include un codice di stato HTTP, un set di intestazioni di risposta e un corpo della risposta in formato XML.

Codice di stato

Un'operazione riuscita restituisce il codice di stato 200 (OK). Per informazioni sui codici di stato, vedere Stato e codici di errore.

Intestazioni di risposta

La risposta per questa operazione include le intestazioni nella tabella seguente. La risposta può includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1 .

Intestazioni comuni

Intestazione della risposta Descrizione
x-ms-request-id Identifica in modo univoco la richiesta effettuata. È possibile usarlo per risolvere i 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 è stato possibile chiudere.
x-ms-client-request-id Può essere usato per risolvere i problemi relativi alle richieste e alle 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.

Osservazioni

Se durante l'elaborazione delle richieste non vengono chiusi handle( ad esempio, il valore di x-ms-handle-id fornito specifica un handle non valido o non sono stati trovati handle aperti 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 si specifica per un file, si otterrà una risposta 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 handle lato servizio x-ms-handle-id. Questo ID handle è diverso dall'handle lato client corrispondente gestito da SMB o da un'applicazione.

Vedere anche