Updated on 2024-07-09 GMT+08:00

Updating Anti-DDoS Defense Policies

Functions

This API enables you to update the Anti-DDoS defense policy of a specified EIP. Successfully invoking this API only means that the service node has received the update request. You need to use the task querying API to check the task execution status. For details about the task querying API, see Querying Anti-DDoS Tasks.

URI

  • URI format

    PUT /v1/{project_id}/antiddos/{floating_ip_id}

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

    floating_ip_id

    Yes

    String

    ID corresponding to the EIP of a user

Request Parameters

Table 1 Parameter description

Parameter

Mandatory

Type

Description

enable_L7

No

Boolean

Whether to enable layer-7 protection.

  • true: Enable layer 7 protection.
  • false: Disable layer 7 protection.

traffic_pos_id

Yes

Integer

Position ID of traffic. The value ranges from 1 to 9, or 99.

http_request_pos_id

Yes

Integer

Position ID of number of HTTP requests. The value ranges from 1 to 15.

cleaning_access_pos_id

Yes

Integer

Position ID of access limit during cleaning. The value ranges from 1 to 8, or 99.

app_type_id

No

Integer

Application type ID. Possible values:
  • 0
  • 1

Response

Table 2 Parameter description

Name

Type

Description

error_code

String

Internal error code

error_msg

String

Internal error description

task_id

String

ID of a task. This ID can be used to query the status of the task.

This field is reserved for use in task auditing later. It is temporarily unused.

Example

  • Example request
    PUT /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos/ee0c854e-082f-499e-b7d8-1b42c22781af
    {
        "enable_L7":false,
        "traffic_pos_id":2,
        "http_request_pos_id":1,
        "cleaning_access_pos_id":1,
        "app_type_id":1
    }
  • Example response
    {
       "error_code": "10000000",
       "error_msg": "The task has been received and is being handled",
       "task_id": "4a4fefe7-34a1-40e2-a87c-16932af3ac4a"
    }

Status Code

See Status Code.