openapi: 3.0.1
info:
title: Cloud Application Security API
license:
name: Imperva License Agreement.
url: http://www.imperva.com/other/license_agreement.asp
version: '1.0'
externalDocs:
description: Cloud Application Security API Reference
url: https://docs.imperva.com/bundle/cloud-application-security/page/api/api.htm
servers:
- url: https://my.imperva.com
description: Imperva API server
variables: {}
security:
- api_key: []
- api_id: []
tags:
- name: Account Management
description: Add, delete, and modify accounts. Get account details.
- name: Site Management
description: Add, remove, and update sites.
- name: DDoS Protection for Individual IPs
description: Manage IP Protection over TCP/IP settings.
- name: DDoS for Networks Test Alerts
description: Generate dummy notifications to test system alerts.
- name: Traffic Statistics and Logs
description: Retrieve traffic statistics and logs for sites or accounts.
- name: Login Protect
description: Provision Login Protect users and configure protected pages.
- name: Integrations
description: Implement integrations with the Imperva service.
paths:
/api/prov/v1/accounts/gettoken:
post:
tags:
- Account Management
summary: Get account login token
description: 'Tokens are used instead of user/password based authentication
to log in to the Imperva Cloud Security Console.
Use this operation to generate a token for an account. The token is valid
for 15 minutes.'
operationId: getToken
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: partner_id
in: query
description: Numeric identifier of the parent id to operate on
schema:
type: string
example: 15
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResultGetSsoToken'
/api/prov/v1/accounts/list:
post:
tags:
- Account Management
summary: List managed accounts
description: Available for Reseller accounts only.
Use this operation to
get the list of accounts that are managed by account of the API client (the
parent account).
operationId: listAccounts
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: page_size
in: query
description: 'The number of objects to return in the response.
Default:
50
Maximum: 100'
schema:
type: string
example: 75
- name: page_num
in: query
description: 'The page to return starting from 0. Default: ''0'
schema:
type: string
example: 0
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResultListUsers'
/api/prov/v1/subaccounts/add:
post:
tags:
- Account Management
summary: Add a new sub account
description: Use this operation to add a new sub account to be managed by the
account of the API client (the parent account).
operationId: addSubAccount
parameters:
- name: sub_account_name
in: query
description: The name of the sub account.
required: true
schema:
type: string
example: My Sub Account
- name: parent_id
in: query
description: The newly created account's parent id. If not specified, the
invoking account will be assigned as the parent account.
schema:
type: integer
format: int64
example: 10
- name: ref_id
in: query
description: Customer specific identifier for this operation.
schema:
type: string
example: 1
- name: log_level
in: query
description: 'Sets the log reporting level for the site.
Possible values:
full, security, none, default
Available only for customers that purchased
the Logs Integration SKU.'
schema:
type: string
example: full
- name: logs_account_id
in: query
description: Numeric identifier of the account that purchased the logs integration
SKU and which collects the logs.
If not specified, operation will be
performed on the account identified by the authentication parameters.
Available
only for customers that purchased the Logs Integration SKU.
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account_id
9415 - Operation not allowed
1015 - Maximum number
of SubAccounts reached
1003 - Plan ID invalid
1010 - Account exists
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSubAccountStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/listSubAccounts:
post:
tags:
- Account Management
summary: List account's sub accounts
description: Use this operation to get a list of sub accounts that are managed
by the account of the API client (the parent account).
operationId: listSubAccounts
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: page_size
in: query
description: 'The number of objects to return in the response.
Default:
50
Maximum: 100'
schema:
type: string
example: 75
- name: page_num
in: query
description: 'The page to return starting from 0. Default: 0'
schema:
type: string
example: 0
responses:
'200':
description: res - contains the specific error code:
9415 - Operation
not allowed
1002 - Account doesn't exist
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/SubAccountStatus'
/api/prov/v1/accounts/configure:
post:
tags:
- Account Management
summary: Modify account configuration
description: Use this operation to change the configuration of the account of
the API client or one of its managed accounts.
operationId: modifyAccountConfiguration
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: param
in: query
description: 'Name of the configuration parameter to set.
Possible values:
name | email | plan_id | error_page_template | support_all_tls_versions
| naked_domain_san_for_new_www_sites | wildcard_san_for_new_sites | ref_id
Note:
plan_id, email, and error_page_template parameters are available for Reseller
account only.'
required: true
schema:
type: string
example: email
- name: value
in: query
description: 'According to the configuration paramater used.
For name
- the updated name, for e-mail - the updated e-mail address.
For plan_id
- a plan id.
For error_page_template - a Base64 encoded template for
an error page.
For log_level - Available only for customers that purchased
the Logs Integration SKU. Sets the log reporting level for the site. Possible
values: full, security, none, default
For support_all_tls_versions -
Use this operation to allow sites in the account to support all TLS versions
for connectivity between clients (visitors) and the Imperva service. When
this option is set, you can then enable the option per site to support all
TLS versions. Possible values: true, false. Note: To remain PCI-compliant,
do not enable this option.
For naked_domain_san_for_new_www_sites -
Use this option to determine if the naked domain SAN will be added to the
SSL certificate for new www sites. Default value: true
For wildcard_san_for_new_sites
- Use this option to determine if the wildcard SAN or the full domain SAN
is added to the Imperva SSL certificate for new sites. Possible values:
true, false, default (determined by plan) Default value: default
For
ref_id - Sets the Reference ID, a free-text field that enables you to add
a unique identifier to correlate an object in our service, such as a protected
website, with an object on the customer side.'
required: true
schema:
type: string
example: John@example.com
responses:
'200':
description: res - contains the specific error code:
6001 - Invalid
configuration parameter name
6002 - Invalid configuration parameter
value
6003 - Action required
2 - Invalid input
9415 - Operation
not allowed
1 - Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/delete:
post:
tags:
- Account Management
summary: Delete managed account
description: 'Available for Reseller accounts only
Use this operation to delete an account.'
operationId: deleteAccount
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
1 - Unexpected
error
2 - Invalid input
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/subaccounts/delete:
post:
tags:
- Account Management
summary: Delete sub account
description: Use this operation to delete a sub account.
operationId: deleteSubAccount
parameters:
- name: sub_account_id
in: query
description: Numeric identifier of the sub account to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
1 - Unexpected
error
2002 - Invalid input2001 - Object is not empty
9415 - Operation
not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts:
post:
tags:
- Account Management
summary: Get account status
description: Use this operation to get account status
operationId: getAccountStatus
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResultAccountStatus'
/api/prov/v1/accounts/setlog:
post:
tags:
- Account Management
summary: Modify account log level
description: Available for Reseller accounts only
Use this operation to
change the account log configuration.
operationId: modifyAccountLogLevel
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: log_level
in: query
description: 'Sets the log reporting level for the site.
Possible values:
full, security, none, default
Available only for customers that purchased
the Log Integration SKU.'
required: true
schema:
type: string
example: full
responses:
'200':
description: res - contains the specific error code:
6001 - Invalid
configuration parameter name
1003 - Plan ID invalid
9415 - Operation
not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/subscription:
post:
tags:
- Account Management
summary: Get account subscription details
description: Use this operation to get subscription details for an account.
operationId: subscription
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: Success
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultAccountSubscription'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/add:
post:
tags:
- Account Management
summary: Add a new managed account
description: 'Available for Reseller accounts only
Use this operation to
add a new account that should be managed by the account of the API client
(the parent account). The new account will be configured according to the
preferences set for the parent account by Imperva.
Depending on these preferences, an activation e-mail will be sent to the specified
e-mail address. The user responds to the activation e-mail, selects a password,
and can then log directly into the Imperva console. The same e-mail address
can also be used to send system notifications to the account. The new account
is identified by a numeric value as provided by Imperva in the response in
the field account_id.'
operationId: addAccount
parameters:
- name: email
in: query
description: 'Email address. For example: "joe@example.com".'
required: true
schema:
type: string
example: example@imperva.com
- name: parent_id
in: query
description: The newly created account's parent id. If not specified, the
invoking account will be assigned as the parent.
schema:
type: integer
format: int64
example: 10
- name: name
in: query
description: 'The account owner''s name. For example: "John Doe".'
schema:
type: string
example: Jhon
- name: plan_id
in: query
description: An identifier of the plan to assign to the new account. For example,
ent100 for the Enterprise 100 plan.
schema:
type: string
example: ent100
- name: ref_id
in: query
description: Customer specific identifier for this operation.
schema:
type: string
example: 324
- name: account_name
in: query
description: Account name.
schema:
type: string
example: John Account
- name: account_description
in: query
description: The account description
schema:
type: string
example: Demo account
- name: user_name
in: query
description: 'The account owner''s name. For example: "John Doe".'
schema:
type: string
example: Jhon
- name: log_level
in: query
description: 'Sets the log reporting level for the site.Possible values: full,
security, none, default
Available only for customers that purchased
the Logs Integration SKU.'
schema:
type: string
example: full
- name: logs_account_id
in: query
description: 'Numeric identifier of the account that purchased the logs integration
SKU and which collects the logs.
If not specified, operation will be
performed on the account identified by the authentication parameters.
Available only for customers that purchased the Logs Integration SKU.'
schema:
type: string
example: 15
responses:
'200':
description: res - contains the specific error code:
1003 - Plan ID
invalid
1001 - Email invalid
1010 - Account exists
9403 -
Unknown/unauthorized account_id
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultAccountStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/caching-rules/add:
post:
tags:
- Site Management
summary: Add a cache rule
description: Use this operation for adding a cache rule
operationId: addCacheRule
parameters:
- name: action
in: query
description: Rule action. See Possible action parameter values.
Possible
action parameter values:
- HTTP_CACHE_MAKE_STATIC Cache
Resource
- HTTP_CACHE_CLIENT_CACHE_CTL Cache Resource on Client
- HTTP_CACHE_FORCE_UNCACHEABLE
Don't Cache Resource
- HTTP_CACHE_DIFFERENTIATE_SSL Differentiate
Cache Key by HTTP/HTTPS Scheme
- HTTP_CACHE_DIFFERENTIATE_BY_HEADER
Differentiate Cache Key by Header
- HTTP_CACHE_DIFFERENTIATE_BY_COOKIE
Differentiate Cache Key by Cookie
- HTTP_CACHE_IGNORE_PARAMS
Ignore Parameters in Cache Key
- HTTP_CACHE_IGNORE_AUTH_HEADER
CacheRuleAction.HTTP_CACHE_IGNORE_AUTH_HEADER
- HTTP_CACHE_FORCE_VALIDATION
Force User Authentication
- HTTP_CACHE_ADD_TAG Create Tag
- HTTP_CACHE_ENRICH_CACHE_KEY
Enrich Cache Key
required: true
schema:
type: string
example: HTTP_CACHE_CREATE_TAG
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: name
in: query
description: Rule name.
required: true
schema:
type: string
example: rule1
- name: filter
in: query
description: Rule will trigger only a request that matches this filter. For
more details on filters, see Syntax
Guide.
schema:
type: string
example: URL == /admin
- name: ttl
in: query
description: Rule TTL. Only relevant when action is HTTP_CACHE_MAKE_STATIC
or HTTP_CACHE_CLIENT_CACHE_CTL
schema:
type: string
example: TTL value
- name: ttl_unit
in: query
description: Rule TTL time unit.
Must be one of SECONDS, MINUTES, HOURS,
DAYS or WEEKS. If no time unit is provided, SECONDS is used.
Only relevant
when action is HTTP_CACHE_MAKE_STATIC or HTTP_CACHE_CLIENT_CACHE_CTL
schema:
type: string
example: SECONDS
- name: differentiated_by_value
in: query
description: Value to differentiate by. HTTP_CACHE_DIFFERENTIATE_BY_HEADER
- header name, HTTP_CACHE_DIFFERENTIATE_BY_COOKIE - cookie name, HTTP_CACHE_DIFFERENTIATE_BY_GEO
- geo location
(ISO 3166-1 alpha-2 country codes ), otherwise irrelevant.
schema:
type: string
example: cookie name
- name: params
in: query
description: Comma separated list of parameters to ignore.
schema:
type: string
example: '{a,b,c}'
- name: all_params
in: query
description: 'When set to true: all parameters in cache key will be
ignored.
Default: false.
Relevant for HTTP_CACHE_IGNORE_PARAMS action'
schema:
type: boolean
example: true
- name: tag_name
in: query
description: The name of the tag to add.
schema:
type: string
example: tag example
- name: text
in: query
description: Add text to the cache key as suffix. Relevant for the HTTP_CACHE_ENRICH_CACHE_KEY
action
schema:
type: string
example: suffix
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
2 - Invalid input
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultAddCacheRule'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/caching-rules/delete:
post:
tags:
- Site Management
summary: Delete a cache rule
description: Use this operation for deleting a cache rule
operationId: deleteCacheRule
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: rule_id
in: query
description: ID of the rule to change.
required: true
schema:
type: integer
format: int64
example: 3746
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
2 - Invalid input
2002
- Object is not found
1 - Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/caching-rules/enable:
post:
tags:
- Site Management
summary: Enable or disable cache rule
description: Use this operation for enabling or disable cache rule
operationId: enableDisableCacheRule
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: rule_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 3746
- name: enable
in: query
description: When true, the rule will be enabled. Set to false to disable.
required: true
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
2 - Invalid input
2002
- Object is not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/caching-rules/list:
post:
tags:
- Site Management
summary: List cache rules for a given site
description: Use this operation for representing cache rules for a given site
operationId: listCacheRules
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: page_size
in: query
description: 'The number of objects to return in the response.
Default
is 50.
Maximum: 100'
schema:
type: string
example: 75
- name: page_num
in: query
description: The page to return starting from 0. Default is 0.
schema:
type: string
example: 0
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
2 - Invalid input
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/SiteCacheRuleResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/caching-rules/edit:
post:
tags:
- Site Management
summary: Edit a cache rule
description: Use this operation for editing a cache rule
operationId: editCacheRule
parameters:
- name: action
in: query
description: Rule action. See Possible action parameter values.
Possible
action parameter values:
- HTTP_CACHE_MAKE_STATIC Cache
Resource
- HTTP_CACHE_CLIENT_CACHE_CTL Cache Resource on Client
- HTTP_CACHE_FORCE_UNCACHEABLE
Don't Cache Resource
- HTTP_CACHE_DIFFERENTIATE_SSL Differentiate
Cache Key by HTTP/HTTPS Scheme
- HTTP_CACHE_DIFFERENTIATE_BY_HEADER
Differentiate Cache Key by Header
- HTTP_CACHE_DIFFERENTIATE_BY_COOKIE
Differentiate Cache Key by Cookie
- HTTP_CACHE_IGNORE_PARAMS
Ignore Parameters in Cache Key
- HTTP_CACHE_IGNORE_AUTH_HEADER
CacheRuleAction.HTTP_CACHE_IGNORE_AUTH_HEADER
- HTTP_CACHE_FORCE_VALIDATION
Force User Authentication
- HTTP_CACHE_ADD_TAG Create Tag
- HTTP_CACHE_ENRICH_CACHE_KEY
Enrich Cache Key
required: true
schema:
type: string
example: HTTP_CACHE_CREATE_TAG
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: rule_id
in: query
description: ID of the rule to change.
required: true
schema:
type: integer
format: int64
example: 3746
- name: name
in: query
description: Rule name.
required: true
schema:
type: string
example: rule1
- name: filter
in: query
description: Rule will trigger only a request that matches this filter. For
more details on filters, see Syntax
Guide.
schema:
type: string
example: URL == /admin
- name: ttl
in: query
description: Rule TTL. Only relevant when action is HTTP_CACHE_MAKE_STATIC
or HTTP_CACHE_CLIENT_CACHE_CTL
schema:
type: string
example: TTL value
- name: ttl_unit
in: query
description: Rule TTL time unit.
Must be one of SECONDS, MINUTES, HOURS,
DAYS or WEEKS. If no time unit is provided, SECONDS is used.
Only relevant
when action is HTTP_CACHE_MAKE_STATIC or HTTP_CACHE_CLIENT_CACHE_CTL
schema:
type: string
example: SECONDS
- name: differentiated_by_value
in: query
description: Value to differentiate by. HTTP_CACHE_DIFFERENTIATE_BY_HEADER
- header name, HTTP_CACHE_DIFFERENTIATE_BY_COOKIE - cookie name, HTTP_CACHE_DIFFERENTIATE_BY_GEO
- geo location
(ISO 3166-1 alpha-2 country codes ), otherwise irrelevant.
schema:
type: string
example: cookie name
- name: params
in: query
description: Comma separated list of parameters to ignore.
schema:
type: string
example: '{a,b,c}'
- name: all_params
in: query
description: 'When set to true: all parameters in cache key will be
ignored.
Default: false.
Relevant for HTTP_CACHE_IGNORE_PARAMS action'
schema:
type: boolean
example: true
- name: tag_name
in: query
description: The name of the tag to add.
schema:
type: string
example: tag1
- name: text
in: query
description: Add text to the cache key as suffix. Relevant for the HTTP_CACHE_ENRICH_CACHE_KEY
action
schema:
type: string
example: cache
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
2 - Invalid input
2002
- Object is not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/v1/infra/stats:
post:
tags:
- Traffic Statistics and Logs
summary: Get Infrastructure Protection Statistics
description: Use this operation to get Infrastructure Protection event information
for an account.
operationId: getInfraStats
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: integer
format: int64
example: 10
- name: ip_prefix
in: query
description: Specific Protected IP or IP range. For example, 1.1.1.0/24.
schema:
type: string
example: 1.1.1.0/24
- name: traffic
in: query
description: 'Specific traffic. One of: Total, Passed, Blocked.'
schema:
type: string
example: Blocked
- name: traffic_type
in: query
description: 'A comma separated list of specific traffic types. Any of: UDP,
TCP, DNS, DNS_RESPONSE, ICMP, SYN, FRAG, LARGE_SYN, NTP, NETFLOW, SSDP,
GENERAL. Cannot be used together with the pop parameter.'
schema:
type: string
example: TCP
- name: pop
in: query
description: 'A comma separated list of specific PoP names. For example: iad,
tko. Cannot be used together with the traffic_type parameter. For the list
of PoP codes and locations, see Imperva
Data Centers (PoPs).'
schema:
type: string
example: tko
- name: start
in: query
description: 'The start date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: integer
format: int64
example: 1610356734
- name: end
in: query
description: 'The end date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: integer
format: int64
example: 1610356734
- name: directionTypes
in: query
description: The type of direction(INGRESS/EGRESS) to filter the data
schema:
type: string
example: INGRESS
- name: range_type
in: query
description: 'Can be one of the following: BGP, PROTECTED_IP'
schema:
type: string
example: INCAPSULA_IP
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
3015
- Internal error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/InfraStatsApiResponse'
- $ref: '#/components/schemas/ApiResult'
/api/stats/v1:
post:
tags:
- Traffic Statistics and Logs
summary: Get statistics
description: Get site statistics for one or more sites. This operation may return
multiple statistics, as specified in the stats parameter.
operationId: getStats
parameters:
- name: account_id
in: query
description: 'Numeric identifier of the account to fetch data for.
Note:
You must specify either account_id or site_id.'
schema:
type: string
example: 10
- name: time_range
in: query
description: 'Time range to fetch data for.
Some operations require the
user to specify a time range. This is done via the time_range parameter,
which accepts the following values:
- today Retrieve data
from midnight today until the current time.
- last_7_days Retrieve
data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: string
example: last_7_days
- name: start
in: query
description: 'Start date in milliseconds since 1970. Used together with the
time_range parameter to specify a custom time range.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
- name: end
in: query
description: 'End date in milliseconds since 1970. Used together with the
time_range parameter to specify a custom time range.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
- name: site_id
in: query
description: 'Numeric identifier of the site to fetch data for. Multiple sites
can be specified in a comma separated list. For example: 123,124,125.
Note:
You must specify either account_id or site_id.'
schema:
type: string
example: 123
- name: stats
in: query
description: Statistics to fetch, as specified in the table below. Multiple
statistics can be specified in a comma separated list.
Values for the
stats parameters:
- visits_timeseries Number of visits
by type (Humans/Bots) over time.
- hits_timeseries Number of
hits by type (Humans/Bots/Blocked) over time and per second.
- bandwidth_timeseries
Amount of bytes (bandwidth) and bits per second (throughput) transferred
via the Imperva network from clients to proxy servers and vice-versa over
time.
- requests_geo_dist_summary Total number of requests
routed via the Imperva network by data center location.
- visits_dist_summary
Total number of visits per client application and country.
- caching
Total number of requests and bytes that were cached by the Imperva network.
- caching_timeseries
Number of requests and bytes that were cached by the Imperva network, with
one day resolution, with info regarding the caching mode (standard or advanced).
- threats
Total number of threats by type with additional information regarding the
security rules configuration.
- incap_rules List of security
rules with total number of reported incidents for each rule.
- incap_rules_timeseries
List of security rules with a series of reported incidents for each rule
with the specified granularity.
- delivery_rules List of delivery
rules with total number of hits for each rule.
- delivery_rules_timeseries
List of delivery rules with a series of hits for each rule with the specified
granularity.
required: true
schema:
type: string
example: threats
- name: granularity
in: query
description: 'Time interval in milliseconds between data points for time series
statistics. (See the timeseries values in the table below.)
The default
granularity depends on the specified time range, as follows:
- Time
range of less than 24 hours: Default granularity is 7200000 (2 hours).
- Time
range of between 24 hours and 30 days: Default granularity is 86400000 (1
day).
- Time range of more than 30 days: Default granularity is 259200000
(3 days).
The response includes one result for each interval. For
example, if you specify a time range value of last_7_days, the default granularity
is 1 day, and the response will return 7 results.'
schema:
type: string
example: 7200000
responses:
'200':
description: res - contains the specific error code:
13001 (Timerange
invalid), 13002 (Granularity invalid)
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStats'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra/top-table:
post:
tags:
- Traffic Statistics and Logs
summary: Get Infrastructure Protection Top Items (Table View)
description: Use this operation to view the highest peak values and highest
average values for a protected IP range during a selected time period.
operationId: getInfraProtectTopTable
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: integer
format: int64
example: 10
- name: ip_range
in: query
description: The customer's IP range.
required: true
schema:
type: string
example: INCAPSULA_IP
- name: range_type
in: query
description: 'One of the following: BGP, PROTECTED_IP'
required: true
schema:
type: string
example: PROTECTED_IP
- name: start
in: query
description: 'The start date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: integer
format: int64
example: 1610356734
- name: end
in: query
description: 'The end date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: integer
format: int64
example: 1610356734
- name: data_type
in: query
description: 'One of the following: SRC_IP, DST_IP, SRC_PORT_PROTOCOL, DST_PORT_PROTOCOL'
required: true
schema:
type: string
example: SRC_IP
- name: metric_type
in: query
description: 'One of the following: SRC_IP, DST_IP, SRC_PORT_PROTOCOL, DST_PORT_PROTOCOL'
required: true
schema:
type: string
example: BPS
- name: mitigation_type
in: query
description: 'One of the following: BLOCK, PASS'
required: true
schema:
type: string
example: BLOCK
- name: aggregation_type
in: query
description: 'One of the following: PEAK, AVERAGE'
required: true
schema:
type: string
example: AVERAGE
- name: data_storage_region
in: query
description: The data region to use. If not specified, account's default data
region will be used.
schema:
type: string
example: EU
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
1
- Unexpected error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/AnalyticsTopTableApiResponse'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra/top-graph:
post:
tags:
- Traffic Statistics and Logs
summary: Get Infrastructure Protection Top Items (Graph View)
description: Use this operation to view the highest peak values and highest
average values for a protected IP range during a selected time period.
operationId: getInfraProtectTopData
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: integer
format: int64
example: 10
- name: ip_range
in: query
description: The customer's IP range.
required: true
schema:
type: string
example: INCAPSULA_IP
- name: range_type
in: query
description: 'One of the following: BGP, PROTECTED_IP'
required: true
schema:
type: string
example: PROTECTED_IP
- name: start
in: query
description: 'The start date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: integer
format: int64
example: 1610356734
- name: end
in: query
description: 'The end date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: integer
format: int64
example: 1610356734
- name: data_type
in: query
description: 'One of the following: SRC_IP, DST_IP, SRC_PORT_PROTOCOL, DST_PORT_PROTOCOL'
required: true
schema:
type: string
example: SRC_IP
- name: metric_type
in: query
description: 'One of the following: BW, PPS'
required: true
schema:
type: string
example: BPS
- name: mitigation_type
in: query
description: 'One of the following: BLOCK, PASS'
required: true
schema:
type: string
example: BLOCK
- name: data_storage_region
in: query
description: The data region to use. If not specified, account's default data
region will be used.
schema:
type: string
example: EU
- name: objects
in: query
description: A comma separated list of items to fetch data for. e.g., 10.10.10.10,
2.2.2.2. If not specified, top items are automatically fetched.
schema:
type: string
example: 1.1.1.1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
1
- Unexpected error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/AnalyticsTopGraphDataResponse'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra/histogram:
post:
tags:
- Traffic Statistics and Logs
summary: Get Infrastructure Protection Histogram
description: Use this operation to view the highest packet size values for a
protected IP range during a selected time period.
operationId: getInfraProtectHistogram
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: integer
format: int64
example: 10
- name: ip_range
in: query
description: The customer's IP range.
required: true
schema:
type: string
example: INCAPSULA_IP
- name: range_type
in: query
description: 'One of the following: BGP, PROTECTED_IP'
required: true
schema:
type: string
example: PROTECTED_IP
- name: start
in: query
description: 'The start date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: integer
format: int64
example: 1610356734
- name: end
in: query
description: 'The end date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: integer
format: int64
example: 1610356734
- name: mitigation_type
in: query
description: 'One of the following: BLOCK, PASS'
required: true
schema:
type: string
example: BLOCK
- name: data_storage_region
in: query
description: The data region to use. If not specified, account's default data
region will be used.
schema:
type: string
example: EU
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
1
- Unexpected error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/AnalyticsHistogramApiResponse'
- $ref: '#/components/schemas/ApiResult'
/api/visits/v1:
post:
tags:
- Traffic Statistics and Logs
summary: Get visits
description: Use this operation to get a log of recent visits to a website.
operationId: getVisits
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: time_range
in: query
description: 'Time range to fetch data for. Default is last_7_days.
Some
operations require the user to specify a time range. This is done via the
time_range parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: last_7_days
- name: start
in: query
description: 'Start date in milliseconds since 1970.
Some operations require
the user to specify a time range. This is done via the time_range parameter,
which accepts the following values:
- today Retrieve data
from midnight today until the current time.
- last_7_days Retrieve
data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
- name: end
in: query
description: 'End date in milliseconds since 1970.
Some operations require
the user to specify a time range. This is done via the time_range parameter,
which accepts the following values:
- today Retrieve data
from midnight today until the current time.
- last_7_days Retrieve
data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
- name: page_size
in: query
description: The number of objects to return in the response. Defaults to
10. Maximum is 100.
schema:
type: string
example: 15
- name: page_num
in: query
description: The page to return starting from 0. Default to 0.
schema:
type: string
example: 1
- name: security
in: query
description: 'Filter the sessions that were handled according to the security-related
specifications. Multiple values are supported, e.g.: "api.threats.action.block_ip,
api.threats.sql_injection".'
schema:
type: string
example: api.threats.action.block_ip
- name: country
in: query
description: Filter the sessions coming from the specified country.
schema:
type: string
example: SE
- name: ip
in: query
description: Filter the sessions coming from the specified IP.
schema:
type: string
example: 1.2.3.4
- name: visit_id
in: query
description: Comma separated list of visit IDs to load.
schema:
type: string
example: 133077760038625792
- name: list_live_visits
in: query
description: 'Whether or not to list visits that did not end and that may
still be updated.
Possible values: true, false
Default: true'
schema:
type: string
example: true
- name: use_previous_region
in: query
description: 'Whether or not to list visits from old region data. Valid only
if a data region was changed in the last 90 days. One of: true | false.
Default: false'
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
1 - Unexpected
error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSessions'
- $ref: '#/components/schemas/ApiResult'
/api/logscollector/upload/publickey:
post:
tags:
- Traffic Statistics and Logs
summary: Upload Public Key
description: Available only for Enterprise Plan customers that purchased the
Security Logs Integration SKU.
operationId: uploadLCPublicKey
parameters:
- name: config_id
in: query
description: The Logs Collector configuration identifier.
required: true
schema:
type: string
example: 5912
- name: public_key
in: query
description: The public key file (2048bit) in base64 format (without password
protection).
required: true
schema:
type: string
example: MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAp dkVeG9ypRTuOUq4jocTQBXupcT
wqH/gmCxb5xqdp0Dxrac91VsPmmGTNw0vMrcZfXPzRM26zzkhakA9vKR9TobpML3Tv90Gb43XByHjwipYNBxN/nfjCksXigqfqLUtiUODPfSqdwoUk6PJHAUnCvp8boPGaLFiFvwlPwtjBp8lNb4jgMH3Czbbgk3Q
p zXIEg024WAGnp NrjsNM1xAuP9ON T096iBJaJqX7H2heWGw/7UqR eMtv7/vGilhi9kX2/sgNe5LDdAqdcWjzeCDXVqzqk
rxil kHnAkwJ7eNAi49i4f6Zl6Zyhpf69fI0KOjaCI7QrEXZ1jwLQIDAQAB
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
13008
- Invalid configuration ID
13009 - Invalid key length
13007 -
Invalid public key
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultLCPublicKey'
- $ref: '#/components/schemas/ApiResult'
/api/logscollector/change/status:
post:
tags:
- Traffic Statistics and Logs
summary: Change Logs Collector Configuration Status
description: Change the status of the Logs Collector configuration.
operationId: changeLogsCollectorsConfigStatus
parameters:
- name: config_id
in: query
description: The Logs Collector configuration identifier.
required: true
schema:
type: string
example: 5912
- name: logs_config_new_status
in: query
description: 'The new configuration status of the Logs Collector.
Possible values: ACTIVE, SUSPENDED'
required: true
schema:
type: string
example: ACTIVE
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
13008
- Invalid configuration ID
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/v1/infra/events:
post:
tags:
- Traffic Statistics and Logs
summary: Get Infrastructure Protection Events
description: Use this operation to get Infrastructure Protection event information
for an account
operationId: getInfraEvents
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: event_type
in: query
description: 'A comma separated list of specific event types. Any of: GRE_TUNNEL_UP,
GRE_TUNNEL_DOWN, ORIGIN_CONNECTION_GRE_UP, ORIGIN_CONNECTION_GRE_DOWN, ORIGIN_CONNECTION_ECX_UP,
ORIGIN_CONNECTION_ECX_DOWN, ORIGIN_CONNECTION_CROSS_CONNECT_UP, ORIGIN_CONNECTION_CROSS_CONNECT_DOWN,
DDOS_START_IP_RANGE, DDOS_STOP_IP_RANGE, DDOS_QUIET_TIME_IP_RANGE, EXPORTER_NO_DATA,
EXPORTER_BAD_DATA, EXPORTER_GOOD_DATA, MONITORING_CRITICAL_ATTACK, PROTECTED_IP_STATUS_UP,
PROTECTED_IP_STATUS_DOWN, PER_IP_DDOS_START_IP_RANGE.'
schema:
type: string
example: GRE_TUNNEL_UP
- name: ip_prefix
in: query
description: Specific Protected IP or IP range. For example, 1.1.1.0/24.
schema:
type: string
example: 1.1.1.0/24
- name: page_size
in: query
description: 'The number of objects to return in the response.
Default:
50
Maximum: 100'
schema:
type: string
example: 2
- name: page_num
in: query
description: 'The page to return starting from 0. Default: 0'
schema:
type: string
example: 1
- name: start
in: query
description: 'The start date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
- name: end
in: query
description: 'The end date in milliseconds, since 1970.
Some operations
require the user to specify a time range. This is done via the time_range
parameter, which accepts the following values:
- today
Retrieve data from midnight today until the current time.
- last_7_days
Retrieve data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/InfraEventsApiResponse'
- $ref: '#/components/schemas/ApiResult'
/api/integration/v1/ips:
post:
tags:
- Integrations
summary: Get Imperva IP Ranges
description: Use this operation to get the updated list of Imperva IP ranges.
This list may be used to define firewall rules that restrict access to customers
sites from non-Imperva IPs.
operationId: getIPRanges
parameters:
- name: resp_format
in: query
description: 'Response format.
Possible values: json | apache | nginx
| iptables | text
Default: json'
schema:
type: string
example: json
responses:
'200':
description: res - contains the specific error code:
14001 - Format
invalid
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultIncapsulaRanges'
- $ref: '#/components/schemas/ApiResult'
/api/integration/v1/texts:
post:
tags:
- Integrations
summary: Get Texts
description: Use this operation to retrieve a list of all text messages that
may be part of API responses. For each message a key and a value are provided.
The key is the unique identifier of the message and the value is the message
text itself, in the API's default locale (English).
operationId: getTexts
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResultGetTexts'
/api/integration/v1/geo:
post:
tags:
- Integrations
summary: Get Geographical Info
description: Use this operation to retrieve a list of all the countries and
continents codes.
operationId: getGeoInfo
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GeoInfo'
/api/integration/v1/clapps:
post:
tags:
- Integrations
summary: Get Client Applications Info
description: Use this operation to retrieve a list of all the client applications.
operationId: getClappsInfo
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResultGetClappsInfo'
/api/prov/v1/sites/lp/configure:
post:
tags:
- Login Protect
summary: Add Login Protect User
description: Use this operation to change Login Protect settings for a site.
operationId: modifyLpSiteConfiguration
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: enabled
in: query
description: 'Pass true to enable login protect on site, and false to disable
it.
Default: true'
schema:
type: boolean
example: true
- name: specific_users_list
in: query
description: Comma separated email list to set login protect users for the
site. If the list is empty all users will be allowed to access the site
using Login Protect.
schema:
type: string
example: admin@example.com
- name: send_lp_notifications
in: query
description: 'Pass true to send notification on successful login using login
protect.
Default: false'
schema:
type: boolean
example: true
- name: allow_all_users
in: query
description: 'Pass true to allow all login protect users to access the site.
If you want to allow only a specific list of users to access the site using
Login Protect set this to false, and add the list to specific_user_list.
Default:
true'
schema:
type: boolean
example: true
- name: authentication_methods
in: query
description: 'Comma separated list of allowed authentication methods: sms
| email | ga'
schema:
type: string
example: sms
- name: urls
in: query
description: A comma separated list of resource paths. For example, /home
and /admin/index.html are resource paths, while http://www.example.com/home
is not. Each URL should be encoded separately using percent encoding as
specified by RFC 3986 (http://tools.ietf.org/html/rfc3986#section-2.1).
An empty URL list will remove all URLs.
schema:
type: string
example: /home
- name: url_patterns
in: query
description: 'A comma separated list of url patterns. Possible values: contains
| equals | prefix | suffix | not_equals | not_contain | not_prefix | not_suffix.
The patterns should be in accordance with the matching urls sent by the
urls parameter.'
schema:
type: string
example: prefix
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id18001 - Format invalid
18002 - Application invalid
18011
- Invalid SMS Text
9403 - Unknown/unauthorized account_id
1001
- E-mail invalid
18003 - Invalid phone number
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/lp/configure-app:
post:
tags:
- Login Protect
summary: Configure Login Protect on Admin Areas
description: Use this operation to configure Login Protect on wordpress | joomla
| phpbb admin areas.
operationId: configureProtectedAppByLp
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: protected_app
in: query
description: Protect admin areas of joomla | wordpress | phpBB.
schema:
type: string
example: wordpress
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
18001 - Format invalid
18002 - Application invalid
18011
- Invalid SMS Text
9403 - Unknown/unauthorized account_id
1001
- E-mail invalid
18003 - Invalid phone number
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/lp/add-user:
post:
tags:
- Login Protect
summary: Add Login Protect User
description: Use this operation to add a Login Protect user for a site.
operationId: addLpUser
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
- name: email
in: query
description: Email address.
required: true
schema:
type: string
example: admin@example.com
- name: name
in: query
description: 'Example: John Smith'
schema:
type: string
example: John Smith
- name: phone
in: query
description: 'Phone number. For example: "1-8662507659"'
schema:
type: string
example: 1-8662507659
- name: is_phone_verified
in: query
description: Whether or not to skip phone verification.
schema:
type: boolean
example: true
- name: is_email_verified
in: query
description: Whether or not to skip email address verification.
schema:
type: boolean
example: true
- name: should_send_activation_email
in: query
description: Whether or not to send activation email to user.
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:9403 - Unknown/unauthorized
account_id
1001 - E-mail invalid18005 - Login Protect User Exists18006
- Operation Not Allowed18009 - Not Supported Action
18004 - Failed
to Send E-Mail
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/lp/users:
post:
tags:
- Login Protect
summary: Get Login Protect Users
description: Use this operation to get the account's login protect user list.
operationId: getLpUsers
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
18003 - Invalid
phone number18004 - Failed to Send E-Mail
9403 - Unknown/unauthorized
account_id
1001 - E-mail invalid18005 - Login Protect User Exists
18006
- Operation Not Allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/LoginProtectUsersApiResults'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/lp/edit-user:
post:
tags:
- Login Protect
summary: Edit Login Protect User
description: Edit Login Protect user's settings.
operationId: editLpUser
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
- name: email
in: query
description: Email address.
required: true
schema:
type: string
example: admin@example.com
- name: name
in: query
description: 'Example: John Smith'
schema:
type: string
example: John Smith
- name: phone
in: query
description: 'Phone number. For example: "1-8662507659"'
schema:
type: string
example: 1-8662507659
- name: is_phone_verified
in: query
description: Whether or not to skip phone verification.
schema:
type: boolean
example: true
- name: is_email_verified
in: query
description: Whether or not to skip email address verification.
schema:
type: boolean
example: true
- name: should_send_activation_email
in: query
description: Whether or not to send activation email to user.
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account_id
1001 - E-mail invalid
18005 - Login Protect User Exists
18006
- Operation Not Allowed
18009 - Not Supported Action18004 -
Failed to Send E-Mail
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/lp/send-sms:
post:
tags:
- Login Protect
summary: Send SMS to User
description: Use this operation to send an SMS to a login protect user.
operationId: sendSms
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
- name: email
in: query
description: Email address.
required: true
schema:
type: string
example: admin@example.com
- name: sms_text
in: query
description: Text that will be sent in SMS.
required: true
schema:
type: string
example: hello
responses:
'200':
description: res - contains the specific error code:
18003 -Invalid
phone number
18011 - Invalid SMS Text
9403 - Unknown/unauthorized
account_id
18010 - Invalid User
18007 - Exceeded Allowed SMS
18008
- Failed to Send SMS
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/lp/remove:
post:
tags:
- Login Protect
summary: Remove Login Protect User
description: Use this operation to remove a login protect user from an account's
user list.
operationId: removeLpUser
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
- name: email
in: query
description: Email address.
required: true
schema:
type: string
example: admin@example.com
responses:
'200':
description: res - contains the specific error code:
18003 - Invalid
phone number
18004 - Failed to Send E-Mail
9403 - Unknown/unauthorized
account_id
1001 - E-mail invalid
18005 - Login Protect User Exists
18006
- Operation Not Allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/add:
post:
tags:
- Site Management
summary: Add data center
description: Use this operation for adding data center to site.
operationId: addDataCenter
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: name
in: query
description: The new data center's name.
required: true
schema:
type: string
example: DataCenter
- name: server_address
in: query
description: 'The server''s address. Possible values: IP, CNAME'
required: true
schema:
type: string
example: 1.1.1.1
- name: lb_algorithm
in: query
description: Data center load balancing algorithm. Possible values are:
LB_LEAST_PENDING_REQUESTS
- Server with least pending requests
LB_LEAST_OPEN_CONNECTIONS - Server
with least open connections
LB_SOURCE_IP_HASH - Server by IP hash
RANDOM
- Random server
WEIGHTED - Server by weight
schema:
type: string
enum:
- LB_LEAST_PENDING_REQUESTS
- LB_LEAST_OPEN_CONNECTIONS
- LB_SOURCE_IP_HASH
- RANDOM
- WEIGHTED
example: LB_LEAST_PENDING_REQUESTS
- name: is_enabled
in: query
description: Enables the data center.
schema:
type: boolean
example: true
- name: is_content
in: query
description: The data center will be available for specific resources (Forward
Delivery Rules).
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
2 - a datacenter
with that name already exists
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/DataCenterResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/edit:
post:
tags:
- Site Management
summary: Edit site
description: Use this operation to editing site's data center
operationId: editDataCenter
parameters:
- name: dc_id
in: query
description: The data center's ID.
required: true
schema:
type: integer
format: int64
example: 10
- name: name
in: query
description: The new data center's name.
schema:
type: string
example: DataCenter
- name: is_enabled
in: query
description: Enables the data center.
schema:
type: boolean
example: true
- name: is_standby
in: query
description: Defines the data center as standby for failover.
schema:
type: boolean
example: true
- name: is_content
in: query
description: The data center will be available for specific resources (Forward
Delivery Rules).
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
9413 -invalid datacenter2-
datacenter with that name already exists
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/DataCenterResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/resume:
post:
tags:
- Site Management
summary: Resume traffic to your active data centers
description: When at least one active data center is back up, you have to manually
reroute your traffic back to the active data center.
Traffic does not
revert automatically to your active data centers.
operationId: resumeTrafficToActiveDCs
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 -Unknown/unauthorized
site_id
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/delete:
post:
tags:
- Site Management
summary: delete site
description: Use this operation for deleting site datacenter.
operationId: deleteDataCenter
parameters:
- name: dc_id
in: query
description: The data center's ID.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
5 -Could not delete
datacenter2- invalid datacenter9415- invalid.dc.state
3011
- There must be at least one active data center not configured for forward
rules in the site
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/DataCenterResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/servers/add:
post:
tags:
- Site Management
summary: 'Add datacenter '
description: Use this operation to adding datacenter server.
operationId: addDCServer
parameters:
- name: dc_id
in: query
description: The data center's ID.
required: true
schema:
type: integer
format: int64
example: 10
- name: server_address
in: query
description: Server IP address.
required: true
schema:
type: string
example: 1.1.1.1
- name: is_disabled
in: query
description: Enables the data center
schema:
type: boolean
example: true
- name: is_standby
in: query
description: Set the server as Active (P0) or Standby (P1) (Boolean).
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
1 -General error2-
invalid datacenter
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ServerOperationResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/servers/delete:
post:
tags:
- Site Management
summary: 'Delete datacenter '
description: Use this operation to deleting datacenter server.
operationId: deleteDCServer
parameters:
- name: server_id
in: query
description: Server ID.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
9415 -invalid.server.state2-
invalid datacenter
1 - Unexpected error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ServerOperationResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/servers/edit:
post:
tags:
- Site Management
summary: Edit datacenter
description: Use this operation to editing datacenter server.
operationId: editDCServer
parameters:
- name: server_id
in: query
description: Server ID.
required: true
schema:
type: integer
format: int64
example: 10
- name: server_address
in: query
description: The IP address of the server to modify.
schema:
type: string
example: 1.1.1.1
- name: is_enabled
in: query
description: Enable or disable the server (Boolean).
schema:
type: boolean
example: true
- name: is_standby
in: query
description: Set the server as Active (P0) or Standby (P1) (Boolean).
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
9415 -invalid.server.state2-
invalid datacenter
1 -Unexpected error
9413 -invalid server
1
-General error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ServerOperationResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/dataCenters/list:
post:
tags:
- Site Management
summary: List site's data centers
description: Use this operation for listing site's data centers including datacenters
servers.
operationId: listDataCenters
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - invalid
site2 - invalid datacenter
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ListDataCenterResponse'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/datacenter/origin-pop/modify:
post:
tags:
- Site Management
summary: Set Data Center Origin PoP
description: Set an origin PoP for a given data center.
operationId: setDataCenterOriginPoP
parameters:
- name: dc_id
in: query
description: Numeric identifier of the data center to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: origin_pop
in: query
description: 'The ID of the PoP that serves as an access point between Imperva
and the customer’s origin server. For example: “lax”, for Los Angeles.'
schema:
type: string
example: lax, for Los Angeles
responses:
'200':
description: res - contains the specific error code:
405 - Api is disabled2
- invalid datacenter
5 - Cant set Origin PoP for datacenter
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/datacenter/origin-pop/recommend:
post:
tags:
- Site Management
summary: Get Data Center Recommended Origin PoPs
description: Get a list of recommended origin PoPs for a given data center.
operationId: getRecommendedDataCenterOriginPoPs
parameters:
- name: dc_id
in: query
description: Numeric identifier of the data center to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
405 - Api is disabled2-
invalid datacenter
5 - Cant set Origin PoP for datacenter
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/RecommendedPopsApiResult'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache-mode:
post:
tags:
- Site Management
summary: Modify Caching Mode
description: Use this operation to edit basic site caching settings.
operationId: setCachingMode
parameters:
- name: cache_mode
in: query
description: 'Possible values:
disablecustom_cache_rules_onlystatic_onlystatic_and_dynamicaggressiveDefault
value: static_only'
required: true
schema:
type: string
example: static_and_dynamic
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: dynamic_cache_duration
in: query
description: 'Profile dynamic pages and cache duration. Pass a number followed
by ''_'' and one of: hr | min | sec | days | weeks.Default: 5_min'
schema:
type: string
example: 5_min
- name: aggressive_cache_duration
in: query
description: 'Cache resource duration. Pass a number followed by ''_'' and
one of: hr | min | sec | days | weeksDefault: 1_hr'
schema:
type: string
example: 1_hr
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache-mode/get:
post:
tags:
- Site Management
summary: Get Caching Mode
description: Use this operation to get a site's caching mode.
operationId: getCachingMode
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetCacheMode'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/purge:
post:
tags:
- Site Management
summary: Purge Resources
description: Use this operation to purge site resources.
operationId: modifyPurgeSettings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: resource_url
in: query
description: Comma separated list of URLs where the resource is located.
required: true
schema:
type: string
example: /home
- name: resource_pattern
in: query
description: 'Comma separated list of pattern. One of: contains | equals |
prefix | suffix | not_equals | not_contains | not_prefix | not_suffix'
required: true
schema:
type: string
example: prefix
- name: should_purge_all_site_resources
in: query
description: 'Should purge all cached resources on site.Possible values:If
the parameter does not exist, is null, or an empty string, it is ignored
and only specific resources defined by the resource_pattern and resource_url
parameters are purged.true or TRUE: All site resources
are purged.false or FALSE: Nothing is done.Any other
string: An error is returned.'
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
3015 - Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/cache/purge:
post:
tags:
- Site Management
summary: Purge Site Cache
description: Use this operation to purge all cached content on our proxy servers
for a specific site.
Our Proxy servers keep cached content of your sites
in order to accelerate page load times for your users.
When you want this
cached content to be refreshed (for example, after making adjustments in your
site) you can use this API call.
In order to purge the entire cached content
for this site just use the API call with no parameters.
If you want to
purge a specific resource add the resource name as parameter.
operationId: purgeSiteCache
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: purge_pattern
in: query
description: The pattern of the resource to be purged from the cache. For
example:Resource_name - Resources that contain Resource_name
will be purged^Resource_name - Resources that start with
Resource_name will be purgedResource_name$ - Resources that
end with Resource_name will be purged.
schema:
type: string
- name: purge_tag_names
in: query
description: A comma separated list of tag names to purge.
schema:
type: string
responses:
'200':
description: res - contains the specific error code:
5010 - Pattern
invalid
9413 - Unknown/unauthorized site_id.
9415 - Operation
not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/response-headers:
post:
tags:
- Site Management
summary: Modify Cached Response Headers
description: Use this operation to modify cached response headers.
operationId: modifyResponseHeaderSettings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: cache_headers
in: query
description: Comma separated list of header names to be cached
schema:
type: string
example: h1
- name: cache_all_headers
in: query
description: Cache all response headers. Pass "true" or "false" in the value
parameter. Cannot be selected together with cache_headers. Default:false
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/response-headers/get:
post:
tags:
- Site Management
summary: Get Cached Response Headers
description: Use this operation to get a site's cached response headers.
operationId: getResponseHeaderSettings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
5 - Operation is unavailable
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetResponseHeaderSettings'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/tag-response:
post:
tags:
- Site Management
summary: Tag the Response According to the Value of a Header
description: Specify which origin response header contains the cache tags in
your resources.
operationId: modifyTagResponseHeader
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: header
in: query
description: 'Specify which origin response header contains the cache tags
in your resources. default: "".'
required: true
schema:
type: string
example: cache
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/tag-response/get:
post:
tags:
- Site Management
summary: Get Header to Tag Responses By
description: Get the origin response header containing the cache tags in your
resources
operationId: getTagResponseHeader
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetTagResponseHeader'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache404/modify:
post:
tags:
- Site Management
summary: Modify Cache 404 Settings
description: Use this operation to modify the caching settings of 404 responses
for a site.
operationId: modifyCache404Settings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: enable
in: query
description: Pass 'true' to cache 404 responses, 'false' to disable the option.
required: true
schema:
type: string
example: true
- name: time
in: query
description: 'A positive number representing the amount of time to cache 404
responses. Default value: 10'
schema:
type: string
example: 10
- name: time_unit
in: query
description: 'Unit of time for caching 404 responses. One of MINUTES, HOURS,
DAYS, WEEKS. Default value: HOURS'
schema:
type: string
example: HOURS
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache404:
post:
tags:
- Site Management
summary: Get Cache 404 Settings
description: Use this operation to get the caching settings of 404 responses
for a site.
operationId: getCache404Settings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/GetCache404SettingsApiResult'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/pop-level-cache/modify:
post:
tags:
- Site Management
summary: Modify PoP Level Cache
description: Use this operation to modify the PoP level cache status for a site.
operationId: modifyPopLevelCache
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: enable
in: query
description: Pass 'true' to enable pop level cache, 'false' to disable the
option.
required: true
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/pop-level-cache:
post:
tags:
- Site Management
summary: Get PoP Level Cache
description: Use this operation to get the PoP level cache status for a site.
operationId: getPopLevelCache
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/GetPopLevelCacheSettingsApiResult'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/resource-map-size/modify:
post:
tags:
- Site Management
summary: Set Resource Map Size
description: Set the site's maximum number of cached resources.
operationId: setResourceMapSize
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: resource_map_size
in: query
description: Limit for the amount of cached resources.
required: true
schema:
type: string
example: 34000
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/resource-map-size:
post:
tags:
- Site Management
summary: Get Resource Map Size
description: Get the site's maximum number of cached resources.
operationId: getResourceMapSize
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetResourceMapSize'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache-size-limit-large-mem/modify:
post:
tags:
- Site Management
summary: Set Total Cache Size
description: Set the site's limit for the total size of cache.
operationId: setCacheSizeLimitLargeMem
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: cache_size_limit_large_mem
in: query
description: A positive number representing limit for total size of cached
resources.
required: true
schema:
type: string
example: 500
- name: cache_size_limit_large_mem_unit
in: query
description: Unit of the limit for total size of cached resources. One of
BYTES, KB, MB.
required: true
schema:
type: string
example: BYTES
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache-size-limit-large-mem:
post:
tags:
- Site Management
summary: Get Total Cache Size
description: Get the site's limit for the total size of cache.
operationId: getCacheSizeLimitLargeMem
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetCacheSizeLimitLargeMem'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/max-resp-size/modify:
post:
tags:
- Site Management
summary: Set Response Max Size
description: Set the site's limit for the size of a single file returned from
the cache.
operationId: setMaxRespSize
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: max_resp_size
in: query
description: A positive number representing limit for the size of cached resources.
required: true
schema:
type: string
example: 20971520
- name: max_resp_size_unit
in: query
description: Unit of the limit for the size of cached resources. One of BYTES,
KB, MB.
required: true
schema:
type: string
example: BYTES
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/max-resp-size:
post:
tags:
- Site Management
summary: Get Response Max Size
description: Get the site's limit for the size of a single file returned from
the cache.
operationId: getMaxRespSize
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetMaxRespSize'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/secure-resources:
post:
tags:
- Site Management
summary: Modify Secure Resources Mode
description: Use this operation to modify the Secure Resources mode for a site.
operationId: setSecureResourcesMode
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: secured_resources_mode
in: query
description: do_not_cache - Do not cache HTTPS resources
defaults
- Use default HTTPS caching. Do not cache HTML pages
defaults_with_html
- Use default HTTPS caching. Also cache HTML pages
general -
Cache HTTPS according to general caching settings
required: true
schema:
type: string
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/secure-resources/get:
post:
tags:
- Site Management
summary: Get Secure Resources Mode
description: Use this operation to get the Secure Resources mode for a site.
operationId: getSecureResourcesMode
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetSecureResources'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/stale-content:
post:
tags:
- Site Management
summary: Modify Stale Content Settings
description: When Imperva can't connect to the origin server, serve stale content
instead of displaying an error to end users for the specified amount of time.
Expired resources are returned from cache, and refreshed asynchronously in
the background.
operationId: modifyStaleContent
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: serve_stale_content
in: query
description: Pass true to serve stale content, false to disable
the option.
required: true
schema:
type: string
example: true
- name: stale_content_mode
in: query
description: Pass ADAPTIVE to use Imperva's algorithm, or CUSTOM
to specify an amount of time. When using CUSTOM, you must specify
the time and time_unit parameters.
schema:
type: string
example: ADAPTIVE
- name: time
in: query
description: A positive number representing the amount of time to serve stale
content.
schema:
type: string
example: 10
- name: time_unit
in: query
description: Stale content time unit. One of SECONDS, MINUTES, HOURS.
schema:
type: string
example: MINUTES
responses:
'200':
description: 'res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
5
- Operation unavailable '
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/stale-content/get:
post:
tags:
- Site Management
summary: Get Stale Content Settings
description: When Imperva can't connect to the origin server, serve stale content
instead of displaying an error to end users for the specified amount of time.
Expired resources are returned from cache, and refreshed asynchronously in
the background.
operationId: getStaleContent
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/GetStaleContentApiResult'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/advanced:
post:
tags:
- Site Management
summary: Advanced Caching Settings
description: Use this operation to modify advanced caching settings.
operationId: modifyAdvancedCachingSettings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: param
in: query
description: 'Name of configuration parameter to set.
Possible values
for param and value parameters:
- async_validation Sets
Async validation. Pass "true" or "false" in the value parameter.
- minify_javascript
Sets the Minify JS. Pass "true" or "false" in the value parameter.
- minify_css
Sets the Minify CSS. Pass "true" or "false" in the value parameter
- minify_static_html
Sets Minify static HTML. Pass "true" or "false" in the value parameter
- compress_jpeg
Sets the Compress JPEG. Pass "true" or "false" in the value parameter.
- progressive_image_rendering
Sets the Progressive Image rendering flag. Pass "true" or "false" in the
value parameter.
- aggressive_compression Sets the Aggressive
compression rendering flag. Pass "true" or "false" in the value parameter.
- compress_png
Sets the Compress PNG flag. Pass "true" or "false" in the value parameter.
- on_the_fly_compression
"On the fly" Compression. Pass "true" or "false" in the value parameter.
- tcp_pre_pooling
TCP Pre-Pooling. Pass "true" or "false" in the value parameter.
- comply_no_cache
Comply with no-cache and max-age directives in client requests. Pass "true"
or "false" in the value parameter.
- comply_vary Comply with
the Vary header. Pass "true" or "false" in the value parameter.
- use_shortest_caching
Use shortest caching duration in case of conflicts. Pass "true" or "false"
in the value parameter.
- prefer_last_modified Prefer ''last
modified'' over eTag. Pass "true" or "false" in the value parameter.
- disable_client_side_caching
Disable client side caching. Pass "true" or "false" in the value parameter.
- cache_300x
Cache 300X responses. Pass "true" or "false" in the value parameter.
- unite_naked_full_cache
Use the same cache for full and naked domains. For example, use the same
cached resource for and a.
- cache_empty_responses
Cache responses that don’t have a message body.
- cache_http_10_responses
Cache HTTP 1.0 type responses that don’t include the Content-Length header
or chunking. Pass "true" or "false" in the value parameter.
- send_age_header
Send Cache-Control: max-age and Age headers. Pass "true" or
"false" in the value parameter.
- support_non_sni_clients By
default, non-SNI clients are supported. Disable this option to block non-SNI
clients. Pass "true" or "false" in the value parameter.
- origin_connection_reuse
By default, TCP connections that are opened for a client request remain
open for a short time to handle additional requests that may arrive. This
option disables that behavior.. Pass "true" or "false" in the value parameter.
- redirect_http_to_https
Redirect HTTP requests to HTTPS requests by sending an HTTP 301 response.
- redirect_naked_domain_to_full
Redirect requests from your website''s naked domain to its full domain by
sending and HTTP 301 response.
- http_2 Enables supporting
browsers to take advantage of the performance enhancements provided by HTTP/2
for your website. Non-supporting browsers can connect via HTTP/1.0 or HTTP/1.1.
HTTP/2 support requires that SSL is configured for your website. Pass "true"
or "false" in the value parameter
'
required: true
schema:
type: string
example: async_validation
- name: value
in: query
description: According to the param value.
required: true
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
5 - Operation unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/advanced/get:
post:
tags:
- Site Management
summary: Get Advanced Caching Settings
description: Use this operation to get advanced caching settings.
operationId: getAdvancedCachingSettings
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: param
in: query
description: 'Name of configuration parameter to set.
Possible values
for param and value parameters:
- async_validation Sets
Async validation. Pass "true" or "false" in the value parameter.
- minify_javascript
Sets the Minify JS. Pass "true" or "false" in the value parameter.
- minify_css
Sets the Minify CSS. Pass "true" or "false" in the value parameter
- minify_static_html
Sets Minify static HTML. Pass "true" or "false" in the value parameter
- compress_jpeg
Sets the Compress JPEG. Pass "true" or "false" in the value parameter.
- progressive_image_rendering
Sets the Progressive Image rendering flag. Pass "true" or "false" in the
value parameter.
- aggressive_compression Sets the Aggressive
compression rendering flag. Pass "true" or "false" in the value parameter.
- compress_png
Sets the Compress PNG flag. Pass "true" or "false" in the value parameter.
- on_the_fly_compression
"On the fly" Compression. Pass "true" or "false" in the value parameter.
- tcp_pre_pooling
TCP Pre-Pooling. Pass "true" or "false" in the value parameter.
- comply_no_cache
Comply with no-cache and max-age directives in client requests. Pass "true"
or "false" in the value parameter.
- comply_vary Comply with
the Vary header. Pass "true" or "false" in the value parameter.
- use_shortest_caching
Use shortest caching duration in case of conflicts. Pass "true" or "false"
in the value parameter.
- prefer_last_modified Prefer ''last
modified'' over eTag. Pass "true" or "false" in the value parameter.
- disable_client_side_caching
Disable client side caching. Pass "true" or "false" in the value parameter.
- cache_300x
Cache 300X responses. Pass "true" or "false" in the value parameter.
- unite_naked_full_cache
Use the same cache for full and naked domains. For example, use the same
cached resource for and a.
- cache_empty_responses
Cache responses that don’t have a message body.
- cache_http_10_responses
Cache HTTP 1.0 type responses that don’t include the Content-Length header
or chunking. Pass "true" or "false" in the value parameter.
- send_age_header
Send Cache-Control: max-age and Age headers. Pass "true" or
"false" in the value parameter.
- support_non_sni_clients By
default, non-SNI clients are supported. Disable this option to block non-SNI
clients. Pass "true" or "false" in the value parameter.
- origin_connection_reuse
By default, TCP connections that are opened for a client request remain
open for a short time to handle additional requests that may arrive. This
option disables that behavior.. Pass "true" or "false" in the value parameter.
- redirect_http_to_https
Redirect HTTP requests to HTTPS requests by sending an HTTP 301 response.
- redirect_naked_domain_to_full
Redirect requests from your website''s naked domain to its full domain by
sending and HTTP 301 response.
- http_2 Enables supporting
browsers to take advantage of the performance enhancements provided by HTTP/2
for your website. Non-supporting browsers can connect via HTTP/1.0 or HTTP/1.1.
HTTP/2 support requires that SSL is configured for your website. Pass "true"
or "false" in the value parameter
'
required: true
schema:
type: string
example: async_validation
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/GetAdvancedCachingSettingsApiResult'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/xray/get-link:
post:
tags:
- Site Management
summary: Get XRay Access Link
description: 'Use this operation to get a URL that enables debug headers on
the specific site. '
operationId: getXrayLink
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
1 - Unexpected
error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetSiteXrayLink'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache-shield/enable:
post:
tags:
- Site Management
summary: Enable Cache Shield
description: Enable Cache Shield for a given site.
operationId: enableCacheShield
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: enable
in: query
description: Use true to enable cache shield on the specified site,
and false to disable it.
required: true
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
1 - Unexpected error
405 - Api
is disabled
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/cache-shield:
post:
tags:
- Site Management
summary: Is Cache Shield Enabled
description: Get the enablement state of the Cache Shield feature for a given
site.
operationId: isCacheShieldEnabled
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/IsCacheShieldEnabledApiResult'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/rewrite-port/modify:
post:
tags:
- Site Management
summary: Modify Rewrite Port
description: Use this operation to rewrite the port number used to access the
origin server.
operationId: modifyRewritePorts
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: rewrite_port_enabled
in: query
description: Boolean value to indicate whether the default non-SSL port should
be rewritten or not
required: true
schema:
type: boolean
example: true
- name: port
in: query
description: The port number. If empty, rewrite port will be removed
schema:
type: string
example: 80
- name: rewrite_ssl_port_enabled
in: query
description: Boolean value to indicate whether the default SSL port should
be rewritten or not
required: true
schema:
type: boolean
example: true
- name: ssl_port
in: query
description: The port number to rewrite default SSL port to
schema:
type: string
example: 443
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/rewrite-port:
post:
tags:
- Site Management
summary: Get Rewrite Port
description: Use this operation to get the rewritten port number used to access
the origin server.
operationId: getRewritePorts
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultGetRewritePorts'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/error-page/modify:
post:
tags:
- Site Management
summary: Modify Error Page
description: Use this operation to set a custom error page for a given site.
operationId: modifySiteErrorPageTemplate
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: error_page_template
in: query
description: The error page html template. $TITLE$ and $BODY$ placeholders
are required.
required: true
schema:
type: string
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9413
- Unknown/unauthorized site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/performance/error-page:
post:
tags:
- Site Management
summary: Get Error Page
description: Use this operation to get the custom error page for a given site.
operationId: getSiteErrorPageTemplate
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/status:
post:
tags:
- Site Management
summary: Get Site Status
description: Use this operation to get the status of a site.
operationId: siteStatus
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: tests
in: query
description: 'List of tests to run on site before returning its status.
A
comma separated list of one of: domain_validation, services, dns
Values
for the stats parameters:
- domain_validation Runs the
domain validation test on the specified site. This test will check for HTML
meta tag or DNS records, according to the selected domain validation method.
- services
Runs the services test on the specified site. This test will check the availability
of HTTP and HTTPS connections on the site.
- dns Runs the DNS
test on the specified site. This test will check whether the site owner
performed the DNS changes required in order to protect the site.
'
schema:
type: string
example: domain_validation
responses:
'200':
description: res - contains the specific error code:
3001 - Domain invalid
6002
- Invalid configuration parameter value
9415 - Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/list:
post:
tags:
- Site Management
summary: List Sites
description: List sites for an account
operationId: listSites
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
If the account has sub accounts, the operation returns results
for the sites in the account and in all of its sub accounts.
schema:
type: string
example: 15
- name: page_size
in: query
description: 'The number of objects to return in the response. Default is
50. Maximum: 100'
schema:
type: string
example: 2
- name: page_num
in: query
description: he page to return starting from 0. Default is 0
schema:
type: string
example: 1
responses:
'200':
description: res - contains the specific error code:
1 - Unexpected
error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResultListSites'
/api/prov/v1/domain/emails:
post:
tags:
- Site Management
summary: Get Domain Approver E-mail Addresses
description: Use this operation to get the list of email addresses that can
be used when adding an SSL site.
operationId: domainEmails
parameters:
- name: domain
in: query
description: 'The domain name of the site. For example: www.example.com,
www.example.com, www.example.com'
required: true
schema:
type: string
example: www.example.com
responses:
'200':
description: res - contains the specific error code:
3001 - Domain invalid
3011
- Site unresolvable
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultDomainEmails'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/setlog:
post:
tags:
- Site Management
summary: Modify Site Logs Level
description: Use this operation to change the site log configuration.
operationId: modifySiteLogLevel
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: log_level
in: query
description: 'Available only for customers that purchased the Logs Integration
SKU. Sets the log reporting level for the site.
Possible values: full,
security, none, default'
required: true
schema:
type: string
example: full
- name: logs_account_id
in: query
description: Available only for customers that purchased the Logs Integration
SKU. Numeric identifier of the account that purchased the logs integration
SKU and which collects the logs.
If not specified, operation will be
performed on the account identified by the authentication parameters
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
6002
- Invalid configuration parameter name
6001 - Invalid configuration
parameter name
9415 - Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/tls:
post:
tags:
- Site Management
summary: Set support for all TLS versions
description: Use this operation to support all TLS versions for the site for
connectivity between clients (visitors) and the Imperva service. To remain
PCI-compliant, do not enable this option.
operationId: modifySiteSupportDeprecatedTLS
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 10
- name: support_all_tls_versions
in: query
description: 'Support all TLS versions. Default value: false'
required: true
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
5 - Operation unavailable
9415
- Operation not allowed
1 - Unexpected error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSetSupportDeprecatedTLSForSite'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/configure:
post:
tags:
- Site Management
summary: Modify Site Configuration
description: Use this operation to change one of the basic configuration settings
of the site.
operationId: modifySiteConfiguration
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: example.imperva.com
- name: param
in: query
description: 'Name of configuration parameter to set.
Parameter values:
- active
Whether the site is active or bypassed by the Imperva network. One of: active
| bypass.
- site_ip Comma separated list of IPs. For example:
8.8.8.8,1.2.2.2
- domain_validation Sets the domain validation
method that will be used to generate an SSL certificate. One of: email |
html | dns
Note: When running domain validation on a site, you
may see the following error message in the API response: Internal error
- "Add site operation hasn''t finished".
After running the add site
process, it may take several minutes for the database to finish updating.
During this time, attempts to further configure the site are blocked.
In
some cases, the database is not updated even after the add site process
is complete.
If the issue does not resolve after a few minutes, contact
Support. - approver Sets the approver e-mail address that will
be used to perform SSL domain validation.
- ignore_ssl Sets
the ignore SSL flag (if the site is in pending-select-approver state). Pass
"true" in the value parameter.
- acceleration_level Sets the
acceleration level of the site, one of: none | standard | aggressive. It
is advised to use the newer Modify caching mode API call instead, as it
provides enhanced functionality.
- seal_location Sets the seal
location, e.g. "api.seal_location.bottom_right".
- domain_redirect_to_full
Sets the redirect naked to full flag. Pass "true" in the value parameter.
- remove_ssl
Sets the remove SSL from site flag. Pass "true" in the value parameter.
- ref_id
Sets the Reference ID, a free-text field that enables you to add a unique
identifier to correlate an object in our service, such as a protected website,
with an object on the customer side.
'
required: true
schema:
type: string
example: active
- name: value
in: query
description: According to the param value.
required: true
schema:
type: string
example: bypass
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
6001 - Invalid configuration parameter name
6002 - Invalid
configuration parameter value
1 - Unexpected error
9414 - Feature
not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/delete:
post:
tags:
- Site Management
summary: Delete Site
description: Delete the site.
operationId: deleteSite
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
schema:
type: string
example: 15
responses:
'200':
description: res - contains the specific error code:
1 - Unexpected
error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/add:
post:
tags:
- Site Management
summary: Add a Site
description: Add a new site to an account. If the site already exists, its status
is returned.
operationId: addSite
parameters:
- name: domain
in: query
description: 'The domain name of the site. For example: www.example.com,
www.example.com, www.example.com'
required: true
schema:
type: string
example: example.imperva.com
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
schema:
type: string
example: 10
- name: ref_id
in: query
description: Customer specific identifier for this operation
schema:
type: string
example: 11
- name: send_site_setup_emails
in: query
description: If this value is false, end users will not get emails about the
add site process such as DNS instructions and SSL setup.
schema:
type: string
example: false
- name: site_ip
in: query
description: Manually set the web server IP/CNAME
schema:
type: string
example: 1.2.3.4
- name: force_ssl
in: query
description: If this value is true, manually set the site to support SSL.
This
option is only available for sites with manually configured IP/CNAME and
for specific accounts.
schema:
type: string
example: true
- name: naked_domain_san
in: query
description: 'Use “true” to add the naked domain SAN to a www site’s SSL certificate.
Default value: true'
schema:
type: string
example: true
- name: wildcard_san
in: query
description: 'Use “true” to add the wildcard SAN or “false” to add the full
domain SAN to the site’s SSL certificate. Default value: true'
schema:
type: string
example: true
- name: log_level
in: query
description: Available only for customers that purchased the Logs Integration
SKU.
Sets the log reporting level for the site. Options are “full”,
“security”, “none” and default
schema:
type: string
example: full
- name: logs_account_id
in: query
description: Available only for customers that purchased the Logs Integration
SKU.
Numeric identifier of the account that purchased the logs integration
SKU and which collects the logs.
If not specified, operation will be
performed on the account identified by the authentication parameters
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
3001 - Domain invalid
3002
- Site is on the CloudFlare network
3003 - Site requires SSL
3004
- Domain belongs to a known service3005 - Site is on a service
3006
- Site requires multiple IPs support
3011 - Site unresolvable
3012
- Site unreachable
3013 -Site already protected by the service
3014
- Number of allowed sites exceeded.
3015 - Internal error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/configure/acl:
post:
tags:
- Site Management
summary: Modify Site Access Control List (ACL) Configuration
description: Use this operation to change the ACL configuration of a site. To
modify the configuration for a specific ACL rule, its values are required,
as documented below. To delete an entire ACL list, send an empty string as
the list values.
operationId: modifySiteAclConfiguration
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 15
- name: rule_id
in: query
description: The id of the acl, e.g api.acl.blacklisted_ips.
Values for
the rule_id parameter:
- api.acl.blacklisted_countries
Visitors from denylisted countries and/or continents.
- api.acl.blacklisted_urls
Visitors from denylisted URLs.
- api.acl.blacklisted_ips Visitors
from denylisted IPs.
- api.acl.whitelisted_ips Visitors from
allowlisted IPs.
required: true
schema:
type: string
example: 548723
- name: urls
in: query
description: A comma separated list of resource paths. For example, /home
and /admin/index.html are resource paths, however http://www.example.com/home
is not. Each URL should be encoded separately using percent encoding as
specified by RFC 3986 (http://tools.ietf.org/html/rfc3986#section-2.1).
An empty URL list will remove all URLs
schema:
type: string
example: /home
- name: url_patterns
in: query
description: 'A comma separated list of url patterns, one of: contains | equals
| prefix | suffix | not_equals | not_contain | not_prefix | not_suffix.
The patterns should be in accordance with the matching urls sent by the
urls parameter'
schema:
type: string
example: contains
- name: countries
in: query
description: A comma separated list of country codes
schema:
type: string
example: US
- name: continents
in: query
description: A comma separated list of continent codes
schema:
type: string
example: SA
- name: ips
in: query
description: 'A comma separated list of IPs or IP ranges, e.g: 192.168.1.1,
192.168.1.1-192.168.1.100 or 192.168.1.1/24'
schema:
type: string
example: 192.168.1.1/24
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
1
- Unexpected error
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/data-privacy/show:
post:
tags:
- Site Management
summary: Get Site Data Storage Region
description: Use this operation to get the site data region.
operationId: getDataRegion
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9415
- Operation not allowed
14002 - No region for account
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSetDataRegion'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/configure/allowlist:
post:
tags:
- Site Management
summary: Modify Allow Lists Configuration
description: Use this operation to set allow lists to security rules or ACLs.
To update an existing allow list, send its ID in the id parameter. If the
id parameter does not exist a new allow list will be created.
operationId: modifySiteAllowListsConfiguration
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: string
example: 15
- name: rule_id
in: query
description: The id of the rule (either a security or an acl rule), e.g api.threats.sql_injection,
api.threats.cross_site_scripting, api.threats.illegal_resource_access
required: true
schema:
type: string
example: 548723
- name: allowlist_id
in: query
description: The id (an integer) of the allow list to be set. This field is
optional - in case no id is supplied, a new allow list will be created.
required: true
schema:
type: string
example: 433245
- name: delete_allowlist
in: query
description: An optional boolean parameter. If it is set to "true" and a allow
list id is sent, the allow list will be deleted.
schema:
type: string
example: false
- name: urls
in: query
description: A comma separated list of resource paths.For example, /home
and /admin/index.html are resource paths, while http://www.example.com/home
is not.Each URL should be encoded separately using percent encoding
as specified by RFC 3986 (http://tools.ietf.org/html/rfc3986#section-2.1).
An
empty URL list will remove all URLs.
schema:
type: string
example: /home
- name: countries
in: query
description: A comma separated list of country codes.
schema:
type: string
example: US
- name: continents
in: query
description: A comma separated list of continent codes.
schema:
type: string
example: SA
- name: ips
in: query
description: 'A comma separated list of IPs or IP ranges, e.g: 192.168.1.1,
192.168.1.1-192.168.1.100 or 192.168.1.1/24'
schema:
type: string
example: 192.168.1.1/24
- name: client_app_types
in: query
description: A comma separated list of client application types
schema:
type: string
example: Browser
- name: client_apps
in: query
description: A comma separated list of client application IDs.
schema:
type: string
example: 3
- name: parameters
in: query
description: A comma separated list of encoded parameters.
schema:
type: string
- name: user_agents
in: query
description: A comma separated list of encoded user agents.
schema:
type: string
example: Googlebot-2.1
- name: exception_id_only
in: query
description: Return only the new/edited exception id.
schema:
type: string
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input.
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/configure/security:
post:
tags:
- Site Management
summary: Modify Site Security Configuration
description: Use this operation to change the security configuration of a site.
To modify the configuration for a specific rule, additional parameters may
be required, as documented below.
operationId: modifySiteSecurityConfiguration
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 15
- name: rule_id
in: query
description: ID of the security rule to change.
Values for the rule_id
parameter:
- api.threats.bot_access_control
- api.threats.sql_injection
- api.threats.cross_site_scripting
- api.threats.backdoor
- api.threats.ddos
- api.threats.remote_file_inclusion
required: true
schema:
type: string
example: 578942
- name: block_bad_bots
in: query
description: 'Whether or not to block bad bots. Possible values: true, false'
schema:
type: string
example: true
- name: challenge_suspected_bots
in: query
description: 'Whether or not to send a challenge to clients that are suspected
to be bad bots (CAPTCHA for example). Possible values: true, false'
schema:
type: string
example: true
- name: activation_mode
in: query
description: 'Possible values: off, auto, on
- off security
measures are disabled even if site is under a DDoS attack
- auto
security measures will be activated automatically when the system suspects
site is under a DDoS attack
- on security measures are enabled
even if site is not under a DDoS attack
The syntax is as follows:.activation_mode.
For example, for ''off'', use ''activation_mode=api.threats.ddos.activation_mode.off.
Note:
This parameter is relevant and required for a DDoS rule only -- where rule_id=api.threats.ddos.'
schema:
type: string
example: 'off'
- name: security_rule_action
in: query
description: The action that should be taken when a threat is detected, for
example:
api.threats.action.block_ip. Different actions are allowed
per different threats, e.g. backdoors may only be quarantined, ignored,
or trigger an alert.
Values for the security_rule_action parameter:
- api.threats.action.disabled
Threat is not blocked, site owner is not notified.
- api.threats.action.alert
Threat is not blocked, site owner is notified.
- api.threats.action.block_request
Threat blocked by stopping the request, site owner is notified.
- api.threats.action.block_user
Threat blocked by stopping the request. Additional requests by the client
application will be automatically blocked for a duration of several minutes.
Site owner is notified.
- api.threats.action.block_ip Threat
blocked by stopping the request. Additional requests from the same IP addresses
will be automatically blocked for a duration of several minutes. Site owner
is notified.
- api.threats.action.quarantine_url Relevant only
for Backdoor Protect. When detecting a backdoor, additional requests to
the URL of the backdoor will be automatically blocked. Site owner is notified.
schema:
type: string
example: api.threats.action.alert
- name: quarantined_urls
in: query
description: 'Removes quarantined URLs from the backdoor protection list,
as defined in the Cloud Security Console Website Settings > WAF Settings
> Backdoor Protect.
To remove a URL from the backdoor protection list,
use the following parameters with the specified values:
quarantined_urls:
rule_id: api.threats.backdoor
security_rule_action:
api.threats.action.quarantine_url'
schema:
type: string
example: www.example.com
- name: ddos_traffic_threshold
in: query
description: Consider site to be under DDoS if the request rate is above this
threshold.
The valid values are 10, 20, 50, 100, 200, 500, 750, 1000,
2000, 3000, 4000, 5000
schema:
type: integer
format: int64
example: 1500
responses:
'200':
description: res - contains the specific error code:
9414 - Feature
not permitted
9415 - Operation not allowed
2 - Invalid input
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSiteStatus'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/report:
post:
tags:
- Site Management
summary: Get Site Report
description: Use this operation to get a report for a site. Reports are sent
using Base64 encoding.
operationId: getSiteReport
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: report
in: query
description: 'The report to get. One of: pci-compliance'
required: true
schema:
type: string
example: pci-compliance
- name: format
in: query
description: 'The format to get the report in. One of: pdf | html'
required: true
schema:
type: string
example: pdf
- name: time_range
in: query
description: 'Time range to fetch data for.
Some operations require the
user to specify a time range. This is done via the time_range parameter,
which accepts the following values:
- today Retrieve data
from midnight today until the current time.
- last_7_days Retrieve
data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
required: true
schema:
type: string
example: last_7_days
- name: start
in: query
description: 'Start date in milliseconds since 1970.
Some operations require
the user to specify a time range. This is done via the time_range parameter,
which accepts the following values:
- today Retrieve data
from midnight today until the current time.
- last_7_days Retrieve
data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
- name: end
in: query
description: 'End date in milliseconds since 1970.
Some operations require
the user to specify a time range. This is done via the time_range parameter,
which accepts the following values:
- today Retrieve data
from midnight today until the current time.
- last_7_days Retrieve
data from midnight of 7 days ago until the current time.
- last_30_days
Retrieve data from midnight of 30 days ago until the current time.
- last_90_days
Retrieve data from midnight of 90 days ago until the current time.
- month_to_date
Retrieve data from midnight of the first day of the month until the current
time.
- custom Specify a custom time range using two additional
parameters: start and end.
Results are provided for full days only,
starting from midnight. A time range of less than 24 hours gives results
for the full day.
For example:- A time range of 14:00 - 20:00
yesterday gives results for all of yesterday (midnight to midnight) - a
full day.
- A time range of 14:00 last Tuesday to 14:00 last Wednesday
gives results for all of Tuesday and Wednesday - two full days.
- A
time range of 14:00 yesterday to 14:00 today gives results for all of yesterday
starting from midnight until the current time today.
'
schema:
type: string
example: 1610356734
responses:
'200':
description: res - contains the specific error code:
5001 - Report invalid
5002
- Format invalid
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultReport'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/hostname/purge:
post:
tags:
- Site Management
summary: Purge Hostname from Cache
description: Use this operation to purge the hostname from the cache. This API
is for customers who use the same CNAME provided by Imperva for multiple hostnames
and would like to change the CNAME for a particular hostname. Purging the
hostname is required for the CNAME change to take effect.
operationId: purgeHostname
parameters:
- name: host_name
in: query
description: The hostname to purge from the cache
schema:
type: string
example: example.com
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
3015
- Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/htmlinjections:
post:
tags:
- Site Management
summary: Get HTML Injection Rules
description: Use this operation to list all the HTML Injection rules
operationId: getHtmlInjectionRules
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 15
responses:
'200':
description: Success
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultHtmlInjections'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/configure/htmlInjections:
post:
tags:
- Site Management
summary: Add, Replace or Remove a HTML Injection Rule
description: Use this operation to add a new HTML injection rule, or to replace
or remove an existing rule.
operationId: setHtmlInjectionRule
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 15
- name: url
in: query
description: The URL where the content is injected
required: true
schema:
type: string
example: /home
- name: url_pattern
in: query
description: 'The url pattern. One of: contains | not_contains | equals |
not_equals | prefix | suffix | not_prefix | not_suffix'
required: true
schema:
type: string
example: contains
- name: location
in: query
description: The location of the injection inside the URL ('head' or 'body_end')
required: true
schema:
type: string
example: head
- name: content
in: query
description: The injected HTML snippet, Base64-encoded
schema:
type: string
example: SGVsbG8gV29ybGQh
- name: delete_content
in: query
description: 'Whether or not to delete existing HTML content.
Possible
values: true/false'
schema:
type: boolean
example: false
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultHtmlInjections'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/customCertificate/upload:
post:
tags:
- Site Management
summary: Upload Custom Certificate
description: 'Use this operation to upload custom certificate for your site.
The following SSL certificate file formats are supported: PFX, PEM, CER.'
operationId: uploadCustomCertificate
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
schema:
type: integer
format: int64
example: 10
- name: certificate
in: query
description: The certificate file in base64 format
required: true
schema:
type: string
- name: private_key
in: query
description: The private key of the certificate in base64 format. Optional
in case of PFX certificate file format
required: true
schema:
type: string
- name: passphrase
in: query
description: "The passphrase used to protect your SSL certificate\t"
schema:
type: string
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
4205
- Site does not have SSL
9414 - Feature not permitted
9414 - Feature
not permitted3015 - Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/customCertificate/remove:
post:
tags:
- Site Management
summary: Remove Custom Certificate
description: Use this operation to remove custom certificate.
operationId: removeCustomCertificate
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
schema:
type: integer
format: int64
example: 5437773
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
4205
- Site does not have SSL
9414 - Feature not permitted
9414 - Feature
not permitted3015 - Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/customCertificate/csr:
post:
tags:
- Site Management
summary: Create New CSR
description: Use this operation to create a certificate signing request (CSR)
for your site.
operationId: createNewCSR
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: integer
format: int64
example: 10
- name: email
in: query
description: 'Email address. For example: joe@example.com'
schema:
type: string
example: joe@example.com
- name: country
in: query
description: The two-letter ISO code for the country where your organization
is located
schema:
type: string
example: IL
- name: state
in: query
description: The state/region where your organization is located. This should
not be abbreviated
schema:
type: string
example: IL
- name: city
in: query
description: The city where your organization is located
schema:
type: string
example: JER
- name: organization
in: query
description: The legal name of your organization. This should not be abbreviated
or include suffixes such as Inc., Corp., or LLC
schema:
type: string
example: imperva
- name: organization_unit
in: query
description: The division of your organization handling the certificate. For
example, IT Department
schema:
type: string
example: IT Department
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
4205
- Site does not have SSL
9414 - Feature not permitted
9414 - Feature
not permitted3015 - Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/data-privacy/region-change:
post:
tags:
- Site Management
summary: Set Site Data Storage Region
description: Use this operation to set the site data region.
operationId: setDataRegion
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: data_storage_region
in: query
description: The data region to use.
required: true
schema:
type: string
example: US
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9415
- Operation not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultSetDataRegion'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/data-privacy/show-override-by-geo:
post:
tags:
- Site Management
summary: List Available PoPs for Denylist/Allowlist
description: Use this operation to list all PoPs that are available to add to
a site’s blacklist or allowlist.
operationId: getOverrideSiteRegionsByGeo
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/data-privacy/override-by-geo:
post:
tags:
- Site Management
summary: Set Site Regions by Origin Geolocation
description: Use this operation to set the data storage region for each new
site based on the geolocation of the origin server.
operationId: setOverrideSiteRegionsByGeo
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
If not specified,
operation will be performed on the account identified by the authentication
parameters.
required: true
schema:
type: string
example: 10
- name: override_site_regions_by_geo
in: query
description: A boolean parameter. If it is set to "true", the data storage
region for each new site will be based on the geolocation of the origin
server.
required: true
schema:
type: boolean
example: 10
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9415
- Operation not allowed
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/caa/check-compliance:
post:
tags:
- Site Management
summary: Check CAA compliance
description: Check site’s associated SANs for CAA compliance. If a given SAN
is compliant, its SSL domain validation status is updated accordingly.This
operation returns an updated list of the site’s associated SANs that are not
compliant. An empty list indicates that all SANs are compliant.
operationId: checkCAACompliance
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CaaComplianceCheckResult'
/api/prov/v1/sites/moveSite:
post:
tags:
- Site Management
summary: Move site
description: Use this operation to move a site from its account to another account.
operationId: moveSite
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to move
required: true
schema:
type: integer
format: int64
example: 10
- name: destination_account_id
in: query
description: The numeric identifier of the account which the site will be
moved to
required: true
schema:
type: integer
format: int64
example: 15
responses:
'200':
description: res - contains the specific error code:
9415 - Operation
not allowed
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultMoveSite'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/incapRules/priority/set:
post:
tags:
- Site Management
summary: Set Rule Priority
description: Use this operation to change delivery rule's priority.
operationId: setPriority
parameters:
- name: rule_id
in: query
description: Rule ID
required: true
schema:
type: integer
format: int64
example: 534663
- name: priority
in: query
description: New priority for the selected rule
required: true
schema:
type: integer
format: int32
example: 1
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
2 - Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/SetPriorityResponse'
/api/prov/v1/sites/incapRules/edit:
post:
tags:
- Site Management
summary: Edit Rule
description: Use this operation to edit an existing rule (Delivery, Security
or Rate).
operationId: editCustomRule
parameters:
- name: action
in: query
description: Rule action.
Possible action parameter values for Delivery
Rules:
- RULE_ACTION_REDIRECT Redirect the client to a
different URL, responding with a 30X response.
- RULE_ACTION_SIMPLIFIED_REDIRECT
Redirect the client to a different URL, responding with a 30X response.
- RULE_ACTION_REWRITE_URL
Modify the path to which a specific request is targeted.
- RULE_ACTION_REWRITE_HEADER
Modify or add a request header before passing traffic to the origin server.
- RULE_ACTION_REWRITE_COOKIE
Modify or add cookies that are sent by the client to the origin server.
The cookie name and value should be indicated.
- RULE_ACTION_DELETE_HEADER
Remove a specific request header, which means that it won’t be sent to the
origin server.
- RULE_ACTION_DELETE_COOKIE Remove a specific
cookie set on the client, which means that it won’t be sent to the origin
server.
- RULE_ACTION_FORWARD_TO_DC Define the data center
to which a specific request will be sent.
- RULE_ACTION_FORWARD_TO_PORT
Define the port to which a specific request will be sent.
- RULE_ACTION_RESPONSE_REWRITE_HEADER
Modify or add a header to the response received from the origin server.
- RULE_ACTION_RESPONSE_DELETE_HEADER
Remove a specific response header, which means that it won't be returned
to the client.
- RULE_ACTION_RESPONSE_REWRITE_RESPONSE_CODE
Modify the response code received from the origin server.
Possible
action parameter values for security rules:
- RULE_ACTION_ALERT
Generate a non blocking alert for this event.
- RULE_ACTION_BLOCK
Block the current request and generate an alert for this event.
- RULE_ACTION_BLOCK_USER
Block the current session and generate an alert for this event. Any subsequent
request from the same Session will be blocked.
- RULE_ACTION_BLOCK_IP
Block the current session and generate an alert for this event. Any subsequent
request from the same Session will be blocked.
- RULE_ACTION_RETRY
Require any client matching the rule filters to support cookies in order
to complete the request.
- RULE_ACTION_INTRUSIVE_HTML Require
any client matching the rule filters to support javascript in order to complete
the request. Since the Javascript test is embedded in an HTML page, this
action should only be enabled for HTML resources.
- RULE_ACTION_CAPTCHA
Require any client matching the rule filters to pass a CAPTCHA test in order
to complete the request. Since the CAPTCHA test is embedded in an HTML page,
this action should only be enabled for HTML resources.
Possible
action parameter values for counter (rate) rules:
- RULE_ACTION_RATE
Count the number of requests received that match the rule filter.
schema:
type: string
example: RULE_ACTION_EXCLUDE
- name: rule_id
in: query
description: Rule ID.
required: true
schema:
type: integer
format: int64
example: 10
- name: name
in: query
description: Rule name.
schema:
type: string
example: rule1
- name: filter
in: query
description: Rule will trigger only a request that matches this filter. For
more details on filter guidelines, see Syntax
Guide.
schema:
type: string
example: ==
- name: response_code
in: query
description: Redirect rule's response code. Valid values are 302, 301, 303,
307, 308.
schema:
type: integer
format: int32
example: 1
- name: protocol
in: query
schema:
type: string
example: 10
- name: add_missing
in: query
description: Add cookie or header if it doesn't exist (Rewrite cookie rule
only)
schema:
type: boolean
example: true
- name: from
in: query
description: The pattern to rewrite.
For RULE_ACTION_REWRITE_URL - The
URL to rewrite.
For RULE_ACTION_REWRITE_HEADER - The header value to
rewrite.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to rewrite.
For
RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different URL,
responding with a 30X response.
schema:
type: string
example: /home.php
- name: to
in: query
description: The pattern to change to.
For RULE_ACTION_REWRITE_URL - The
URL to change to.
For RULE_ACTION_REWRITE_HEADER - The header value
to change to.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to change
to.
For RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different
URL, responding with a 30X response.
schema:
type: string
example: '*/home.html'
- name: rewrite_name
in: query
description: Name of cookie or header to rewrite. Applies only for RULE_ACTION_REWRITE_COOKIE
and RULE_ACTION_REWRITE_HEADER.
schema:
type: string
example: rule2
- name: dc_id
in: query
description: Data center to forward request to. Applies only for RULE_ACTION_FORWARD_TO_DC.
schema:
type: integer
format: int64
example: 54313
- name: allow_caching
in: query
schema:
type: boolean
example: true
- name: rate_context
in: query
description: 'The context of the rate counter. Possible values: IP / Session.
Applies only to rules using RULE_ACTION_RATE.'
schema:
type: string
example: IP
- name: rate_interval
in: query
description: 'The interval (in seconds) of the rate counter. Possible values:
A multiple of 10 from 10-300. Applies only to rules using RULE_ACTION_RATE.'
schema:
type: integer
format: int32
example: 5
- name: is_test_mode
in: query
description: Make rule apply only for IP address the API request was sent
from.
This option is not available for Simplified Redirect rules.
schema:
type: boolean
example: true
- name: port_forwarding_context
in: query
description: Context for port forwarding. "Use Port Value" or "Use Header
Name". Applies only for RULE_ACTION_FORWARD_TO_PORT.
schema:
type: string
- name: port_forwarding_value
in: query
description: Port number or header name for port forwarding. Applies only
for RULE_ACTION_FORWARD_TO_PORT.
schema:
type: string
example: 20
- name: multiple_deletions
in: query
description: Delete multiple header occurrences. Applies only to rules using
RULE_ACTION_DELETE_HEADER and RULE_ACTION_RESPONSE_DELETE_HEADER.
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Timerange
invalid, 9413 - Unknown/unauthorized site_id
9415 - Operation not
allowed
3015 - Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/incapRules/add:
post:
tags:
- Site Management
summary: Add Rule
description: Use this operation to add a rule (Delivery, Security or Rate).
operationId: addCustomRule
parameters:
- name: action
in: query
description: Rule action. See the possible values in the table below.
Possible
action parameter values for Delivery Rules:
- RULE_ACTION_REDIRECT
Redirect the client to a different URL, responding with a 30X response.
- RULE_ACTION_SIMPLIFIED_REDIRECT
Redirect the client to a different URL, responding with a 30X response.
- RULE_ACTION_REWRITE_URL
Modify the path to which a specific request is targeted.
- RULE_ACTION_REWRITE_HEADER
Modify or add a request header before passing traffic to the origin server.
- RULE_ACTION_REWRITE_COOKIE
Modify or add cookies that are sent by the client to the origin server.
The cookie name and value should be indicated.
- RULE_ACTION_DELETE_HEADER
Remove a specific request header, which means that it won’t be sent to the
origin server.
- RULE_ACTION_DELETE_COOKIE Remove a specific
cookie set on the client, which means that it won’t be sent to the origin
server.
- RULE_ACTION_FORWARD_TO_DC Define the data center
to which a specific request will be sent.
- RULE_ACTION_FORWARD_TO_PORT
Define the port to which a specific request will be sent.
- RULE_ACTION_RESPONSE_REWRITE_HEADER
Modify or add a header to the response received from the origin server.
- RULE_ACTION_RESPONSE_DELETE_HEADER
Remove a specific response header, which means that it won't be returned
to the client.
- RULE_ACTION_RESPONSE_REWRITE_RESPONSE_CODE
Modify the response code received from the origin server.
Possible
action parameter values for security rules:
- RULE_ACTION_ALERT
Generate a non blocking alert for this event.
- RULE_ACTION_BLOCK
Block the current request and generate an alert for this event.
- RULE_ACTION_BLOCK_USER
Block the current session and generate an alert for this event. Any subsequent
request from the same Session will be blocked.
- RULE_ACTION_BLOCK_IP
Block the current session and generate an alert for this event. Any subsequent
request from the same Session will be blocked.
- RULE_ACTION_RETRY
Require any client matching the rule filters to support cookies in order
to complete the request.
- RULE_ACTION_INTRUSIVE_HTML Require
any client matching the rule filters to support javascript in order to complete
the request. Since the Javascript test is embedded in an HTML page, this
action should only be enabled for HTML resources.
- RULE_ACTION_CAPTCHA
Require any client matching the rule filters to pass a CAPTCHA test in order
to complete the request. Since the CAPTCHA test is embedded in an HTML page,
this action should only be enabled for HTML resources.
Possible
action parameter values for counter (rate) rules:
- RULE_ACTION_RATE
Count the number of requests received that match the rule filter.
required: true
schema:
type: string
example: RULE_ACTION_EXCLUDE
- name: site_id
in: query
description: Numeric identifier of the site to operate on.
required: true
schema:
type: integer
format: int64
example: 10
- name: name
in: query
description: Rule name.
required: true
schema:
type: string
example: rule1
- name: filter
in: query
description: Rule will trigger only a request that matches this filter. For
more details on filter guidelines, see Syntax
Guide.
The filter may contain up to 400 characters.
required: true
schema:
type: string
example: ==
- name: response_code
in: query
description: Redirect rule's response code. Valid values are 302, 301, 303,
307, 308.
schema:
type: integer
format: int32
example: 1
- name: protocol
in: query
schema:
type: string
example: 10
- name: add_missing
in: query
description: Add cookie or header if it doesn't exist (Rewrite cookie rule
only)
schema:
type: boolean
example: true
- name: from
in: query
description: The pattern to rewrite.
For RULE_ACTION_REWRITE_URL - The
URL to rewrite.
For RULE_ACTION_REWRITE_HEADER - The header value to
rewrite.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to rewrite.
For
RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different URL,
responding with a 30X response.
schema:
type: string
example: /home.php
- name: to
in: query
description: The pattern to change to.
For RULE_ACTION_REWRITE_URL - The
URL to change to.
For RULE_ACTION_REWRITE_HEADER - The header value
to change to.
For RULE_ACTION_REWRITE_COOKIE - The cookie value to change
to.
For RULE_ACTION_SIMPLIFIED_REDIRECT - Redirect the client to a different
URL, responding with a 30X response.
schema:
type: string
example: '*/home.html'
- name: rewrite_name
in: query
description: Name of cookie or header to rewrite. Applies only for RULE_ACTION_REWRITE_COOKIE
and RULE_ACTION_REWRITE_HEADER.
schema:
type: string
example: rule2
- name: dc_id
in: query
description: Data center to forward request to. Applies only for RULE_ACTION_FORWARD_TO_DC.
schema:
type: integer
format: int64
example: 54313
- name: allow_caching
in: query
schema:
type: boolean
example: true
- name: is_test_mode
in: query
description: Apply the rule only to the IP address the API request was sent
from.
This option is not available for Simplified Redirect rules.
schema:
type: boolean
example: true
- name: rate_context
in: query
description: 'The context of the rate counter. Possible values: IP / Session.
Applies only to rules using RULE_ACTION_RATE.'
schema:
type: string
example: Session
- name: rate_interval
in: query
description: 'The interval (in seconds) of the rate counter. Possible values:
A multiple of 10 from 10-300. Applies only to rules using RULE_ACTION_RATE.'
schema:
type: integer
format: int32
example: 10
- name: port_forwarding_context
in: query
description: Context for port forwarding. "Use Port Value" or "Use Header
Name". Applies only for RULE_ACTION_FORWARD_TO_PORT.
schema:
type: string
- name: port_forwarding_value
in: query
description: Port number or header name for port forwarding. Applies only
for RULE_ACTION_FORWARD_TO_PORT.
schema:
type: string
example: 20
- name: multiple_deletions
in: query
description: Delete multiple header occurrences. Applies only to rules using
RULE_ACTION_DELETE_HEADER and RULE_ACTION_RESPONSE_DELETE_HEADER.
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input,
3015 - Granularity invalid
content:
application/json:
schema:
$ref: '#/components/schemas/CustomRuleResponse'
/api/prov/v1/sites/incapRules/enableDisable:
post:
tags:
- Site Management
summary: Enable or Disable Rule
description: Use this operation to enable or disable a rule (Delivery, Security
or Rate).
operationId: enableDisableCustomRule
parameters:
- name: rule_id
in: query
description: Rule id
required: true
schema:
type: integer
format: int64
example: 10
- name: enable
in: query
description: When true, the rule will be enabled. Set to false to disable
required: true
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
2 - Timerange
invalid, 9413 - Unknown/unauthorized site_id
9415 - Operation not
allowed
3015 - Internal error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/sites/incapRules/delete:
post:
tags:
- Site Management
summary: Delete Data Center
description: Use this operation to delete site datacenter.
operationId: deleteCustomRule
parameters:
- name: rule_id
in: query
description: Rule id
required: true
schema:
type: integer
format: int64
example: 4356
responses:
'200':
description: res - contains the specific error code:
2 - Timerange
invalid, 9413 - Unknown/unauthorized site_id
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteCustomRuleResponse'
/api/prov/v1/sites/incapRules/list:
post:
tags:
- Site Management
summary: List Rules
description: Use this operation to list security, delivery, and rate rules for
a given site.
operationId: listCustomRules
parameters:
- name: site_id
in: query
description: Numeric identifier of the site to operate on
required: true
schema:
type: string
example: 10
- name: include_incap_rules
in: query
description: Whether or not security rules be included. Defaults to "Yes".
schema:
type: string
example: true
- name: include_ad_rules
in: query
description: Whether or not delivery rules should be included. Defaults to
Yes
schema:
type: string
example: true
- name: pageSize
in: query
description: The number of objects to return in the response. Defaults to
50. Maximum is 100
schema:
type: string
example: 10
- name: pageNum
in: query
description: The page to return starting from 0. Default to 0
schema:
type: string
example: 1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input,
9413 - Unknown/unauthorized site_id
content:
application/json:
schema:
$ref: '#/components/schemas/ListCustomRulesResponse'
/api/prov/v1/sites/incapRules/account/list:
post:
tags:
- Site Management
summary: List Account Rules
description: Use this operation to list rules (Delivery, Security or Rate) for
all sites under a given account.
operationId: listAccountCustomRules
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on
required: true
schema:
type: integer
format: int64
example: 10
- name: include_incap_rules
in: query
description: Whether or not security rules be included. Defaults to "Yes".
schema:
type: boolean
example: true
- name: include_ad_rules
in: query
description: Whether or not delivery rules should be included. Defaults to
"Yes".
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
9413 - Unknown/unauthorized
site_id
405 - Api is disabled
content:
application/json:
schema:
$ref: '#/components/schemas/ListCustomRulesResponse'
/api/prov/v1/accounts/testS3Connection:
post:
tags:
- Account Management
summary: Test connection with S3 bucket
description: Use this operation to check that a connection can be created with
your Amazon S3 bucket.
operationId: testConnectionS3
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on
required: true
schema:
type: string
example: 10
- name: bucket_name
in: query
description: S3 bucket name
required: true
schema:
type: string
- name: access_key
in: query
description: S3 access key
required: true
schema:
type: string
- name: secret_key
in: query
description: S3 secret key
required: true
schema:
type: string
- name: save_on_success
in: query
description: Save this configuration if the test connection was successful.
Default value:false
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account id
9414 - Feature not permitted
1- Unexpected error
6002-
Invalid configuration parameter value
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/testSftpConnection:
post:
tags:
- Account Management
summary: Test connection with SFTP server
description: Use this operation to check that a connection can be created with
your SFTP storage.
operationId: testConnectionSftp
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on.
required: true
schema:
type: string
example: 10
- name: host
in: query
description: The IP address of your SFTP server
required: true
schema:
type: string
example: 10.1.1.1
- name: user_name
in: query
description: A user name that will be used to log in to the SFTP server
required: true
schema:
type: string
example: John Doe
- name: password
in: query
description: A corresponding password for the user account used to log in
to the SFTP server
required: true
schema:
type: string
- name: destination_folder
in: query
description: The path to the directory on the SFTP server
required: true
schema:
type: string
- name: save_on_success
in: query
description: 'Save this configuration if the test connection was successful.
Default value: false'
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account id
9414 - Feature not permitted
1- Unexpected error
6002-
Invalid configuration parameter value
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/setDefaultSiemStorage:
post:
tags:
- Account Management
summary: Set Imperva servers for log storage
description: Use this operation to have your logs saved on Incapsula servers.
Once configured, the logs can be retrieved by API calls.
operationId: setDefaultSiemStorage
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on
required: true
schema:
type: string
example: 10
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account id
9414 - Feature not permitted
1- Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/setAmazonSiemStorage:
post:
tags:
- Account Management
summary: Set S3 configuration for log storage
description: Use this operation to configure your Amazon cloud storage. Once
configured, Imperva logs will be uploaded to the selected location.
operationId: setStorageToS3
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on
required: true
schema:
type: string
example: 10
- name: bucket_name
in: query
description: S3 bucket name
required: true
schema:
type: string
- name: access_key
in: query
description: S3 access key
required: true
schema:
type: string
- name: secret_key
in: query
description: S3 secret key
required: true
schema:
type: string
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account id
9414 - Feature not permitted
1- Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/accounts/setSftpSiemStorage:
post:
tags:
- Account Management
summary: Set SFTP server configuration for log storage
description: Use this operation to configure your SFTP server storage. Once
configured, Incapsula logs will be uploaded to the selected location.
operationId: setStorageToSftp
parameters:
- name: account_id
in: query
description: Numeric identifier of the account to operate on
required: true
schema:
type: string
example: 10
- name: host
in: query
description: The IP address of your SFTP server
required: true
schema:
type: string
example: 10.1.1.1
- name: user_name
in: query
description: A user name that will be used to log in to the SFTP server
required: true
schema:
type: string
example: John Doe
- name: password
in: query
description: A corresponding password for the user account used to log in
to the SFTP server
required: true
schema:
type: string
- name: destination_folder
in: query
description: The path to the directory on the SFTP server
required: true
schema:
type: string
responses:
'200':
description: res - contains the specific error code:
9403 - Unknown/unauthorized
account id
9414 - Feature not permitted
1- Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/ddos/start:
post:
tags:
- DDoS for Networks Test Alerts
summary: DDoS Start
description: Use this operation to send a test notification informing you that
an Infrastructure Protection DDoS attack has started.
You can optionally
provide additional parameters to determine the magnitude of the attack.
operationId: postInfraProtectDdosStart
parameters:
- name: ip_prefix
in: query
description: The IP prefix to send a notification for. For example, 10.10.10.10
schema:
type: string
example: 100.1.2.0/24
- name: bps
in: query
description: Number of bits per second
schema:
type: integer
format: int32
example: 8
- name: pps
in: query
description: Number of packets per second
schema:
type: integer
format: int64
example: 16
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlert'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/ddos/stop:
post:
tags:
- DDoS for Networks Test Alerts
summary: DDoS Stop
description: Use this operation to send a test notification informing you that
an Infrastructure Protection DDoS attack has ended.
You can optionally
provide additional parameters to determine the magnitude of the attack.
operationId: postInfraProtectDdosStop
parameters:
- name: ip_prefix
in: query
description: The IP prefix to send a notification for. For example, 10.10.10.10
schema:
type: string
example: 100.1.2.0/24
- name: bps
in: query
description: Number of bits per second
schema:
type: integer
format: int32
example: 8
- name: pps
in: query
description: Number of packets per second
schema:
type: integer
format: int64
example: 16
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlert'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/connection/down:
post:
tags:
- DDoS for Networks Test Alerts
summary: Connection Down
description: Use this operation to send a test notification informing you that
the Infrastructure Protection connection is down.
You can optionally provide
the name of the connection as it appears in the Management Console’s Protection
Settings page.
operationId: postInfraProtectTunnelDown
parameters:
- name: connection_name
in: query
description: The connection to send a notification for.
Enter the connection
name as it appears in the Cloud Security Console’s Protection Settings page.
For example, Test_GRE_Tunnel.
schema:
type: string
example: CONNECTION_NAME
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlertConnectionStatus'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/connection/up:
post:
tags:
- DDoS for Networks Test Alerts
summary: Connection UP
description: Use this operation to send a test notification informing you that
the Infrastructure Protection connection is up.
You can optionally provide
the name of the connection as it appears in the Management Console’s Protection
Settings page.
operationId: postInfraProtectTunnelUp
parameters:
- name: connection_name
in: query
description: The connection to send a notification for.
Enter the connection
name as it appears in the Cloud Security Console’s Protection Settings page.
For example, Test_GRE_Tunnel.
schema:
type: string
example: CONNECTION_NAME
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlertConnectionStatus'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/ip-protection-status/up:
post:
tags:
- DDoS for Networks Test Alerts
summary: IP Protection Status Up
description: Use this operation to send a test notification informing you that
the IP Protection status is up.
operationId: postProtectedIPStatusUp
parameters:
- name: ip_protection
in: query
description: The IP to send a notification for. For example, 10.10.10.10
schema:
type: string
example: 1.1.1.1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlert'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/ip-protection-status/down:
post:
tags:
- DDoS for Networks Test Alerts
summary: IP Protection Status Down
description: Use this operation to send a test notification informing you that
the IP Protection status is down.
operationId: postProtectedIPStatusDown
parameters:
- name: ip_protection
in: query
description: The IP to send a notification for. For example, 10.10.10.10
schema:
type: string
example: 1.1.1.1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlertProtectedIPStatus'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/monitoring/start:
post:
tags:
- DDoS for Networks Test Alerts
summary: Monitoring Start
description: Use this operation to send a test notification informing you that
flow monitoring has started.
You can optionally provide the exporter IP
found in the Management Console’s Monitoring Settings page.
operationId: postInfraProtectNetFlowStart
parameters:
- name: exporter_ip
in: query
description: The exporter IP to send a notification for. For example, 10.10.10.10.
The
exporter IP can be found in the Cloud Security Console’s Monitoring Settings
page.
schema:
type: string
example: 1.1.1.1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlertExporterStatus'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/monitoring/stop:
post:
tags:
- DDoS for Networks Test Alerts
summary: Monitoring Stop
description: Use this operation to send a test notification informing you that
NetFlow monitoring has stopped.
operationId: postInfraProtectNetFlowStop
parameters:
- name: exporter_ip
in: query
description: The exporter IP to send a notification for. For example, 10.10.10.10.
The
exporter IP can be found in the Cloud Security Console’s Monitoring Settings
page.
schema:
type: string
example: 1.1.1.1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlertExporterStatus'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/monitoring/bad-data:
post:
tags:
- DDoS for Networks Test Alerts
summary: Monitoring Bad Data
description: Use this operation to send a test notification informing you that
the monitoring service is receiving messages that do not conform to the accepted
format.
You can optionally provide the exporter IP found in the Management
Console’s Monitoring Settings page.
operationId: postInfraProtectNetFlowBadData
parameters:
- name: exporter_ip
in: query
description: The exporter IP to send a notification for. For example, 10.10.10.10.
The
exporter IP can be found in the Cloud Security Console’s Monitoring Settings
page.
schema:
type: string
example: 1.1.1.1
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlertExporterStatus'
- $ref: '#/components/schemas/ApiResult'
/api/v1/infra-protect/test-alerts/monitoring/attack-start:
post:
tags:
- DDoS for Networks Test Alerts
summary: Monitoring Attack Start
description: Use this operation to send a test notification informing you that
the monitoring service has detected a DDoS attack.
You can optionally
provide additional parameters to determine the magnitude of the attack.
operationId: postInfraProtectMonitoringAttackStartCriticalAlert
parameters:
- name: ip_prefix
in: query
description: The IP range to send a notification for. For example, 1.1.1.0/24
schema:
type: string
example: 100.1.2.1
- name: bps
in: query
description: Number of bits per second
schema:
type: integer
format: int32
example: 8
- name: pps
in: query
description: Number of packets per second
schema:
type: integer
format: int64
example: 16
- name: packet_type
in: query
description: Packet type. (UDP, TCP, DNS, DNS_RESPONSE, ICMP, SYN, FRAG, LARGE_SYN,
NTP, NETFLOW, SSDP, GENERAL)
schema:
type: string
example: TCP
responses:
'200':
description: res - contains the specific error code:
2 - Invalid input
9414
- Feature not permitted
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultTestAlert'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/add/ip:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Add by CNAME
description: 'Use this operation to onboard a public origin IP to the ''IP Protection
over TCP'' service.
If successful, the operation will return the generated Edge IP.'
operationId: addSipByIp
parameters:
- name: origin_ip
in: query
description: Public origin IP to onboard to service
required: true
schema:
type: string
example: 1.2.3.4
- name: enable_ha_protocol
in: query
description: Provide 'true' to enable the Proxy Protocol setting (disabled
by default)
schema:
type: boolean
example: true
- name: description
in: query
description: description for the generated Edge IP
schema:
type: string
- name: monitoring_type
in: query
description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default),
''TCP'' or ''NONE'''
schema:
type: string
example: TCP
- name: tcp_monitoring_port
in: query
description: Port to use for TCP monitoring of the Edge IP. Required only
when TCP monitoring is used.
schema:
type: integer
format: int32
example: 25
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7002 - IP Protection quota exceeded
7003 - IP cannot be
used
7007 - This entity is already protected
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipIp'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/add/cname:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Add by origin IP
description: 'Use this operation to onboard a CNAME record to the ''IP Protection
over TCP'' service.
If successful, the operation will return the generated Edge IP.'
operationId: addSipByCname
parameters:
- name: cname
in: query
description: CNAME record to onboard to service
required: true
schema:
type: string
example: imperva.test.com
- name: enable_ha_protocol
in: query
description: Provide 'true' to enable the Proxy Protocol setting (disabled
by default)
schema:
type: boolean
example: true
- name: description
in: query
description: Optional description for the generated Edge IP
schema:
type: string
- name: monitoring_type
in: query
description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default),
''TCP'' or ''NONE'''
schema:
type: string
example: TCP
- name: tcp_monitoring_port
in: query
description: Port to use for TCP monitoring of the Edge IP. Required only
when TCP monitoring is used.
schema:
type: integer
format: int32
example: 25
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7002 - IP Protection quota exceeded
7007 - This entity is
already protected7008 - CNAME cannot be used
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipCname'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/add/dns-with-ip:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Add by DNS and origin IP
description: 'Use this operation to onboard a public origin IP with an associated
DNS name to the ''IP Protection over TCP'' service.
If DNS check is enabled, the response will include the list of resolved IPs
for the provided domain name, and the operation will only succeed if the provided
origin IP will be included in that list.
If successful, the operation will return the generated Edge IP.'
operationId: addSipByDnsAndIp
parameters:
- name: dns_name
in: query
description: Domain name to onboard to service
required: true
schema:
type: string
example: example.imperva.com
- name: origin_ip
in: query
description: Public origin IP to onboard to service
required: true
schema:
type: string
example: 1.2.3.4
- name: disable_dns_check
in: query
description: Provide 'true' to disable DNS resolution check (enabled by default)
schema:
type: boolean
example: true
- name: enable_ha_protocol
in: query
description: Provide 'true' to enable the Proxy Protocol setting (disabled
by default)
schema:
type: boolean
example: true
- name: description
in: query
description: description for the generated Edge IP
schema:
type: string
- name: monitoring_type
in: query
description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default),
''TCP'' or ''NONE'
schema:
type: string
example: TCP
- name: tcp_monitoring_port
in: query
description: Port to use for TCP monitoring of the Edge IP. Required only
when TCP monitoring is used.
schema:
type: integer
format: int32
example: 25
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7001 - IP not among DNS resolved records
7002 - IP Protection
quota exceeded
7003 - IP cannot be used
7004 - Domain name cannot
be used
7005 - No DNS records found
7007 - This entity is already
protected
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithIp'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/add/dns-with-cname:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Add by DNS and CNAME
description: 'Use this operation to onboard a CNAME record with an associated
DNS name to the ''IP Protection over TCP'' service.
If DNS check is enabled, the response will include the list of resolved CNAME
records for the provided domain name, and the operation will only succeed
if the provided CNAME will be included in that list.
If successful, the operation will return the generated Edge IP.'
operationId: addSipByDnsAndCname
parameters:
- name: dns_name
in: query
description: Domain name to onboard to service
required: true
schema:
type: string
example: example.imperva.com
- name: cname
in: query
description: CNAME record to onboard to service
required: true
schema:
type: string
example: imperva.test.com
- name: disable_dns_check
in: query
description: Provide 'true' to disable DNS resolution check (enabled by default)
schema:
type: boolean
example: true
- name: enable_ha_protocol
in: query
description: Provide 'true' to enable the Proxy Protocol setting (disabled
by default)
schema:
type: boolean
example: true
- name: description
in: query
description: description for the generated Edge IP
schema:
type: string
- name: monitoring_type
in: query
description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default),
''TCP'' or ''NONE'
schema:
type: string
example: TCP
- name: tcp_monitoring_port
in: query
description: Port to use for TCP monitoring of the Edge IP. Required only
when TCP monitoring is used.
schema:
type: integer
format: int32
example: 25
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7002 - IP Protection quota exceeded
7004 - Domain name cannot
be used
7005 - No DNS records found
7007 - This entity is already
protected
7008 - CNAME cannot be used
7009 - CNAME not among DNS
resolved records
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithCname'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/edit/ip:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Edit by origin IP
description: 'Use this operation to assign a new origin IP to the provided Edge
IP under the ''IP Protection over TCP'' service.
This operation is also able to change the type of the entity protected by
the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS
name will be overwritten).
If successful, the operation will return the Edge IP.
WARNING: Any entity already protected by this Edge IP prior to the change
will no longer be protected once modification is successful, unless duplicate
protection is used.'
operationId: editSipByIp
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
- name: origin_ip
in: query
description: Public origin IP to onboard to service
required: true
schema:
type: string
example: 1.2.3.4
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7003 - IP cannot be used
7006 - Edge IP not found
7007
- This entity is already protected
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipIp'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/edit/cname:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Edit by CNAME
description: 'Use this operation to assign a new CNAME record to the provided
Edge IP under the ''IP Protection over TCP'' service.
This operation is also able to change the type of the entity protected by
the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS
will be overwritten).
If successful, the operation will return the Edge IP.
WARNING: Any entity already protected by this Edge IP prior to the change
will no longer be protected once modification is successful, unless duplicate
protection is used.'
operationId: editSipByCname
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
- name: cname
in: query
description: CNAME to onboard to service
required: true
schema:
type: string
example: imperva.test.com
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7003 - IP cannot be used
7006 - Edge IP not found
7007
- This entity is already protected
7008 - CNAME cannot be used
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipCname'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/edit/dns-with-ip:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Edit by DNS and origin IP
description: 'Use this operation to assign a new origin IP with an associated
DNS name to the provided Edge IP under the ''IP Protection over TCP'' service.
This operation is also able to change the type of the entity protected by
the provided Edge IP (Any existing combination of Origin IP/CNAME and DNS
name will be overwritten).
If DNS check is enabled, the response will include the list of resolved IPs
for the provided domain name, and the operation will only succeed if the provided
origin IP is included in that list.
If successful, the operation will return the Edge IP.
WARNING: Any entity already protected by this Edge IP prior to the change
will no longer be protected once modification is successful, unless duplicate
protection is used.'
operationId: editSipByDnsAndIp
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
- name: dns_name
in: query
description: Domain name to onboard to service
required: true
schema:
type: string
example: imperva.example.com
- name: origin_ip
in: query
description: Public origin IP to onboard to service
required: true
schema:
type: string
example: 1.2.3.4
- name: disable_dns_check
in: query
description: Provide 'true' to disable DNS resolution check (enabled by default)
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7001 - IP not among DNS resolved records
7003 - IP cannot
be used
7004 - Domain name cannot be used
7005 - No DNS records
found
7006 - Edge IP not found
7007 - This entity is already protected
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithIp'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/edit/dns-with-cname:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Edit by DNS and origin IP
description: 'Use this operation to assign a new CNAME record with an associated
DNS name to the provided Edge IP under the ''IP Protection over TCP'' service.
This
operation is also able to change the type of the entity protected by the provided
Edge IP (Any existing combination of Origin IP/CNAME and DNS name will be
overwritten).
If DNS check is enabled, the response will include the list
of resolved CNAME records for the provided domain name, and the operation
will only succeed if the provided CNAME is included in that list.
If successful,
the operation will return the Edge IP.
WARNING: Any entity already protected
by this Edge IP prior to the change will no longer be protected once modification
is successful, unless duplicate protection is used.'
operationId: editSipByDnsAndCname
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
- name: dns_name
in: query
description: Domain name to onboard to service
required: true
schema:
type: string
example: imperva.example.com
- name: cname
in: query
description: CNAME to onboard to service
required: true
schema:
type: string
example: imperva.example.com
- name: disable_dns_check
in: query
description: Provide 'true' to disable DNS resolution check (enabled by default)
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7003 - IP cannot be used
7004 - Domain name cannot be used
7005
- No DNS records found
7006 - Edge IP not found
7007 - This entity
is already protected
7008 - CNAME cannot be used
7009 - CNAME
not among DNS resolved records
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiResultInfraProtectSipDnsWithCname'
- $ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/edit/ha-protocol:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Edit HA Protocol Setting
description: 'Use this operation on the provided Edge IP to toggle its HA Protocol
setting on or off.
By default, this setting is disabled during onboarding unless explicitly set
to ''true''.
WARNING: Do not modify this setting unless you are familiar with the proxy
protocol and understand the implications of enabling or disabling it for your
account.'
operationId: editSipHaProtocol
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
- name: enable_ha_protocol
in: query
description: Provide 'true' to enable the Proxy Protocol setting, 'false'
to disable
required: true
schema:
type: boolean
example: true
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7003 - IP cannot be used7006 - Edge IP not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/edit/monitoring-settings:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Edit Monitoring Settings
description: Use this operation on the specified Edge IP to modify its monitoring
settings.
operationId: editSipMonitoringSettings
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
- name: monitoring_type
in: query
description: 'Monitoring type for the Edge IP. Possible values: ''ICMP'' (default),
''TCP'' or ''NONE'''
required: true
schema:
type: string
example: TCP
- name: tcp_monitoring_port
in: query
description: Port to use for TCP monitoring of the Edge IP. Required only
when TCP monitoring is used.
schema:
type: integer
format: int32
example: 15
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7003 - IP cannot be used
7006 - Edge IP not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
/api/prov/v1/ddos-protection/edge-ip/remove:
post:
tags:
- DDoS Protection for Individual IPs
summary: Protected IP over TCP - Remove
description: 'Use this operation on the provided Edge IP to remove it from the
''IP Protection over TCP'' service.
WARNING: Any entity already protected
by this Edge IP will no longer be protected once the operation is successful,
unless duplicate protection was enabled and used.'
operationId: removeSip
parameters:
- name: edge_ip
in: query
description: Imperva generated Edge IP
required: true
schema:
type: string
example: 172.17.14.1
responses:
'200':
description: res - contains the specific error code:
3015 - Internal
error
7003 - IP cannot be used
7006 - Edge IP not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResult'
components:
schemas:
ApiResultGetSsoToken:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
generated_token:
type: string
example: 344ebcaf34dff34
ApiResultListUsers:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
accounts:
type: array
items:
$ref: '#/components/schemas/accounts'
Login:
type: object
properties:
login_id:
type: string
example: demo_account@incapsula.com
email_verified:
type: boolean
example: true
accounts:
type: object
properties:
email:
type: string
example: example@imperva.com
plan_id:
type: string
example: ent100
plan_name:
type: string
example: Enterprise 100
trial_end_date:
type: string
format: date-time
account_id:
type: integer
format: int64
example: 10
John Account:
type: string
example: Jhon
user_name:
type: string
example: Jhon
logins:
type: array
items:
$ref: '#/components/schemas/Login'
log_level:
type: string
example: full
support_level:
type: string
example: Standard
support_all_tls_versions:
type: boolean
example: true
wildcard_san_for_new_sites:
type: string
example: 'true'
enum:
- 'True'
- 'False'
- Default
naked_domain_san_for_new_www_sites:
type: boolean
example: true
ApiResultSubAccountStatus:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
sub_account:
$ref: '#/components/schemas/SubAccountStatus'
SubAccountStatus:
type: object
properties:
sub_account_id:
type: integer
format: int64
example: 10
sub_account_name:
type: string
example: My Sub Account
ref_id:
type: string
example: '432'
logins:
type: array
items:
$ref: '#/components/schemas/Login'
log_level:
type: string
example: full
support_level:
type: string
example: Standard
ApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ApiResultAccountStatus:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
account:
$ref: '#/components/schemas/account'
account:
type: object
properties:
email:
type: string
example: example@imperva.com
plan_id:
type: string
example: ent100
plan_name:
type: string
example: Enterprise 100
trial_end_date:
type: string
format: date-time
account_id:
type: integer
format: int64
example: 10
John Account:
type: string
example: Jhon
user_name:
type: string
example: Jhon
logins:
type: array
items:
$ref: '#/components/schemas/Login'
log_level:
type: string
example: full
support_level:
type: string
example: Standard
support_all_tls_versions:
type: boolean
example: true
wildcard_san_for_new_sites:
type: string
example: 'true'
enum:
- 'True'
- 'False'
- Default
naked_domain_san_for_new_www_sites:
type: boolean
example: true
AccountBandwidth:
type: object
properties:
' billingCycle':
type: string
example: Earlier billing cycle
onDemandBandwidth:
type: string
example: 0bps
alwaysOnBandwidth:
type: string
example: 7.7kbps
AccountPlanStatus:
type: object
properties:
accountId:
type: integer
format: int64
example: 12345
accountName:
type: string
example: demo_account@incapsula.com
websiteProtection:
type: array
example:
name: Website Protection
planSectionRows:
- name: Additional Sites
purchased: '100'
used: '2'
- name: Load Balancing (old)
purchased: '0'
used: '0'
- name: Additional Login Protect Users
purchased: '5'
used: '0'
items:
type: object
properties:
name:
type: string
planSectionRows:
type: array
items:
$ref: '#/components/schemas/PlanSectionRow'
infrastructureProtection:
type: array
example:
name: Infrastructure Protection
planSectionRows:
- name: On Demand Bandwidth (Clean traffic)
purchased: '0'
used: ''
- name: GRE Tunnel Pairs
purchased: '0 '
used: '0'
items:
type: object
properties:
name:
type: string
planSectionRows:
type: array
items:
$ref: '#/components/schemas/PlanSectionRow'
dnsProtection:
type: array
example:
name: DNS Protection
planSectionRows:
- name: Additional DNS Zones
purchased: '0'
used: '0'
items:
type: object
properties:
name:
type: string
planSectionRows:
type: array
items:
$ref: '#/components/schemas/PlanSectionRow'
additionalServices:
type: array
example:
name: Additional Services
planSectionRows:
- name: Always On Bandwidth (Clean traffic)
purchased: 10Mbps
used: N/A
- name: DDoS Protection
purchased: None
used: ''
- name: Support Level
purchased: Standard
used: Standard
- name: SIEM Integration
purchased: '10'
used: '0'
- name: Web Attack Analytics
purchased: '0'
used: ''
items:
type: object
properties:
name:
type: string
planSectionRows:
type: array
items:
$ref: '#/components/schemas/PlanSectionRow'
ApiResultAccountSubscription:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
planStatus:
$ref: '#/components/schemas/AccountPlanStatus'
bandwidthHistory:
type: array
items:
$ref: '#/components/schemas/AccountBandwidth'
PlanSection:
type: object
properties:
name:
type: string
planSectionRows:
type: array
items:
$ref: '#/components/schemas/PlanSectionRow'
PlanSectionRow:
type: object
properties:
name:
type: string
purchased:
type: string
used:
type: string
ApiResultAddCacheRule:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
rule_id:
type: integer
format: int64
example: 10
SiteCacheRuleResponse:
type: object
example:
HTTP_CACHE_FORCE_UNCACHEABLE:
- id: '3746'
name: rule1
action: HTTP_CACHE_FORCE_UNCACHEABLE
filter: URL == "/admin"
disabled: 'false'
disabledByCacheMode: 'false'
HTTP_CACHE_DIFFERENTIATE_BY_COOKIE:
- id: '3749'
name: rule3
action: HTTP_CACHE_DIFFERENTIATE_BY_COOKIE
filter: CookieExists == "xGroup"
differentiatedByValue: xGroup
disabled: 'false'
disabledByCacheMode: 'false'
HTTP_CACHE_CREATE_TAG:
- id: '3745'
name: rule4
action: HTTP_CACHE_CREATE_TAG
filter: User-Agent contains "Iphone" | User-Agent contains "Android"
tag: mobile
disabled: 'false'
disabledByCacheMode: 'false'
HTTP_CACHE_IGNORE_PARAMS:
- id: '3751'
name: rule7
action: HTTP_CACHE_IGNORE_PARAMS
params: oid
filter: ParamExists == "oid"
disabled: 'false'
disabledByCacheMode: 'false'
- id: '3752'
name: rule8
action: HTTP_CACHE_IGNORE_PARAMS
params: xid
filter: ParamExists == "xid"
disabled: 'false'
disabledByCacheMode: 'false'
HTTP_CACHE_MAKE_STATIC:
- id: '3744'
name: rule9
action: HTTP_CACHE_MAKE_STATIC
ttl: '1'
ttlUnit: MINUTES
filter: URL == "/admin"
disabled: 'false'
disabledByCacheMode: 'false'
InfraStatsApiResponse:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
example:
stats:
- objectId: 607074
payload:
- interval: 15000
startTime: 1509936300000
data:
- 0
- 15
metric: pps
pop: tko
ipPrefix: 192.168.205.0/24
ipPrefixType: bgp
traffic: passed
- interval: 15000
startTime: 1509936300000
data:
- 7968575
- 8484564
metric: bw
pop: tko
ipPrefix: 192.168.205.0/24
ipPrefixType: bgp
traffic: passed
res: 0
res_message: OK
debug_info: {}
ADRule:
type: object
properties:
id:
type: string
name:
type: string
action:
type: string
example: Redirect
createdAt:
type: string
format: date-time
updatedBy:
type: string
example: example@imperva.com
hits:
type: integer
format: int32
example: 3451
ADRuleSeries:
type: object
properties:
id:
type: string
name:
type: string
action:
type: string
example: Redirect
createdAt:
type: string
format: date-time
updatedBy:
type: string
example: example@imperva.com
hits:
type: array
example:
- - 1478613600000
- 6
- - 1478617200000
- 3
items:
type: object
ApiResultSiteStats:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
visits_timeseries:
type: array
items:
$ref: '#/components/schemas/VisitsItem'
requests_geo_dist_summary:
$ref: '#/components/schemas/RequestsGeo'
visits_dist_summary:
type: array
items:
$ref: '#/components/schemas/VisitsSummary'
caching:
$ref: '#/components/schemas/Caching'
caching_timeseries:
type: array
items:
$ref: '#/components/schemas/TimeSeriesItem'
hits_timeseries:
type: array
items:
$ref: '#/components/schemas/TimeSeriesItem'
bandwidth_timeseries:
type: array
items:
$ref: '#/components/schemas/TimeSeriesItem'
threats:
type: array
items:
$ref: '#/components/schemas/Threat'
incap_rules:
type: array
items:
$ref: '#/components/schemas/IncapRule'
incap_rules_timeseries:
type: array
items:
$ref: '#/components/schemas/IncapRuleSeries'
delivery_rules:
type: array
items:
$ref: '#/components/schemas/ADRule'
delivery_rules_timeseries:
type: array
items:
$ref: '#/components/schemas/ADRuleSeries'
Caching:
type: object
properties:
saved_requests:
type: integer
format: int64
example: 23984923
total_requests:
type: integer
format: int64
example: 48723648
saved_bytes:
type: integer
format: int64
example: 762394786
total_bytes:
type: integer
format: int64
example: 1098349834
IncapRule:
type: object
properties:
id:
type: string
name:
type: string
action:
type: string
example: Require Javascript Support
incidents:
type: integer
format: int32
example: 3451
createdAt:
type: string
format: date-time
updatedBy:
type: string
example: example@imperva.com
IncapRuleSeries:
type: object
properties:
id:
type: string
name:
type: string
action:
type: string
example: Require Javascript Support
createdAt:
type: string
format: date-time
updatedBy:
type: string
example: example@imperva.com
incidents:
type: array
example:
- - 1478613600000
- 6
- - 1478617200000
- 3
items:
type: object
RequestsGeo:
type: object
properties:
id:
type: string
name:
type: string
data:
type: array
example: '[[''Tokyo, JA'',24365435],[''Los Angeles, CA'',98762738]]'
items:
type: object
Threat:
type: object
properties:
id:
type: string
name:
type: string
incidents:
type: integer
format: int64
example: 12
status:
type: string
example: ok
status_text_id:
type: string
example: api.threats.action.block_request
status_text:
type: string
example: Block Request
followup:
type: string
example: api.threats.followup.view
followup_text:
type: string
example: View Incidents
followup_url:
type: string
example: https://my.incapsula.com/sites/siteVisits?token=1123_103_13234435091_5d55197912387b94&timeFrame=last_7_days&extSiteId=123&threatFilters=badBot
TimeSeriesItem:
type: object
properties:
id:
type: string
name:
type: string
data:
type: array
example:
- - 1344247200000
- 5
items:
type: object
VisitsItem:
type: object
properties:
id:
type: string
name:
type: string
data:
type: array
example:
- - 1344247200000
- 50
- - 1344247500000
- 40
items:
type: object
VisitsSummary:
type: object
properties:
id:
type: string
name:
type: string
data:
type: array
example: '[[''np'',15],[''no'',778]]'
items:
type: array
items:
type: object
AnalyticsTopTableApiResponse:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
stats:
type: array
items:
$ref: '#/components/schemas/AnalyticsTopTableData'
AnalyticsTopTableData:
type: object
properties:
object:
type: string
example: 10.200.98.3
value:
type: number
format: double
example: 334160
total:
type: number
format: double
example: 1109938
AnalyticsTopGraphDataResponse:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
stats:
type: array
items:
$ref: '#/components/schemas/Stats'
Stats:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
objectid:
type: string
example: '200'
time:
type: string
example: '1522761000000'
payload:
type: array
items:
$ref: '#/components/schemas/TopGraphPayloads'
TopGraphPayloads:
type: object
properties:
interval:
type: string
example: '15000'
startTime:
type: string
format: date-time
data:
type: array
example:
- 5462
- 7563
items:
type: object
example:
- 5462
- 7563
metric:
type: string
example: pps
dataType:
type: string
example: ip
item:
type: string
example: 10.13.0.1
traffic:
type: string
example: blocked
AnalyticsHistogramApiResponse:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
stats:
type: array
example:
PL_100: '366450640'
PL_200: '305475960'
PL_300: '0'
PL_400: '0'
PL_500: '0'
PL_600: '0'
PL_700: '0'
PL_800: '0'
PL_900: '0'
PL_1000: '0'
PL_1100: '0'
PL_1200: '0'
PL_1300: '0'
PL_1400: '0'
PL_1500: '0'
items:
type: object
additionalProperties:
type: object
ActionItem:
type: object
properties:
queryString:
type: string
example: ?jobSYapi_password\u003dXXXXX
postData:
type: string
requestResult:
type: string
description: requestResult
example: api.request_result.req_challenge_javascript
isSecured:
type: boolean
example: false
url:
type: string
example: www.google.com/ddos/ddos-mitigation-services
httpStatus:
type: integer
format: int32
example: 200
responseTime:
type: integer
format: int64
example: 170
thinkTime:
type: integer
format: int64
example: 169
incidentId:
type: string
example: 3411008890000033213-29571073433152
threats:
type: array
items:
$ref: '#/components/schemas/ThreatItem'
ApiResultSessions:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
visits:
type: array
items:
$ref: '#/components/schemas/SessionItem'
SessionItem:
type: object
properties:
id:
type: string
example: '133077760038625792'
siteId:
type: integer
format: int64
example: 7
startTime:
type: integer
format: int64
example: 1361468485000
endTime:
type: integer
format: int64
example: 1361468486000
clientIPs:
type: array
items:
type: object
example: 12.13.14.15
country:
uniqueItems: true
type: array
items:
type: object
example: Sweden
countryCode:
uniqueItems: true
type: array
items:
type: object
example: SE
clientType:
type: string
example: Unclassified
clientApplication:
type: string
example: Bot
clientApplicationId:
type: integer
format: int64
example: 0
httpVersion:
type: string
example: '2.0'
clientApplicationVersion:
type: string
example: '0'
userAgent:
type: string
example: Mozilla/4.0 (compatible; MSIE 5.0; Windows 95; DigExt)
os:
type: string
example: Windows
osVersion:
type: string
example: Windows
supportsCookies:
type: boolean
example: true
supportsJavaScript:
type: boolean
example: true
hits:
type: integer
format: int64
example: 1
pageViews:
type: integer
format: int64
example: 1
entryReferer:
type: string
example: http://lp.usafis.org/_Incapsula_Resource?CWUDNSAI=9_E1521557&incident_id=133077760038102423-139906691365201416&edet=12&cinfo=2ef678e2c753856785000000
entryPage:
type: string
example: www.incapsula.com/ddos/ddos-mitigation-services
servedVia:
type: array
items:
type: object
example: Los Angeles, CA
securitySummary:
type: array
example:
api.threats.sql_injection: '2'
api.threats.cross_site_scripting: '1'
api.threats.illegal_resource_access: '3'
api.threats.remote_file_inclusion: '2'
api.threats.customRule: '3'
api.threats.ddos=DDoS: '4'
api.threats.backdoor: '2'
api.threats.bot_access_control: '1'
api.acl.blacklisted_countries: '1'
api.acl.blacklisted_urls: '1'
api.acl.blacklisted_ips: '1'
items:
type: object
additionalProperties:
type: object
actions:
type: array
items:
$ref: '#/components/schemas/ActionItem'
ThreatItem:
type: object
properties:
securityRule:
type: string
example: api.threats.illegal_resource_access
alertLocation:
type: string
example: api.alert_location.alert_location_path
attackCodes:
uniqueItems: true
type: array
items:
type: object
example: 9070.0
securityRuleAction:
type: string
example: api.rule_action_type.rule_action_block
description: threats
ApiResultLCPublicKey:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
publicKeyId:
type: integer
format: int64
example: 1
InfraEventsApiResponse:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
events:
type: array
items:
$ref: '#/components/schemas/InfraProtectEvent'
InfraProtectEvent:
type: object
properties:
eventTime:
type: string
format: date-time
eventType:
type: string
example: DDOS_STOP_IP_RANGE
enum:
- GRE_TUNNEL_UP
- GRE_TUNNEL_DOWN
- ORIGIN_CONNECTION_GRE_UP
- ORIGIN_CONNECTION_GRE_DOWN
- ORIGIN_CONNECTION_ECX_UP
- ORIGIN_CONNECTION_ECX_DOWN
- ORIGIN_CONNECTION_CROSS_CONNECT_UP
- ORIGIN_CONNECTION_CROSS_CONNECT_DOWN
- IP_RANGE_ATTACK_START
- IP_RANGE_ATTACK_STOP
- DDOS_START_IP_RANGE
- DDOS_STOP_IP_RANGE
- DDOS_QUIET_TIME_IP_RANGE
- EXPORTER_NO_DATA
- EXPORTER_BAD_DATA
- EXPORTER_GOOD_DATA
- MONITORING_ATTACK
- MONITORING_CRITICAL_ATTACK
- PROTECTED_IP_STATUS_UP
- PROTECTED_IP_STATUS_DOWN
- PER_IP_DDOS_START_IP_RANGE
- PER_IP_DDOS_STOP_IP_RANGE
- IIP_ACCOUNT_SERVICE_SUSPENDED
- IIP_ACCOUNT_SERVICE_UNSUSPENDED
- INFRAPROTECT_NULL_ROUTE_STARTED
- INFRAPROTECT_NULL_ROUTE_ESCALATED
- INFRAPROTECT_NULL_ROUTE_ENDED
bwTotal:
type: integer
format: int64
example: 9000
ppsTotal:
type: integer
format: int64
example: 90
bwPassed:
type: integer
format: int64
example: 200
ppsPassed:
type: integer
format: int64
example: 87
bwBlocked:
type: integer
format: int64
example: 8800
ppsBlocked:
type: integer
format: int64
example: 3
eventTarget:
type: string
example: IP_RANGE
enum:
- GRE_TUNNEL
- IP_RANGE
- EXPORTER
- PROTECTED_IP
- INCAPSULA_IP
- NULL_ROUTE
reportedByPop:
type: string
example: zrh
ApiResultIncapsulaRanges:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ipRanges:
type: array
items:
type: object
example: 199.83.128.0/21
ipv6Ranges:
type: array
items:
type: object
example: 2a02:e980::/29
ApiResultGetTexts:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
texts:
type: array
example:
api.stats.visits_timeseries.human: Human visits
api.stats.visits_timeseries.bot: Bot visits
api.threats.followup.view: View Incidents
items:
type: object
additionalProperties:
type: object
GeoInfo:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
countriesCodes:
type: array
example:
BD: Bangladesh
BE: Belgium
items:
type: object
additionalProperties:
type: object
continentsCodes:
type: array
example:
AF: Africa
items:
type: object
additionalProperties:
type: object
ApiResultGetClappsInfo:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
clientApps:
type: array
example:
'1': Firefox
items:
type: object
additionalProperties:
type: object
clientAppTypes:
type: array
example:
'1': Browser
items:
type: object
additionalProperties:
type: object
APISealLocationItem:
type: object
properties:
id:
type: string
name:
type: string
ApiResultSiteStatus:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
site_id:
type: integer
format: int64
example: 10
statusEnum:
type: string
example: pending-dns-changes
enum:
- pending-dns-changes
- fully-configured
- pending-select-approver
- pending-certificate
- unknown
status:
type: string
example: pending-dns-changes
domain:
type: string
example: admin@example.com
account_id:
type: integer
format: int64
example: 1
acceleration_level:
type: string
example: advanced
site_creation_date:
type: integer
format: int64
example: 1610396346000
ips:
type: array
items:
type: object
example: 1.2.3.4
dns:
type: array
items:
$ref: '#/components/schemas/DnsInstructionItem'
original_dns:
type: array
items:
$ref: '#/components/schemas/DnsInstructionItem'
warnings:
type: array
items:
$ref: '#/components/schemas/SiteConfigurationWarning'
active:
type: string
example: active
enum:
- active
- bypass
support_all_tls_versions:
type: boolean
example: true
use_wildcard_san_instead_of_full_domain_san:
type: boolean
example: true
add_naked_domain_san:
type: boolean
example: true
set_site_cookies_without_domain:
type: boolean
example: true
additionalErrors:
type: array
items:
type: object
example: 1001
display_name:
type: string
example: loginprotectapi1610396334653.incaptest.info
security:
type: array
example:
waf:
rules:
- id: api.threats.bot_access_control
name: Bot Access Control
block_bad_bots: true
challenge_suspected_bots: true
- id: api.threats.sql_injection
name: SQL Injection
action: api.threats.action.block_request
action_text: Block Request
- id: api.threats.cross_site_scripting
name: Cross Site Scripting (XSS)
exceptions:
- values:
- urls:
- value: /gsddg
pattern: EQUALS
id: api.rule_exception_type.url
name: URL
id: 244711494
action: api.threats.action.alert
action_text: Alert Only
- id: api.threats.illegal_resource_access
name: Illegal Resource Access
action: api.threats.action.block_user
action_text: Block User
- id: api.threats.ddos
name: DDoS
activation_mode: api.threats.ddos.activation_mode.off
activation_mode_text: 'Off'
ddos_traffic_threshold: api.threats.ddos.ddos_trassic_threshold
ddos_traffic_threshold_text: '750'
- id: api.threats.backdoor
name: Backdoor Protect
action: api.threats.action.quarantine_url
action_text: Auto-Quarantine
- action: api.threats.action.block_ip
action_text: Block IP
id: api.threats.remote_file_inclusion
name: Remote File Inclusion
acls:
rules:
- ips:
- 2.3.4.5
exceptions:
- values:
- id: api.rule_exception_type.url
name: URL
urls:
- value: /home
pattern: EQUALS
id: 493271006
id: api.acl.blacklisted_ips
name: Visitors from denylisted IPs
items:
type: object
additionalProperties:
type: object
sealLocation:
$ref: '#/components/schemas/APISealLocationItem'
ssl:
type: array
example:
origin_server:
detected: 'true'
detectionStatus: ok
items:
type: object
additionalProperties:
type: object
siteDualFactorSettings:
$ref: '#/components/schemas/SiteDualFactorSettings'
login_protect:
$ref: '#/components/schemas/LoginProtectApiResult'
performance_configuration:
$ref: '#/components/schemas/PerformanceConfigurationApiResult'
extended_ddos:
type: integer
format: int32
example: 0
incap_rules:
type: array
items:
$ref: '#/components/schemas/IncapRuleApiResult'
DnsInstructionItem:
type: object
properties:
dns_record_name:
type: string
example: loginprotectapi1610396334653.incaptest.info
set_type_to:
type: string
example: CNAME
enum:
- CNAME
- A
- AAAA
- MX
- NS
- TXT
- Unkown
- CAA
set_data_to:
type: array
items:
type: object
example: 67eufzur3g.dev.impervadns.net
IncapRuleApiResult:
type: object
properties:
id:
type: integer
format: int64
example: 123
name:
type: string
example: Block Click Worms
action:
type: string
example: api.rule_action_type.rule_action_block
rule:
type: string
example: ClientIP == 1.2.3.4
creation_date:
type: integer
format: int64
updated_by:
type: string
example: John
updated_at:
type: integer
format: int64
example: 1611228121241
comment:
type: string
example: rule comment
LoginProtectApiResult:
type: object
properties:
enabled:
type: boolean
example: true
specific_users_list:
type: array
items:
$ref: '#/components/schemas/specific_users_list'
send_lp_notifications:
type: boolean
example: true
allow_all_users:
type: boolean
example: true
authentication_methods:
uniqueItems: true
type: array
items:
type: object
example: email
urls:
type: array
items:
type: object
example: /userlist
url_patterns:
type: array
items:
type: object
example: CONTAINS
PerformanceConfigurationApiResult:
type: object
properties:
advanced_caching_rules:
type: array
example:
never_cache_resources:
- pattern: SUFFIX
url: /test.html
always_cache_resources:
- pattern: NOT_EQUALS
url: /index.html
ttl: '5'
ttlUnits: SECONDS
- pattern: EQUALS
url: /home.html
ttl: '6'
ttlUnits: DAYS
items:
type: object
additionalProperties:
type: object
acceleration_level:
type: string
example: advanced
async_validation:
type: boolean
example: true
minify_javascript:
type: boolean
example: true
minify_css:
type: boolean
example: true
minify_static_html:
type: boolean
example: true
compress_jpeg:
type: boolean
example: true
compress_jepg:
type: boolean
example: true
progressive_image_rendering:
type: boolean
example: true
aggressive_compression:
type: boolean
example: true
compress_png:
type: boolean
example: true
on_the_fly_compression:
type: boolean
example: true
tcp_pre_pooling:
type: boolean
example: true
comply_no_cache:
type: boolean
example: true
comply_vary:
type: boolean
example: true
use_shortest_caching:
type: boolean
example: true
perfer_last_modified:
type: boolean
example: true
prefer_last_modified:
type: boolean
example: true
disable_client_side_caching:
type: boolean
example: true
cache300x:
type: boolean
example: true
cache_headers:
uniqueItems: true
type: array
items:
type: object
SiteConfigurationWarning:
type: object
properties:
type:
type: string
example: CNAME
enum:
- CNAME
- A
- AAAA
- MX
- NS
- TXT
- Unkown
- CAA
set_data_to:
type: array
items:
type: object
example: 67eufzur3g.dev.impervadns.net
SiteDualFactorSettings:
type: object
properties:
specificUsers:
type: array
items:
type: string
example: lpuser1_api1610396342408@incaptest.info
enabled:
type: boolean
example: false
customAreas:
type: array
items:
$ref: '#/components/schemas/customAreas'
customAreasExceptions:
type: array
items:
$ref: '#/components/schemas/customAreasExceptions'
allowAllUsers:
type: boolean
example: true
shouldSuggestApplicatons:
type: boolean
example: true
allowedMedia:
uniqueItems: true
type: array
items:
type: string
example: sms
enum:
- ga
- sms
- email
shouldSendLoginNotifications:
type: boolean
example: true
application:
type: boolean
writeOnly: true
version:
type: integer
format: int32
customAreas:
type: object
properties:
pattern:
type: string
example: CONTAINS
enum:
- EQUALS
- NOT_EQUALS
- NOT_CONTAINS
- PREFIX
- SUFFIX
- NOT_PREFIX
- NOT_SUFFIX
- CONTAINS
url:
type: string
example: /userlist
customAreasExceptions:
type: object
properties:
pattern:
type: string
example: CONTAINS
enum:
- EQUALS
- NOT_EQUALS
- NOT_CONTAINS
- PREFIX
- SUFFIX
- NOT_PREFIX
- NOT_SUFFIX
- CONTAINS
url:
type: string
example: /userlist
specific_users_list:
type: object
properties:
email:
type: string
description: email
example: John@example.com
name:
type: string
description: name
example: John Doe
status:
type: string
description: status
example: INVITATION_SENT
LoginProtectUsersApiResults:
type: object
properties:
users:
type: array
items:
$ref: '#/components/schemas/LpExtendedUser'
LpExtendedUser:
type: object
properties:
email:
type: string
description: email
example: John@example.com
name:
type: string
description: name
example: John Doe
status:
type: string
description: status
example: INVITATION_SENT
phone:
type: string
description: phone
example: 1-8662507658
creation_date:
type: string
description: creation_date
format: date-time
DataCenterResponse:
type: object
properties:
datacenter_id:
type: integer
format: int32
example: 484377
status:
type: string
example: ok
res:
type: string
example: '0'
ServerOperationResponse:
type: object
properties:
server_id:
type: string
example: '2'
status:
type: string
example: ok
res:
type: string
example: '0'
ListDataCenterResponse:
type: object
example:
- isActive: true
id: '54313'
enabled: 'false'
isStandBy: 'false'
servers:
- id: '1034487'
enabled: 'true'
address: 69.61.27.182
isStandby: 'true'
contentOnly: 'true'
PopRttResponse:
type: object
properties:
id:
type: string
example: ord
name:
type: string
example: Chicago, IL
region:
type: string
example: US Central
rtt:
type: integer
format: int32
example: 8
RecommendedPopsApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
pops:
type: array
items:
$ref: '#/components/schemas/PopRttResponse'
reason:
type: string
example: N/A
ApiResultGetCacheMode:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
cache_mode:
type: string
example: static_and_dynamic
ApiResultGetResponseHeaderSettings:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
enabled:
type: boolean
example: true
mode:
type: string
example: CUSTOM
custom_headers:
uniqueItems: true
type: array
items:
type: string
example: Header1
ApiResultGetTagResponseHeader:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
header:
type: string
example: h1
GetCache404SettingsApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
enabled:
type: boolean
example: true
time:
type: integer
format: int32
example: 10
time_unit:
type: string
example: HOURS
GetPopLevelCacheSettingsApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
enabled:
type: boolean
example: true
ApiResultGetResourceMapSize:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
resource_map_size:
type: integer
format: int32
example: 34000
ApiResultGetCacheSizeLimitLargeMem:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
cache_size_limit_large_mem:
type: integer
format: int64
example: 500
unit:
type: string
example: MB
ApiResultGetMaxRespSize:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
max_resp_size:
type: integer
format: int32
example: 20971520
unit:
type: string
example: BYTES
ApiResultGetSecureResources:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
secured_resources_mode:
type: string
example: do_not_cache (i.e. Do not cache HTTPS resources)
GetStaleContentApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
enabled:
type: boolean
example: true
mode:
type: string
example: ADAPTIVE
time:
type: integer
format: int32
example: 10
unit:
type: string
example: HOURS
GetAdvancedCachingSettingsApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
value:
type: boolean
example: true
ApiResultGetSiteXrayLink:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
url:
type: string
example: https://
IsCacheShieldEnabledApiResult:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
enabled:
type: boolean
example: true
ApiResultGetRewritePorts:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
port:
$ref: '#/components/schemas/RewritePort'
ssl_port:
$ref: '#/components/schemas/RewritePort'
RewritePort:
type: object
properties:
from:
type: string
to:
type: string
ApiResultListSites:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ApiResultSiteStatus:
type: array
items:
$ref: '#/components/schemas/ApiResultSiteStatus'
ApiResultDomainEmails:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
domain_emails:
type: array
items:
type: object
example: admin.example.com
ApiResultSetSupportDeprecatedTLSForSite:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
support_all_tls_versions:
type: boolean
example: true
new_A_record:
type: string
example: 1.2.3.4
additional_instructions:
type: string
example: After the site is moved, update the site’s 'A' records according
to the information in Websites General Settings.
ApiResultSetDataRegion:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
region:
type: string
example: US
ApiResultReport:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
format:
type: string
example: pdf
enum:
- html
- xml
- amf
- pdf
- flash
- json
- mail
- csv
- statistics
- syslog
report:
type: string
example: JVBERi0xLjUNCiXvv73vv73vv73vv70NCjEgMCBvYmoNCjw8L1R5cGUvQ2F0YWxvZy9QYWdlcyAyIDAgUi9MYW5nKGVuLVVT
...
ApiResultHtmlInjections:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
html_injections:
type: array
items:
$ref: '#/components/schemas/HtmlInjectionItem'
HtmlInjectionItem:
type: object
properties:
url:
type: string
example: /
url_pattern:
type: string
example: prefix
enum:
- EQUALS
- NOT_EQUALS
- NOT_CONTAINS
- PREFIX
- SUFFIX
- NOT_PREFIX
- NOT_SUFFIX
- CONTAINS
location:
type: string
example: head
content:
type: string
example: Some content
CaaComplianceCheckResult:
type: object
properties:
res:
type: integer
format: int32
res_message:
type: string
non_compliant_sans:
type: array
items:
type: object
example: '*.caa.incaptest.co'
ApiResultMoveSite:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
status:
type: string
writeOnly: true
enum:
- MOVED
- PENDING_CA_APPROVAL
- FAILED
SetPriorityResponse:
type: object
properties:
status:
type: string
example: ok
res:
type: string
example: '0'
CustomRuleResponse:
type: object
properties:
rule_id:
type: integer
format: int64
example: 43573
status:
type: string
example: ok
res:
type: integer
format: int32
example: 0
DeleteCustomRuleResponse:
type: object
properties:
status:
type: string
example: ok
res:
type: integer
format: int32
example: 0
ListCustomRulesResponse:
type: object
properties:
incap_rules:
type: array
example:
All:
- id: '3660'
last_7_days_requests_count: '0'
name: Ortal
action: RULE_ACTION_ALERT
filter: ''
items:
type: object
additionalProperties:
type: object
delivery_rules:
type: array
example:
Redirect:
- to: /home.php
id: '3648'
priority: '1'
last_7_days_requests_count: '0'
name: Test new
action: RULE_ACTION_REWRITE_URL
from: '*/home.html'
filter: ASN == 1
Forward:
- id: '3628'
priority: '2'
last_7_days_requests_count: '0'
name: move to rewrite
dc_id: '54313'
action: RULE_ACTION_FORWARD_TO_DC
filter: ''
items:
type: object
additionalProperties:
type: object
rate_rules:
type: array
example:
Rates:
- id: '4723'
enabled: 'true'
interval: '120'
name: Test Rate IP
context: IP
action: RULE_ACTION_RATE
internal_name: test-rate-ip
filter: ASN == 2
items:
type: object
additionalProperties:
type: object
ApiResultTestAlert:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ip_prefix:
type: string
example: 100.1.2.0/24
status:
type: string
example: DDoS start notification sent successfully
ApiResultTestAlertConnectionStatus:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ip_prefix:
type: string
example: 100.1.2.0/24
status:
type: string
example: DDoS start notification sent successfully
connection_name:
type: string
example: CONNECTION_NAME
ApiResultTestAlertProtectedIPStatus:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ip_prefix:
type: string
example: 100.1.2.0/24
status:
type: string
example: DDoS start notification sent successfully
ip:
type: string
example: 1.2.3.4
ApiResultTestAlertExporterStatus:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
ip_prefix:
type: string
example: 100.1.2.0/24
status:
type: string
example: DDoS start notification sent successfully
ApiResultInfraProtectSipIp:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
edge_ip:
type: string
example: 172.17.14.1
origin_ip:
type: string
example: 1.2.3.4
ApiResultInfraProtectSipCname:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
edge_ip:
type: string
example: 172.17.14.1
cname:
type: string
example: imperva.test.com
ApiResultInfraProtectSipDnsWithIp:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
edge_ip:
type: string
example: 172.17.14.1
resolved_ips:
uniqueItems: true
type: array
items:
type: string
example: 157.166.226.25
origin_ip:
type: string
example: 157.166.249.10
ApiResultInfraProtectSipDnsWithCname:
type: object
properties:
res:
type: integer
description: res - contains specific error code
format: int32
example: 0
res_message:
type: string
example: OK
debug_info:
type: array
items:
type: object
additionalProperties:
type: object
example: {}
example: {}
edge_ip:
type: string
example: 172.17.14.1
resolved_cnames:
uniqueItems: true
type: array
items:
type: string
example: imperva.test.com
cname:
type: string
example: imperva.test.com
securitySchemes:
api_id:
type: apiKey
name: x-API-Id
in: header
api_key:
type: apiKey
name: x-API-Key
in: header