# Managing S3 Batch Operations jobs
<a name="batch-ops-managing-jobs"></a>

Amazon S3 provides a robust set of tools to help you manage your S3 Batch Operations jobs after you create them. This section describes the operations that you can use to manage and track your jobs by using the Amazon S3 console, AWS Command Line Interface (AWS CLI), AWS SDKs, or Amazon S3 REST API.

**Topics**
+ [

## Using the Amazon S3 console to manage your S3 Batch Operations jobs
](#batch-ops-manage-console)
+ [

# Listing jobs
](batch-ops-list-jobs.md)
+ [

# Viewing job details
](batch-ops-job-details.md)
+ [

# Assigning job priority
](batch-ops-job-priority.md)

## Using the Amazon S3 console to manage your S3 Batch Operations jobs
<a name="batch-ops-manage-console"></a>

Using the console, you can manage your S3 Batch Operations jobs. For example, you can:
+ View active and queued jobs
+ Check the status of a job
+ Change a job's priority
+ Confirm and run a job
+ Clone a job
+ Cancel a job

**To manage Batch Operations using the console**

1. Sign in to the AWS Management Console and open the Amazon S3 console at [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. In the left navigation pane, choose **Batch Operations**.

1. Choose the job that you want to manage.

# Listing jobs
<a name="batch-ops-list-jobs"></a>

You can retrieve a list of your S3 Batch Operations jobs. The list provides information about jobs that haven't yet finished, and jobs that finished within the last 90 days. For each job, the list includes details such as job ID, description, priority, current status, and the number of tasks that have succeeded and failed.

You can filter your job list by status. If you retrieve the list by using the console, you can also search your jobs by description or ID and filter them by AWS Region.

## Get a list of `Active` and `Complete` jobs
<a name="batch-ops-example-cli-active-jobs"></a>

The following AWS CLI example gets a list of `Active` and `Complete` jobs. To use this example, replace the *`user input placeholders`* with your own information.

```
aws s3control list-jobs \
    --region us-west-2 \
    --account-id account-id \
    --job-statuses '["Active","Complete"]' \
    --max-results 20
```

For more information and examples, see [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/list-jobs.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/list-jobs.html) in the *AWS CLI Command Reference*.

# Viewing job details
<a name="batch-ops-job-details"></a>

If you want more information about an Amazon S3 Batch Operations job than you can retrieve by listing jobs, you can view all the details for a single job. You can view details for jobs that haven't yet finished, or jobs that finished within the last 90 days. In addition to the information returned in a job list, a single job's details include information such as: 
+ The operation parameters.
+ Details about the manifest.
+ Information about the completion report, if you configured one when you created the job.
+ The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that you assigned to run the job.

By viewing an individual job's details, you can access a job's entire configuration. To view a job’s details, you can use the Amazon S3 console or the AWS Command Line Interface (AWS CLI).

## Get an S3 Batch Operations job description in the Amazon S3 console
<a name="batch-ops-console-job-description"></a>

**To view a Batch Operations job description by using the console**

1. Sign in to the AWS Management Console and open the Amazon S3 console at [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. In the left navigation pane, choose **Batch Operations**.

1. Choose the job ID of the specific job to view its details.

## Get an S3 Batch Operations job description in the AWS CLI
<a name="batch-ops-example-cli-job-description"></a>

The following example gets the description of an S3 Batch Operations job by using the AWS CLI. To use the following example command, replace the *`user input placeholders`* with your own information.

```
aws s3control describe-job \
--region us-west-2 \
--account-id account-id \
--job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c
```

For more information and examples, see [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html) in the *AWS CLI Command Reference*.

# Assigning job priority
<a name="batch-ops-job-priority"></a>

You can assign each Amazon S3 Batch Operations job a numeric priority, which can be any positive integer. S3 Batch Operations prioritizes jobs according to the assigned priority. Jobs with a higher priority (or a higher numeric value for the priority parameter) are evaluated first. Priority is determined in descending order. For example, a job queue with a priority value of 10 is given scheduling preference over a job queue with a priority value of 1. 

You can change a job's priority while the job is running. If you submit a new job with a higher priority while a job is running, the lower-priority job can pause to allow the higher-priority job to run.

Changing a job's priority doesn't affect the job's processing speed.

**Note**  
S3 Batch Operations honors job priorities on a best-effort basis. Although jobs with higher priorities generally take precedence over jobs with lower priorities, Amazon S3 doesn't guarantee strict ordering of jobs.

## Using the S3 console
<a name="batch-ops-example-console-update-job-priority"></a>

**How to update job priority in the Amazon S3 console**

1. Sign in to the AWS Management Console and open the Amazon S3 console at [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. In the left navigation pane, choose **Batch Operations**.

1. Select the specific job that you would like to manage.

1. Choose **Action**. In the dropdown list, choose **Update priority**.

## Using the AWS CLI
<a name="batch-ops-example-cli-update-job-priority"></a>

The following example updates the job priority by using the AWS CLI. A higher number indicates a higher execution priority. To use the following example command, replace the *`user input placeholders`* with your own information.

```
aws s3control update-job-priority \
    --region us-west-2 \
    --account-id account-id \
    --priority 98 \
    --job-id 00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c
```

## Using the AWS SDK for Java
<a name="batch-ops-examples-java-update-job-priority."></a>

To update the priority of an S3 Batch Operations job using the AWS SDK for Java, you can use the S3Control client to modify the job's execution priority, which determines the order in which jobs are processed relative to other jobs in the queue.

For more information about job priority, see [Assigning job priority](#batch-ops-job-priority).

For examples of how to update job priority with the AWS SDK for Java, see [Update the priority of a batch job](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_UpdateJobPriority_section.html) in the *Amazon S3 API Reference*.