取消轉移。使用 transferOperations.get
方法,檢查是否成功取消作業,或是否在 cancel
要求下仍完成作業。
取消作業後,目前正在執行的轉移作業會中斷。對於週期性轉移工作,系統仍會執行下一個轉移工作的例項。舉例來說,如果工作已設定為每天下午 1 點執行,而你在下午 1 點 5 分取消週一的作業,週一轉移作業就會停止。不過,我們仍會在星期二嘗試執行轉移工作。
這項設定只適用於目前執行中的作業。如果目前沒有作業在執行,cancel
就不會執行任何動作。
取消工作後,下一個工作會計算檔案的差異,並可能修復任何不一致的狀態。舉例來說,如果您每天執行工作,而今天的工作找到 10 個新檔案,並在您取消工作前轉移了 5 個檔案,明天的工作轉移作業就會計算新的差異,包括今天未複製的 5 個檔案,以及明天發現的任何新檔案。
HTTP 要求
POST https://storagetransfer.googleapis.com/v1/{name=transferOperations/**}:cancel
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
要取消的作業資源名稱。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體會是空白的 JSON 物件。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/cloud-platform
詳情請參閱 Authentication Overview。