Cancela uma transferência. Use o método transferOperations.get para verificar se o cancelamento foi bem-sucedido ou se a operação foi concluída apesar da solicitação cancel.
Quando você cancela uma operação, a transferência em execução é interrompida. Para jobs de transferência recorrentes, a próxima instância do job de transferência ainda será executada. Por exemplo, se o job estiver configurado para ser executado todos os dias às 13h e você cancelar a operação de segunda-feira às 13h05, a transferência de segunda-feira será interrompida. No entanto, uma tentativa de transferência ainda será feita na terça-feira.
Isso se aplica apenas às operações em execução. Se uma operação não estiver em execução, cancel não fará nada.
Quando você cancela um job, o próximo job calcula um delta de arquivos e pode reparar qualquer estado inconsistente. Por exemplo, se você executa um job todos os dias e o job de hoje encontrou 10 arquivos novos e transferiu cinco antes de ser cancelado, a operação de transferência de amanhã vai calcular um novo delta com os cinco arquivos que não foram copiados hoje, além dos novos arquivos descobertos amanhã.
Solicitação HTTP
POST https://storagetransfer.googleapis.com/v1/{name=transferOperations/**}:cancel
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros | |
|---|---|
name |
O nome do recurso de operação a ser cancelado. |
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta será um objeto JSON vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/cloud-platform
Para mais informações, consulte Authentication Overview.