AWS IoT
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

ListThings

列出您的事物。使用 attributeName attributeValue 参数来筛选事物。例如,使用 attributeName=Color 和 attributeValue=Red 调用 ListThings 可检索注册表中包含属性 Color 并且值为 Red 的所有事物。

https

请求语法:

GET /things?maxResults=maxResults&nextToken=nextToken&attributeName=attributeName&attributeValue=attributeValue&thingTypeName=thingTypeName

URI 请求参数:

名称

类型

请求?

描述

nextToken

NextToken

用于检索下一组结果的令牌。

maxResults

RegistryMaxResults

此操作中要返回的最大结果数。

attributeName

AttributeName

用于搜索事物的属性名称。

attributeValue

AttributeValue

用于搜索事物的属性值。

thingTypeName

ThingTypeName

用于搜索事物的事物类型的名称。

响应语法:

Content-type: application/json { "things": [ { "thingName": "string", "thingTypeName": "string", "thingArn": "string", "attributes": { "string": "string" }, "version": "long" } ], "nextToken": "string" }

响应正文参数:

名称

类型

请求?

描述

things

ThingAttributeList

事物。

nextToken

NextToken

用于获取下一组结果的令牌,没有更多结果时为 null

错误:

InvalidRequestException

请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

cli

摘要:

aws iot list-things \ [--next-token <value>] \ [--max-results <value>] \ [--attribute-name <value>] \ [--attribute-value <value>] \ [--thing-type-name <value>] \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "nextToken": "string", "maxResults": "integer", "attributeName": "string", "attributeValue": "string", "thingTypeName": "string" }

cli-input-json 字段:

名称

类型

描述

nextToken

字符串

用于检索下一组结果的令牌。

maxResults

integer

范围 - 最大值:250,最小值:1

此操作中要返回的最大结果数。

attributeName

字符串

最大长度:128

模式:[a-zA-Z0-9_.,@/:#-]+

用于搜索事物的属性名称。

attributeValue

字符串

最大长度:800

模式:[a-zA-Z0-9_.,@/:#-]*

用于搜索事物的属性值。

thingTypeName

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

用于搜索事物的事物类型的名称。

输出:

{ "things": [ { "thingName": "string", "thingTypeName": "string", "thingArn": "string", "attributes": { "string": "string" }, "version": "long" } ], "nextToken": "string" }

cli 输出字段:

名称

类型

描述

things

列表

成员:ThingAttribute

java 类:java.util.List

事物。

thingName

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

事物的名称。

thingTypeName

字符串

最大长度:128,最小长度:1

模式:[a-zA-Z0-9:_-]+

如果事物已经与类型关联,则为事物类型的名称。

thingArn

字符串

事物 ARN。

个属性

map

名称/值对形式的事物属性的列表。

version

long

注册表中事物记录的版本。

nextToken

字符串

用于获取下一组结果的令牌,没有更多结果时为 null

错误:

InvalidRequestException

请求的内容无效。例如,UpdateJobExecution 请求包含无效状态详细信息时,将返回此代码。消息包含有关错误的详细信息。

ThrottlingException

速率超过限制。

UnauthorizedException

您没有权限执行此操作。

ServiceUnavailableException

服务暂时不可用。

InternalFailureException

出现意外错误。