View a markdown version of this page

CancelJob - Amazon Location Service

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 CancelJobla 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.

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.