ListExecutions - AWS Snowball

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

ListExecutions

返回一台或多台目标设备的任务状态。

请求语法

GET /executions?maxResults=maxResults&nextToken=nextToken&state=state&taskId=taskId HTTP/1.1

URI请求参数

该请求使用以下URI参数。

maxResults

每页最大列表任务数量。

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

nextToken

用于继续浏览下一页任务的分页标记。

长度限制:长度下限为 1。长度上限为 1024。

模式:^[a-zA-Z0-9+/=]*$

state

一种用于按任务当前状态筛选任务的结构。

有效值:QUEUED | IN_PROGRESS | CANCELED | FAILED | SUCCEEDED | REJECTED | TIMED_OUT

taskId

任务的 ID。

长度限制:长度下限为 1。长度上限为 64。

必需:是

请求体

该请求没有请求正文。

响应语法

HTTP/1.1 200 Content-type: application/json { "executions": [ { "executionId": "string", "managedDeviceId": "string", "state": "string", "taskId": "string" } ], "nextToken": "string" }

响应元素

如果操作成功,服务将发回 HTTP 200 响应。

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

executions

执行列表。每个执行记录都包含任务 ID、执行任务的设备、执行 ID 和执行状态。

类型:ExecutionSummary 对象数组

nextToken

继续浏览下一个执行页面的分页标记。

类型:字符串

长度限制:长度下限为 1。长度上限为 1024。

模式:^[a-zA-Z0-9+/=]*$

错误

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

AccessDeniedException

您没有足够的访问权限,无法执行该操作。

HTTP状态码:403

InternalServerException

处理请求时出现意外错误。

HTTP状态码:500

ResourceNotFoundException

该请求引用的资源不存在。

HTTP状态码:404

ThrottlingException

由于请求限制而导致请求被拒绝。

HTTP状态码:429

ValidationException

输入无法满足 AWS 服务指定的约束。

HTTP状态码:400

另请参阅

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