Tutorial: Search and filter AWS Batch jobs - AWS Batch

Tutorial: Search and filter AWS Batch jobs

Use this procedure to list all the jobs in a job queue in the AWS Batch console. Optionally, use the Filter type dropdown list to narrow the results based on the criteria you specify.

  1. Navigate to the AWS Batch console.

  2. In the Navigation pane, choose Jobs.

  3. Expand the Job queue dropdown list and choose the job queue that you want to search within.

    Note

    You can search for jobs within only one job queue at a time.

  4. (Optional) Choose the filter type you want to apply.

    • Created after: Returns jobs created after a specific date and time (in UTC). If you select this option, two filter value fields appear where you can specify the earliest date and time that the search will return.

    • Created before: Returns jobs created before a specific date and time (in UTC). If you select this option, two filter value fields appear where you can specify the latest date and time that the search will return.

    • Job definition: Returns jobs created with a specific job definition name. If you select this option, a field appears where you can specify a job’s complete or partial definition (if you add an asterisk (*) at the end, the filter matches any job definition that begins with the string before the asterisk).

    • Job name: Returns jobs that have a specific job name. If you select this option, a field appears where you can specify a job’s complete or partial name (if you add an asterisk (*) at the end, the filter matches any job name that begins with the string before the asterisk).

    • Status: Returns jobs that have the selected job status. If you select this option, a dropdown list appears for you to expand and select a specific status. For more information, see Job states.

  5. (Optional) Choose Load all jobs to return all jobs within a job queue in the last seven days and without the previous filters. If you choose this option, the following message appears:

    Note

    AWS Batch now stores seven (7) days of job history. Choosing to load all jobs will increase the time it takes to access your jobs and start searching and filtering. Using a filter type instead will provide more immediate results. Are you sure you want to load all jobs.

    A Choose Confirm to close the message.

    • If you choose this option, a dropdown list appears where you can choose similar filter options: Status, Job name, and Job ID. If you choose one of these options, you can further filter your search criteria where the specified filter is equal to, is not equal to, contains, or does not contain the criteria you enter.

  6. When the options are complete, choose Search.