对接IEF管理边缘节点

前提条件

• 已申请IEF服务，具体操作请参见智能边缘平台。
• 已获取AK（Access Key ID）、SK（Secret Access Key），即访问密钥对，具体操作请参见获取AK/SK。

创建IEF连接器

1. 参考登录AstroZero新版应用设计器中操作，进入应用设计器。
2. 在左侧导航栏中，选择“集成”。
3. 单击“连接器”中的“ 连接器实例”，进入连接器实例页面。
4. 在左侧导航栏中，选择“AI > 智能边缘平台”。
5. 在右侧页面单击“+”，设置IEF对接信息。
   图1 创建IEF连接器
   

   表1 创建IEF连接器参数说明

   参数	说明
   名称	新建连接器的名称。命名要求如下： 长度不能超过64个字符，包括前缀命名空间的长度。 须知： 名称前的内容为命名空间，在AstroZero中为了避免不同租户间数据的重名，租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间，创建后不支持修改。 必须以英文字母开头，只能由英文字母、数字或单下划线组成，且不能以下划线结尾。
   区域	IEF服务的区域。
   访问密钥ID	与私有访问密钥关联的唯一标识符，访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。配置为前提条件中“AK”的值。
   访问密钥	私有访问密钥。与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。配置为前提条件中“SK”的值。
   打包当前配置	选中该选项后，应用打包时会将当前配置的连接器信息一并打包。例如，如果应用包发布到运行环境，当前配置默认会被同步到运行环境中。如果不勾选，则内容不会打包发布到运行环境，此时需要您参考管理应用中的连接器中操作，创建对应的连接器。 默认为选中，对信息敏感的场景，建议不勾选。

6. （可选）测试连接器。
   1. 在连接器详情页面，单击“测试”。
   2. 选择接口，设置入参后，单击“测试”。
      图2 配置测试页面
      
      • 选择接口：调用的IEF的接口名。
      • 入参：调用接口的入参，所有接口的入参合集如下：
        • project_id：项目ID。
        • node_id：边缘节点ID。
        • device_id：边缘设备ID。
        • topic：IEF上的消息路由中的“源端点资源”取值，去掉“/”，剩下部分即为该“topic”取值。获取方法如下：
          1. 登录IEF服务控制台。
          2. 在左侧导航栏中，选择“边云消息 > 消息路由”。
          3. 获取所用的消息路由的“源端点资源”取值。
        • 发送的消息(json)：发送的消息的json格式。

      提示如下信息，表示测试成功。

      图3 测试成功
      

在脚本中调用连接器

在脚本中，调用连接器实现调用IEF的接口。

1. 参考创建空白AstroZero脚本中操作，创建一个空白脚本。
2. 在脚本编辑器中，输入如下代码。

   import { Decimal } from 'decimal';
   import { Error } from 'error';
   import * as ief from 'ief';
   
   export class Input {
   
       @action.param({ type: "String", required: true, description: "type" })
       project_id: string;
   
       //   @action.param({ type: "String", required: true, description: "the operation value 2" })
       //  node_id: string;
   }
   
   export class Output {
       @action.param({ type: "Object", required: true })
       result: Object;
   }
   
   export class Calculator {
       @action.method({ input: "Input", output: "Output", description: "do a operation" })
       run(input: Input): Output {
           let output = new Output();
           let cli = ief.newClient("ief_test");
           output.result = cli.getProjectNode(input.project_id);
           //console.log(output.result);
           return output;
       }
   
   }

   其中，ief.newClient("ief_test")中的“ief_test”为连接器的名称。

3. 单击脚本编辑器页面上方的，保存脚本。
4. 保存成功后，单击，运行脚本。
5. 在输入参数页签，输入请求参数的项目ID，单击测试窗口右上角的。

   {
       "project_id":"XXXXXXXXXXX"
   }

   在输出参数页签，显示出边缘节点列表，表示执行事件成功。

6. 单击脚本编辑器页面上方的，启用脚本。

在服务编排中调用连接器

在服务编排中，调用连接器实现与IEF的对接。