-
请求示例 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-AC
CES S-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,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" : "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,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
-
响应示例 返回状态码为201:创建成功,响应体参考AddressSetResponse。 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" : "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,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" : "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,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
-
请求示例 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-ACCESS-TOKEN: x-yyyyyy
{
"securityInfo" : [
{
"id" : "000000-0000-0000-0000-000000000000",
"name" : "test_1",
"description" : "XXX",
"priority" : 50,
"attackDefenseEnable" : false,
"isDefault" : false
}
]
}
-
请求示例 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
-
响应示例 返回状态码为200:查询成功,响应体参考QuerySecurityZoneDetailResponse。 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" : "",
"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,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:查询成功,响应体参考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:内部错误。 详细信息请参见实际响应消息体。
-
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"
-
响应参数 返回状态码为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 /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
-
响应示例 返回状态码为200:查询成功,响应体参考QuerySecurityZoneResponse。 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" : "",
"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,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