

# 管理 S3 分批操作任务
<a name="batch-ops-managing-jobs"></a>

Amazon S3 提供一组功能强大的工具，帮助您在创建 S3 分批操作任务后管理任务。本节介绍了可以通过 Amazon S3 控制台、AWS Command Line Interface（AWS CLI）、AWS SDK 或 Amazon S3 REST API 来管理和跟踪任务的操作。

**Topics**
+ [使用 Amazon S3 控制台管理 S3 分批操作任务](#batch-ops-manage-console)
+ [列出任务](batch-ops-list-jobs.md)
+ [查看任务详细信息](batch-ops-job-details.md)
+ [分配任务优先级](batch-ops-job-priority.md)

## 使用 Amazon S3 控制台管理 S3 分批操作任务
<a name="batch-ops-manage-console"></a>

使用控制台，您可以管理 S3 分批操作任务。例如，您可以：
+ 查看活动任务和已排队的任务
+ 检查作业的状态
+ 更改工作的优先级
+ 确认并运行任务
+ 克隆任务
+ 取消任务

**要使用控制台管理分批操作**

1. 登录到 AWS 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。

1. 在左侧导航窗格中，选择**批量操作**。

1. 选择要管理的作业。

# 列出任务
<a name="batch-ops-list-jobs"></a>

您可以检索 S3 分批操作任务的列表。此列表提供您尚未完成的作业的相关信息，以及您在过去 90 天内完成的作业的相关信息。对于每个作业，列表提供了其详细信息，例如作业 ID、描述、优先级、当前状态以及成功和失败的任务数。

您可以按状态筛选任务列表。如果您使用控制台检索列表，还可以按描述或 ID 搜索作业并按 AWS 区域对作业进行筛选。

## 获取 `Active` 和 `Complete` 任务的列表
<a name="batch-ops-example-cli-active-jobs"></a>

以下 AWS CLI 示例获取 `Active` 和 `Complete` 任务的列表。要使用此示例，请将 *`user input placeholders`* 替换为您自己的信息。

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

有关更多信息和示例，请参阅 *AWS CLI 命令参考*中的 [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)。

# 查看任务详细信息
<a name="batch-ops-job-details"></a>

如果您需要有关 Amazon S3 批量操作作业的信息比通过列出作业所检索到的信息更多，则可查看单个作业的所有详细信息。您可以查看尚未完成的作业或者过去 90 天内完成的作业的详细信息。除了作业列表中返回的信息之外，单个作业的详细信息还包含其他信息，例如：
+ 操作参数。
+ 有关清单的详细信息。
+ 有关完成报告的信息（如果您在创建作业时配置了完成报告）。
+ 您分配用于运行作业务的 AWS Identity and Access Management（IAM）角色的 Amazon 资源名称（ARN）。

通过查看单个任务的详细信息，可以访问任务的整个配置。要查看任务的详细信息，您可以使用 Amazon S3 控制台或 AWS Command Line Interface（AWS CLI）。

## 在 Amazon S3 控制台中获取 S3 批量操作任务的描述
<a name="batch-ops-console-job-description"></a>

**使用控制台查看批量操作任务的描述**

1. 登录到 AWS 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。

1. 在左侧导航窗格中，选择**批量操作**。

1. 选择特定任务的任务 ID，以查看其详细信息。

## 在 AWS CLI 中获取 S3 批量操作任务的描述
<a name="batch-ops-example-cli-job-description"></a>

以下示例使用 AWS CLI 获取 S3 批量操作任务的描述。要使用以下示例命令，请将 *`user input placeholders`* 替换为您自己的信息。

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

有关更多信息和示例，请参阅 *AWS CLI 命令参考*中的 [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)。

# 分配任务优先级
<a name="batch-ops-job-priority"></a>

可以为每个 Amazon S3 批量操作任务分配一个数字优先级，该优先级可以是任意正整数。S3 批量操作根据分配的优先级确定任务的优先次序。系统将首先评估具有较高优先级（或者优先级参数的数值较高）的任务。优先级按降序确定。例如，优先级值为 10 的任务队列将会比优先级值为 1 的任务队列优先计划。

可以在任务正在运行时更改其优先级。如果您在任务运行时提交优先级更高的新任务，则优先级较低的任务可以暂停，以允许优先级高的任务运行。

更改任务的优先级不会影响任务的处理速度。

**注意**  
S3 批量操作尽最大努力遵循任务优先级。尽管优先级高的任务通常优先于优先级低的任务，但 Amazon S3 无法保证任务的严格顺序。

## 使用 S3 控制台
<a name="batch-ops-example-console-update-job-priority"></a>

**如何在 Amazon S3 控制台中更新任务优先级**

1. 登录到 AWS 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)。

1. 在左侧导航窗格中，请选择**分批操作**。

1. 请选择您想要管理的特定任务。

1. 请选择 **Action**（操作）。请在下拉列表中，选择 **Update priority**（更新优先级）。

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

以下示例使用 AWS CLI 更新任务优先级。数字越大，执行优先级越高。要使用以下示例命令，请将 *`user input placeholders`* 替换为您自己的信息。

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

## 使用 适用于 Java 的 AWS SDK
<a name="batch-ops-examples-java-update-job-priority."></a>

要使用适用于 Java 的 AWS SDK 更新 S3 批量操作任务的优先级，可以使用 S3Control 客户端来修改该任务的执行优先级，该优先级决定了任务相对于队列中其它任务的处理顺序。

有关任务优先级的更多信息，请参阅 [分配任务优先级](#batch-ops-job-priority)。

有关如何使用适用于 Java 的 AWS SDK 更新任务优先级的示例，请参阅《Amazon S3 API Reference》**中的 [Update the priority of a batch job](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_UpdateJobPriority_section.html)。