Method: transferOperations.cancel

取消轉移。使用 transferOperations.get 方法,檢查是否成功取消作業,或是否在 cancel 要求下仍完成作業。

取消作業後,目前正在執行的轉移作業會中斷。對於週期性轉移工作,系統仍會執行下一個轉移工作的例項。舉例來說,如果工作已設定為每天下午 1 點執行,而你在下午 1 點 5 分取消週一的作業,週一轉移作業就會停止。不過,我們仍會在星期二嘗試執行轉移工作。

這項設定只適用於目前執行中的作業。如果目前沒有作業在執行,cancel 就不會執行任何動作。

取消工作後,下一個工作會計算檔案的差異,並可能修復任何不一致的狀態。舉例來說,如果您每天執行工作,而今天的工作找到 10 個新檔案,並在您取消工作前轉移了 5 個檔案,明天的工作轉移作業就會計算新的差異,包括今天未複製的 5 個檔案,以及明天發現的任何新檔案。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

要取消的作業資源名稱。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會是空白的 JSON 物件。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱 Authentication Overview