Abort Copy File
L'operazione Abort Copy File annulla un'operazione in sospeso Copy File e lascia un file di destinazione con lunghezza zero e metadati completi. Questa operazione si applica alla versione 2015-02-21 e successive.
Disponibilità del protocollo
| Protocollo di condivisione file abilitato | Disponibile |
|---|---|
| SMB |
|
| NFS |
|
Richiesta
È possibile costruire la Abort Copy File richiesta come indicato di seguito. È consigliato il protocollo HTTPS.
A partire dalla versione 2013-08-15, è possibile specificare una firma di accesso condiviso per il file di destinazione se si trova nello stesso account del file di origine. A partire dalla versione 2015-04-05, è anche possibile specificare una firma di accesso condiviso per il file di destinazione se si trova in un account di archiviazione diverso.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy©id=<id> |
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 padre. |
myfile |
Nome del file. |
Per informazioni dettagliate sulle restrizioni di denominazione dei percorsi, vedere Denominazione e riferimento a condivisioni, directory, file e metadati.
Parametri URI
È possibile specificare il parametro aggiuntivo seguente nell'URI della richiesta.
| Parametro | Descrizione |
|---|---|
timeout |
Facoltativa. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione dei timeout per le operazioni di File di Azure. |
Intestazioni della richiesta
Nella seguente tabella 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 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. Specifica la versione dell'operazione da usare per questa richiesta. Questa operazione è disponibile solo nelle versioni 2015-02-21 e successive. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-copy-action:abort |
Obbligatorio. |
x-ms-lease-id:<ID> |
Obbligatorio se il file di destinazione ha un lease attivo. Disponibile per le versioni 2019-02-02 e successive. |
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 al momento della configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare File di Azure. |
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 tramite l'intestazione Authorization . Disponibile per la versione 2022-11-02 e successive. |
x-ms-allow-trailing-dot: { <Boolean> } |
Facoltativa. 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. |
Testo della richiesta
Nessuno.
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codice stato
Un'operazione completata correttamente restituisce il codice di stato 204 (Nessun contenuto). 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 include inoltre intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.
| Intestazione risposta | Descrizione |
|---|---|
x-ms-request-id |
Questa intestazione identifica in modo univoco la richiesta effettuata e può essere usata per la risoluzione dei problemi della richiesta. |
x-ms-version |
Indica la versione di File di Azure utilizzata per eseguire la richiesta. |
Date o x-ms-date |
Valore di data/ora UTC che indica l'ora in cui è stata avviata la risposta. Il servizio genera questo valore. |
x-ms-client-request-id |
È possibile usare questa intestazione 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. Il valore è al massimo 1024 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
Nessuno.
Autorizzazione
Solo il proprietario dell'account può chiamare questa operazione.
Commenti
Quando si annulla un'operazione in sospeso Copy File , l'intestazione del file di x-ms-copy-status destinazione è impostata su aborted. L'annullamento di un'operazione di copia comporta un file di destinazione di lunghezza zero. Tuttavia, i metadati per il file di destinazione avranno i nuovi valori copiati dal BLOB o dal file di origine o impostati in modo esplicito nella Copy File chiamata all'operazione.
È possibile annullare solo un'operazione di copia in sospeso. Se si tenta di annullare una copia completata o non riuscita, si verifica un errore di conflitto. Il tentativo di annullare un'operazione di copia utilizzando un ID di copia non corretto genera anche un errore di conflitto.