Node.js SDK使用指南
物联网平台提供Node.js语言的应用侧SDK供开发者使用。本文介绍Node.js SDK的安装和配置,及使用Node.js SDK调用应用侧API的示例。
![](https://support.huaweicloud.com/sdkreference-iothub/public_sys-resources/note_3.0-zh-cn.png)
当前SDK AK/SK的方式只支持基础版,不支持标准版和企业版,标准版和企业版建议使用token方式接入。
SDK获取和安装
- 安装Node.js开发环境。
访问Node.js官网,下载并按说明安装Node.js开发环境。
华为云 Node.js SDK 支持 Node 10.16.1 及以上版本。
- 安装依赖
npm install @huaweicloud/huaweicloud-sdk-core npm install @huaweicloud/huaweicloud-sdk-iotda
代码示例
以调用查询设备列表接口为例,以下代码示例向您展示使用Node.js SDK的主要步骤:
- 创建认证。
- 创建IoTDAClient实例并初始化。
- 实例化请求对象。
- 调用查询设备列表接口。
const core = require('@huaweicloud/huaweicloud-sdk-core'); const iotda = require("@huaweicloud/huaweicloud-sdk-iotda"); // 认证用的ak和sk直接写到代码中有很大的安全风险,建议在配置文件或者环境变量中密文存放,使用时解密,确保安全; // 本示例以ak和sk保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 const ak = process.env.HUAWEICLOUD_SDK_AK; const sk = process.env.HUAWEICLOUD_SDK_SK; // endpoint:请在控制台的"总览"界面的"平台接入地址"中查看“应用侧”的https接入地址。 // const endpoint = "https://iotda.cn-north-4.myhuaweicloud.com"; const endpoint = "<YOUR ENDPOINT>"; const project_id = "<YOUR PROJECT_ID>"; // region_id: 如果是上海一,请填写"cn-east-3";如果是北京四,请填写"cn-north-4";如果是华南广州,请填写"cn-south-1" const region_id = "<YOUR REGION_ID>"; // 配置跳过服务端证书验证(可选) process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0" // 创建认证 const credentials = new core.BasicCredentials() .withAk(ak) .withSk(sk) // 标准版/企业版需要使用衍生算法,基础版请删除配置"withDerivedPredicate" .withDerivedPredicate(core.BasicCredentials.getDefaultDerivedPredicate) .withProjectId(project_id) // 创建IoTDAClient实例并初始化 const client = iotda.IoTDAClient.newBuilder() .withCredential(credentials) .withEndpoint(endpoint) .withRegion(new core.Region(region_id, endpoint)) .build(); // 实例化请求对象 const request = new iotda.ListDevicesRequest(); // 调用查询设备列表接口 const result = client.listDevices(request); result.then(result => { console.log("JSON.stringify(result)::" + JSON.stringify(result)); }).catch(ex => { console.log("exception:" + JSON.stringify(ex)); });
参数
说明
ak
您的华为云账号访问密钥ID(Access Key ID)。请在华为云控制台访问密钥。
页面上创建和查看您的 AK/SK。更多信息请查看sk
您的华为云账号秘密访问密钥(Secret Access Key)。
endpoint
请替换为您要访问的华为云服务所在区域的终端节点。
您可以在控制台上查看当前服务所在区域名称,区域名称、区域和终端节点的对应关系,具体步骤请参考地区和终端节点。
project_id
您要访问的华为云服务所在项目 ID ,根据您想操作的项目所属区域选择对应的项目 ID
region_id
如果是上海一,请填写"cn-east-3";如果是北京四,请填写"cn-north-4";如果是华南广州,请填写"cn-south-4"
更多
项目源码及更多详细的使用指导请参考华为云开发者 Node.js 软件开发工具包(Node.js SDK)。
推荐您使用API在线调试工具API Explorer ,API Explorer 支持快速调试和检索,调试API的同时,可以根据您的参数实时生成各种开发语言的SDK示例代码,方便您直接根据示例代码使用SDK。