Cancelar una operación masiva

Detén un trabajo masivo que no haya terminado. Los elementos que aún no han comenzado se cancelan; a los elementos que ya se están ejecutando se les permite finalizar.

cancelBulkOperation detiene un trabajo que enviaste. Es de mejor esfuerzo e irreversible: los elementos que aún están QUEUED se cancelan, mientras que a los elementos que ya están RUNNING se les permite finalizar y registrar sus resultados. No revierte el trabajo que ya haya finalizado.

Requisitos

Authorization: Basic <API_KEY>
La capacidad de API masiva en tu aplicación.
El trabajo debe pertenecer a tu aplicación: un id de trabajo desconocido o de otra aplicación devuelve not-found.

Mutación

mutation CancelBulkOperation($bulkJobId: UUID!) {
  cancelBulkOperation(bulkJobId: $bulkJobId) {
    jobId
    status
    succeededItemCount
    failedItemCount
    skippedItemCount
  }
}

{
  "bulkJobId": "9c1e6f2a-1d4b-4a2e-8f0c-2b7e5a9d1234"
}

Respuesta

{
  "data": {
    "cancelBulkOperation": {
      "jobId": "9c1e6f2a-1d4b-4a2e-8f0c-2b7e5a9d1234",
      "status": "CANCELLED",
      "succeededItemCount": 4,
      "failedItemCount": 0,
      "skippedItemCount": 0
    }
  }
}

Argumentos

Parámetro	Tipo	Descripción
`bulkJobId`	`UUID!`	El id de trabajo devuelto por `submitBulkOperation`.

Campos de la respuesta

Campo	Descripción
`status`	`CANCELLED` una vez que el trabajo ha dejado de aceptar nuevo trabajo. Los elementos que ya habían tenido éxito o fallado mantienen su resultado.
`succeededItemCount` / `failedItemCount` / `skippedItemCount`	Contadores finales por elemento, incluyendo cualquier elemento que haya terminado después de que se realizó la cancelación.

Errores

Error	HTTP	Cuándo
`BulkApiAccessDenied`	403	Tu aplicación no tiene la capacidad de API masiva.
`BulkJobNotFound`	404	El id de trabajo es desconocido o pertenece a otra aplicación (deliberadamente indistinguible).

Cancelar un trabajo ya terminado o ya cancelado no es un error: devuelve el trabajo sin cambios (ver abajo).

Cancelar es idempotente y seguro para reintentar. Llamarlo sobre un trabajo que ya está finalizado (COMPLETED, COMPLETED_WITH_ERRORS, FAILED) o ya CANCELLED devuelve el trabajo sin cambios: nunca arroja error y nunca revierte elementos completados. Debido a que se permite que los elementos en curso terminen, consulta el trabajo con Rastrear un trabajo masivo si necesitas los conteos finales después de cancelar.

​Requisitos

​Mutación

​Respuesta

​Argumentos

​Campos de la respuesta

​Errores

Requisitos

Mutación

Respuesta

Argumentos

Campos de la respuesta

Errores