# 将 `UpdateJobStatus` 与 AWS SDK 或 CLI 配合使用
以下代码示例演示如何使用 `UpdateJobStatus`。
操作示例是大型程序的代码摘录，必须在上下文中运行。在以下代码示例中，您可以查看此操作的上下文：
+ [了解基本功能](s3-control_example_s3-control_Basics_section.md)
------
#### [ CLI ]
**AWS CLI**
**更新 Amazon S3 批量操作任务的状态**
以下 `update-job-status` 示例取消正在等待批准的指定任务。
```
aws s3control update-job-status \
--account-id {{123456789012}} \
--job-id {{8d9a18fe-c303-4d39-8ccc-860d372da386}} \
--requested-job-status {{Cancelled}}
```
输出：
```
{
"Status": "Cancelled",
"JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386"
}
```
以下 `update-job-status` 示例确认并运行正在等待批准的指定任务。
```
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"}}
{{}}}
```
以下 `update-job-status` 示例取消正在运行的指定任务。
```
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"
}
```
+ 有关 API 详细信息，请参阅《AWS CLI 命令参考》**中的 [UpdateJobStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/update-job-status.html)。
------
#### [ Java ]
**适用于 Java 的 SDK 2.x**
查看 GitHub，了解更多信息。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/s3/src/main/java/com/example/s3/batch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
/**
* 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 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
});
}
```
+ 有关 API 详细信息，请参阅《AWS SDK for Java 2.x API Reference》**中的 [UpdateJobStatus](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3control-2018-08-20/UpdateJobStatus)。
------
#### [ Python ]
**适用于 Python 的 SDK（Boto3）**
查看 GitHub，了解更多信息。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/s3/scenarios/batch#code-examples)中查找完整示例，了解如何进行设置和运行。
```
def cancel_job(self, job_id: str, account_id: str) -> None:
"""
Cancel an S3 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
)
current_status = response['Job']['Status']
print(f"Current job status: {current_status}")
if current_status in ['Ready', 'Suspended', 'Active']:
self.s3control_client.update_job_status(
AccountId=account_id,
JobId=job_id,
RequestedJobStatus='Cancelled'
)
print(f"Job {job_id} was successfully canceled.")
elif current_status in ['Completing', 'Complete']:
print(f"Job is in '{current_status}' state - cannot be cancelled")
if current_status == 'Completing':
print("Job is finishing up and will complete soon.")
elif current_status == 'Complete':
print("Job has already completed successfully.")
else:
print(f"Job is in '{current_status}' state - cancel not allowed")
except ClientError as e:
print(f"Error canceling job: {e}")
raise
```
+ 有关 API 详细信息，请参阅《AWS SDK for Python (Boto3) API Reference》**中的 [UpdateJobStatus](https://docs.aws.amazon.com/goto/boto3/s3control-2018-08-20/UpdateJobStatus)。
------
#### [ SAP ABAP ]
**适用于 SAP ABAP 的 SDK**
查看 GitHub，了解更多信息。在 [AWS 代码示例存储库](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/s3c#code-examples)中查找完整示例，了解如何进行设置和运行。
```
TRY.
" iv_requested_status = 'Cancelled'
oo_result = lo_s3c->updatejobstatus( " oo_result is returned for testing purposes.
iv_accountid = iv_account_id
iv_jobid = iv_job_id
iv_requestedjobstatus = iv_requested_status
).
MESSAGE |Job { oo_result->get_jobid( ) } status updated to { oo_result->get_status( ) }| TYPE 'I'.
CATCH /aws1/cx_s3cjobstatusexception INTO DATA(lo_ex_js).
MESSAGE lo_ex_js->get_text( ) TYPE 'I'.
RAISE EXCEPTION TYPE /aws1/cx_rt_generic
EXPORTING previous = lo_ex_js.
CATCH /aws1/cx_s3cnotfoundexception INTO DATA(lo_ex_nf).
MESSAGE lo_ex_nf->get_text( ) TYPE 'I'.
RAISE EXCEPTION TYPE /aws1/cx_rt_generic
EXPORTING previous = lo_ex_nf.
CATCH /aws1/cx_s3cclientexc INTO DATA(lo_ex_cli).
MESSAGE lo_ex_cli->get_text( ) TYPE 'I'.
RAISE EXCEPTION TYPE /aws1/cx_rt_generic
EXPORTING previous = lo_ex_cli.
CATCH /aws1/cx_s3cserverexc INTO DATA(lo_ex_srv).
MESSAGE lo_ex_srv->get_text( ) TYPE 'I'.
RAISE EXCEPTION TYPE /aws1/cx_rt_generic
EXPORTING previous = lo_ex_srv.
ENDTRY.
```
+ 有关 API 详细信息，请参阅《AWS SDK for SAP ABAP API Reference》**中的 [UpdateJobStatus](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。
------
有关 AWS SDK 开发人员指南和代码示例的完整列表，请参阅 [使用 AWS SDK 通过 Amazon S3 进行开发](sdk-general-information-section.md)。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。