设备管理-华为云

设备接入 IOTDA-设备代理:功能介绍

功能介绍物联网平台将设备拓扑与数据转发能力解耦，对于数据转发能力支持通过一种设备代理策略来进行描述。即在台注册设备时已经固定拓扑关系，但是可以通过其他网关进行数据转发。这种设备代理策略需要在平台进行定义，和管理。代理授权主要分为两个部分：时间维度：可为代理设备的转发权限设定一定的时限，一旦过期该设备便不再具备代理能力。空间维度：只有加入该设备代理的设备才能转发彼此的数据（设备代理内的网关可共同转发子设备数据）。在同一时刻，子设备只能存在一个确定的网关，且只能通过这个网关进行数据转发，因此在对子设备进行数据转发前需要提前确定代理关系。子设备代理网关的切换必须通过网关上报子设备状态来实现，当上报子设备状态为在线时，平台会根据用户在平台定义好的代理策略进行校验，校验通过后平台就会在该子设备与当前网关之间建立代理关系，之后才会允许通过该代理网关进行数据转发。当上报子设备状态为离线后，会清除代理关系，禁止通过该网关进行数据转发。

设备接入 IOTDA 设备管理

华为乾坤-查询设备管理认证信息:响应示例

响应示例返回状态码为200：查询成功，返回配置信息。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "data" : { "authType" : "default", "profileId" : "aeb684c8-0d37-496f-bafa-4b06d5151e2e", "cmdEnable" : true, "authProtocol" : "", "authenticationEnable" : false, "authorizationEnable" : false, "accountingEnable" : false } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤设备管理认证配置

华为乾坤-查询设备管理认证信息:URI

URI /controller/campus/v1/networkservice/networkconfig/net/devicemgrauth/sites/{siteId}/devicemgrauth 表1 path参数列表参数名称必选类型参数值域默认值参数说明参数示例 siteId 是 string - - 站点ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

华为乾坤设备管理认证配置

华为乾坤-查询设备管理认证信息:请求示例

请求示例 HTTP的示例 GET /controller/campus/v1/networkservice/networkconfig/net/devicemgrauth/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/devicemgrauth HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy

华为乾坤设备管理认证配置

华为乾坤-查询设备管理认证信息:响应参数

响应参数返回状态码为200：查询成功，返回配置信息。表2 GetDeviceMgrAuthConfigResponse对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 DeviceMgrAuthServerInfo对象的参数列表参数名称类型参数值域默认值参数说明参数示例 authType string default tacacs radius - 设备管理认证方式。取值范围：default---默认、tacacs---HWTACA CS 认证、radius---RADIUS认证。 "default" profileId string 36个字符。 - 设备管理认证服务器模板ID。字符串为UUID格式。当authType为tacacs或radius时，profileId必填。 "aeb684c8-0d37-496f-bafa-4b06d5151e2e" cmdEnable boolean true false false 命令行授权，当authType为tacacs时，cmdEnable必填。默认值为false。 true authProtocol string PAP CHAP PAP 认证协议，当authType为radius时，authProtocol必填。默认值为PAP。 - authenticationEnable boolean true false false 认证逃生使能。当authType为tacacs或radius时，authenticationEnable必填。默认值为false。 false authorizationEnable boolean true false false 授权逃生使能。当authType为tacacs时，authorizationEnable必填。默认值为false。 false accountingEnable boolean true false false 计费逃生使能。当authType为tacacs或radius时，accountingEnable必填。默认值为false。 false 返回状态码为400：校验异常。详细信息请参见实际响应消息体。

华为乾坤设备管理认证配置

华为乾坤-修改当前租户的CPE接入非法控制器防范功能开关:请求示例

请求示例 HTTP的示例 PUT /controller/campus/v1/systemparameter/securityconfig/verify-controller HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "controllerValidate" : "true" }

华为乾坤设备管理安全控制

华为乾坤-修改当前租户的CPE接入非法控制器防范功能开关:响应参数

响应参数返回状态码为200：修改CPE接入非法控制器防范功能开关成功，响应体参考ControllerValidateModifyOutput。表3 ControllerValidateModifyOutput对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~2048个字符。 - 错误信息。 "OK" controllerValidate string 4~5个字符。 - 校验开关状态，该字段为“true”时，开关已开启，该字段为“false”时，开关未开启。 "true" 返回状态码为500：接口调用内部错误，无响应体。详细信息请参见实际响应消息体。

华为乾坤设备管理安全控制

华为乾坤-修改当前租户的CPE接入非法控制器防范功能开关:响应示例

响应示例返回状态码为200：修改CPE接入非法控制器防范功能开关成功，响应体参考ControllerValidateModifyOutput。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "OK", "controllerValidate" : "true" } 返回状态码为500：接口调用内部错误，无响应体。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤设备管理安全控制

华为乾坤-修改当前租户的CPE接入非法控制器防范功能开关:请求参数

请求参数表1 body参数列表参数名称必选类型参数值域默认值参数说明参数示例 controllerValidateModifyInput 是 REFERENCE 详细请参见表2。修改CPE接入非法控制器防范功能开关请求体。 - 表2 ControllerValidateModifyInput对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 controllerValidate 否 string 4~5个字符。 - 校验开关状态，该字段为“true”时，开关已开启，该字段为“false”时，开关未开启。 "true"

华为乾坤设备管理安全控制

华为乾坤-更新子设备:响应示例

响应示例返回状态码为200：更新成功返回。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "totalRecords" : 100, "data" : [ { "parentId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "tenant1", "isExclusiveResource" : false, "vpnNumber" : 100, "bandWidth" : 100, "siteNumber" : 100, "sdwanBandwidth" : 100, "encryptedSdwanBandwidth" : 100, "vxlanBandwidth" : 100, "status" : 0, "role" : "Interworking Gateway", "siteId" : "00000000-0000-0000-0000-000000000000", "siteName" : "site1" } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤子设备管理

华为乾坤-更新子设备:请求示例

请求示例 HTTP的示例 PUT /controller/sdwan/v1/naas/virtual/device HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "deviceInfos" : [ { "parentId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "deviceName" : "tenant1", "isExclusiveResource" : false, "vpnNumber" : 100, "bandWidth" : 100, "siteNumber" : 100, "sdwanBandwidth" : 100, "encryptedSdwanBandwidth" : 100, "vxlanBandwidth" : 100, "status" : 0, "role" : "Interworking Gateway", "siteId" : "00000000-0000-0000-0000-000000000000", "siteName" : "site1" } ] }

华为乾坤子设备管理

华为乾坤-查询设备校验控制器证书实体字段开关状态:响应示例

响应示例返回状态码为200：查询证书校验安全开关信息成功，响应体参考ControllerValidateQueryOutput。 HTTP/1.1 200 OK Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "OK", "controllerValidate" : "true" } 返回状态码为500：接口调用内部错误，无响应体。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

华为乾坤设备管理安全控制

华为乾坤-查询设备校验控制器证书实体字段开关状态:响应参数

响应参数返回状态码为200：查询证书校验安全开关信息成功，响应体参考ControllerValidateQueryOutput。表1 ControllerValidateQueryOutput对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~2048个字符。 - 错误信息。 "OK" controllerValidate string 4~5个字符。 - 校验开关状态，该字段为“true”时，开关已开启，该字段为“false”时，开关未开启。 "true" 返回状态码为500：接口调用内部错误，无响应体。详细信息请参见实际响应消息体。

华为乾坤设备管理安全控制

华为乾坤-查询设备校验控制器证书实体字段开关状态:请求示例

请求示例 HTTP的示例 GET /controller/campus/v1/systemparameter/securityconfig/verify-controller HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy

华为乾坤设备管理安全控制

华为乾坤-修改设备管理认证信息:请求参数

请求参数表2 body参数列表参数名称必选类型参数值域默认值参数说明参数示例 body 是 REFERENCE 详细请参见表3。配置参数。 - 表3 DeviceMgrAuthServerInfo对象的参数列表参数名称必选类型参数值域默认值参数说明参数示例 authType 是 string default tacacs radius - 设备管理认证方式。取值范围：default---默认、tacacs---HWTACACS认证、radius---RADIUS认证。 "default" profileId 否 string 36个字符。 - 设备管理认证服务器模板ID。字符串为UUID格式。当authType为tacacs或radius时，profileId必填。 "aeb684c8-0d37-496f-bafa-4b06d5151e2e" cmdEnable 否 boolean true false false 命令行授权，当authType为tacacs时，cmdEnable必填。默认值为false。 true authProtocol 否 string PAP CHAP PAP 认证协议，当authType为radius时，authProtocol必填。默认值为PAP。 - authenticationEnable 否 boolean true false false 认证逃生使能。当authType为tacacs或radius时，authenticationEnable必填。默认值为false。 false authorizationEnable 否 boolean true false false 授权逃生使能。当authType为tacacs时，authorizationEnable必填。默认值为false。 false accountingEnable 否 boolean true false false 计费逃生使能。当authType为tacacs或radius时，accountingEnable必填。默认值为false。 false

华为乾坤设备管理认证配置

云服务器内容精选

设备管理

7*24

备案

专业服务

退订

建议反馈

售前咨询热线