VAC DDoS protection
All operations require authentication.
List mitigation entriesProduction
List mitigation entries. Returns the IP addresses of the block that have a VAC DDoS mitigation entry. Filterable by state or auto-mitigation.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
Query parameters
Filter the value of auto property (=)
Filter the value of state property (=)
creationPendingokremovalPendingResponse
Example uses ip = 192.0.2.0/24
$ curl https:/[ "192.0.2.0"]
List IP mitigation timeoutsProduction
List IP mitigation timeouts. Returns the IPs of the block with a custom VAC mitigation timeout: how long each one stays in mitigation after an attack ends.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
Response
Example uses ip = 192.0.2.0/24
$ curl https:/[ "192.0.2.0"]
Get a mitigation entryProduction
Get a mitigation entry. Returns whether a given IP address of the block is under VAC auto-mitigation, and its state: creationPending, ok or removalPending.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
IPv4 address (e.g., 192.0.2.0)
Response
Set on true if your ip is on auto-mitigation
IPv4 address (e.g., 192.0.2.0)
DEPRECATED: this field is kept for backward compatibility of the API, changing its value has no operational impact
Current state of your ip on mitigation
creationPendingokremovalPendingExample uses ip = 192.0.2.0/24, ipOnMitigation = 192.0.2.0
$ curl https:/{ "auto": true, "ipOnMitigation": "192.0.2.0", "permanent": true, "state": "creationPending"}
Get an IP mitigation timeoutProduction
Get an IP mitigation timeout. Returns the VAC mitigation timeout of a given IP address, in minutes, and its state: ok or tasksPending.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
IPv4 address (e.g., 192.0.2.0)
Response
Delay to wait before remove ip from auto mitigation after an attack
015603601560IPv4 address (e.g., 192.0.2.0)
Current state of your mitigation profile
oktasksPendingExample uses ip = 192.0.2.0/24, ipMitigationProfile = 192.0.2.0
$ curl https:/{ "autoMitigationTimeOut": 0, "ipMitigationProfile": "192.0.2.0", "state": "ok"}
Create a mitigation entryProduction
Create a mitigation entry. Creates a VAC DDoS mitigation entry for an IP address of the block. No longer needed: entries are created automatically during an attack.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
Request body (required)
IPv4 address (e.g., 192.0.2.0)
Response
Set on true if your ip is on auto-mitigation
IPv4 address (e.g., 192.0.2.0)
DEPRECATED: this field is kept for backward compatibility of the API, changing its value has no operational impact
Current state of your ip on mitigation
creationPendingokremovalPendingExample uses ip = 192.0.2.0/24
$ curl https:/{ "auto": true, "ipOnMitigation": "192.0.2.0", "permanent": true, "state": "creationPending"}
Create an IP mitigation timeoutProduction
Create an IP mitigation timeout. Sets how long, in minutes: 0, 15, 60, 360 or 1560, a given IP address stays in VAC mitigation after an attack ends.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
Request body (required)
Delay to wait before remove ip from auto mitigation after an attack
015603601560IPv4 address (e.g., 192.0.2.0)
Response
Delay to wait before remove ip from auto mitigation after an attack
015603601560IPv4 address (e.g., 192.0.2.0)
Current state of your mitigation profile
oktasksPendingExample uses ip = 192.0.2.0/24
$ curl https:/{ "autoMitigationTimeOut": 0, "ipMitigationProfile": "192.0.2.0", "state": "ok"}
Delete a mitigation entryProduction
Delete a mitigation entry. Removes a given IP address of the block from VAC mitigation, and returns its mitigation entry with its state.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
IPv4 address (e.g., 192.0.2.0)
Response
Set on true if your ip is on auto-mitigation
IPv4 address (e.g., 192.0.2.0)
DEPRECATED: this field is kept for backward compatibility of the API, changing its value has no operational impact
Current state of your ip on mitigation
creationPendingokremovalPendingExample uses ip = 192.0.2.0/24, ipOnMitigation = 192.0.2.0
$ curl https:/{ "auto": true, "ipOnMitigation": "192.0.2.0", "permanent": true, "state": "creationPending"}
Delete an IP mitigation timeoutProduction
Delete an IP mitigation timeout. Removes the custom VAC mitigation timeout of a given IP address; the default applies again. The call returns no content.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
IPv4 address (e.g., 192.0.2.0)
Response
Example uses ip = 192.0.2.0/24, ipMitigationProfile = 192.0.2.0
$ curl https:/Update an IP mitigation timeoutProduction
Update an IP mitigation timeout. Changes the VAC mitigation timeout of a given IP address, the only editable field, to 0, 15, 60, 360 or 1560 minutes.
Path parameters
IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)
IPv4 address (e.g., 192.0.2.0)
Request body (required)
Delay to wait before remove ip from auto mitigation after an attack
015603601560IPv4 address (e.g., 192.0.2.0)
Current state of your mitigation profile
oktasksPendingResponse
Example uses ip = 192.0.2.0/24, ipMitigationProfile = 192.0.2.0
$ curl https:/