翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ジョブキュー内のジョブ 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. **[検索オプション]** の場合:

   1. **[ステータス]** ドロップダウンリストでは、フィルタリングするステータスを 1 つ以上選択できます。詳細については、「[ジョブの状態](job_states.md)」および「[サービスジョブのステータス](service-job-status.md)」を参照してください。
**注記**  
配列ジョブの親は、子ジョブが に更新`PENDING`されると に更新`RUNNABLE`され、子ジョブの実行中に `PENDING`ステータスのままになります。これらのジョブを表示するには、すべての子ジョブが終了状態になるまで`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* をフィルタリングする共有識別子に置き換えます。

------