Cancela una transferencia. Usa el método transferOperations.get para verificar si la cancelación se realizó de forma correcta o si la operación se completó a pesar de la solicitud cancel.
Cuando cancelas una operación, se interrumpe la transferencia que se está ejecutando. En el caso de los trabajos de transferencia recurrentes, se ejecutará la siguiente instancia del trabajo de transferencia. Por ejemplo, si tu trabajo está configurado para ejecutarse todos los días a la 1 p.m. y cancelas la operación del lunes a las 1:05 p.m., se detendrá la transferencia del lunes. Sin embargo, se intentará realizar una transferencia el martes.
Esto solo se aplica a las operaciones que se están ejecutando actualmente. Si no hay una operación en ejecución, cancel no hace nada.
Cuando cancelas un trabajo, el siguiente calcula un delta de archivos y puede reparar cualquier estado incoherente. Por ejemplo, si ejecutas una tarea todos los días y la de hoy encontró 10 archivos nuevos y transfirió cinco antes de que la cancelaras, la operación de transferencia de mañana calculará un delta nuevo con los cinco archivos que no se copiaron hoy, además de los archivos nuevos que se descubran mañana.
Solicitud HTTP
POST https://storagetransfer.googleapis.com/v1/{name=transferOperations/**}:cancel
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros | |
|---|---|
name |
El nombre del recurso de la operación que se cancelará. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta es un objeto JSON vacío.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/cloud-platform
Para obtener más información, consulta Authentication Overview.