ListDevices - Amazon Snowball
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

ListDevices

返回在运行命令的 Amazon Web Services 区域中启用了 Amazon Snow 设备管理的 Amazon Web Services 账户 上所有设备的列表。

请求语法

GET /managed-devices?jobId=jobId&maxResults=maxResults&nextToken=nextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

jobId

用于订购设备的作业 ID。

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

maxResults

每页最大列表设备数量。

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

nextToken

用于继续浏览下一页结果的分页标记。

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

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

请求正文

该请求没有请求体。

响应语法

HTTP/1.1 200 Content-type: application/json { "devices": [ { "associatedWithJob": "string", "managedDeviceArn": "string", "managedDeviceId": "string", "tags": { "string" : "string" } } ], "nextToken": "string" }

响应元素

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

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

devices

包含设备相关信息的设备结构列表。

类型:DeviceSummary 对象数组

nextToken

用于继续浏览下一页设备的分页标记。

类型:字符串

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

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

错误

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

AccessDeniedException

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

HTTP 状态代码:403

InternalServerException

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

HTTP 状态代码:500

ThrottlingException

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

HTTP 状态代码:429

ValidationException

输入未能满足 Amazon 服务指定的约束。

HTTP 状态代码:400

另请参阅

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