Interface AWSWAFAsync
-
- All Superinterfaces:
AWSWAF
- All Known Implementing Classes:
AbstractAWSWAFAsync
,AWSWAFAsyncClient
public interface AWSWAFAsync extends AWSWAF
Interface for accessing WAF asynchronously. Each asynchronous method will return a Java Future object representing the asynchronous operation; overloads which accept anAsyncHandler
can be used to receive notification when an asynchronous operation completes.This is the AWS WAF API Reference. This guide is for developers who need detailed information about the AWS WAF API actions, data types, and errors. For detailed information about AWS WAF features and an overview of how to use the AWS WAF API, see the AWS WAF Developer Guide.
-
-
Method Summary
-
Methods inherited from interface com.amazonaws.services.waf.AWSWAF
createByteMatchSet, createIPSet, createRule, createSizeConstraintSet, createSqlInjectionMatchSet, createWebACL, createXssMatchSet, deleteByteMatchSet, deleteIPSet, deleteRule, deleteSizeConstraintSet, deleteSqlInjectionMatchSet, deleteWebACL, deleteXssMatchSet, getByteMatchSet, getCachedResponseMetadata, getChangeToken, getChangeTokenStatus, getIPSet, getRule, getSampledRequests, getSizeConstraintSet, getSqlInjectionMatchSet, getWebACL, getXssMatchSet, listByteMatchSets, listIPSets, listRules, listSizeConstraintSets, listSqlInjectionMatchSets, listWebACLs, listXssMatchSets, setEndpoint, setRegion, shutdown, updateByteMatchSet, updateIPSet, updateRule, updateSizeConstraintSet, updateSqlInjectionMatchSet, updateWebACL, updateXssMatchSet
-
-
-
-
Method Detail
-
createByteMatchSetAsync
Future<CreateByteMatchSetResult> createByteMatchSetAsync(CreateByteMatchSetRequest createByteMatchSetRequest)
Creates a
ByteMatchSet
. You then use UpdateByteMatchSet to identify the part of a web request that you want AWS WAF to inspect, such as the values of theUser-Agent
header or the query string. For example, you can create aByteMatchSet
that matches any requests withUser-Agent
headers that contain the stringBadBot
. You can then configure AWS WAF to reject those requests.To create and configure a
ByteMatchSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateByteMatchSet
request. - Submit a
CreateByteMatchSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of anUpdateByteMatchSet
request. - Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createByteMatchSetRequest
-- Returns:
- A Java Future containing the result of the CreateByteMatchSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createByteMatchSetAsync
Future<CreateByteMatchSetResult> createByteMatchSetAsync(CreateByteMatchSetRequest createByteMatchSetRequest, AsyncHandler<CreateByteMatchSetRequest,CreateByteMatchSetResult> asyncHandler)
Creates a
ByteMatchSet
. You then use UpdateByteMatchSet to identify the part of a web request that you want AWS WAF to inspect, such as the values of theUser-Agent
header or the query string. For example, you can create aByteMatchSet
that matches any requests withUser-Agent
headers that contain the stringBadBot
. You can then configure AWS WAF to reject those requests.To create and configure a
ByteMatchSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateByteMatchSet
request. - Submit a
CreateByteMatchSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of anUpdateByteMatchSet
request. - Submit an UpdateByteMatchSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createByteMatchSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateByteMatchSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createIPSetAsync
Future<CreateIPSetResult> createIPSetAsync(CreateIPSetRequest createIPSetRequest)
Creates an IPSet, which you use to specify which web requests you want to allow or block based on the IP addresses that the requests originate from. For example, if you're receiving a lot of requests from one or more individual IP addresses or one or more ranges of IP addresses and you want to block the requests, you can create an
IPSet
that contains those IP addresses and then configure AWS WAF to block the requests.To create and configure an
IPSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateIPSet
request. - Submit a
CreateIPSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateIPSet
request to specify the IP addresses that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createIPSetRequest
-- Returns:
- A Java Future containing the result of the CreateIPSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createIPSetAsync
Future<CreateIPSetResult> createIPSetAsync(CreateIPSetRequest createIPSetRequest, AsyncHandler<CreateIPSetRequest,CreateIPSetResult> asyncHandler)
Creates an IPSet, which you use to specify which web requests you want to allow or block based on the IP addresses that the requests originate from. For example, if you're receiving a lot of requests from one or more individual IP addresses or one or more ranges of IP addresses and you want to block the requests, you can create an
IPSet
that contains those IP addresses and then configure AWS WAF to block the requests.To create and configure an
IPSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateIPSet
request. - Submit a
CreateIPSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateIPSet
request to specify the IP addresses that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createIPSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateIPSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createRuleAsync
Future<CreateRuleResult> createRuleAsync(CreateRuleRequest createRuleRequest)
Creates a
Rule
, which contains theIPSet
objects,ByteMatchSet
objects, and other predicates that identify the requests that you want to block. If you add more than one predicate to aRule
, a request must match all of the specifications to be allowed or blocked. For example, suppose you add the following to aRule
:- An
IPSet
that matches the IP address192.0.2.44/32
- A
ByteMatchSet
that matchesBadBot
in theUser-Agent
header
You then add the
Rule
to aWebACL
and specify that you want to blocks requests that satisfy theRule
. For a request to be blocked, it must come from the IP address 192.0.2.44 and theUser-Agent
header in the request must contain the valueBadBot
.To create and configure a
Rule
, perform the following steps:- Create and update the predicates that you want to include in the
Rule
. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateRule
request. - Submit a
CreateRule
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateRule request. - Submit an
UpdateRule
request to specify the predicates that you want to include in theRule
. - Create and update a
WebACL
that contains theRule
. For more information, see CreateWebACL.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createRuleRequest
-- Returns:
- A Java Future containing the result of the CreateRule operation returned by the service.
- An
-
createRuleAsync
Future<CreateRuleResult> createRuleAsync(CreateRuleRequest createRuleRequest, AsyncHandler<CreateRuleRequest,CreateRuleResult> asyncHandler)
Creates a
Rule
, which contains theIPSet
objects,ByteMatchSet
objects, and other predicates that identify the requests that you want to block. If you add more than one predicate to aRule
, a request must match all of the specifications to be allowed or blocked. For example, suppose you add the following to aRule
:- An
IPSet
that matches the IP address192.0.2.44/32
- A
ByteMatchSet
that matchesBadBot
in theUser-Agent
header
You then add the
Rule
to aWebACL
and specify that you want to blocks requests that satisfy theRule
. For a request to be blocked, it must come from the IP address 192.0.2.44 and theUser-Agent
header in the request must contain the valueBadBot
.To create and configure a
Rule
, perform the following steps:- Create and update the predicates that you want to include in the
Rule
. For more information, see CreateByteMatchSet, CreateIPSet, and CreateSqlInjectionMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateRule
request. - Submit a
CreateRule
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateRule request. - Submit an
UpdateRule
request to specify the predicates that you want to include in theRule
. - Create and update a
WebACL
that contains theRule
. For more information, see CreateWebACL.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createRuleRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateRule operation returned by the service.
- An
-
createSizeConstraintSetAsync
Future<CreateSizeConstraintSetResult> createSizeConstraintSetAsync(CreateSizeConstraintSetRequest createSizeConstraintSetRequest)
Creates a
SizeConstraintSet
. You then use UpdateSizeConstraintSet to identify the part of a web request that you want AWS WAF to check for length, such as the length of theUser-Agent
header or the length of the query string. For example, you can create aSizeConstraintSet
that matches any requests that have a query string that is longer than 100 bytes. You can then configure AWS WAF to reject those requests.To create and configure a
SizeConstraintSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateSizeConstraintSet
request. - Submit a
CreateSizeConstraintSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of anUpdateSizeConstraintSet
request. - Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createSizeConstraintSetRequest
-- Returns:
- A Java Future containing the result of the CreateSizeConstraintSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createSizeConstraintSetAsync
Future<CreateSizeConstraintSetResult> createSizeConstraintSetAsync(CreateSizeConstraintSetRequest createSizeConstraintSetRequest, AsyncHandler<CreateSizeConstraintSetRequest,CreateSizeConstraintSetResult> asyncHandler)
Creates a
SizeConstraintSet
. You then use UpdateSizeConstraintSet to identify the part of a web request that you want AWS WAF to check for length, such as the length of theUser-Agent
header or the length of the query string. For example, you can create aSizeConstraintSet
that matches any requests that have a query string that is longer than 100 bytes. You can then configure AWS WAF to reject those requests.To create and configure a
SizeConstraintSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateSizeConstraintSet
request. - Submit a
CreateSizeConstraintSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of anUpdateSizeConstraintSet
request. - Submit an UpdateSizeConstraintSet request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createSizeConstraintSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateSizeConstraintSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createSqlInjectionMatchSetAsync
Future<CreateSqlInjectionMatchSetResult> createSqlInjectionMatchSetAsync(CreateSqlInjectionMatchSetRequest createSqlInjectionMatchSetRequest)
Creates a SqlInjectionMatchSet, which you use to allow, block, or count requests that contain snippets of SQL code in a specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.
To create and configure a
SqlInjectionMatchSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateSqlInjectionMatchSet
request. - Submit a
CreateSqlInjectionMatchSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateSqlInjectionMatchSet request. - Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests in which you want to allow, block, or count malicious SQL code.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createSqlInjectionMatchSetRequest
- A request to create a SqlInjectionMatchSet.- Returns:
- A Java Future containing the result of the CreateSqlInjectionMatchSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createSqlInjectionMatchSetAsync
Future<CreateSqlInjectionMatchSetResult> createSqlInjectionMatchSetAsync(CreateSqlInjectionMatchSetRequest createSqlInjectionMatchSetRequest, AsyncHandler<CreateSqlInjectionMatchSetRequest,CreateSqlInjectionMatchSetResult> asyncHandler)
Creates a SqlInjectionMatchSet, which you use to allow, block, or count requests that contain snippets of SQL code in a specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.
To create and configure a
SqlInjectionMatchSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateSqlInjectionMatchSet
request. - Submit a
CreateSqlInjectionMatchSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateSqlInjectionMatchSet request. - Submit an UpdateSqlInjectionMatchSet request to specify the parts of web requests in which you want to allow, block, or count malicious SQL code.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createSqlInjectionMatchSetRequest
- A request to create a SqlInjectionMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateSqlInjectionMatchSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createWebACLAsync
Future<CreateWebACLResult> createWebACLAsync(CreateWebACLRequest createWebACLRequest)
Creates a
WebACL
, which contains theRules
that identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluatesRules
in order based on the value ofPriority
for eachRule
.You also specify a default action, either
ALLOW
orBLOCK
. If a web request doesn't match any of theRules
in aWebACL
, AWS WAF responds to the request with the default action.To create and configure a
WebACL
, perform the following steps:- Create and update the
ByteMatchSet
objects and other predicates that you want to include inRules
. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet. - Create and update the
Rules
that you want to include in theWebACL
. For more information, see CreateRule and UpdateRule. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateWebACL
request. - Submit a
CreateWebACL
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateWebACL request. - Submit an UpdateWebACL request to specify the
Rules
that you want to include in theWebACL
, to specify the default action, and to associate theWebACL
with a CloudFront distribution.
For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.
- Parameters:
createWebACLRequest
-- Returns:
- A Java Future containing the result of the CreateWebACL operation returned by the service.
- Create and update the
-
createWebACLAsync
Future<CreateWebACLResult> createWebACLAsync(CreateWebACLRequest createWebACLRequest, AsyncHandler<CreateWebACLRequest,CreateWebACLResult> asyncHandler)
Creates a
WebACL
, which contains theRules
that identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluatesRules
in order based on the value ofPriority
for eachRule
.You also specify a default action, either
ALLOW
orBLOCK
. If a web request doesn't match any of theRules
in aWebACL
, AWS WAF responds to the request with the default action.To create and configure a
WebACL
, perform the following steps:- Create and update the
ByteMatchSet
objects and other predicates that you want to include inRules
. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet. - Create and update the
Rules
that you want to include in theWebACL
. For more information, see CreateRule and UpdateRule. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateWebACL
request. - Submit a
CreateWebACL
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateWebACL request. - Submit an UpdateWebACL request to specify the
Rules
that you want to include in theWebACL
, to specify the default action, and to associate theWebACL
with a CloudFront distribution.
For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.
- Parameters:
createWebACLRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateWebACL operation returned by the service.
- Create and update the
-
createXssMatchSetAsync
Future<CreateXssMatchSetResult> createXssMatchSetAsync(CreateXssMatchSetRequest createXssMatchSetRequest)
Creates an XssMatchSet, which you use to allow, block, or count requests that contain cross-site scripting attacks in the specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.
To create and configure an
XssMatchSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateXssMatchSet
request. - Submit a
CreateXssMatchSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateXssMatchSet request. - Submit an UpdateXssMatchSet request to specify the parts of web requests in which you want to allow, block, or count cross-site scripting attacks.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createXssMatchSetRequest
- A request to create an XssMatchSet.- Returns:
- A Java Future containing the result of the CreateXssMatchSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
createXssMatchSetAsync
Future<CreateXssMatchSetResult> createXssMatchSetAsync(CreateXssMatchSetRequest createXssMatchSetRequest, AsyncHandler<CreateXssMatchSetRequest,CreateXssMatchSetResult> asyncHandler)
Creates an XssMatchSet, which you use to allow, block, or count requests that contain cross-site scripting attacks in the specified part of web requests. AWS WAF searches for character sequences that are likely to be malicious strings.
To create and configure an
XssMatchSet
, perform the following steps:- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aCreateXssMatchSet
request. - Submit a
CreateXssMatchSet
request. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateXssMatchSet request. - Submit an UpdateXssMatchSet request to specify the parts of web requests in which you want to allow, block, or count cross-site scripting attacks.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
createXssMatchSetRequest
- A request to create an XssMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the CreateXssMatchSet operation returned by the service.
- Use GetChangeToken to get the change token that you provide in
the
-
deleteByteMatchSetAsync
Future<DeleteByteMatchSetResult> deleteByteMatchSetAsync(DeleteByteMatchSetRequest deleteByteMatchSetRequest)
Permanently deletes a ByteMatchSet. You can't delete a
ByteMatchSet
if it's still used in anyRules
or if it still includes any ByteMatchTuple objects (any filters).If you just want to remove a
ByteMatchSet
from aRule
, use UpdateRule.To permanently delete a
ByteMatchSet
, perform the following steps:- Update the
ByteMatchSet
to remove filters, if any. For more information, see UpdateByteMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteByteMatchSet
request. - Submit a
DeleteByteMatchSet
request.
- Parameters:
deleteByteMatchSetRequest
-- Returns:
- A Java Future containing the result of the DeleteByteMatchSet operation returned by the service.
- Update the
-
deleteByteMatchSetAsync
Future<DeleteByteMatchSetResult> deleteByteMatchSetAsync(DeleteByteMatchSetRequest deleteByteMatchSetRequest, AsyncHandler<DeleteByteMatchSetRequest,DeleteByteMatchSetResult> asyncHandler)
Permanently deletes a ByteMatchSet. You can't delete a
ByteMatchSet
if it's still used in anyRules
or if it still includes any ByteMatchTuple objects (any filters).If you just want to remove a
ByteMatchSet
from aRule
, use UpdateRule.To permanently delete a
ByteMatchSet
, perform the following steps:- Update the
ByteMatchSet
to remove filters, if any. For more information, see UpdateByteMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteByteMatchSet
request. - Submit a
DeleteByteMatchSet
request.
- Parameters:
deleteByteMatchSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteByteMatchSet operation returned by the service.
- Update the
-
deleteIPSetAsync
Future<DeleteIPSetResult> deleteIPSetAsync(DeleteIPSetRequest deleteIPSetRequest)
Permanently deletes an IPSet. You can't delete an
IPSet
if it's still used in anyRules
or if it still includes any IP addresses.If you just want to remove an
IPSet
from aRule
, use UpdateRule.To permanently delete an
IPSet
from AWS WAF, perform the following steps:- Update the
IPSet
to remove IP address ranges, if any. For more information, see UpdateIPSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteIPSet
request. - Submit a
DeleteIPSet
request.
- Parameters:
deleteIPSetRequest
-- Returns:
- A Java Future containing the result of the DeleteIPSet operation returned by the service.
- Update the
-
deleteIPSetAsync
Future<DeleteIPSetResult> deleteIPSetAsync(DeleteIPSetRequest deleteIPSetRequest, AsyncHandler<DeleteIPSetRequest,DeleteIPSetResult> asyncHandler)
Permanently deletes an IPSet. You can't delete an
IPSet
if it's still used in anyRules
or if it still includes any IP addresses.If you just want to remove an
IPSet
from aRule
, use UpdateRule.To permanently delete an
IPSet
from AWS WAF, perform the following steps:- Update the
IPSet
to remove IP address ranges, if any. For more information, see UpdateIPSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteIPSet
request. - Submit a
DeleteIPSet
request.
- Parameters:
deleteIPSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteIPSet operation returned by the service.
- Update the
-
deleteRuleAsync
Future<DeleteRuleResult> deleteRuleAsync(DeleteRuleRequest deleteRuleRequest)
Permanently deletes a Rule. You can't delete a
Rule
if it's still used in anyWebACL
objects or if it still includes any predicates, such asByteMatchSet
objects.If you just want to remove a
Rule
from aWebACL
, use UpdateWebACL.To permanently delete a
Rule
from AWS WAF, perform the following steps:- Update the
Rule
to remove predicates, if any. For more information, see UpdateRule. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteRule
request. - Submit a
DeleteRule
request.
- Parameters:
deleteRuleRequest
-- Returns:
- A Java Future containing the result of the DeleteRule operation returned by the service.
- Update the
-
deleteRuleAsync
Future<DeleteRuleResult> deleteRuleAsync(DeleteRuleRequest deleteRuleRequest, AsyncHandler<DeleteRuleRequest,DeleteRuleResult> asyncHandler)
Permanently deletes a Rule. You can't delete a
Rule
if it's still used in anyWebACL
objects or if it still includes any predicates, such asByteMatchSet
objects.If you just want to remove a
Rule
from aWebACL
, use UpdateWebACL.To permanently delete a
Rule
from AWS WAF, perform the following steps:- Update the
Rule
to remove predicates, if any. For more information, see UpdateRule. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteRule
request. - Submit a
DeleteRule
request.
- Parameters:
deleteRuleRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteRule operation returned by the service.
- Update the
-
deleteSizeConstraintSetAsync
Future<DeleteSizeConstraintSetResult> deleteSizeConstraintSetAsync(DeleteSizeConstraintSetRequest deleteSizeConstraintSetRequest)
Permanently deletes a SizeConstraintSet. You can't delete a
SizeConstraintSet
if it's still used in anyRules
or if it still includes any SizeConstraint objects (any filters).If you just want to remove a
SizeConstraintSet
from aRule
, use UpdateRule.To permanently delete a
SizeConstraintSet
, perform the following steps:- Update the
SizeConstraintSet
to remove filters, if any. For more information, see UpdateSizeConstraintSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteSizeConstraintSet
request. - Submit a
DeleteSizeConstraintSet
request.
- Parameters:
deleteSizeConstraintSetRequest
-- Returns:
- A Java Future containing the result of the DeleteSizeConstraintSet operation returned by the service.
- Update the
-
deleteSizeConstraintSetAsync
Future<DeleteSizeConstraintSetResult> deleteSizeConstraintSetAsync(DeleteSizeConstraintSetRequest deleteSizeConstraintSetRequest, AsyncHandler<DeleteSizeConstraintSetRequest,DeleteSizeConstraintSetResult> asyncHandler)
Permanently deletes a SizeConstraintSet. You can't delete a
SizeConstraintSet
if it's still used in anyRules
or if it still includes any SizeConstraint objects (any filters).If you just want to remove a
SizeConstraintSet
from aRule
, use UpdateRule.To permanently delete a
SizeConstraintSet
, perform the following steps:- Update the
SizeConstraintSet
to remove filters, if any. For more information, see UpdateSizeConstraintSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteSizeConstraintSet
request. - Submit a
DeleteSizeConstraintSet
request.
- Parameters:
deleteSizeConstraintSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteSizeConstraintSet operation returned by the service.
- Update the
-
deleteSqlInjectionMatchSetAsync
Future<DeleteSqlInjectionMatchSetResult> deleteSqlInjectionMatchSetAsync(DeleteSqlInjectionMatchSetRequest deleteSqlInjectionMatchSetRequest)
Permanently deletes a SqlInjectionMatchSet. You can't delete a
SqlInjectionMatchSet
if it's still used in anyRules
or if it still contains any SqlInjectionMatchTuple objects.If you just want to remove a
SqlInjectionMatchSet
from aRule
, use UpdateRule.To permanently delete a
SqlInjectionMatchSet
from AWS WAF, perform the following steps:- Update the
SqlInjectionMatchSet
to remove filters, if any. For more information, see UpdateSqlInjectionMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteSqlInjectionMatchSet
request. - Submit a
DeleteSqlInjectionMatchSet
request.
- Parameters:
deleteSqlInjectionMatchSetRequest
- A request to delete a SqlInjectionMatchSet from AWS WAF.- Returns:
- A Java Future containing the result of the DeleteSqlInjectionMatchSet operation returned by the service.
- Update the
-
deleteSqlInjectionMatchSetAsync
Future<DeleteSqlInjectionMatchSetResult> deleteSqlInjectionMatchSetAsync(DeleteSqlInjectionMatchSetRequest deleteSqlInjectionMatchSetRequest, AsyncHandler<DeleteSqlInjectionMatchSetRequest,DeleteSqlInjectionMatchSetResult> asyncHandler)
Permanently deletes a SqlInjectionMatchSet. You can't delete a
SqlInjectionMatchSet
if it's still used in anyRules
or if it still contains any SqlInjectionMatchTuple objects.If you just want to remove a
SqlInjectionMatchSet
from aRule
, use UpdateRule.To permanently delete a
SqlInjectionMatchSet
from AWS WAF, perform the following steps:- Update the
SqlInjectionMatchSet
to remove filters, if any. For more information, see UpdateSqlInjectionMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteSqlInjectionMatchSet
request. - Submit a
DeleteSqlInjectionMatchSet
request.
- Parameters:
deleteSqlInjectionMatchSetRequest
- A request to delete a SqlInjectionMatchSet from AWS WAF.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteSqlInjectionMatchSet operation returned by the service.
- Update the
-
deleteWebACLAsync
Future<DeleteWebACLResult> deleteWebACLAsync(DeleteWebACLRequest deleteWebACLRequest)
Permanently deletes a WebACL. You can't delete a
WebACL
if it still contains anyRules
.To delete a
WebACL
, perform the following steps:- Update the
WebACL
to removeRules
, if any. For more information, see UpdateWebACL. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteWebACL
request. - Submit a
DeleteWebACL
request.
- Parameters:
deleteWebACLRequest
-- Returns:
- A Java Future containing the result of the DeleteWebACL operation returned by the service.
- Update the
-
deleteWebACLAsync
Future<DeleteWebACLResult> deleteWebACLAsync(DeleteWebACLRequest deleteWebACLRequest, AsyncHandler<DeleteWebACLRequest,DeleteWebACLResult> asyncHandler)
Permanently deletes a WebACL. You can't delete a
WebACL
if it still contains anyRules
.To delete a
WebACL
, perform the following steps:- Update the
WebACL
to removeRules
, if any. For more information, see UpdateWebACL. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteWebACL
request. - Submit a
DeleteWebACL
request.
- Parameters:
deleteWebACLRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteWebACL operation returned by the service.
- Update the
-
deleteXssMatchSetAsync
Future<DeleteXssMatchSetResult> deleteXssMatchSetAsync(DeleteXssMatchSetRequest deleteXssMatchSetRequest)
Permanently deletes an XssMatchSet. You can't delete an
XssMatchSet
if it's still used in anyRules
or if it still contains any XssMatchTuple objects.If you just want to remove an
XssMatchSet
from aRule
, use UpdateRule.To permanently delete an
XssMatchSet
from AWS WAF, perform the following steps:- Update the
XssMatchSet
to remove filters, if any. For more information, see UpdateXssMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteXssMatchSet
request. - Submit a
DeleteXssMatchSet
request.
- Parameters:
deleteXssMatchSetRequest
- A request to delete an XssMatchSet from AWS WAF.- Returns:
- A Java Future containing the result of the DeleteXssMatchSet operation returned by the service.
- Update the
-
deleteXssMatchSetAsync
Future<DeleteXssMatchSetResult> deleteXssMatchSetAsync(DeleteXssMatchSetRequest deleteXssMatchSetRequest, AsyncHandler<DeleteXssMatchSetRequest,DeleteXssMatchSetResult> asyncHandler)
Permanently deletes an XssMatchSet. You can't delete an
XssMatchSet
if it's still used in anyRules
or if it still contains any XssMatchTuple objects.If you just want to remove an
XssMatchSet
from aRule
, use UpdateRule.To permanently delete an
XssMatchSet
from AWS WAF, perform the following steps:- Update the
XssMatchSet
to remove filters, if any. For more information, see UpdateXssMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of aDeleteXssMatchSet
request. - Submit a
DeleteXssMatchSet
request.
- Parameters:
deleteXssMatchSetRequest
- A request to delete an XssMatchSet from AWS WAF.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the DeleteXssMatchSet operation returned by the service.
- Update the
-
getByteMatchSetAsync
Future<GetByteMatchSetResult> getByteMatchSetAsync(GetByteMatchSetRequest getByteMatchSetRequest)
Returns the ByteMatchSet specified by
ByteMatchSetId
.- Parameters:
getByteMatchSetRequest
-- Returns:
- A Java Future containing the result of the GetByteMatchSet operation returned by the service.
-
getByteMatchSetAsync
Future<GetByteMatchSetResult> getByteMatchSetAsync(GetByteMatchSetRequest getByteMatchSetRequest, AsyncHandler<GetByteMatchSetRequest,GetByteMatchSetResult> asyncHandler)
Returns the ByteMatchSet specified by
ByteMatchSetId
.- Parameters:
getByteMatchSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetByteMatchSet operation returned by the service.
-
getChangeTokenAsync
Future<GetChangeTokenResult> getChangeTokenAsync(GetChangeTokenRequest getChangeTokenRequest)
When you want to create, update, or delete AWS WAF objects, get a change token and include the change token in the create, update, or delete request. Change tokens ensure that your application doesn't submit conflicting requests to AWS WAF.
Each create, update, or delete request must use a unique change token. If your application submits a
GetChangeToken
request and then submits a secondGetChangeToken
request before submitting a create, update, or delete request, the secondGetChangeToken
request returns the same value as the firstGetChangeToken
request.When you use a change token in a create, update, or delete request, the status of the change token changes to
PENDING
, which indicates that AWS WAF is propagating the change to all AWS WAF servers. UseGetChangeTokenStatus
to determine the status of your change token.- Parameters:
getChangeTokenRequest
-- Returns:
- A Java Future containing the result of the GetChangeToken operation returned by the service.
-
getChangeTokenAsync
Future<GetChangeTokenResult> getChangeTokenAsync(GetChangeTokenRequest getChangeTokenRequest, AsyncHandler<GetChangeTokenRequest,GetChangeTokenResult> asyncHandler)
When you want to create, update, or delete AWS WAF objects, get a change token and include the change token in the create, update, or delete request. Change tokens ensure that your application doesn't submit conflicting requests to AWS WAF.
Each create, update, or delete request must use a unique change token. If your application submits a
GetChangeToken
request and then submits a secondGetChangeToken
request before submitting a create, update, or delete request, the secondGetChangeToken
request returns the same value as the firstGetChangeToken
request.When you use a change token in a create, update, or delete request, the status of the change token changes to
PENDING
, which indicates that AWS WAF is propagating the change to all AWS WAF servers. UseGetChangeTokenStatus
to determine the status of your change token.- Parameters:
getChangeTokenRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetChangeToken operation returned by the service.
-
getChangeTokenStatusAsync
Future<GetChangeTokenStatusResult> getChangeTokenStatusAsync(GetChangeTokenStatusRequest getChangeTokenStatusRequest)
Returns the status of a
ChangeToken
that you got by calling GetChangeToken.ChangeTokenStatus
is one of the following values:PROVISIONED
: You requested the change token by callingGetChangeToken
, but you haven't used it yet in a call to create, update, or delete an AWS WAF object.PENDING
: AWS WAF is propagating the create, update, or delete request to all AWS WAF servers.IN_SYNC
: Propagation is complete.
- Parameters:
getChangeTokenStatusRequest
-- Returns:
- A Java Future containing the result of the GetChangeTokenStatus operation returned by the service.
-
getChangeTokenStatusAsync
Future<GetChangeTokenStatusResult> getChangeTokenStatusAsync(GetChangeTokenStatusRequest getChangeTokenStatusRequest, AsyncHandler<GetChangeTokenStatusRequest,GetChangeTokenStatusResult> asyncHandler)
Returns the status of a
ChangeToken
that you got by calling GetChangeToken.ChangeTokenStatus
is one of the following values:PROVISIONED
: You requested the change token by callingGetChangeToken
, but you haven't used it yet in a call to create, update, or delete an AWS WAF object.PENDING
: AWS WAF is propagating the create, update, or delete request to all AWS WAF servers.IN_SYNC
: Propagation is complete.
- Parameters:
getChangeTokenStatusRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetChangeTokenStatus operation returned by the service.
-
getIPSetAsync
Future<GetIPSetResult> getIPSetAsync(GetIPSetRequest getIPSetRequest)
Returns the IPSet that is specified by
IPSetId
.- Parameters:
getIPSetRequest
-- Returns:
- A Java Future containing the result of the GetIPSet operation returned by the service.
-
getIPSetAsync
Future<GetIPSetResult> getIPSetAsync(GetIPSetRequest getIPSetRequest, AsyncHandler<GetIPSetRequest,GetIPSetResult> asyncHandler)
Returns the IPSet that is specified by
IPSetId
.- Parameters:
getIPSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetIPSet operation returned by the service.
-
getRuleAsync
Future<GetRuleResult> getRuleAsync(GetRuleRequest getRuleRequest)
Returns the Rule that is specified by the
RuleId
that you included in theGetRule
request.- Parameters:
getRuleRequest
-- Returns:
- A Java Future containing the result of the GetRule operation returned by the service.
-
getRuleAsync
Future<GetRuleResult> getRuleAsync(GetRuleRequest getRuleRequest, AsyncHandler<GetRuleRequest,GetRuleResult> asyncHandler)
Returns the Rule that is specified by the
RuleId
that you included in theGetRule
request.- Parameters:
getRuleRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetRule operation returned by the service.
-
getSampledRequestsAsync
Future<GetSampledRequestsResult> getSampledRequestsAsync(GetSampledRequestsRequest getSampledRequestsRequest)
Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 100 requests, and you can specify any time range in the previous three hours.
GetSampledRequests
returns a time range, which is usually the time range that you specified. However, if your resource (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed,GetSampledRequests
returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.- Parameters:
getSampledRequestsRequest
-- Returns:
- A Java Future containing the result of the GetSampledRequests operation returned by the service.
-
getSampledRequestsAsync
Future<GetSampledRequestsResult> getSampledRequestsAsync(GetSampledRequestsRequest getSampledRequestsRequest, AsyncHandler<GetSampledRequestsRequest,GetSampledRequestsResult> asyncHandler)
Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 100 requests, and you can specify any time range in the previous three hours.
GetSampledRequests
returns a time range, which is usually the time range that you specified. However, if your resource (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed,GetSampledRequests
returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.- Parameters:
getSampledRequestsRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetSampledRequests operation returned by the service.
-
getSizeConstraintSetAsync
Future<GetSizeConstraintSetResult> getSizeConstraintSetAsync(GetSizeConstraintSetRequest getSizeConstraintSetRequest)
Returns the SizeConstraintSet specified by
SizeConstraintSetId
.- Parameters:
getSizeConstraintSetRequest
-- Returns:
- A Java Future containing the result of the GetSizeConstraintSet operation returned by the service.
-
getSizeConstraintSetAsync
Future<GetSizeConstraintSetResult> getSizeConstraintSetAsync(GetSizeConstraintSetRequest getSizeConstraintSetRequest, AsyncHandler<GetSizeConstraintSetRequest,GetSizeConstraintSetResult> asyncHandler)
Returns the SizeConstraintSet specified by
SizeConstraintSetId
.- Parameters:
getSizeConstraintSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetSizeConstraintSet operation returned by the service.
-
getSqlInjectionMatchSetAsync
Future<GetSqlInjectionMatchSetResult> getSqlInjectionMatchSetAsync(GetSqlInjectionMatchSetRequest getSqlInjectionMatchSetRequest)
Returns the SqlInjectionMatchSet that is specified by
SqlInjectionMatchSetId
.- Parameters:
getSqlInjectionMatchSetRequest
- A request to get a SqlInjectionMatchSet.- Returns:
- A Java Future containing the result of the GetSqlInjectionMatchSet operation returned by the service.
-
getSqlInjectionMatchSetAsync
Future<GetSqlInjectionMatchSetResult> getSqlInjectionMatchSetAsync(GetSqlInjectionMatchSetRequest getSqlInjectionMatchSetRequest, AsyncHandler<GetSqlInjectionMatchSetRequest,GetSqlInjectionMatchSetResult> asyncHandler)
Returns the SqlInjectionMatchSet that is specified by
SqlInjectionMatchSetId
.- Parameters:
getSqlInjectionMatchSetRequest
- A request to get a SqlInjectionMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetSqlInjectionMatchSet operation returned by the service.
-
getWebACLAsync
Future<GetWebACLResult> getWebACLAsync(GetWebACLRequest getWebACLRequest)
Returns the WebACL that is specified by
WebACLId
.- Parameters:
getWebACLRequest
-- Returns:
- A Java Future containing the result of the GetWebACL operation returned by the service.
-
getWebACLAsync
Future<GetWebACLResult> getWebACLAsync(GetWebACLRequest getWebACLRequest, AsyncHandler<GetWebACLRequest,GetWebACLResult> asyncHandler)
Returns the WebACL that is specified by
WebACLId
.- Parameters:
getWebACLRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetWebACL operation returned by the service.
-
getXssMatchSetAsync
Future<GetXssMatchSetResult> getXssMatchSetAsync(GetXssMatchSetRequest getXssMatchSetRequest)
Returns the XssMatchSet that is specified by
XssMatchSetId
.- Parameters:
getXssMatchSetRequest
- A request to get an XssMatchSet.- Returns:
- A Java Future containing the result of the GetXssMatchSet operation returned by the service.
-
getXssMatchSetAsync
Future<GetXssMatchSetResult> getXssMatchSetAsync(GetXssMatchSetRequest getXssMatchSetRequest, AsyncHandler<GetXssMatchSetRequest,GetXssMatchSetResult> asyncHandler)
Returns the XssMatchSet that is specified by
XssMatchSetId
.- Parameters:
getXssMatchSetRequest
- A request to get an XssMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the GetXssMatchSet operation returned by the service.
-
listByteMatchSetsAsync
Future<ListByteMatchSetsResult> listByteMatchSetsAsync(ListByteMatchSetsRequest listByteMatchSetsRequest)
Returns an array of ByteMatchSetSummary objects.
- Parameters:
listByteMatchSetsRequest
-- Returns:
- A Java Future containing the result of the ListByteMatchSets operation returned by the service.
-
listByteMatchSetsAsync
Future<ListByteMatchSetsResult> listByteMatchSetsAsync(ListByteMatchSetsRequest listByteMatchSetsRequest, AsyncHandler<ListByteMatchSetsRequest,ListByteMatchSetsResult> asyncHandler)
Returns an array of ByteMatchSetSummary objects.
- Parameters:
listByteMatchSetsRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListByteMatchSets operation returned by the service.
-
listIPSetsAsync
Future<ListIPSetsResult> listIPSetsAsync(ListIPSetsRequest listIPSetsRequest)
Returns an array of IPSetSummary objects in the response.
- Parameters:
listIPSetsRequest
-- Returns:
- A Java Future containing the result of the ListIPSets operation returned by the service.
-
listIPSetsAsync
Future<ListIPSetsResult> listIPSetsAsync(ListIPSetsRequest listIPSetsRequest, AsyncHandler<ListIPSetsRequest,ListIPSetsResult> asyncHandler)
Returns an array of IPSetSummary objects in the response.
- Parameters:
listIPSetsRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListIPSets operation returned by the service.
-
listRulesAsync
Future<ListRulesResult> listRulesAsync(ListRulesRequest listRulesRequest)
Returns an array of RuleSummary objects.
- Parameters:
listRulesRequest
-- Returns:
- A Java Future containing the result of the ListRules operation returned by the service.
-
listRulesAsync
Future<ListRulesResult> listRulesAsync(ListRulesRequest listRulesRequest, AsyncHandler<ListRulesRequest,ListRulesResult> asyncHandler)
Returns an array of RuleSummary objects.
- Parameters:
listRulesRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListRules operation returned by the service.
-
listSizeConstraintSetsAsync
Future<ListSizeConstraintSetsResult> listSizeConstraintSetsAsync(ListSizeConstraintSetsRequest listSizeConstraintSetsRequest)
Returns an array of SizeConstraintSetSummary objects.
- Parameters:
listSizeConstraintSetsRequest
-- Returns:
- A Java Future containing the result of the ListSizeConstraintSets operation returned by the service.
-
listSizeConstraintSetsAsync
Future<ListSizeConstraintSetsResult> listSizeConstraintSetsAsync(ListSizeConstraintSetsRequest listSizeConstraintSetsRequest, AsyncHandler<ListSizeConstraintSetsRequest,ListSizeConstraintSetsResult> asyncHandler)
Returns an array of SizeConstraintSetSummary objects.
- Parameters:
listSizeConstraintSetsRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListSizeConstraintSets operation returned by the service.
-
listSqlInjectionMatchSetsAsync
Future<ListSqlInjectionMatchSetsResult> listSqlInjectionMatchSetsAsync(ListSqlInjectionMatchSetsRequest listSqlInjectionMatchSetsRequest)
Returns an array of SqlInjectionMatchSet objects.
- Parameters:
listSqlInjectionMatchSetsRequest
- A request to list the SqlInjectionMatchSet objects created by the current AWS account.- Returns:
- A Java Future containing the result of the ListSqlInjectionMatchSets operation returned by the service.
-
listSqlInjectionMatchSetsAsync
Future<ListSqlInjectionMatchSetsResult> listSqlInjectionMatchSetsAsync(ListSqlInjectionMatchSetsRequest listSqlInjectionMatchSetsRequest, AsyncHandler<ListSqlInjectionMatchSetsRequest,ListSqlInjectionMatchSetsResult> asyncHandler)
Returns an array of SqlInjectionMatchSet objects.
- Parameters:
listSqlInjectionMatchSetsRequest
- A request to list the SqlInjectionMatchSet objects created by the current AWS account.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListSqlInjectionMatchSets operation returned by the service.
-
listWebACLsAsync
Future<ListWebACLsResult> listWebACLsAsync(ListWebACLsRequest listWebACLsRequest)
Returns an array of WebACLSummary objects in the response.
- Parameters:
listWebACLsRequest
-- Returns:
- A Java Future containing the result of the ListWebACLs operation returned by the service.
-
listWebACLsAsync
Future<ListWebACLsResult> listWebACLsAsync(ListWebACLsRequest listWebACLsRequest, AsyncHandler<ListWebACLsRequest,ListWebACLsResult> asyncHandler)
Returns an array of WebACLSummary objects in the response.
- Parameters:
listWebACLsRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListWebACLs operation returned by the service.
-
listXssMatchSetsAsync
Future<ListXssMatchSetsResult> listXssMatchSetsAsync(ListXssMatchSetsRequest listXssMatchSetsRequest)
Returns an array of XssMatchSet objects.
- Parameters:
listXssMatchSetsRequest
- A request to list the XssMatchSet objects created by the current AWS account.- Returns:
- A Java Future containing the result of the ListXssMatchSets operation returned by the service.
-
listXssMatchSetsAsync
Future<ListXssMatchSetsResult> listXssMatchSetsAsync(ListXssMatchSetsRequest listXssMatchSetsRequest, AsyncHandler<ListXssMatchSetsRequest,ListXssMatchSetsResult> asyncHandler)
Returns an array of XssMatchSet objects.
- Parameters:
listXssMatchSetsRequest
- A request to list the XssMatchSet objects created by the current AWS account.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the ListXssMatchSets operation returned by the service.
-
updateByteMatchSetAsync
Future<UpdateByteMatchSetResult> updateByteMatchSetAsync(UpdateByteMatchSetRequest updateByteMatchSetRequest)
Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet. For each
ByteMatchTuple
object, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
ByteMatchSetUpdate
object, you delete the existing object and add a new one. - The part of a web request that you want AWS WAF to inspect, such as a
query string or the value of the
User-Agent
header. - The bytes (typically a string that corresponds with ASCII characters)
that you want AWS WAF to look for. For more information, including how
you specify the values for the AWS WAF API and the AWS CLI or SDKs, see
TargetString
in the ByteMatchTuple data type. - Where to look, such as at the beginning or the end of a query string.
- Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.
For example, you can add a
ByteMatchSetUpdate
object that matches web requests in whichUser-Agent
headers contain the stringBadBot
. You can then configure AWS WAF to block those requests.To create and configure a
ByteMatchSet
, perform the following steps:- Create a
ByteMatchSet.
For more information, see CreateByteMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of anUpdateByteMatchSet
request. - Submit an
UpdateByteMatchSet
request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateByteMatchSetRequest
-- Returns:
- A Java Future containing the result of the UpdateByteMatchSet operation returned by the service.
- Whether to insert or delete the object from the array. If you want to
change a
-
updateByteMatchSetAsync
Future<UpdateByteMatchSetResult> updateByteMatchSetAsync(UpdateByteMatchSetRequest updateByteMatchSetRequest, AsyncHandler<UpdateByteMatchSetRequest,UpdateByteMatchSetResult> asyncHandler)
Inserts or deletes ByteMatchTuple objects (filters) in a ByteMatchSet. For each
ByteMatchTuple
object, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
ByteMatchSetUpdate
object, you delete the existing object and add a new one. - The part of a web request that you want AWS WAF to inspect, such as a
query string or the value of the
User-Agent
header. - The bytes (typically a string that corresponds with ASCII characters)
that you want AWS WAF to look for. For more information, including how
you specify the values for the AWS WAF API and the AWS CLI or SDKs, see
TargetString
in the ByteMatchTuple data type. - Where to look, such as at the beginning or the end of a query string.
- Whether to perform any conversions on the request, such as converting it to lowercase, before inspecting it for the specified string.
For example, you can add a
ByteMatchSetUpdate
object that matches web requests in whichUser-Agent
headers contain the stringBadBot
. You can then configure AWS WAF to block those requests.To create and configure a
ByteMatchSet
, perform the following steps:- Create a
ByteMatchSet.
For more information, see CreateByteMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of anUpdateByteMatchSet
request. - Submit an
UpdateByteMatchSet
request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateByteMatchSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateByteMatchSet operation returned by the service.
- Whether to insert or delete the object from the array. If you want to
change a
-
updateIPSetAsync
Future<UpdateIPSetResult> updateIPSetAsync(UpdateIPSetRequest updateIPSetRequest)
Inserts or deletes IPSetDescriptor objects in an
IPSet
. For eachIPSetDescriptor
object, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change an
IPSetDescriptor
object, you delete the existing object and add a new one. - The IP address version,
IPv4
. - The IP address in CIDR notation, for example,
192.0.2.0/24
(for the range of IP addresses from192.0.2.0
to192.0.2.255
) or192.0.2.44/32
(for the individual IP address192.0.2.44
).
AWS WAF supports /8, /16, /24, and /32 IP address ranges. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
You use an
IPSet
to specify which web requests you want to allow or block based on the IP addresses that the requests originated from. For example, if you're receiving a lot of requests from one or a small number of IP addresses and you want to block the requests, you can create anIPSet
that specifies those IP addresses, and then configure AWS WAF to block the requests.To create and configure an
IPSet
, perform the following steps:- Submit a CreateIPSet request.
- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateIPSet
request to specify the IP addresses that you want AWS WAF to watch for.
When you update an
IPSet
, you specify the IP addresses that you want to add and/or the IP addresses that you want to delete. If you want to change an IP address, you delete the existing IP address and add the new one.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateIPSetRequest
-- Returns:
- A Java Future containing the result of the UpdateIPSet operation returned by the service.
- Whether to insert or delete the object from the array. If you want to
change an
-
updateIPSetAsync
Future<UpdateIPSetResult> updateIPSetAsync(UpdateIPSetRequest updateIPSetRequest, AsyncHandler<UpdateIPSetRequest,UpdateIPSetResult> asyncHandler)
Inserts or deletes IPSetDescriptor objects in an
IPSet
. For eachIPSetDescriptor
object, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change an
IPSetDescriptor
object, you delete the existing object and add a new one. - The IP address version,
IPv4
. - The IP address in CIDR notation, for example,
192.0.2.0/24
(for the range of IP addresses from192.0.2.0
to192.0.2.255
) or192.0.2.44/32
(for the individual IP address192.0.2.44
).
AWS WAF supports /8, /16, /24, and /32 IP address ranges. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
You use an
IPSet
to specify which web requests you want to allow or block based on the IP addresses that the requests originated from. For example, if you're receiving a lot of requests from one or a small number of IP addresses and you want to block the requests, you can create anIPSet
that specifies those IP addresses, and then configure AWS WAF to block the requests.To create and configure an
IPSet
, perform the following steps:- Submit a CreateIPSet request.
- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateIPSet
request to specify the IP addresses that you want AWS WAF to watch for.
When you update an
IPSet
, you specify the IP addresses that you want to add and/or the IP addresses that you want to delete. If you want to change an IP address, you delete the existing IP address and add the new one.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateIPSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateIPSet operation returned by the service.
- Whether to insert or delete the object from the array. If you want to
change an
-
updateRuleAsync
Future<UpdateRuleResult> updateRuleAsync(UpdateRuleRequest updateRuleRequest)
Inserts or deletes Predicate objects in a
Rule
. EachPredicate
object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests that you want to allow, block, or count. If you add more than one predicate to aRule
, a request must match all of the specifications to be allowed, blocked, or counted. For example, suppose you add the following to aRule
:- A
ByteMatchSet
that matches the valueBadBot
in theUser-Agent
header - An
IPSet
that matches the IP address192.0.2.44
You then add the
Rule
to aWebACL
and specify that you want to block requests that satisfy theRule
. For a request to be blocked, theUser-Agent
header in the request must contain the valueBadBot
and the request must originate from the IP address 192.0.2.44.To create and configure a
Rule
, perform the following steps:- Create and update the predicates that you want to include in the
Rule
. - Create the
Rule
. See CreateRule. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateRule request. - Submit an
UpdateRule
request to add predicates to theRule
. - Create and update a
WebACL
that contains theRule
. See CreateWebACL.
If you want to replace one
ByteMatchSet
orIPSet
with another, you delete the existing one and add the new one.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateRuleRequest
-- Returns:
- A Java Future containing the result of the UpdateRule operation returned by the service.
- A
-
updateRuleAsync
Future<UpdateRuleResult> updateRuleAsync(UpdateRuleRequest updateRuleRequest, AsyncHandler<UpdateRuleRequest,UpdateRuleResult> asyncHandler)
Inserts or deletes Predicate objects in a
Rule
. EachPredicate
object identifies a predicate, such as a ByteMatchSet or an IPSet, that specifies the web requests that you want to allow, block, or count. If you add more than one predicate to aRule
, a request must match all of the specifications to be allowed, blocked, or counted. For example, suppose you add the following to aRule
:- A
ByteMatchSet
that matches the valueBadBot
in theUser-Agent
header - An
IPSet
that matches the IP address192.0.2.44
You then add the
Rule
to aWebACL
and specify that you want to block requests that satisfy theRule
. For a request to be blocked, theUser-Agent
header in the request must contain the valueBadBot
and the request must originate from the IP address 192.0.2.44.To create and configure a
Rule
, perform the following steps:- Create and update the predicates that you want to include in the
Rule
. - Create the
Rule
. See CreateRule. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateRule request. - Submit an
UpdateRule
request to add predicates to theRule
. - Create and update a
WebACL
that contains theRule
. See CreateWebACL.
If you want to replace one
ByteMatchSet
orIPSet
with another, you delete the existing one and add the new one.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateRuleRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateRule operation returned by the service.
- A
-
updateSizeConstraintSetAsync
Future<UpdateSizeConstraintSetResult> updateSizeConstraintSetAsync(UpdateSizeConstraintSetRequest updateSizeConstraintSetRequest)
Inserts or deletes SizeConstraint objects (filters) in a SizeConstraintSet. For each
SizeConstraint
object, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
SizeConstraintSetUpdate
object, you delete the existing object and add a new one. - The part of a web request that you want AWS WAF to evaluate, such as
the length of a query string or the length of the
User-Agent
header. - Whether to perform any transformations on the request, such as
converting it to lowercase, before checking its length. Note that
transformations of the request body are not supported because the AWS
resource forwards only the first
8192
bytes of your request to AWS WAF. - A
ComparisonOperator
used for evaluating the selected part of the request against the specifiedSize
, such as equals, greater than, less than, and so on. - The length, in bytes, that you want AWS WAF to watch for in selected part of the request. The length is computed after applying the transformation.
For example, you can add a
SizeConstraintSetUpdate
object that matches web requests in which the length of theUser-Agent
header is greater than 100 bytes. You can then configure AWS WAF to block those requests.To create and configure a
SizeConstraintSet
, perform the following steps:- Create a
SizeConstraintSet.
For more information, see CreateSizeConstraintSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of anUpdateSizeConstraintSet
request. - Submit an
UpdateSizeConstraintSet
request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateSizeConstraintSetRequest
-- Returns:
- A Java Future containing the result of the UpdateSizeConstraintSet operation returned by the service.
- Whether to insert or delete the object from the array. If you want to
change a
-
updateSizeConstraintSetAsync
Future<UpdateSizeConstraintSetResult> updateSizeConstraintSetAsync(UpdateSizeConstraintSetRequest updateSizeConstraintSetRequest, AsyncHandler<UpdateSizeConstraintSetRequest,UpdateSizeConstraintSetResult> asyncHandler)
Inserts or deletes SizeConstraint objects (filters) in a SizeConstraintSet. For each
SizeConstraint
object, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
SizeConstraintSetUpdate
object, you delete the existing object and add a new one. - The part of a web request that you want AWS WAF to evaluate, such as
the length of a query string or the length of the
User-Agent
header. - Whether to perform any transformations on the request, such as
converting it to lowercase, before checking its length. Note that
transformations of the request body are not supported because the AWS
resource forwards only the first
8192
bytes of your request to AWS WAF. - A
ComparisonOperator
used for evaluating the selected part of the request against the specifiedSize
, such as equals, greater than, less than, and so on. - The length, in bytes, that you want AWS WAF to watch for in selected part of the request. The length is computed after applying the transformation.
For example, you can add a
SizeConstraintSetUpdate
object that matches web requests in which the length of theUser-Agent
header is greater than 100 bytes. You can then configure AWS WAF to block those requests.To create and configure a
SizeConstraintSet
, perform the following steps:- Create a
SizeConstraintSet.
For more information, see CreateSizeConstraintSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of anUpdateSizeConstraintSet
request. - Submit an
UpdateSizeConstraintSet
request to specify the part of the request that you want AWS WAF to inspect (for example, the header or the URI) and the value that you want AWS WAF to watch for.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateSizeConstraintSetRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateSizeConstraintSet operation returned by the service.
- Whether to insert or delete the object from the array. If you want to
change a
-
updateSqlInjectionMatchSetAsync
Future<UpdateSqlInjectionMatchSetResult> updateSqlInjectionMatchSetAsync(UpdateSqlInjectionMatchSetRequest updateSqlInjectionMatchSetRequest)
Inserts or deletes SqlInjectionMatchTuple objects (filters) in a SqlInjectionMatchSet. For each
SqlInjectionMatchTuple
object, you specify the following values:Action
: Whether to insert the object into or delete the object from the array. To change aSqlInjectionMatchTuple
, you delete the existing object and add a new one.FieldToMatch
: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.TextTransformation
: Which text transformation, if any, to perform on the web request before inspecting the request for snippets of malicious SQL code.
You use
SqlInjectionMatchSet
objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain snippets of SQL code in the query string and you want to block the requests, you can create aSqlInjectionMatchSet
with the applicable settings, and then configure AWS WAF to block the requests.To create and configure a
SqlInjectionMatchSet
, perform the following steps:- Submit a CreateSqlInjectionMatchSet request.
- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateSqlInjectionMatchSet
request to specify the parts of web requests that you want AWS WAF to inspect for snippets of SQL code.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateSqlInjectionMatchSetRequest
- A request to update a SqlInjectionMatchSet.- Returns:
- A Java Future containing the result of the UpdateSqlInjectionMatchSet operation returned by the service.
-
updateSqlInjectionMatchSetAsync
Future<UpdateSqlInjectionMatchSetResult> updateSqlInjectionMatchSetAsync(UpdateSqlInjectionMatchSetRequest updateSqlInjectionMatchSetRequest, AsyncHandler<UpdateSqlInjectionMatchSetRequest,UpdateSqlInjectionMatchSetResult> asyncHandler)
Inserts or deletes SqlInjectionMatchTuple objects (filters) in a SqlInjectionMatchSet. For each
SqlInjectionMatchTuple
object, you specify the following values:Action
: Whether to insert the object into or delete the object from the array. To change aSqlInjectionMatchTuple
, you delete the existing object and add a new one.FieldToMatch
: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.TextTransformation
: Which text transformation, if any, to perform on the web request before inspecting the request for snippets of malicious SQL code.
You use
SqlInjectionMatchSet
objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain snippets of SQL code in the query string and you want to block the requests, you can create aSqlInjectionMatchSet
with the applicable settings, and then configure AWS WAF to block the requests.To create and configure a
SqlInjectionMatchSet
, perform the following steps:- Submit a CreateSqlInjectionMatchSet request.
- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateSqlInjectionMatchSet
request to specify the parts of web requests that you want AWS WAF to inspect for snippets of SQL code.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateSqlInjectionMatchSetRequest
- A request to update a SqlInjectionMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateSqlInjectionMatchSet operation returned by the service.
-
updateWebACLAsync
Future<UpdateWebACLResult> updateWebACLAsync(UpdateWebACLRequest updateWebACLRequest)
Inserts or deletes ActivatedRule objects in a
WebACL
. EachRule
identifies web requests that you want to allow, block, or count. When you update aWebACL
, you specify the following values:- A default action for the
WebACL
, eitherALLOW
orBLOCK
. AWS WAF performs the default action if a request doesn't match the criteria in any of theRules
in aWebACL
. - The
Rules
that you want to add and/or delete. If you want to replace oneRule
with another, you delete the existingRule
and add the new one. - For each
Rule
, whether you want AWS WAF to allow requests, block requests, or count requests that match the conditions in theRule
. - The order in which you want AWS WAF to evaluate the
Rules
in aWebACL
. If you add more than oneRule
to aWebACL
, AWS WAF evaluates each request against theRules
in order based on the value ofPriority
. (TheRule
that has the lowest value forPriority
is evaluated first.) When a web request matches all of the predicates (such asByteMatchSets
andIPSets
) in aRule
, AWS WAF immediately takes the corresponding action, allow or block, and doesn't evaluate the request against the remainingRules
in theWebACL
, if any. - The CloudFront distribution that you want to associate with the
WebACL
.
To create and configure a
WebACL
, perform the following steps:- Create and update the predicates that you want to include in
Rules
. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet. - Create and update the
Rules
that you want to include in theWebACL
. For more information, see CreateRule and UpdateRule. - Create a
WebACL
. See CreateWebACL. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateWebACL request. - Submit an
UpdateWebACL
request to specify theRules
that you want to include in theWebACL
, to specify the default action, and to associate theWebACL
with a CloudFront distribution.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateWebACLRequest
-- Returns:
- A Java Future containing the result of the UpdateWebACL operation returned by the service.
- A default action for the
-
updateWebACLAsync
Future<UpdateWebACLResult> updateWebACLAsync(UpdateWebACLRequest updateWebACLRequest, AsyncHandler<UpdateWebACLRequest,UpdateWebACLResult> asyncHandler)
Inserts or deletes ActivatedRule objects in a
WebACL
. EachRule
identifies web requests that you want to allow, block, or count. When you update aWebACL
, you specify the following values:- A default action for the
WebACL
, eitherALLOW
orBLOCK
. AWS WAF performs the default action if a request doesn't match the criteria in any of theRules
in aWebACL
. - The
Rules
that you want to add and/or delete. If you want to replace oneRule
with another, you delete the existingRule
and add the new one. - For each
Rule
, whether you want AWS WAF to allow requests, block requests, or count requests that match the conditions in theRule
. - The order in which you want AWS WAF to evaluate the
Rules
in aWebACL
. If you add more than oneRule
to aWebACL
, AWS WAF evaluates each request against theRules
in order based on the value ofPriority
. (TheRule
that has the lowest value forPriority
is evaluated first.) When a web request matches all of the predicates (such asByteMatchSets
andIPSets
) in aRule
, AWS WAF immediately takes the corresponding action, allow or block, and doesn't evaluate the request against the remainingRules
in theWebACL
, if any. - The CloudFront distribution that you want to associate with the
WebACL
.
To create and configure a
WebACL
, perform the following steps:- Create and update the predicates that you want to include in
Rules
. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet. - Create and update the
Rules
that you want to include in theWebACL
. For more information, see CreateRule and UpdateRule. - Create a
WebACL
. See CreateWebACL. - Use
GetChangeToken
to get the change token that you provide in theChangeToken
parameter of an UpdateWebACL request. - Submit an
UpdateWebACL
request to specify theRules
that you want to include in theWebACL
, to specify the default action, and to associate theWebACL
with a CloudFront distribution.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateWebACLRequest
-asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateWebACL operation returned by the service.
- A default action for the
-
updateXssMatchSetAsync
Future<UpdateXssMatchSetResult> updateXssMatchSetAsync(UpdateXssMatchSetRequest updateXssMatchSetRequest)
Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet. For each
XssMatchTuple
object, you specify the following values:Action
: Whether to insert the object into or delete the object from the array. To change aXssMatchTuple
, you delete the existing object and add a new one.FieldToMatch
: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.TextTransformation
: Which text transformation, if any, to perform on the web request before inspecting the request for cross-site scripting attacks.
You use
XssMatchSet
objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain cross-site scripting attacks in the request body and you want to block the requests, you can create anXssMatchSet
with the applicable settings, and then configure AWS WAF to block the requests.To create and configure an
XssMatchSet
, perform the following steps:- Submit a CreateXssMatchSet request.
- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateXssMatchSet
request to specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateXssMatchSetRequest
- A request to update an XssMatchSet.- Returns:
- A Java Future containing the result of the UpdateXssMatchSet operation returned by the service.
-
updateXssMatchSetAsync
Future<UpdateXssMatchSetResult> updateXssMatchSetAsync(UpdateXssMatchSetRequest updateXssMatchSetRequest, AsyncHandler<UpdateXssMatchSetRequest,UpdateXssMatchSetResult> asyncHandler)
Inserts or deletes XssMatchTuple objects (filters) in an XssMatchSet. For each
XssMatchTuple
object, you specify the following values:Action
: Whether to insert the object into or delete the object from the array. To change aXssMatchTuple
, you delete the existing object and add a new one.FieldToMatch
: The part of web requests that you want AWS WAF to inspect and, if you want AWS WAF to inspect a header, the name of the header.TextTransformation
: Which text transformation, if any, to perform on the web request before inspecting the request for cross-site scripting attacks.
You use
XssMatchSet
objects to specify which CloudFront requests you want to allow, block, or count. For example, if you're receiving requests that contain cross-site scripting attacks in the request body and you want to block the requests, you can create anXssMatchSet
with the applicable settings, and then configure AWS WAF to block the requests.To create and configure an
XssMatchSet
, perform the following steps:- Submit a CreateXssMatchSet request.
- Use GetChangeToken to get the change token that you provide in
the
ChangeToken
parameter of an UpdateIPSet request. - Submit an
UpdateXssMatchSet
request to specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks.
For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
- Parameters:
updateXssMatchSetRequest
- A request to update an XssMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.- Returns:
- A Java Future containing the result of the UpdateXssMatchSet operation returned by the service.
-
-