检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
第九次正式发布。 新增 边缘节点组管理接口。 服务管理接口。 加密数据管理接口。 批量节点管理接口。 批量作业管理接口。 2022-11-02 第八次正式发布。 新增系统订阅管理相关接口。 2021-12-15 第七次正式发布。 新增终端设备模板相关接口。 2021-09-24 第六次正式发布。
功能介绍 该API用于查询边缘节点。 如果不携带任何检索参数，将返回该租户的所有边缘节点信息。 app_name和tags不支持复合查询，如果同时存在则返回tags查询结果，可以同时携带多个其他检索参数，可同时生效。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET https:
当您使用智能边缘平台的API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 更多服务错误码请参见 API错误中心。 表1 错误码说明 错误码 错误信息 描述 处理措施 IEF.011002 The API is not registered. API未注册 确认请
使用前必读 概述 调用说明 终端节点（Endpoint） 约束与限制 基本概念 铂金版实例消息头说明
数据结构 表1 node 参数 参数类型 描述 id String 边缘节点ID name String 边缘节点名称 description String 边缘节点描述 created_at String 创建时间 updated_at String 更新时间 project_id
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content DELETE操作正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。
须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，用户要调用接口来创建IEF实例，那么这个IAM用户被授予的策略中必须包含允许“ief:iefI
力，为企业提供完整的边缘和云协同的一体化服务的边缘计算解决方案。 您可以使用本文档提供API对智能边缘平台进行相关操作，如创建、删除等。支持的全部操作请参见API概览。 在调用智能边缘平台API之前，请确保已经充分了解相关概念，详细信息请参见产品介绍。 父主题： 使用前必读
调用说明 智能边缘平台提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。 父主题： 使用前必读
约束与限制 约束与限制请参见具体API的说明。 父主题： 使用前必读
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和IAM用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块
终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询智能边缘平台的终端节点。 表1 IEF的终端节点 区域名称 区域 终端节点（Endpoint） 华北-北京一 cn-north-1 ief2
铂金版实例消息头说明 在访问铂金版实例的API时，需要在请求消息头中添加名为ief-instance-id的消息头，instanceid取值为铂金版实例ID，如下所示。 1 2 3 POST https://{{ednpoint}}/v2/{project_id}/edgemgr/nodes
容器的环境变量内容，并重新下发容器才能生效。这种方式不灵活，不推荐使用。 如果用户是通过IEF提供的API接口方式获取的终端设备，那么可以在app内通过使用查询终端设备详情的接口获取最新的终端设备内容。请参见查询终端设备详情。 父主题： 边缘节点
SystemEventBus到DIS/APIG服务：您可以将终端设备数据发送到边缘节点SystemEventBus（MQTT broker）的自定义Topic中，IEF会将这些数据转发到DIS通道或APIG后端地址。数据转发到DIS通道或者APIG后端地址后，您可以提取这些数据，并
边缘文件服务：SystemREST到Service Bus，通过调用云端的REST Gateway接口，获取边缘节点上的文件服务。 边缘消息下发服务：SystemREST到SystemEventBus，通过调用云端的REST Gateway接口，向边缘节点中的SystemEventBus（MQTT broker）发送消息。
Docker版本必须高于17.06。使用高于或等于1.23版本的docker时，需设置docker cgroupfs版本为1，不支持docker HTTP API v2。 （请勿使用18.09.0版本Docker，该版本存在严重bug，详见https://github.com/docker/for-
邮寄测试：需要您提前按IEF硬件接入条件准备好测试机器，与IEM接口人联系，邮寄至指定地址，待IEM测试完毕后连同测试报告一起回寄给您。 远程测试：如因机器邮寄不便或其他原因，建议您选择远程测试的方式来进行。将机器准备好后，与IEM接口人进行时间预约，通过桌面连线的方式，与您在预约的时间进行机器测试。
系统订阅流程 系统订阅流程如下： 在APIG创建供IEF调用的API。 在IEF中创建APIG端点。 在IEF中创建系统订阅。 创建API 在APIG中创建API，具体请参见APIG 快速入门。 该API用于给IEF调用，发送系统事件消息。 创建APIG端点 登录IEF管理控制台。 选择左侧导航栏“边云消息
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
