Cancel Import or Validation Job

Overview

This API allows users to cancel import or validation operations that are currently in progress or scheduled for future execution. Cancellation is immediate for scheduled jobs and graceful for running jobs.

Cancellation Behavior

• Scheduled Jobs: Immediate cancellation, no processing occurs
• In Progress Jobs: Graceful shutdown, current item completes, no new items start
• Completed Jobs: Cannot be cancelled (returns error)
• Failed Jobs: Cannot be cancelled (already stopped)

When to Cancel

• Content Issues: Discover problems with source content
• Timing Changes: Need to reschedule for different time
• Resource Constraints: System resources are needed elsewhere
• User Request: Manual cancellation by authorized users
• System Maintenance: Planned maintenance windows

Cancellation Process

1. Request Received: System receives cancellation request
2. Status Check: Verifies current job status
3. Graceful Shutdown: For running jobs, completes current item
4. Resource Cleanup: Releases allocated system resources
5. Status Update: Marks job as cancelled
6. Notification: Updates job status and logs

Post-Cancellation

• Job Status: Changes to "Cancelled"
• Partial Results: Any completed items remain in system
• Logs: Cancellation reason and timing recorded
• Resources: System resources freed for other operations

Best Practices

• Monitor Jobs: Regularly check job status to identify candidates for cancellation
• Plan Cancellations: Schedule cancellations during low-usage periods
• Resource Planning: Consider resource impact before cancelling large jobs