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 anAsyncHandlercan 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-Agentheader or the query string. For example, you can create aByteMatchSetthat matches any requests withUser-Agentheaders 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
ChangeTokenparameter of aCreateByteMatchSetrequest. - Submit a
CreateByteMatchSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of anUpdateByteMatchSetrequest. - 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-Agentheader or the query string. For example, you can create aByteMatchSetthat matches any requests withUser-Agentheaders 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
ChangeTokenparameter of aCreateByteMatchSetrequest. - Submit a
CreateByteMatchSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of anUpdateByteMatchSetrequest. - 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
IPSetthat 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
ChangeTokenparameter of aCreateIPSetrequest. - Submit a
CreateIPSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateIPSetrequest 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
IPSetthat 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
ChangeTokenparameter of aCreateIPSetrequest. - Submit a
CreateIPSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateIPSetrequest 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 theIPSetobjects,ByteMatchSetobjects, 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
IPSetthat matches the IP address192.0.2.44/32 - A
ByteMatchSetthat matchesBadBotin theUser-Agentheader
You then add the
Ruleto aWebACLand 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-Agentheader 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
ChangeTokenparameter of aCreateRulerequest. - Submit a
CreateRulerequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateRule request. - Submit an
UpdateRulerequest to specify the predicates that you want to include in theRule. - Create and update a
WebACLthat 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 theIPSetobjects,ByteMatchSetobjects, 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
IPSetthat matches the IP address192.0.2.44/32 - A
ByteMatchSetthat matchesBadBotin theUser-Agentheader
You then add the
Ruleto aWebACLand 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-Agentheader 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
ChangeTokenparameter of aCreateRulerequest. - Submit a
CreateRulerequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateRule request. - Submit an
UpdateRulerequest to specify the predicates that you want to include in theRule. - Create and update a
WebACLthat 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-Agentheader or the length of the query string. For example, you can create aSizeConstraintSetthat 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
ChangeTokenparameter of aCreateSizeConstraintSetrequest. - Submit a
CreateSizeConstraintSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of anUpdateSizeConstraintSetrequest. - 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-Agentheader or the length of the query string. For example, you can create aSizeConstraintSetthat 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
ChangeTokenparameter of aCreateSizeConstraintSetrequest. - Submit a
CreateSizeConstraintSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of anUpdateSizeConstraintSetrequest. - 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
ChangeTokenparameter of aCreateSqlInjectionMatchSetrequest. - Submit a
CreateSqlInjectionMatchSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter 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
ChangeTokenparameter of aCreateSqlInjectionMatchSetrequest. - Submit a
CreateSqlInjectionMatchSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter 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 theRulesthat identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluatesRulesin order based on the value ofPriorityfor eachRule.You also specify a default action, either
ALLOWorBLOCK. If a web request doesn't match any of theRulesin 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
ByteMatchSetobjects and other predicates that you want to include inRules. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet. - Create and update the
Rulesthat 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
ChangeTokenparameter of aCreateWebACLrequest. - Submit a
CreateWebACLrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateWebACL request. - Submit an UpdateWebACL request to specify the
Rulesthat you want to include in theWebACL, to specify the default action, and to associate theWebACLwith 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 theRulesthat identify the CloudFront web requests that you want to allow, block, or count. AWS WAF evaluatesRulesin order based on the value ofPriorityfor eachRule.You also specify a default action, either
ALLOWorBLOCK. If a web request doesn't match any of theRulesin 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
ByteMatchSetobjects and other predicates that you want to include inRules. For more information, see CreateByteMatchSet, UpdateByteMatchSet, CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet. - Create and update the
Rulesthat 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
ChangeTokenparameter of aCreateWebACLrequest. - Submit a
CreateWebACLrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateWebACL request. - Submit an UpdateWebACL request to specify the
Rulesthat you want to include in theWebACL, to specify the default action, and to associate theWebACLwith 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
ChangeTokenparameter of aCreateXssMatchSetrequest. - Submit a
CreateXssMatchSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter 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
ChangeTokenparameter of aCreateXssMatchSetrequest. - Submit a
CreateXssMatchSetrequest. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter 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
ByteMatchSetif it's still used in anyRulesor if it still includes any ByteMatchTuple objects (any filters).If you just want to remove a
ByteMatchSetfrom aRule, use UpdateRule.To permanently delete a
ByteMatchSet, perform the following steps:- Update the
ByteMatchSetto remove filters, if any. For more information, see UpdateByteMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteByteMatchSetrequest. - Submit a
DeleteByteMatchSetrequest.
- 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
ByteMatchSetif it's still used in anyRulesor if it still includes any ByteMatchTuple objects (any filters).If you just want to remove a
ByteMatchSetfrom aRule, use UpdateRule.To permanently delete a
ByteMatchSet, perform the following steps:- Update the
ByteMatchSetto remove filters, if any. For more information, see UpdateByteMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteByteMatchSetrequest. - Submit a
DeleteByteMatchSetrequest.
- 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
IPSetif it's still used in anyRulesor if it still includes any IP addresses.If you just want to remove an
IPSetfrom aRule, use UpdateRule.To permanently delete an
IPSetfrom AWS WAF, perform the following steps:- Update the
IPSetto remove IP address ranges, if any. For more information, see UpdateIPSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteIPSetrequest. - Submit a
DeleteIPSetrequest.
- 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
IPSetif it's still used in anyRulesor if it still includes any IP addresses.If you just want to remove an
IPSetfrom aRule, use UpdateRule.To permanently delete an
IPSetfrom AWS WAF, perform the following steps:- Update the
IPSetto remove IP address ranges, if any. For more information, see UpdateIPSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteIPSetrequest. - Submit a
DeleteIPSetrequest.
- 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
Ruleif it's still used in anyWebACLobjects or if it still includes any predicates, such asByteMatchSetobjects.If you just want to remove a
Rulefrom aWebACL, use UpdateWebACL.To permanently delete a
Rulefrom AWS WAF, perform the following steps:- Update the
Ruleto remove predicates, if any. For more information, see UpdateRule. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteRulerequest. - Submit a
DeleteRulerequest.
- 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
Ruleif it's still used in anyWebACLobjects or if it still includes any predicates, such asByteMatchSetobjects.If you just want to remove a
Rulefrom aWebACL, use UpdateWebACL.To permanently delete a
Rulefrom AWS WAF, perform the following steps:- Update the
Ruleto remove predicates, if any. For more information, see UpdateRule. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteRulerequest. - Submit a
DeleteRulerequest.
- 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
SizeConstraintSetif it's still used in anyRulesor if it still includes any SizeConstraint objects (any filters).If you just want to remove a
SizeConstraintSetfrom aRule, use UpdateRule.To permanently delete a
SizeConstraintSet, perform the following steps:- Update the
SizeConstraintSetto remove filters, if any. For more information, see UpdateSizeConstraintSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteSizeConstraintSetrequest. - Submit a
DeleteSizeConstraintSetrequest.
- 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
SizeConstraintSetif it's still used in anyRulesor if it still includes any SizeConstraint objects (any filters).If you just want to remove a
SizeConstraintSetfrom aRule, use UpdateRule.To permanently delete a
SizeConstraintSet, perform the following steps:- Update the
SizeConstraintSetto remove filters, if any. For more information, see UpdateSizeConstraintSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteSizeConstraintSetrequest. - Submit a
DeleteSizeConstraintSetrequest.
- 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
SqlInjectionMatchSetif it's still used in anyRulesor if it still contains any SqlInjectionMatchTuple objects.If you just want to remove a
SqlInjectionMatchSetfrom aRule, use UpdateRule.To permanently delete a
SqlInjectionMatchSetfrom AWS WAF, perform the following steps:- Update the
SqlInjectionMatchSetto remove filters, if any. For more information, see UpdateSqlInjectionMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteSqlInjectionMatchSetrequest. - Submit a
DeleteSqlInjectionMatchSetrequest.
- 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
SqlInjectionMatchSetif it's still used in anyRulesor if it still contains any SqlInjectionMatchTuple objects.If you just want to remove a
SqlInjectionMatchSetfrom aRule, use UpdateRule.To permanently delete a
SqlInjectionMatchSetfrom AWS WAF, perform the following steps:- Update the
SqlInjectionMatchSetto remove filters, if any. For more information, see UpdateSqlInjectionMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteSqlInjectionMatchSetrequest. - Submit a
DeleteSqlInjectionMatchSetrequest.
- 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
WebACLif it still contains anyRules.To delete a
WebACL, perform the following steps:- Update the
WebACLto removeRules, if any. For more information, see UpdateWebACL. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteWebACLrequest. - Submit a
DeleteWebACLrequest.
- 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
WebACLif it still contains anyRules.To delete a
WebACL, perform the following steps:- Update the
WebACLto removeRules, if any. For more information, see UpdateWebACL. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteWebACLrequest. - Submit a
DeleteWebACLrequest.
- 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
XssMatchSetif it's still used in anyRulesor if it still contains any XssMatchTuple objects.If you just want to remove an
XssMatchSetfrom aRule, use UpdateRule.To permanently delete an
XssMatchSetfrom AWS WAF, perform the following steps:- Update the
XssMatchSetto remove filters, if any. For more information, see UpdateXssMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteXssMatchSetrequest. - Submit a
DeleteXssMatchSetrequest.
- 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
XssMatchSetif it's still used in anyRulesor if it still contains any XssMatchTuple objects.If you just want to remove an
XssMatchSetfrom aRule, use UpdateRule.To permanently delete an
XssMatchSetfrom AWS WAF, perform the following steps:- Update the
XssMatchSetto remove filters, if any. For more information, see UpdateXssMatchSet. - Use GetChangeToken to get the change token that you provide in
the
ChangeTokenparameter of aDeleteXssMatchSetrequest. - Submit a
DeleteXssMatchSetrequest.
- 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
GetChangeTokenrequest and then submits a secondGetChangeTokenrequest before submitting a create, update, or delete request, the secondGetChangeTokenrequest returns the same value as the firstGetChangeTokenrequest.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. UseGetChangeTokenStatusto 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
GetChangeTokenrequest and then submits a secondGetChangeTokenrequest before submitting a create, update, or delete request, the secondGetChangeTokenrequest returns the same value as the firstGetChangeTokenrequest.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. UseGetChangeTokenStatusto 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
ChangeTokenthat you got by calling GetChangeToken.ChangeTokenStatusis 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
ChangeTokenthat you got by calling GetChangeToken.ChangeTokenStatusis 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
RuleIdthat you included in theGetRulerequest.- 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
RuleIdthat you included in theGetRulerequest.- 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.
GetSampledRequestsreturns 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,GetSampledRequestsreturns 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.
GetSampledRequestsreturns 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,GetSampledRequestsreturns 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
ByteMatchTupleobject, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
ByteMatchSetUpdateobject, 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-Agentheader. - 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
TargetStringin 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
ByteMatchSetUpdateobject that matches web requests in whichUser-Agentheaders 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
ChangeTokenparameter of anUpdateByteMatchSetrequest. - Submit an
UpdateByteMatchSetrequest 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
ByteMatchTupleobject, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
ByteMatchSetUpdateobject, 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-Agentheader. - 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
TargetStringin 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
ByteMatchSetUpdateobject that matches web requests in whichUser-Agentheaders 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
ChangeTokenparameter of anUpdateByteMatchSetrequest. - Submit an
UpdateByteMatchSetrequest 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 eachIPSetDescriptorobject, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change an
IPSetDescriptorobject, 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.0to192.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
IPSetto 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 anIPSetthat 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
ChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateIPSetrequest 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 eachIPSetDescriptorobject, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change an
IPSetDescriptorobject, 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.0to192.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
IPSetto 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 anIPSetthat 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
ChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateIPSetrequest 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. EachPredicateobject 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
ByteMatchSetthat matches the valueBadBotin theUser-Agentheader - An
IPSetthat matches the IP address192.0.2.44
You then add the
Ruleto aWebACLand specify that you want to block requests that satisfy theRule. For a request to be blocked, theUser-Agentheader in the request must contain the valueBadBotand 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
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateRule request. - Submit an
UpdateRulerequest to add predicates to theRule. - Create and update a
WebACLthat contains theRule. See CreateWebACL.
If you want to replace one
ByteMatchSetorIPSetwith 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. EachPredicateobject 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
ByteMatchSetthat matches the valueBadBotin theUser-Agentheader - An
IPSetthat matches the IP address192.0.2.44
You then add the
Ruleto aWebACLand specify that you want to block requests that satisfy theRule. For a request to be blocked, theUser-Agentheader in the request must contain the valueBadBotand 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
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateRule request. - Submit an
UpdateRulerequest to add predicates to theRule. - Create and update a
WebACLthat contains theRule. See CreateWebACL.
If you want to replace one
ByteMatchSetorIPSetwith 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
SizeConstraintobject, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
SizeConstraintSetUpdateobject, 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-Agentheader. - 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
8192bytes of your request to AWS WAF. - A
ComparisonOperatorused 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
SizeConstraintSetUpdateobject that matches web requests in which the length of theUser-Agentheader 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
ChangeTokenparameter of anUpdateSizeConstraintSetrequest. - Submit an
UpdateSizeConstraintSetrequest 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
SizeConstraintobject, you specify the following values:- Whether to insert or delete the object from the array. If you want to
change a
SizeConstraintSetUpdateobject, 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-Agentheader. - 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
8192bytes of your request to AWS WAF. - A
ComparisonOperatorused 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
SizeConstraintSetUpdateobject that matches web requests in which the length of theUser-Agentheader 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
ChangeTokenparameter of anUpdateSizeConstraintSetrequest. - Submit an
UpdateSizeConstraintSetrequest 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
SqlInjectionMatchTupleobject, 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
SqlInjectionMatchSetobjects 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 aSqlInjectionMatchSetwith 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
ChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateSqlInjectionMatchSetrequest 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
SqlInjectionMatchTupleobject, 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
SqlInjectionMatchSetobjects 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 aSqlInjectionMatchSetwith 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
ChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateSqlInjectionMatchSetrequest 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. EachRuleidentifies 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, eitherALLOWorBLOCK. AWS WAF performs the default action if a request doesn't match the criteria in any of theRulesin aWebACL. - The
Rulesthat you want to add and/or delete. If you want to replace oneRulewith another, you delete the existingRuleand 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
Rulesin aWebACL. If you add more than oneRuleto aWebACL, AWS WAF evaluates each request against theRulesin order based on the value ofPriority. (TheRulethat has the lowest value forPriorityis evaluated first.) When a web request matches all of the predicates (such asByteMatchSetsandIPSets) in aRule, AWS WAF immediately takes the corresponding action, allow or block, and doesn't evaluate the request against the remainingRulesin 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
Rulesthat you want to include in theWebACL. For more information, see CreateRule and UpdateRule. - Create a
WebACL. See CreateWebACL. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateWebACL request. - Submit an
UpdateWebACLrequest to specify theRulesthat you want to include in theWebACL, to specify the default action, and to associate theWebACLwith 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. EachRuleidentifies 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, eitherALLOWorBLOCK. AWS WAF performs the default action if a request doesn't match the criteria in any of theRulesin aWebACL. - The
Rulesthat you want to add and/or delete. If you want to replace oneRulewith another, you delete the existingRuleand 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
Rulesin aWebACL. If you add more than oneRuleto aWebACL, AWS WAF evaluates each request against theRulesin order based on the value ofPriority. (TheRulethat has the lowest value forPriorityis evaluated first.) When a web request matches all of the predicates (such asByteMatchSetsandIPSets) in aRule, AWS WAF immediately takes the corresponding action, allow or block, and doesn't evaluate the request against the remainingRulesin 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
Rulesthat you want to include in theWebACL. For more information, see CreateRule and UpdateRule. - Create a
WebACL. See CreateWebACL. - Use
GetChangeTokento get the change token that you provide in theChangeTokenparameter of an UpdateWebACL request. - Submit an
UpdateWebACLrequest to specify theRulesthat you want to include in theWebACL, to specify the default action, and to associate theWebACLwith 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
XssMatchTupleobject, 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
XssMatchSetobjects 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 anXssMatchSetwith 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
ChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateXssMatchSetrequest 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
XssMatchTupleobject, 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
XssMatchSetobjects 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 anXssMatchSetwith 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
ChangeTokenparameter of an UpdateIPSet request. - Submit an
UpdateXssMatchSetrequest 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.
-
-