# Use `DescribeJob` with an AWS SDK or CLI
The following code examples show how to use `DescribeJob`.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code example:
+ [Learn the basics](s3-control_example_s3-control_Basics_section.md)
------
#### [ CLI ]
**AWS CLI**
**To describe an Amazon S3 batch operations job**
The following `describe-job` provides configuration parameters and status for the specified batch operations job.
```
aws s3control describe-job \
--account-id 123456789012 \
--job-id 93735294-df46-44d5-8638-6356f335324e
```
Output:
```
{
"Job": {
"TerminationDate": "2019-10-03T21:49:53.944Z",
"JobId": "93735294-df46-44d5-8638-6356f335324e",
"FailureReasons": [],
"Manifest": {
"Spec": {
"Fields": [
"Bucket",
"Key"
],
"Format": "S3BatchOperations_CSV_20180820"
},
"Location": {
"ETag": "69f52a4e9f797e987155d9c8f5880897",
"ObjectArn": "arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv"
}
},
"Operation": {
"S3PutObjectTagging": {
"TagSet": [
{
"Value": "true",
"Key": "confidential"
}
]
}
},
"RoleArn": "arn:aws:iam::123456789012:role/S3BatchJobRole",
"ProgressSummary": {
"TotalNumberOfTasks": 8,
"NumberOfTasksFailed": 0,
"NumberOfTasksSucceeded": 8
},
"Priority": 42,
"Report": {
"ReportScope": "AllTasks",
"Format": "Report_CSV_20180820",
"Enabled": true,
"Prefix": "batch-op-create-job",
"Bucket": "arn:aws:s3:::employee-records-logs"
},
"JobArn": "arn:aws:s3:us-west-2:123456789012:job/93735294-df46-44d5-8638-6356f335324e",
"CreationTime": "2019-10-03T21:48:48.048Z",
"Status": "Complete"
}
}
```
+ For API details, see [DescribeJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/describe-job.html) in *AWS CLI Command Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/s3/src/main/java/com/example/s3/batch#code-examples).
```
/**
* Asynchronously describes the specified job.
*
* @param jobId the ID of the job to describe
* @param accountId the ID of the AWS account associated with the job
* @return a {@link CompletableFuture} that completes when the job description is available
* @throws RuntimeException if an error occurs while describing the job
*/
public CompletableFuture describeJobAsync(String jobId, String accountId) {
DescribeJobRequest jobRequest = DescribeJobRequest.builder()
.jobId(jobId)
.accountId(accountId)
.build();
return getAsyncClient().describeJob(jobRequest)
.thenAccept(response -> {
System.out.println("Job ID: " + response.job().jobId());
System.out.println("Description: " + response.job().description());
System.out.println("Status: " + response.job().statusAsString());
System.out.println("Role ARN: " + response.job().roleArn());
System.out.println("Priority: " + response.job().priority());
System.out.println("Progress Summary: " + response.job().progressSummary());
// Print out details about the job manifest.
JobManifest manifest = response.job().manifest();
System.out.println("Manifest Location: " + manifest.location().objectArn());
System.out.println("Manifest ETag: " + manifest.location().eTag());
// Print out details about the job operation.
JobOperation operation = response.job().operation();
if (operation.s3PutObjectTagging() != null) {
System.out.println("Operation: S3 Put Object Tagging");
System.out.println("Tag Set: " + operation.s3PutObjectTagging().tagSet());
}
// Print out details about the job report.
JobReport report = response.job().report();
System.out.println("Report Bucket: " + report.bucket());
System.out.println("Report Prefix: " + report.prefix());
System.out.println("Report Format: " + report.format());
System.out.println("Report Enabled: " + report.enabled());
System.out.println("Report Scope: " + report.reportScopeAsString());
})
.exceptionally(ex -> {
System.err.println("Failed to describe job: " + ex.getMessage());
throw new RuntimeException(ex);
});
}
```
+ For API details, see [DescribeJob](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3control-2018-08-20/DescribeJob) in *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK for Python (Boto3)**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/s3/scenarios/batch#code-examples).
```
def describe_job_details(self, job_id: str, account_id: str) -> None:
"""
Describe detailed information about a batch job.
Args:
job_id (str): ID of the batch job
account_id (str): AWS account ID
"""
try:
response = self.s3control_client.describe_job(
AccountId=account_id,
JobId=job_id
)
job = response['Job']
print(f"Job ID: {job['JobId']}")
print(f"Description: {job.get('Description', 'N/A')}")
print(f"Status: {job['Status']}")
print(f"Role ARN: {job['RoleArn']}")
print(f"Priority: {job['Priority']}")
if 'ProgressSummary' in job:
progress = job['ProgressSummary']
print(f"Progress Summary: Total={progress.get('TotalNumberOfTasks', 0)}, "
f"Succeeded={progress.get('NumberOfTasksSucceeded', 0)}, "
f"Failed={progress.get('NumberOfTasksFailed', 0)}")
except ClientError as e:
print(f"Error describing job: {e}")
raise
```
+ For API details, see [DescribeJob](https://docs.aws.amazon.com/goto/boto3/s3control-2018-08-20/DescribeJob) in *AWS SDK for Python (Boto3) API Reference*.
------
For a complete list of AWS SDK developer guides and code examples, see [Developing with Amazon S3 using the AWS SDKs](sdk-general-information-section.md). This topic also includes information about getting started and details about previous SDK versions.