AWS IoT
开发人员指南
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

UpdateThingShadow

更新指定事物的影子。

有关更多信息,请参阅《AWS IoT 开发人员指南》中的 UpdateThingShadow

请求语法:

POST /things/thingName/shadow Content-type: application/json { "payload": "blob" }

URI 请求参数:

名称

类型

请求?

描述

thingName

ThingName

事物的名称。

请求正文参数:

名称

类型

请求?

描述

payload

JsonDocument

状态信息,采用 JSON 格式。

响应语法:

Content-type: application/json { "payload": "blob" }

响应正文参数:

名称

类型

请求?

描述

payload

JsonDocument

状态信息,采用 JSON 格式。

错误:

ConflictException

指定的版本与文档的版本不匹配。

HTTP 响应代码:409

RequestEntityTooLargeException

有效负载超出允许的最大值.

HTTP 响应代码:413

InvalidRequestException

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

HTTP 响应代码:400

ThrottlingException

速率超过限制。

HTTP 响应代码:429

UnauthorizedException

您没有权限执行此操作。

HTTP 响应代码:401

ServiceUnavailableException

服务暂时不可用。

HTTP 响应代码:503

InternalFailureException

出现意外错误。

HTTP 响应代码:500

MethodNotAllowedException

不支持指定的 HTTP 动词和 URI 组合。

HTTP 响应代码:405

UnsupportedDocumentEncodingException

不支持的编码。

HTTP 响应代码:415

CLI

摘要:

aws iot-data update-thing-shadow \ --thing-name <value> \ --payload <value> \ [--cli-input-json <value>] \ [--generate-cli-skeleton]

cli-input-json format:

{ "thingName": "string", "payload": "blob" }

cli-input-json 字段:

名称

类型

描述

thingName

字符串

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

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

事物的名称。

payload

blob

状态信息,采用 JSON 格式。

输出:

{ "payload": "blob" }

cli 输出字段:

名称

类型

描述

payload

blob

状态信息,采用 JSON 格式。

本页内容: