华为云用户手册

请求示例 HTTP的示例 POST /controller/campus/api/v1/organization/path/delete 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 { "orgs" : ["/org1/org2","/org11/org22"], "cascade" : true }

响应示例 返回状态码为200：执行成功，响应体参考ResetDeviceResponse。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "error", "data" : { "successList" : [ { "deviceId" : "7836fa7e-0c5b-470d-bce5-10add71ef9ff", "esn" : "2102350LEC10G3000107" } ], "failList" : [ { "deviceId" : "a62ff0f5-d0b4-4c37-8d63-e12f5d851983", "esn" : "AP5008293511111111AA", "errmsg" : "The device does not exist.", "errcode" : "13107260" } ] } }

响应参数 返回状态码为200：执行成功，响应体参考ResetDeviceResponse。 表3 ResetDeviceResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "error" data REFERENCE 详细请参见表4。 设备恢复出厂设置和恢复开局配置返回结果。 - 表4 ResetDeviceResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 successList ARRAY_REFERENCE 0-10000个列表项，详细请参见表5。 成功恢复出厂设置和恢复开局配置的设备ID列表。 - failList ARRAY_REFERENCE 0-10000个列表项，详细请参见表6。 恢复出厂设置和恢复开局配置失败的设备列表。 - 表5 ResetDeviceSuccessDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId uuid 36个字符。 - 设备ID。 "7836fa7e-0c5b-470d-bce5-10add71ef9ff" esn string 0~256个字符。 - 设备ESN号。 "2102350LEC10G3000107" 表6 ResetDeviceFailedDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 36个字符。 - 设备ID。 "a62ff0f5-d0b4-4c37-8d63-e12f5d851983" esn string 0~256个字符。 - 设备ESN号。 "AP5008293511111111AA" errmsg string - - 设备恢复出厂设置和恢复开局配置失败错误信息。 "The device does not exist." errcode string - - 设备恢复出厂设置和恢复开局配置失败错误码。 "13107260"

请求示例 HTTP的示例 POST /controller/campus/v1/oamservice/reset/device-configurations 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 { "deviceIds" : ["7836fa7e-0c5b-470d-bce5-10add71ef9ff","a62ff0f5-d0b4-4c37-8d63-e12f5d851983"] }

响应示例 返回状态码为201：接口调用成功，响应体参考LoopbackResponse。 HTTP/1.1 201 Created Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "success" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "wanLinkId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "LoopBack601", "ipAddress" : "10.1.1.1", "prefixLength" : 24, "deviceName" : "device1" } ], "fail" : [ { "errcode" : "1", "errmsg" : "", "data" : { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "wanLinkId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "LoopBack601", "ipAddress" : "10.1.1.1", "prefixLength" : 24, "deviceName" : "device1" } } ] } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 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,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 loopbackInfos 是 REFERENCE 详细请参见表2。 创建Loopback请求数据。 - 表2 LoopbackInfos对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 Loopbacks 是 ARRAY_REFERENCE 1-100个列表项，详细请参见表3。 - - 表3 LoopbackInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 uuid 0~36个字符。 - LoopbackID,主键字段。创建时无需填写，更新和删除时必填,uuid格式。 "00000000-0000-0000-0000-000000000000" vpnId 否 uuid 0~36个字符。 - VPNID，创建时VPNID、WANLINKID二选一必填，不能修改，UUID格式。 "00000000-0000-0000-0000-000000000000" wanLinkId 否 uuid 0~36个字符。 - WANLINKID，创建时VPNID、WANLINKID二选一必填，不能修改，UUID格式。 "00000000-0000-0000-0000-000000000000" siteId 否 uuid 0~36个字符。 - 站点ID,创建时必填，不能修改,uuid格式。 "00000000-0000-0000-0000-000000000000" deviceId 否 uuid 0~36个字符。 - 设备ID。创建时必填，不能修改,uuid格式。 "00000000-0000-0000-0000-000000000000" interfaceName 否 string 0~32个字符。 - interface名称，创建时必填。不能修改,命名规范：loopback开头接数字范围1-99、101-899、 910-1023，大小写敏感。 "LoopBack601" ipAddress 否 string 0~64个字符。 - 接口IP，创建时必填。 "10.1.1.1" prefixLength 否 int32 [1-32] - 掩码，创建时必填。 24 deviceName 否 string 0~256个字符。 - 设备名称。查询时返回。 "device1"

响应参数 返回状态码为201：接口调用成功，响应体参考LoopbackResponse。 表4 LoopbackResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码：0 表示接口执行成功，非0 表示接口执行失败。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 0-100个列表项，详细请参见表5。 成功添加或更新的Loopback。 - fail ARRAY_REFERENCE 0-100个列表项，详细请参见表6。 添加或者更新失败的Loopback。 - 表5 LoopbackInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid 0~36个字符。 - LoopbackID,主键字段。创建时无需填写，更新和删除时必填,uuid格式。 "00000000-0000-0000-0000-000000000000" vpnId uuid 0~36个字符。 - VPNID，创建时VPNID、WANLINKID二选一必填，不能修改，UUID格式。 "00000000-0000-0000-0000-000000000000" wanLinkId uuid 0~36个字符。 - WANLINKID，创建时VPNID、WANLINKID二选一必填，不能修改，UUID格式。 "00000000-0000-0000-0000-000000000000" siteId uuid 0~36个字符。 - 站点ID,创建时必填，不能修改,uuid格式。 "00000000-0000-0000-0000-000000000000" deviceId uuid 0~36个字符。 - 设备ID。创建时必填，不能修改,uuid格式。 "00000000-0000-0000-0000-000000000000" interfaceName string 0~32个字符。 - interface名称，创建时必填。不能修改,命名规范：loopback开头接数字范围1-99、101-899、 910-1023，大小写敏感。 "LoopBack601" ipAddress string 0~64个字符。 - 接口IP，创建时必填。 "10.1.1.1" prefixLength int32 [1-32] - 掩码，创建时必填。 24 deviceName string 0~256个字符。 - 设备名称。查询时返回。 "device1" 表6 FailLoopbackInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码：0 表示接口执行成功，非0 表示接口执行失败。 "1" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表5。 - - 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/net/loopbacks 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 { "Loopbacks" : [ { "id" : "00000000-0000-0000-0000-000000000000", "vpnId" : "00000000-0000-0000-0000-000000000000", "wanLinkId" : "00000000-0000-0000-0000-000000000000", "siteId" : "00000000-0000-0000-0000-000000000000", "deviceId" : "00000000-0000-0000-0000-000000000000", "interfaceName" : "LoopBack601", "ipAddress" : "10.1.1.1", "prefixLength" : 24, "deviceName" : "device1" } ] }

请求示例 HTTP的示例 POST /v1/perfservice/alarms/current-alarms/statistic 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 { "objectIds" : [ "" ], "cleared" : "0" }

响应参数 返回状态码为200：接口调用成功，响应体参考AlarmStatisticOutput。 表3 AlarmStatisticOutput对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~256个字符。 - 错误码。 "null" errmsg string 0~256个字符。 - 错误信息。 "null" data ARRAY_REFERENCE 0-500个列表项，详细请参见表4。 告警统计结果数据 - 表4 AlarmStatisticData对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 objectId string 1~64个字符。 - 统计对象id - criticalAlarmNum string 0~32个字符。 - 紧急告警统计 "10" majorAlarmNum string 0~32个字符。 - 重要告警统计 "15" minorAlarmNum string 0~32个字符。 - 次要告警统计 "30" warningAlarmNum string 0~32个字符。 - 提示告警统计 "40" 返回状态码为400：接口入参非法的状态返回码。 详细信息请参见实际响应消息体。 返回状态码为500：接口发生内部错误后的状态返回码。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：接口调用成功，响应体参考AlarmStatisticOutput。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "null", "errmsg" : "null", "data" : [ { "objectId" : "", "criticalAlarmNum" : "10", "majorAlarmNum" : "15", "minorAlarmNum" : "30", "warningAlarmNum" : "40" } ] } 返回状态码为400：接口入参非法的状态返回码。 HTTP/1.1 400 Bad Request Date: Sun,11 May 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,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应示例 返回状态码为200：查询成功。 HTTP/1.1 200 OK Date: Sun,11 May 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" : { "pageIndex" : 1, "pageSize" : 20, "totalPage" : 10, "totalRecords" : 10, "QueryDeviceInfo" : [ { "deviceName" : "AirEngine6760R-51_FBF792C3", "deviceId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "deviceEsn" : "AA02353VUTFIOJNKGG13", "deviceStatus" : 3, "deviceMeshRole" : "mpp", "meshConfigRole" : "mpp", "meshId" : "fbb684c8-0d37-496f-bafa-4b06d5151e2e", "meshName" : "apmesh" } ] } } 返回状态码为400：校验失败。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：查询成功。 表3 QueryDeviceDtos对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data REFERENCE 详细请参见表4。 站点内设备信息结构体 - 表4 QueryDeviceInfos对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 pageIndex int32 [1-65535] - 页面索引。 1 pageSize int32 [1-100] - 每页显示记录数。 20 totalPage int32 [1-65535] - 总页数。 10 totalRecords int32 [1-65535] - 总记录数。 10 QueryDeviceInfo ARRAY_REFERENCE 0-100个列表项，详细请参见表5。 站点内设备信息结构体。 - 表5 QueryDeviceInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceName string 0~64个字符。 - 设备名称。 "AirEngine6760R-51_FBF792C3" deviceId string 36个字符。 - 设备Id。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" deviceEsn string 20个字符。 - 设备esn。 "AA02353VUTFIOJNKGG13" deviceStatus int32 [0-5] - 设备状态。0 正常 1 告警 3 错误 4 未注册 3 deviceMeshRole string 0~64个字符。 - 设备上报的Mesh角色 mpp或者mp。 "mpp" meshConfigRole string 0~64个字符。 - Mesh配置角色 mpp或者mp。 "mpp" meshId string 36个字符。 - Apmesh唯一标识, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" meshName string 1~30个字符。 - Apmesh名称。 "apmesh" 返回状态码为400：校验失败。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /controller/campus/api/v1/networkconfig/apmesh/sites/fbb684c8-0d37-496f-bafa-4b06d5151e2e/devices?filterCondition=all&pageIndex=1&pageSize=20 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

URI /controller/campus/api/v1/networkconfig/apmesh/sites/{siteId}/devices 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 是 string 36个字符。 - 站点ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e" 表2 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 filterCondition 是 string all inMesh notInMesh - 过滤条件。inMesh表示查询已加入Apmesh的设备。notInMesh表示查询未加入Apmesh的设备。all表示查询所有支持mesh功能的AP设备。 "all" pageIndex 是 int32 [1-65535] - 页面索引。 1 pageSize 是 int32 [1-100] - 每页显示记录数。 20

响应示例 返回状态码为200：操作成功。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "bindingName" : "binding1", "deviceRoles" : ["Gateway","CORE"], "deviceTypes" : ["AP","LSW"], "deviceModels" : ["S12700E-4","S12700E-12"], "deviceNameContains" : "device1", "id" : "00000000-0000-0000-0000-000000000000" } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "" } 返回状态码为500：内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

请求示例 HTTP的示例 GET /v1/networkservice/hierarchy-template/template-groups/members/fbde1c5d-5b94-49e3-a912-48641015e45c/properties 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

响应示例 返回状态码为200：接口调用成功，响应体参考QuerySiteConnectPortResponse。 HTTP/1.1 200 OK Date: Sun,11 May 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" : { "connectPortInfos" : [ { "siteId" : "00000000-0000-0000-0000-000000000000", "connectPortEnable" : true, "srcPort" : 4501, "portNum" : 0, "portStep" : 10 } ] } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 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,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

响应参数 返回状态码为200：接口调用成功，响应体参考QuerySiteConnectPortResponse。 表2 QuerySiteConnectPortResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~10个字符。 - 错误码，0表示成功，非0表示失败。 "0" errmsg string 0~256个字符。 - 错误信息 - data REFERENCE 详细请参见表3。 连接源端口列表 - 表3 SiteConnectPortConfigInfos对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 connectPortInfos ARRAY_REFERENCE 1-100个列表项，详细请参见表4。 连接源端口列表 - 表4 SiteConnectPortConfig对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId string - - 站点ID，uuid格式。 "00000000-0000-0000-0000-000000000000" connectPortEnable boolean true false - 连接源端口开关，默认为false。 true srcPort int32 [4501-65535] - 连接源端口号动态扫描起始端口。 4501 portNum int32 [0-3] - 连接源端口号动态扫描次数。 0 portStep int32 [0-10] - 连接源端口号动态扫描步长。 10 返回状态码为400：校验异常。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误。 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/net/site/connect-port?siteId=00000000-0000-0000-0000-000000000000 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

请求示例 HTTP的示例 PUT /controller/campus/v3/networkconfig/site-templates/fbb684c8-0d37-496f-bafa-4b06d5151e2e/apwids 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 { "securityLevel" : "Off", "illegalDeviceDetect" : { "illegalDeviceDetect" : false, "macWhiteList" : [ "XX:XX:XX:XX:XX:XX" ], "ouiSsidMatch" : "both", "ouiWhiteList" : [ "02:02:00" ], "ssidWhiteList" : [ "abc" ] }, "manualContainDevice" : { "manualContainDevice" : false, "manualContainDeviceList" : [ "XX:XX:XX:XX:XX:XX" ] }, "spoofAPContain" : { "spoofAPContain" : false, "spoofingSSIDRuleList" : [ "abc" ] }, "terminalProtection" : { "terminalProtection" : false, "protectTerminalMACList" : [ "XX:XX:XX:XX:XX:XX" ] }, "bruteForceAttackDetect" : { "bruteForceAttackDetect" : false, "bruteForceThreshold" : 20, "bruteForceInterval" : 60 }, "spoofAttackDetect" : false, "floodAttackDetect" : false, "weakIvDetect" : false, "dynamicBlackListDefense" : false, "adhocContain" : false, "openDeviceContain" : false }

响应示例 返回状态码为200：站点模板下修改AP无线安全配置成功后的消息返回体。 HTTP/1.1 200 OK Date: Sun,11 May 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" : { "securityLevel" : "Off", "illegalDeviceDetect" : { "illegalDeviceDetect" : false, "macWhiteList" : [ "XX:XX:XX:XX:XX:XX" ], "ouiSsidMatch" : "both", "ouiWhiteList" : [ "02:02:00" ], "ssidWhiteList" : [ "abc" ] }, "manualContainDevice" : { "manualContainDevice" : false, "manualContainDeviceList" : [ "XX:XX:XX:XX:XX:XX" ] }, "spoofAPContain" : { "spoofAPContain" : false, "spoofingSSIDRuleList" : [ "abc" ] }, "terminalProtection" : { "terminalProtection" : false, "protectTerminalMACList" : [ "XX:XX:XX:XX:XX:XX" ] }, "bruteForceAttackDetect" : { "bruteForceAttackDetect" : false, "bruteForceThreshold" : 20, "bruteForceInterval" : 60 }, "spoofAttackDetect" : false, "floodAttackDetect" : false, "weakIvDetect" : false, "dynamicBlackListDefense" : false, "adhocContain" : false, "openDeviceContain" : false } } 返回状态码为400：校验异常。 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/apwids 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板ID, UUID格式。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"

响应示例 返回状态码为200：查询认证源返回体。 HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "pageIndex" : 1, "pageSize" : 20, "total" : 100, "data" : [ { "id" : "8a3aa7626c64a640016c64c3b96d01a8", "tenantId" : "8a3aa7626c64a640016c64c3b96d01a8", "ldapServerId" : "8a3aa7626c64a640016c64b698c300f4", "ldapServerName" : "10.179.182.226", "dn" : "ou=Domain Controllers", "synTime" : "12:30", "status" : 0, "enable" : 0, "updateTime" : "2019-08-12 19:37:15", "syncFailedReason" : "证书策略不存在" } ] } 返回状态码为400：出现错误返回结果 HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive

URI /v1/accountservice/cert-manager/crls 表1 query参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 pageIndex 是 int32 [1-100] - 分页页码 1 pageSize 是 int32 [20-100] - 分页数量 20 keyWord 否 string 0~256个字符。 - 关键字,仅支持dn值的过滤 "com"

请求示例 HTTP的示例 GET /v1/accountservice/cert-manager/crls?pageIndex=1&pageSize=20&keyWord=com 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

响应参数 返回状态码为200：查询认证源返回体。 表2 QueryCrlResult对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 1~64个字符。 - 错误码 "0" errmsg string 0~256个字符。 - 错误描述 "" pageIndex int32 [1-100] - 分页页码。 1 pageSize int32 [20-100] - 每页大小。 20 total int32 [0-10000] - 总记录 100 data ARRAY_REFERENCE 0-100个列表项，详细请参见表3。 CRL证书列表数据。 - 表3 CrlDistributionPoint对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 1~64个字符。 - 证书的唯一标识 "8a3aa7626c64a640016c64c3b96d01a8" tenantId string 30~36个字符。 - 租户Id "8a3aa7626c64a640016c64c3b96d01a8" ldapServerId string 1~64个字符。 - 认证源主键 "8a3aa7626c64a640016c64b698c300f4" ldapServerName string 1~64个字符。 - 认证源名字 "10.179.182.226" dn string 1~600个字符。 - Crl发布点 "ou=Domain Controllers" synTime string 1~64个字符。 - 同步时间, 时：分 "12:30" status int32 [0-3] - 同步成功或失败 未同步：0；同步中：1；同步成功：2；同步失败：3 0 enable int32 [0-1] - 是否启用同步设置 同步开关（开启：1；关闭：0） 0 updateTime string 1~64个字符。 - 修改时间, 格式 按照当前时区 yyyy-MM-dd HH:mm:ss "2019-08-12 19:37:15" syncFailedReason string 1~64个字符。 - 同步失败原因 "证书策略不存在" 返回状态码为400：出现错误返回结果 详细信息请参见实际响应消息体。

请求示例 HTTP的示例 POST /controller/campus/baseservice/api/v1/filemgr/files 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 { "fileName" : "test.xml", "displayName" : "test", "fileType" : 20, "fileSize" : 11, "localFilePath" : "C:\\fakepath\\test.xml", "description" : "", "pieceEnable" : false, "dependency" : "" }

响应参数 返回状态码为200：保存文件信息成功返回。返回体参考AddFileInfoResponse 表3 AddFileInfoResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errCode string - - 错误码。 0 : 无错误 1 : 参数校验或数据访问错误 详细信息见errMsg "0" errMsg string - - 添加文件结果 "test.xml Add success!" fileId string - - 添加文件id "549d0eec-9d6a-40c2-ab36-c7239e5fe409" fileName string - - 添加文件名称 "test.xml" 返回状态码为400：参数错误。 详细信息请参见实际响应消息体。 返回状态码为500：服务内部错误。 详细信息请参见实际响应消息体。

响应示例 返回状态码为200：保存文件信息成功返回。返回体参考AddFileInfoResponse HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errCode" : "0", "errMsg" : "test.xml Add success!", "fileId" : "549d0eec-9d6a-40c2-ab36-c7239e5fe409", "fileName" : "test.xml" } 返回状态码为400：参数错误。 HTTP/1.1 400 Bad Request Date: Sun,11 May 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,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive