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

UpdateThingShadow

更新指定事物的事物影子。

更新仅影响请求状态文档中指定的字段。值为 null 的所有字段均将从事物影子中删除。

请求

该请求包括标准的 HTTP 标头以及以下 URI 和正文:

HTTP POST https://endpoint/things/thingName/shadow BODY: request state document

有关更多信息,请参阅请求状态文档示例

响应

请求成功后,响应将包括标准的 HTTP 标头以及以下代码和正文:

HTTP 200 BODY: response state document

有关更多信息,请参阅响应状态文档示例

授权

要更新事物影子,需要一项允许发起人执行 iot:UpdateThingShadow 操作的策略。Thing Shadows 服务接受两种形式的身份验证:使用 IAM 凭证的签名版本 4 或使用客户端证书的 TLS 双向身份验证。

以下是允许发起人更新事物影子的示例策略:

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": "iot:UpdateThingShadow", "Resource": ["arn:aws:iot:region:account:thing/thing"] }] }