“华为云：基于API Explorer调试IoT应用侧API”的版本间的差异

2023年5月2日 (二) 14:32的版本

实验目标与基本要求

通过本实验，您将能够掌握物联网平台应用侧API的调用方法及请求参数使用规范要求。

实验摘要

1. 登录华为云

2. 开通设备接入服务

3. 创建产品

4. 注册设备

5. 设备上报数据

6. 查询设备影子数据

7. 资源释放

实验步骤

登录华为云

进入【实验操作桌面】，打开Chrome浏览器，首次可自动登录并进入华为云控制台页面。

如后续关闭浏览器重新登录或自动登录失败，可按如此步骤登录：选择【IAM用户登录】模式，于登录对话框中输入系统为您分配的华为云实验账号和密码登录华为云，如下图所示：

注意：账号信息详见实验手册上方，切勿使用您自己的华为云账号登录。

开通设备接入服务

创建产品

1.为了方便后续多窗口同步操作，请新建浏览器标签页，访问API Explorer首页，链接：https://apiexplorer.developer.huaweicloud.com/apiexplorer/overview，搜索“iotda”打开“设备接入”产品

产品是什么？

在物联网平台中，某一类具有相同能力或特征的设备的合集被称为一款产品。您可为产品定义产品模型，产品模型用于描述设备具备的能力和特性。定义产品模型，即在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息。

2. 选择“产品管理 > CreateProduct”，填写相关参数，创建名称为“MQTT_Smoke”的产品。

Tips：为了方便填写参数，可以勾选“只看必填项”，或将body切换为文本输入。

请求体示例如下：

其中，服务ID为sensor，两个属性alarm、smokeValue为整型值。

{
 "name": "MQTT_Smoke",
 "device_type": "MQTT_Smoke",
 "protocol_type": "MQTT",
 "data_format": "json",
 "service_capabilities": [
  {
   "service_id": "sensor",
   "service_type": "sensor",
   "properties": [
    {
     "property_name": "alarm",
     "data_type": "int",
     "method": "RW"
    },
    {
     "property_name": "smokeValue",
     "data_type": "int",
     "method": "RW"
    }
   ]
  }
 ]
}

参数填写完成，单击“调试”发起请求。

此时可在调试结果右侧看到示例代码及SDK的添加方法。

3. 请求成功，浏览器切换到控制台标签页，选择“服务列表”->“IoT物联网”->“设备接入IoTDA”，进入设备接入服务控制台，在左侧菜单栏选择“产品”，查看已创建的产品。

Tips：如果请求失败，请根据错误码排查修改请求参数后重试

4. 请记录产品ID，用于后续注册设备时使用。6450e15a4f1d680324501d2b

注册设备

1. 浏览器切换到API Explorer标签页，选择“设备管理 > AddDevice”，填写相关参数，创建一个设备。

Tips：为了方便填写参数，可以勾选“只看必填项”，或将body切换为文本输入。

请求体示例如下：

其中，“product_id”从创建产品成功返回的响应结果中获取，“node_id”为设备标识码，可以自定义填写一串字符串。

{
  "node_id": "abc12345678",
  "product_id": "6450e15a4f1d680324501d2b"
}

参数填写完成，单击“调试”发起请求。

3. 请求成功，浏览器切换到控制台标签页，进入设备接入服务控制台，在左侧菜单栏选择“设备 > 所有设备”，查看已注册成功的设备。

Tips：如果请求失败，请根据错误码排查修改请求参数后重试。

设备为“未激活”状态，如下图所示：

4. 请记录设备ID(device_id)和设备密钥(secret)，用于后续设备上报数据配置连接参数时使用。

{
 "app_id": "a9817d4ea29f4a499635f0a4269bb84e",
 "app_name": "DefaultApp_63d0wee0",
 "device_id": "6450e15a4f1d680324501d2b_abc12345678",
 "node_id": "abc12345678",
 "gateway_id": "6450e15a4f1d680324501d2b_abc12345678",
 "device_name": null,
 "node_type": "GATEWAY",
 "description": null,
 "fw_version": null,
 "sw_version": null,
 "device_sdk_version": null,
 "auth_info": {
  "auth_type": "SECRET",
  "secret": "52a6bf10bb5b93ffee841ca380918a2b",
  "fingerprint": null,
  "secure_access": false,
  "timeout": 0
 },
 "product_id": "6450e15a4f1d680324501d2b",
 "product_name": "MQTT_Smoke",
 "status": "INACTIVE",
 "create_time": "20230502T142651Z",
 "connection_status_update_time": null,
 "active_time": null,
 "tags": [],
 "extension_info": null
}