Method: transferOperations.cancel

Bricht eine Übertragung ab. Mit der Methode transferOperations.get kannst du prüfen, ob der Vorgang erfolgreich abgebrochen oder trotz der cancel-Anfrage abgeschlossen wurde.

Wenn Sie einen Vorgang abbrechen, wird die aktuell laufende Übertragung unterbrochen. Bei wiederkehrenden Übertragungsjobs wird die nächste Instanz des Übertragungsjobs weiterhin ausgeführt. Wenn Ihr Job beispielsweise so konfiguriert ist, dass er jeden Tag um 13:00 Uhr ausgeführt wird, und Sie die Ausführung für Montag um 13:05 Uhr abbrechen, wird die Übertragung für Montag beendet. Am Dienstag wird jedoch weiterhin versucht, eine Übertragung durchzuführen.

Das gilt nur für derzeit laufende Vorgänge. Wenn derzeit kein Vorgang ausgeführt wird, passiert bei cancel nichts.

Wenn Sie einen Job abbrechen, berechnet der nächste Job ein Delta der Dateien und kann inkonsistente Status korrigieren. Wenn Sie beispielsweise jeden Tag einen Job ausführen und bei der heutigen Ausführung 10 neue Dateien gefunden und fünf Dateien übertragen wurden, bevor Sie den Job abgebrochen haben, wird bei der Übertragung am nächsten Tag ein neues Delta mit den fünf Dateien berechnet, die heute nicht kopiert wurden, sowie allen neuen Dateien, die morgen gefunden werden.

HTTP-Anfrage

POST https://storagetransfer.googleapis.com/v1/{name=transferOperations/**}:cancel

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Der Name der abzubrechenden Vorgangsressource

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie unter Authentication Overview.