-
响应参数 返回状态码为200:查询成功,响应体参考QueryUrlFilterPolicyResponse。 表2 QueryUrlFilterPolicyResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 1 pageSize int32 - - 每页显示数量。 10 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项,详细请参见表8。 URL过滤策略信息。 - 返回状态码为400:请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:查询成功,响应体参考QueryUrlFilterPolicyResponse。 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" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_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
-
请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/policy/security/url-filter-policies?policyName=qos policy 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:删除成功,响应体参考UrlFilterPolicyResponse。 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" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_1"
]
]
}
}
],
"fail" : [
{
"errcode" : "0x00c8000c",
"errmsg" : "The parameter is invalid.",
"data" : {
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_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
-
请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/security/url-filter-policy/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
{
"effectImmediate" : true,
"urlFilterPolicies" : [
{
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_1"
]
]
}
}
]
}
-
响应示例 返回状态码为201:创建成功,响应体参考UrlFilterPolicyResponse。 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",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_1"
]
]
}
}
],
"fail" : [
{
"errcode" : "0x00c8000c",
"errmsg" : "The parameter is invalid.",
"data" : {
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_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
-
请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/security/url-filter-policies 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
{
"effectImmediate" : true,
"urlFilterPolicies" : [
{
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_1"
]
]
}
}
]
}
-
响应示例 返回状态码为200:查询成功,响应体参考QueryPnfUrlFilterPolicyResponse。 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" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"defaultAction" : "permit",
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
]
}
]
} 返回状态码为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的示例 GET /controller/campus/v1/sdwan/policy/security/url-filter-manager?pageIndex=0&pageSize=20&sort=desc&id=00000000-0000-0000-0000-000000000000&vpnId=00000000-0000-0000-0000-000000000000&policyName=qos policy 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:查询成功,响应体参考QueryPnfUrlFilterPolicyResponse。 表2 QueryPnfUrlFilterPolicyResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 1 pageSize int32 - - 每页显示数量。 10 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项,详细请参见表5。 URL过滤策略信息。 - 返回状态码为400:请求参数错误。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
-
响应示例 返回状态码为200:修改成功,响应体参考UrlFilterPolicyResponse。 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" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_1"
]
]
}
}
],
"fail" : [
{
"errcode" : "0x00c8000c",
"errmsg" : "The parameter is invalid.",
"data" : {
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_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
-
请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/policy/security/url-filter-policies 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
{
"effectImmediate" : true,
"urlFilterPolicies" : [
{
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"status" : 1,
"isActive" : true,
"defaultAction" : "permit",
"excludedUrls" : [
"www.example.com"
],
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
],
"policyType" : false,
"securityZone" : {
"securityInterZones" : [
[
"test_1"
]
]
}
}
]
}
-
请求示例 HTTP的示例 POST /controller/campus/v1/sdwan/policy/security/url-filter-manager 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
{
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"defaultAction" : "permit",
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
]
}
-
响应示例 返回状态码为201:创建成功,响应体参考PnfUrlFilterPolicyResponse。 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" : "0x00c8000c",
"errmsg" : "The parameter is invalid.",
"data" : {
"id" : "00000000-0000-0000-0000-000000000000",
"vpnId" : "00000000-0000-0000-0000-000000000000",
"name" : "UrlFilterPolicy",
"defaultAction" : "permit",
"blackUrls" : [
"www.example.com"
],
"whiteUrls" : [
"www.example.com"
],
"level" : "high",
"customFilters" : [
{
"cid" : 1,
"classification" : "P2P",
"action" : "permit"
}
]
}
} 返回状态码为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