ListJobs - AWS Snowball

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

ListJobs

返回指定长度的 JobListEntry 对象的数组。每个 JobListEntry 对象都包含一个作业的状态、一个作业的 ID 以及一个指示该作业是否属于作业部分的值(如果是导出作业)。在美国某个地区调用此 API 操作将从所有美国地区与该账户关联的所有作业列表中返回作业。

请求语法

{ "MaxResults": number, "NextToken": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

请求接受采用 JSON 格式的以下数据。

MaxResults

要返回的 JobListEntry 对象数量。

类型:整数

有效范围:最小值为 0。最大值为 100。

必需:否

NextToken

HTTP 请求是无状态请求。要确定哪个对象出现在 JobListEntry 对象列表中的“下一个”,您可以选择指定 NextToken 作为返回列表的起点。

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

模式:.*

必需:否

响应语法

{ "JobListEntries": [ { "CreationDate": number, "Description": "string", "IsMaster": boolean, "JobId": "string", "JobState": "string", "JobType": "string", "SnowballType": "string" } ], "NextToken": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

JobListEntries

每个 JobListEntry 对象都包含一个作业的状态、一个作业的 ID 以及一个指示该作业是否属于作业部分的值(如果是导出作业)。

类型:JobListEntry 对象数组

NextToken

HTTP 请求是无状态请求。如果您在下次调用 NextToken 时使用这个自动生成的 ListJobs 值,则返回的 JobListEntry 对象将从数组中的这一点开始。

类型:字符串

长度限制:最小长度为 1。长度上限为 1024。

模式:.*

错误

有关所有操作返回的常见错误的信息,请参阅 常见错误

InvalidNextTokenException

NextToken 字符串被意外更改,操作已停止。在不更改 NextToken 字符串的情况下运行操作,然后重试。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息,请参阅以下内容: