文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# `UpdateJobPriority`与 AWS SDK 或 CLI 配合使用
以下代码示例演示如何使用 `UpdateJobPriority`。
操作示例是大型程序的代码摘录，必须在上下文中运行。在以下代码示例中，您可以查看此操作的上下文：
+ [了解基本功能](s3-control_example_s3-control_Basics_section.md)
------
#### [ CLI ]
**AWS CLI**
**更新 Amazon S3 批量操作任务的任务优先级**
以下 `update-job-priority` 示例会将指定的任务更新为新的优先级。
```
aws s3control update-job-priority \
--account-id 123456789012 \
--job-id 8d9a18fe-c303-4d39-8ccc-860d372da386 \
--priority 52
```
输出：
```
{
"JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386",
"Priority": 52
}
```
+ 有关 API 的详细信息，请参阅*AWS CLI 命令参考[UpdateJobPriority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/update-job-priority.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)中查找完整示例，了解如何进行设置和运行。
```
/**
* Updates the priority of a job asynchronously.
*
* @param jobId the ID of the job to update
* @param accountId the ID of the account associated with the job
* @return a {@link CompletableFuture} that represents the asynchronous operation, which completes when the job priority has been updated or an error has occurred
*/
public CompletableFuture updateJobPriorityAsync(String jobId, String accountId) {
UpdateJobPriorityRequest priorityRequest = UpdateJobPriorityRequest.builder()
.accountId(accountId)
.jobId(jobId)
.priority(60)
.build();
CompletableFuture future = new CompletableFuture<>();
getAsyncClient().updateJobPriority(priorityRequest)
.thenAccept(response -> {
System.out.println("The job priority was updated");
future.complete(null); // Complete the CompletableFuture on successful execution
})
.exceptionally(ex -> {
System.err.println("Failed to update job priority: " + ex.getMessage());
future.completeExceptionally(ex); // Complete the CompletableFuture exceptionally on error
return null; // Return null to handle the exception
});
return future;
}
```
+ 有关 API 的详细信息，请参阅 *AWS SDK for Java 2.x API 参考[UpdateJobPriority](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3control-2018-08-20/UpdateJobPriority)*中的。
------
#### [ 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 update_job_priority(self, job_id: str, account_id: str) -> None:
"""
Update the priority of a batch job and start it.
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']:
self.s3control_client.update_job_priority(
AccountId=account_id,
JobId=job_id,
Priority=60
)
print("The job priority was updated")
try:
self.s3control_client.update_job_status(
AccountId=account_id,
JobId=job_id,
RequestedJobStatus='Ready'
)
print("Job activated successfully")
except ClientError as activation_error:
print(f"Note: Could not activate job automatically: {activation_error}")
print("Job priority was updated successfully. Job may need manual activation in the console.")
elif current_status in ['Active', 'Completing', 'Complete']:
print(f"Job is in '{current_status}' state - priority cannot be updated")
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("Job is currently running.")
else:
print(f"Job is in '{current_status}' state - priority update not allowed")
except ClientError as e:
print(f"Error updating job priority: {e}")
print("Continuing with the scenario...")
return
```
+ 有关 API 的详细信息，请参阅适用[UpdateJobPriority](https://docs.aws.amazon.com/goto/boto3/s3control-2018-08-20/UpdateJobPriority)于 *Python 的AWS SDK (Boto3) API 参考*。
------