Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Use UpdateJobStatus
with an Amazon SDK or CLI
The following code examples show how to use UpdateJobStatus
.
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:
- CLI
-
- Amazon CLI
-
To update the status of an Amazon S3 batch operations job
The following update-job-status
example cancels the specified job which is awaiting approval.
aws s3control update-job-status \
--account-id 123456789012
\
--job-id 8d9a18fe-c303-4d39-8ccc-860d372da386
\
--requested-job-status Cancelled
Output:
{
"Status": "Cancelled",
"JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386"
}
The following update-job-status
example confirms and runs the specified which is awaiting approval.
aws s3control update-job-status \
--account-id 123456789012
\
--job-id 5782949f-3301-4fb3-be34-8d5bab54dbca
\
--requested-job-status Ready
Output::
{
"Status": "Ready",
"JobId": "5782949f-3301-4fb3-be34-8d5bab54dbca"
}
The following update-job-status
example cancels the specified job which is running.
aws s3control update-job-status \
--account-id 123456789012 \
--job-id 5782949f-3301-4fb3-be34-8d5bab54dbca \
--requested-job-status Cancelled
Output::
{
"Status": "Cancelling",
"JobId": "5782949f-3301-4fb3-be34-8d5bab54dbca"
}
- Java
-
- SDK for Java 2.x
-
/**
* Cancels a job asynchronously.
*
* @param jobId The ID of the job to be canceled.
* @param accountId The ID of the account associated with the job.
* @return A {@link CompletableFuture} that completes when the job status has been updated to "CANCELLED".
* If an error occurs during the update, the returned future will complete exceptionally.
*/
public CompletableFuture<Void> cancelJobAsync(String jobId, String accountId) {
UpdateJobStatusRequest updateJobStatusRequest = UpdateJobStatusRequest.builder()
.accountId(accountId)
.jobId(jobId)
.requestedJobStatus(String.valueOf(JobStatus.CANCELLED))
.build();
return asyncClient.updateJobStatus(updateJobStatusRequest)
.thenAccept(updateJobStatusResponse -> {
System.out.println("Job status updated to: " + updateJobStatusResponse.status());
})
.exceptionally(ex -> {
System.err.println("Failed to cancel job: " + ex.getMessage());
throw new RuntimeException(ex); // Propagate the exception
});
}
For a complete list of Amazon SDK developer guides and code examples, see
Developing with Amazon S3 using the Amazon SDKs.
This topic also includes information about getting started and details about previous SDK versions.