地球上的万物和生灵，受到太阳的普照和恩泽，遵循着生长化收藏的自然规律而繁衍生息。在阳光的照耀下，也根据自身独特的轮廓，在大地
上留下了黑暗的区域，人类称之为影子；阿里IOT的设备影子功能主要用于两个方面，设备在线时，作为设备状态信息的缓存；设备离线时，作为设备再次上线时，离线前状态的保存；

关于SHADOW在云端的api一共有两个，主要是查询和更新设备影子常用的两个操作；

本次用来实验和验证的软件链接如下：
http://xysuger.xunyun17.xyz/v0.0.10.rar
读者如果感兴趣的话，可以自行下载运行验证；
。
第一个操作是GetDeviceShadow，这个接口提供了用户可以通过云端，获得当前设备的影子信息。这个命令带有两个参数，分别为产品关键字和设备的名称；发送的详细格式如下：
XYsayFrO.IoT.Srv.GetDeviceShadow.a141rgUXgFl.lamp3_dev.

发送完后，返回结果如下：

这里如果发送成功后，会返回设备的影子信息，详细信息是通过json格式返回的，所以我们可以在里面看到很多大括号；这里的可以看到的是期望的数据和实际发送的数据，以color属性为例，这里实际上报的值为蓝色blue，期望的值为绿色green。版本号在最后显示为3。如果设备第一次使用，是没有设备影子的，这里的值也就为空；

第二个接口为更新设备影子，这个接口可以通过云端向指定产品下的设备发送更新影子的具体消息，发送的命令为UpdateDeviceShadow，这个命令带有三个参数第一个为产品的标识符，第二个发送的设备名称，这前两个参数和上面介绍的接口一样，第三个参数为json格式的影子信息，所以稍微有些复杂，json格式的主要要求就是用大括号把每种类别的信息括起来，然后每一类单独的信息通过分号把类型和值分开，对于设备影子的信息，一般要求有这么四种信息需要上传，第一种信息为上传的方法method，这里是update表示更新；第二种信息为期待的状态desired，这里我们将color属性的期待状态改为蓝色blue,第三种信息为实际上报的状态，这里我们将color属性的实际上报状态改为red红色，第四种为更新的版本号，要求大于当前的版本号，我们通过上面的接口得知，当前的版本号为3，这里配置为4；最后组合起来的完整命令如下：

XYsayFrO.IoT.Srv.UpdateDeviceShadow.a141rgUXgFl.lamp3_dev.{"method":"update","state":{"desired":{"color":"blue"},"reported":{"color":"red"}},"version":4}.
运行后，返回success:true，表示运行成功；接着我们重复运行第一条命令，校验以下我们修改的信息是否生效；

发送完后，返回结果如下：

这里如果发送成功后，会在success字段返回true;
通过察看ShadowMessage的json数据包，可以看到版本已经被改成4了，期望和实际的color值，也和以前的不一样了，而是和我们修改后的一致；

由于阿里iot关于设备影子的接口只有2个，所以关于设备影子在云端接口基本操作的解释就介绍到这里；
随着这篇文章的结束，这个系列的文章也完结了。特此写个顺口溜作为这个系列的结尾：
阿里物联奥妙多，
诸多功能来加持，
产品管理定格局，
设备操作分细节，
分组定义划功能，
主题来把特性显，
规则引擎逻辑强，
消息通信最及时，
设备影子促稳定，
七类接口全学会，
物联世界任我游。

快到年底了，工作也忙起来了，提前预祝各位读者，元旦快乐，新年快乐；明年开春再见；)

(en)