安全域管理接口-华为云

华为乾坤-创建安全域:响应示例

响应示例返回状态码为201：创建成功，响应体参考AddressSetResponse。 HTTP/1.1 201 Created 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" : "", "success" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } } ] } 返回状态码为202：请求正在处理中，请求处理详情请通过查询业务编排结果，确认是否处理成功。响应体参考SecurityZoneTimeOutResponse。 HTTP/1.1 202 Accepted 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" : "", "success" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } } ], "processInstanceId" : "" } 返回状态码为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的示例 POST /controller/campus/v1/sdwan/policy/security/zone 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 { "securityInfo" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ] }

华为乾坤安全域管理接口

华为乾坤-批量删除安全域:请求示例

请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/security/zone/action/batch-delete 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 { "securityInfo" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ] }

华为乾坤安全域管理接口

华为乾坤-批量删除安全域:响应示例

响应示例返回状态码为200：删除成功，响应体参考AddressSetResponse。 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" : "", "success" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : 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 返回状态码为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：查询成功，响应体参考QuerySecurityZoneDetailResponse。表2 QuerySecurityZoneDetailResponse对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string 0~256个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" totalRecords int32 [0-65535] - 总的数据条数。 1 pageSize int32 [0-65535] - 每页显示数量。 10 pageIndex int32 [0-65535] - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表3。安全域信息。 - 表3 SecurityZoneApplyInfo对象的参数列表参数名称类型参数值域默认值参数说明参数示例 siteId string 0~64个字符。 - 站点ID。 "000000-0000-0000-0000-000000000000" siteName string 0~64个字符。 - 站点名称。 "hub" deviceId string 0~64个字符。 - 设备ID。 "000000-0000-0000-0000-000000000000" deviceName string 0~64个字符。 - 设备名称。 "device1" interfaceId string 0~64个字符。 - 接口ID。 "000000-0000-0000-0000-000000000000" interfaceName string 0~64个字符。 - 接口名称。 "GE0/0/1" 返回状态码为400：请求参数错误。详细信息请参见实际响应消息体。返回状态码为500：内部错误。详细信息请参见实际响应消息体。

华为乾坤安全域管理接口

华为乾坤-查询已加入安全域站点，设备，接口信息:响应示例

响应示例返回状态码为200：查询成功，响应体参考QuerySecurityZoneDetailResponse。 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" : 1, "pageSize" : 10, "pageIndex" : 1, "data" : [ { "siteId" : "000000-0000-0000-0000-000000000000", "siteName" : "hub", "deviceId" : "000000-0000-0000-0000-000000000000", "deviceName" : "device1", "interfaceId" : "000000-0000-0000-0000-000000000000", "interfaceName" : "GE0/0/1" } ] } 返回状态码为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

华为乾坤安全域管理接口

华为乾坤-查询已加入安全域站点，设备，接口信息:URI

URI /controller/campus/v1/sdwan/policy/security/zone/detail 表1 query参数列表参数名称必选类型参数值域默认值参数说明参数示例 pageIndex 否 int32 [1-1000] 1 当前页数，默认是1。 1 pageSize 否 int32 [1-1000] 20 每页显示数量，默认是20。 20 id 是 string 0~64个字符。 - 安全域ID。 "000000-0000-0000-0000-000000000000" siteName 否 string 0~64个字符。 - 站点名称，支持模糊查询，按站点过滤。 "siteName"

华为乾坤安全域管理接口

华为乾坤-查询已加入安全域站点，设备，接口信息:请求示例

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/policy/security/zone/detail?pageIndex=1&pageSize=20&id=000000-0000-0000-0000-000000000000&siteName=siteName 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/v1/sdwan/policy/security/zone 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 { "securityInfo" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ] }

华为乾坤安全域管理接口

华为乾坤-批量修改安全域:响应示例

响应示例返回状态码为200：修改成功，响应体参考AddressSetResponse。 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" : "", "success" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } } ] } 返回状态码为202：请求正在处理中，请求处理详情请通过查询业务编排结果，确认是否处理成功。响应体参考SecurityZoneTimeOutResponse。 HTTP/1.1 202 Accepted 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" : "", "success" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : false } } ], "processInstanceId" : "" } 返回状态码为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

华为乾坤安全域管理接口

华为乾坤-批量修改安全域:响应参数

响应参数返回状态码为200：修改成功，响应体参考AddressSetResponse。 SecurityZoneResponse对象的参数列表，详细请参见表4。返回状态码为202：请求正在处理中，请求处理详情请通过查询业务编排结果，确认是否处理成功。响应体参考SecurityZoneTimeOutResponse。 SecurityZoneTimeOutResponse对象的参数列表，详细请参见表7。返回状态码为400：请求参数错误。详细信息请参见实际响应消息体。返回状态码为500：内部错误。详细信息请参见实际响应消息体。

华为乾坤安全域管理接口

华为乾坤-查询安全域:响应示例

响应示例返回状态码为200：查询成功，响应体参考QuerySecurityZoneResponse。 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" : 1, "pageSize" : 10, "pageIndex" : 1, "data" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "priority" : 50, "attackDefenseEnable" : false, "isDefault" : 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 返回状态码为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：查询成功，响应体参考QuerySecurityZoneResponse。表2 QuerySecurityZoneResponse对象的参数列表参数名称类型参数值域默认值参数说明参数示例 errcode string 0~256个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" totalRecords int32 [0-65535] - 总的数据条数。 1 pageSize int32 [0-65535] - 每页显示数量。 10 pageIndex int32 [0-65535] - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项，详细请参见表5。安全域信息。 - 返回状态码为400：请求参数错误。详细信息请参见实际响应消息体。返回状态码为500：内部错误。详细信息请参见实际响应消息体。

华为乾坤安全域管理接口

华为乾坤-查询安全域:URI

URI /controller/campus/v1/sdwan/policy/security/zone 表1 query参数列表参数名称必选类型参数值域默认值参数说明参数示例 pageIndex 否 int32 [0-1000] 1 当前页数，默认是1。 1 pageSize 否 int32 [0-1000] 20 每页显示数量，默认是20。 20 sort 否 string 0~255个字符。 - 排序字段。 "name" id 否 string 0~64个字符。 - 安全域ID。 "000000-0000-0000-0000-000000000000" zoneName 否 string 0~64个字符。 - 安全域名称，支持模糊匹配。 "trust" queryDefault 否 boolean true false false 是否仅查询默认的安全域，为空时则混合查询。 false

华为乾坤安全域管理接口

华为乾坤-查询安全域:请求示例

请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/policy/security/zone?pageIndex=1&pageSize=20&sort=name&id=000000-0000-0000-0000-000000000000&zoneName=trust&queryDefault=false 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

华为乾坤安全域管理接口

云服务器内容精选

安全域管理接口

7*24

备案

专业服务

退订

建议反馈

售前咨询热线