Help Center/ Edge Security/ API Reference/ API/ HTTP Protection Rule Management - Precise Protection/ This API is used to query precise protection rules.
Updated on 2024-11-18 GMT+08:00

This API is used to query precise protection rules.

Function

This API is used to query precise protection rules.

URI

GET /v1/edgesec/configuration/http/policies/{policy_id}/access-control-rule

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

policy_id

Yes

String

Policy ID.

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

name

No

String

Rule name

page

No

Integer

Page number, which is required for pagination query.

pagesize

No

Integer

Pagination query parameter. The number of records displayed on each page is specified by pagesize.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

auth token

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

total

Integer

Number of protection rules in a policy

items

Array of ShowHttpAccessControlRuleResponseBody objects

Protection rule list

Table 5 ShowHttpAccessControlRuleResponseBody

Parameter

Type

Description

id

String

Rule ID.

name

String

Rule name.

policy_id

String

ID of the policy to which the rule belongs.

policy_name

String

Name of the policy to which the rule belongs.

timestamp

Long

Time when a rule is created

description

String

Rule description.

status

Integer

Rule enabling status

time

Boolean

Whether to set the effective time

start

Long

Effective time

terminal

Long

Expiration time

priority

Integer

Priority

conditions

Array of HttpAccessControlRuleCondition objects

Hit condition.

action

HttpRuleAction object

Action of the protection rule.

producer

Integer

Source

Table 6 HttpAccessControlRuleCondition

Parameter

Type

Description

category

String

Field type. The options are url, custom_asn, custom_geoip, robot, user-agent, ip, params, cookie, referer, header, method, request_line, request, response_code, response_length, response_time, response_header and response_body.

index

String

Subfield:

  • If the field type is url, custom_asn, custom_geoip, robot, user-agent, referer, request_line, method, request, response_code, response_length, response_time or response_body, the index parameter does not need to be passed in.

  • If the field type is params, cookie, header, or response_header and the subfield is customized, the index field is a customized subfield.

contents

Array of strings

Content list

logic_operation

String

Processing logic

value_list_id

String

ID of the reference table

size

Long

This field is used if the protection rule involves a threshold.

check_all_indexes_logic

Integer

  1. All subfields/2. Any subfield

Table 7 HttpRuleAction

Parameter

Type

Description

category

String

Operation type,

  • block: block.

  • pass: allow.

  • log: Only log detected attacks.

followed_action_id

String

Attack punishment rule ID. This parameter is available only when category is set to block.

detail

HttpRuleActionDetail object

Action of the protection rule.

Table 8 HttpRuleActionDetail

Parameter

Type

Description

redirect_url

String

URL to which the page is redirected.

response

HttpRuleActionResponse object

Return page of the protection rule

Table 9 HttpRuleActionResponse

Parameter

Type

Description

content_type

String

Content type.

content

String

Content

Status code: 400

Table 10 Response body parameters

Parameter

Type

Description

error_code

String

Standard error code: service name.8-digit code

error_msg

String

Detailed error information.

encoded_authorization_message

String

If the service is integrated with IAM5.0, an IAM response must be returned when access is denied.

Status code: 401

Table 11 Response body parameters

Parameter

Type

Description

error_code

String

Standard error code: service name.8-digit code

error_msg

String

Detailed error information.

encoded_authorization_message

String

If the service is integrated with IAM5.0, an IAM response must be returned when access is denied.

Status code: 500

Table 12 Response body parameters

Parameter

Type

Description

error_code

String

Standard error code: service name.8-digit code

error_msg

String

Detailed error information.

encoded_authorization_message

String

If the service is integrated with IAM5.0, an IAM response must be returned when access is denied.

Example Requests

None

Example Responses

None

Status Codes

Status Code

Description

200

OK

400

Request failed.

401

The token does not have required permissions.

500

Internal server error.

Error Codes

See Error Codes.