

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CancelJob
<a name="cancel-job-api"></a>

`CancelJob` 작업은 실행 중이거나 보류 중인 작업을 중지합니다. **보류** 중 또는 **실행** 중 상태의 작업만 취소할 수 있습니다. 취소는 비동기식이므로 작업 상태를 모니터링하여 완료를 확인해야 합니다. 취소된 작업은 처리 중에 취소가 발생하는 시기에 따라 출력 위치에 부분적인 결과가 발생할 수 있습니다.

자세한 내용은 Amazon Location Service API 참조의 [CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)을 참조하세요. ** 

이 API에 대한 요청, 응답 및 CLI 명령의 예는 [작업을 취소하는 방법을 참조하세요](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html).

## 사용 사례
<a name="cancel-job-use-cases"></a>
+ **불필요한 처리 중지:** 잘못된 구성으로 제출되었거나, 변경된 비즈니스 요구 사항으로 인해 더 이상 필요하지 않거나, 실수로 시작된 작업을 취소합니다. 이렇게 하면 리소스 낭비와 불필요한 요금을 방지할 수 있습니다.
+ **리소스 및 비용 최적화:** 우선 순위가 높은 작업을 처리해야 하는 경우 우선 순위가 낮은 작업을 취소하여 처리 용량을 확보합니다.

## 요청 이해
<a name="cancel-job-request-parameters"></a>

이 `CancelJob` 요청은 취소할 작업을 식별하는 데 단일 파라미터만 필요합니다. 이 간단한 요청 구조를 사용하면 더 이상 필요하지 않은 작업의 처리를 쉽게 중지할 수 있습니다.

요청에는 다음 파라미터가 포함됩니다.

**작업 식별**  
취소할 작업을 지정하는 필수 파라미터입니다.  
+ `JobId`: 취소할 작업의 고유 식별자입니다. 패턴와 일치하는 1\~100자여야 합니다`[-._\w]+`. 작업이 생성될 때 `StartJob` 작업에서 반환되는 것과 동일한 식별자입니다. `Pending` 또는 `Running` 상태의 작업만 취소할 수 있습니다.

## 응답 이해
<a name="cancel-job-response-details"></a>

`CancelJob` 응답은 취소 요청을 확인하고 작업의 업데이트된 상태를 제공합니다. 취소는 비동기식이므로 작업이 `Cancelled` 상태에 도달할 때까지 `GetJob` 작업을 모니터링해야 합니다.

응답에는 다음 필드가 포함됩니다.

**작업 식별**  
취소 중인 작업의 고유 식별자입니다.  
+ `JobId`: 고유한 작업 식별자입니다.
+ `JobArn`: 취소 중인 작업의 Amazon 리소스 이름(ARN)입니다.

**취소 상태**  
취소 요청 후 현재 작업 상태입니다.  
+ `Status`: 취소 요청 직후의 작업 상태입니다. 일반적으로 취소가 진행 중임을 `Cancelling` 나타냅니다. `Cancelled` 취소가 완료되면 상태가 로 전환됩니다. `GetJob`를 사용하여이 전환을 모니터링합니다.

**참고**  
취소된 작업은 처리 중에 취소가 발생하는 시기에 따라 출력 위치에 부분적인 결과가 발생할 수 있습니다. 출력 위치를 확인하여 취소가 완료되기 전에 부분 데이터가 작성되었는지 확인합니다. 작업이 취소되기 전에 처리되어 출력 버킷에 기록된 레코드 수에 대한 요금이 청구됩니다.