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

# 작업 대기열에서 작업 AWS Batch 검색
<a name="searching-filtering-jobs"></a>

작업 검색을 AWS Batch 사용하여에서 작업을 검색하고 필터링할 수 있습니다. 이 기능은 기존 작업 대기열에서 작업을 검색하고 필터링하는 옵션을 제공합니다.

검색 및 필터는 최종 상태(`SUCCEEDED` 또는 `FAILED`)가 아닌 작업을 검색할 수 있습니다. 작업 상태가 `SUCCEEDED` 또는 `FAILED`가 되면 최대 7일 동안 작업을 검색할 수 있습니다. 여전히 작업의 CloudWatch 또는 Amazon EventBridge 로그를 볼 수 있습니다.

여러 기준을 동시에 사용하여 검색하려면 **고급 검색** 기능을 사용합니다. 예를 들어 **상태**, **날짜 범위** 및 **추가 기준**(예: 작업 이름, 작업 정의, 작업 ID)과 같은 필터 중 일부 또는 전부를 포함할 수 있습니다.

## 검색 AWS Batch 작업(AWS 콘솔)
<a name="search-jobs"></a>

이 절차를 사용하여 AWS Batch 콘솔의 작업 대기열에서 작업을 검색합니다.

1. [AWS Batch 콘솔](https://console.aws.amazon.com/batch/home)로 이동합니다.

1. 탐색 창에서 **작업**을 선택합니다.

1. **고급 검색**을 켭니다.

1. **작업 대기열** 드롭다운 목록을 확장하고 검색할 작업 대기열을 선택합니다.
**참고**  
한 번에 하나의 작업 대기열 내에서만 작업을 검색할 수 있습니다.

1. **검색 옵션**:

   1. **상태** 드롭다운 목록에서 필터링할 상태를 하나 이상 선택할 수 있습니다. 자세한 내용은 [작업 상태](job_states.md) 및 [서비스 작업 상태](service-job-status.md) 섹션을 참조하세요.
**참고**  
배열 작업 상위는 하위 작업이 로 업데이트될 `PENDING` 때 로 업데이트되고 하위 작업이 실행되는 동안 `PENDING` 상태를 `RUNNABLE` 유지합니다. 이러한 작업을 보려면 모든 하위 작업이 터미널 상태에 도달할 때까지 `PENDING` 상태를 기준으로 필터링합니다.

   1. **날짜 범위**를 선택하여 날짜 및 시간 범위를 기준으로 결과를 필터링합니다.
      + **상대 모드**를 선택하여 현재 날짜 및 시간에서 역순으로 계산한 시간 범위 내에 생성 날짜를 가진 작업을 검색합니다.
      + **절대 모드**를 선택하여 지정한 날짜 및 시간 범위 내에 생성 날자를 가진 작업을 검색합니다.

   1. **추가 기준** 필드에 검색 결과에 포함할 키워드를 입력합니다. 예를 들어이 필드를 사용하여 **작업 이름**, **작업 정의**, **작업 ID** 또는 **공유 식별자**로 검색할 수 있습니다. 속성에 따라서는 같음(=) 또는 포함(^)과 같은 추가 연산자를 정의해야 할 수 있습니다.
**참고**  
SageMaker 훈련 작업 대기열은 **작업 이름** 및 **작업 ID**별 필터링만 지원합니다.
**참고**  
**공유 식별자**를 기준으로 필터링할 때 작업 상태를 지정할 수도 있습니다. 이는 다른 필터가 작업 상태 필터링을 제외하는 제한에 대한 예외입니다.

1. **검색**을 선택합니다.

## AWS Batch 작업 검색 및 필터링(AWS CLI)
<a name="search-filter-jobs-cli"></a>

이 절차를 사용하여 AWS CLI로 작업 대기열에 있는 모든 작업을 나열합니다. 선택적으로, **-filters** 파라미터를 사용하여 지정한 기준에 따라 결과의 범위를 좁힙니다.

------
#### [ Search job queue (AWS CLI) ]

[list-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-jobs.html) 명령을 사용하여 작업 대기열을 검색하고 필터링할 수 있습니다.

예를 들어 작업 이름을 기반으로 작업 대기열을 검색할 수 있습니다.

```
aws batch list-jobs \
    --job-queue my-job-queue \
    --filters name=JOB_NAME,values="my-job"
```

공유 식별자를 기준으로 작업을 필터링합니다.

```
aws batch list-jobs \
    --job-queue my-job-queue \
    --filters name=SHARE_IDENTIFIER,values="my-share"
```

공유 식별자를 기준으로 필터링할 때 작업 상태를 포함할 수 있습니다.

```
aws batch list-jobs \
    --job-queue my-job-queue \
    --job-status RUNNING \
    --filters name=SHARE_IDENTIFIER,values="my-share"
```

위의 명령에서 다음과 같이 변경합니다.
+ *my-job-queue*를 작업 대기열의 이름으로 바꿉니다.
+ *my-job*을 작업의 이름으로 바꿉니다.
+ *my-share*를 필터링하려는 공유 식별자로 바꿉니다.

------
#### [ Search service job queue (AWS CLI) ]

[list-service-jobs](https://docs.aws.amazon.com/cli/latest/reference/batch/list-service-jobs.html) 명령을 사용하여 서비스 작업 대기열을 검색하고 필터링할 수 있습니다.

예를 들어 작업 이름을 기반으로 서비스 작업 대기열을 검색할 수 있습니다.

```
aws batch list-service-jobs \
    --job-queue my-sm-queue \
    --filters name=JOB_NAME,values="my-sm-job"
```

공유 식별자를 기준으로 서비스 작업을 필터링합니다.

```
aws batch list-service-jobs \
    --job-queue my-sm-queue \
    --filters name=SHARE_IDENTIFIER,values="my-share"
```

위의 명령에서 다음과 같이 변경합니다.
+ *my-sm-queue*를 서비스 작업 대기열의 이름으로 바꿉니다.
+ *my-sm-job*을 서비스 작업의 이름으로 바꿉니다.
+ *my-share*를 필터링하려는 공유 식별자로 바꿉니다.

------