Annullare un trasferimento. Utilizza il metodo transferOperations.get per verificare se l'annullamento è andato a buon fine o se l'operazione è stata completata nonostante la richiesta cancel.
Quando annulli un'operazione, il trasferimento in esecuzione viene interrotto. Per i job di trasferimento ricorrenti, verrà comunque eseguita l'istanza successiva del job di trasferimento. Ad esempio, se il job è configurato per essere eseguito ogni giorno alle 13:00 e annulli l'operazione del lunedì alle 13:05, il trasferimento del lunedì verrà interrotto. Tuttavia, martedì verrà comunque tentato un job di trasferimento.
Questo vale solo per le operazioni in esecuzione. Se al momento non è in esecuzione un'operazione, cancel non fa nulla.
Quando annulli un job, il job successivo calcola un delta di file e può riparare eventuali stati incoerenti. Ad esempio, se esegui un job ogni giorno e quello di oggi ha trovato 10 nuovi file e ne ha trasferiti cinque prima che tu lo annullassi, l'operazione di trasferimento di domani calcolerà un nuovo delta con i cinque file che non sono stati copiati oggi, oltre a eventuali nuovi file scoperti domani.
Richiesta HTTP
POST https://storagetransfer.googleapis.com/v1/{name=transferOperations/**}:cancel
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri | |
|---|---|
name |
Il nome della risorsa dell'operazione da annullare. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta è un oggetto JSON vuoto.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la sezione Authentication Overview.