Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CancelJob
La `CancelJob` operación detiene un trabajo pendiente o en ejecución. Solo se pueden cancelar los trabajos en estado **pendiente** o en **ejecución**. La cancelación es asincrónica, por lo que debe supervisar el estado del trabajo para confirmar su finalización. Los trabajos cancelados pueden tener resultados parciales en la ubicación de salida en función de cuándo se produzca la cancelación durante el procesamiento.
Para obtener más información, consulta [CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)la *referencia de la API de Amazon Location Service*.
Para ver ejemplos de solicitudes, respuestas y comandos de CLI para esta API, consulta [Cómo cancelar un trabajo](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html).
## Casos de uso
+ **Detenga el procesamiento innecesario:** cancele los trabajos que se enviaron con una configuración incorrecta, que ya no se necesitan debido a un cambio en los requisitos empresariales o que se iniciaron por error. Esto puede evitar el desperdicio de recursos y los cargos innecesarios.
+ **Optimización de recursos y costes:** libere capacidad de procesamiento cancelando los trabajos de menor prioridad cuando sea necesario procesar tareas de mayor prioridad.
## Explicación de la solicitud
La `CancelJob` solicitud solo requiere un parámetro para identificar qué trabajo se debe cancelar. Esta sencilla estructura de solicitud facilita la detención del procesamiento de los trabajos que ya no se necesitan.
La solicitud incluye el siguiente parámetro:
**Identificación del trabajo**
Parámetro obligatorio que especifica qué trabajo se va a cancelar.
+ `JobId`: el identificador único del trabajo que se va a cancelar. Debe tener entre 1 y 100 caracteres que coincidan con el patrón. `[-._\w]+` Es el mismo identificador devuelto por la `StartJob` operación cuando se creó el trabajo. Solo se pueden cancelar los trabajos en `Running` estado `Pending` o estado.
## Explicación de la respuesta
La `CancelJob` respuesta confirma la solicitud de cancelación y proporciona el estado actualizado del trabajo. Como la cancelación es asíncrona, debe utilizar la `GetJob` operación para supervisar el trabajo hasta que alcance el estado. `Cancelled`
La respuesta incluye los siguientes campos:
**Identificación del trabajo**
Identificadores únicos del trabajo que se va a cancelar.
+ `JobId`: el identificador único del trabajo.
+ `JobArn`: Nombre del recurso de Amazon (ARN) del trabajo que se va a cancelar.
**Estado de cancelación**
Estado actual del trabajo tras la solicitud de cancelación.
+ `Status`: Estado del trabajo inmediatamente después de la solicitud de cancelación. Normalmente, `Cancelling` para indicar que la cancelación está en curso. El estado pasa a `Cancelled` cuando se completa la cancelación. Se utiliza `GetJob` para supervisar esta transición.
**nota**
Los trabajos cancelados pueden tener resultados parciales en la ubicación de salida en función de cuándo se produzca la cancelación durante el procesamiento. Compruebe la ubicación de salida para determinar si se escribió algún dato parcial antes de que se completara la cancelación. Se le facturará por el número de registros que se procesaron y escribieron en el depósito de salida antes de que se cancelara el trabajo.