com.amazonaws.services.waf.AWSWAFRegionalAsync Maven / Gradle / Ivy
Show all versions of aws-java-sdk-waf Show documentation
/*
* Copyright 2012-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.waf;
import javax.annotation.Generated;
import com.amazonaws.services.waf.model.*;
/**
* Interface for accessing WAF Regional asynchronously. Each asynchronous method will return a Java Future object
* representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive
* notification when an asynchronous operation completes.
*
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
* {@link com.amazonaws.services.waf.AbstractAWSWAFRegionalAsync} instead.
*
*
*
* This is the AWS WAF Regional API Reference for using AWS WAF with Elastic Load Balancing (ELB) Application
* Load Balancers. The AWS WAF actions and data types listed in the reference are available for protecting Application
* Load Balancers. You can use these actions and data types by means of the endpoints listed in AWS Regions and Endpoints. 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.
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AWSWAFRegionalAsync extends AWSWAFRegional {
/**
*
* Associates a web ACL with a resource.
*
*
* @param associateWebACLRequest
* @return A Java Future containing the result of the AssociateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.AssociateWebACL
* @see AWS
* API Documentation
*/
java.util.concurrent.Future associateWebACLAsync(AssociateWebACLRequest associateWebACLRequest);
/**
*
* Associates a web ACL with a resource.
*
*
* @param associateWebACLRequest
* @param 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.
* @return A Java Future containing the result of the AssociateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.AssociateWebACL
* @see AWS
* API Documentation
*/
java.util.concurrent.Future associateWebACLAsync(AssociateWebACLRequest associateWebACLRequest,
com.amazonaws.handlers.AsyncHandler 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 the User-Agent header or the query string.
* For example, you can create a ByteMatchSet that matches any requests with User-Agent
* headers that contain the string BadBot. 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 a
* CreateByteMatchSet request.
*
*
* -
*
* Submit a CreateByteMatchSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateByteMatchSet 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.
*
*
* @param createByteMatchSetRequest
* @return A Java Future containing the result of the CreateByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateByteMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 the User-Agent header or the query string.
* For example, you can create a ByteMatchSet that matches any requests with User-Agent
* headers that contain the string BadBot. 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 a
* CreateByteMatchSet request.
*
*
* -
*
* Submit a CreateByteMatchSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateByteMatchSet 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.
*
*
* @param createByteMatchSetRequest
* @param 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.
* @return A Java Future containing the result of the CreateByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateByteMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future createByteMatchSetAsync(CreateByteMatchSetRequest createByteMatchSetRequest,
com.amazonaws.handlers.AsyncHandler 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 a
* CreateIPSet request.
*
*
* -
*
* 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.
*
*
*
*
* For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
*
*
* @param createIPSetRequest
* @return A Java Future containing the result of the CreateIPSet operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future 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 a
* CreateIPSet request.
*
*
* -
*
* 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.
*
*
*
*
* For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
*
*
* @param createIPSetRequest
* @param 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.
* @return A Java Future containing the result of the CreateIPSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createIPSetAsync(CreateIPSetRequest createIPSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates a Rule, which contains the IPSet objects, ByteMatchSet objects,
* and other predicates that identify the requests that you want to block. If you add more than one predicate to a
* Rule, a request must match all of the specifications to be allowed or blocked. For example, suppose
* you add the following to a Rule:
*
*
* -
*
* An IPSet that matches the IP address 192.0.2.44/32
*
*
* -
*
* A ByteMatchSet that matches BadBot in the User-Agent header
*
*
*
*
* You then add the Rule to a WebACL and specify that you want to blocks requests that
* satisfy the Rule. For a request to be blocked, it must come from the IP address 192.0.2.44
* and the User-Agent header in the request must contain the value BadBot.
*
*
* 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 a
* CreateRule request.
*
*
* -
*
* Submit a CreateRule request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateRule request.
*
*
* -
*
* Submit an UpdateRule request to specify the predicates that you want to include in the
* Rule.
*
*
* -
*
* Create and update a WebACL that contains the Rule. 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.
*
*
* @param createRuleRequest
* @return A Java Future containing the result of the CreateRule operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createRuleAsync(CreateRuleRequest createRuleRequest);
/**
*
* Creates a Rule, which contains the IPSet objects, ByteMatchSet objects,
* and other predicates that identify the requests that you want to block. If you add more than one predicate to a
* Rule, a request must match all of the specifications to be allowed or blocked. For example, suppose
* you add the following to a Rule:
*
*
* -
*
* An IPSet that matches the IP address 192.0.2.44/32
*
*
* -
*
* A ByteMatchSet that matches BadBot in the User-Agent header
*
*
*
*
* You then add the Rule to a WebACL and specify that you want to blocks requests that
* satisfy the Rule. For a request to be blocked, it must come from the IP address 192.0.2.44
* and the User-Agent header in the request must contain the value BadBot.
*
*
* 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 a
* CreateRule request.
*
*
* -
*
* Submit a CreateRule request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateRule request.
*
*
* -
*
* Submit an UpdateRule request to specify the predicates that you want to include in the
* Rule.
*
*
* -
*
* Create and update a WebACL that contains the Rule. 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.
*
*
* @param createRuleRequest
* @param 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.
* @return A Java Future containing the result of the CreateRule operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createRuleAsync(CreateRuleRequest createRuleRequest,
com.amazonaws.handlers.AsyncHandler 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 the User-Agent header
* or the length of the query string. For example, you can create a SizeConstraintSet 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 a
* CreateSizeConstraintSet request.
*
*
* -
*
* Submit a CreateSizeConstraintSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateSizeConstraintSet 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.
*
*
* @param createSizeConstraintSetRequest
* @return A Java Future containing the result of the CreateSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 the User-Agent header
* or the length of the query string. For example, you can create a SizeConstraintSet 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 a
* CreateSizeConstraintSet request.
*
*
* -
*
* Submit a CreateSizeConstraintSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateSizeConstraintSet 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.
*
*
* @param createSizeConstraintSetRequest
* @param 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.
* @return A Java Future containing the result of the CreateSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future createSizeConstraintSetAsync(CreateSizeConstraintSetRequest createSizeConstraintSetRequest,
com.amazonaws.handlers.AsyncHandler 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 a
* CreateSqlInjectionMatchSet request.
*
*
* -
*
* Submit a CreateSqlInjectionMatchSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* 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.
*
*
* @param createSqlInjectionMatchSetRequest
* A request to create a SqlInjectionMatchSet.
* @return A Java Future containing the result of the CreateSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 a
* CreateSqlInjectionMatchSet request.
*
*
* -
*
* Submit a CreateSqlInjectionMatchSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* 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.
*
*
* @param createSqlInjectionMatchSetRequest
* A request to create a SqlInjectionMatchSet.
* @param 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.
* @return A Java Future containing the result of the CreateSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future createSqlInjectionMatchSetAsync(
CreateSqlInjectionMatchSetRequest createSqlInjectionMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Creates a WebACL, which contains the Rules that identify the CloudFront web requests
* that you want to allow, block, or count. AWS WAF evaluates Rules in order based on the value of
* Priority for each Rule.
*
*
* You also specify a default action, either ALLOW or BLOCK. If a web request doesn't
* match any of the Rules in a WebACL, 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 in
* Rules. For more information, see CreateByteMatchSet, UpdateByteMatchSet,
* CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.
*
*
* -
*
* Create and update the Rules that you want to include in the WebACL. For more
* information, see CreateRule and UpdateRule.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a
* CreateWebACL request.
*
*
* -
*
* Submit a CreateWebACL request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateWebACL request.
*
*
* -
*
* Submit an UpdateWebACL request to specify the Rules that you want to include in the
* WebACL, to specify the default action, and to associate the WebACL with a CloudFront
* distribution.
*
*
*
*
* For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.
*
*
* @param createWebACLRequest
* @return A Java Future containing the result of the CreateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createWebACLAsync(CreateWebACLRequest createWebACLRequest);
/**
*
* Creates a WebACL, which contains the Rules that identify the CloudFront web requests
* that you want to allow, block, or count. AWS WAF evaluates Rules in order based on the value of
* Priority for each Rule.
*
*
* You also specify a default action, either ALLOW or BLOCK. If a web request doesn't
* match any of the Rules in a WebACL, 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 in
* Rules. For more information, see CreateByteMatchSet, UpdateByteMatchSet,
* CreateIPSet, UpdateIPSet, CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.
*
*
* -
*
* Create and update the Rules that you want to include in the WebACL. For more
* information, see CreateRule and UpdateRule.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a
* CreateWebACL request.
*
*
* -
*
* Submit a CreateWebACL request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateWebACL request.
*
*
* -
*
* Submit an UpdateWebACL request to specify the Rules that you want to include in the
* WebACL, to specify the default action, and to associate the WebACL with a CloudFront
* distribution.
*
*
*
*
* For more information about how to use the AWS WAF API, see the AWS WAF Developer Guide.
*
*
* @param createWebACLRequest
* @param 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.
* @return A Java Future containing the result of the CreateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future createWebACLAsync(CreateWebACLRequest createWebACLRequest,
com.amazonaws.handlers.AsyncHandler 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 a
* CreateXssMatchSet request.
*
*
* -
*
* Submit a CreateXssMatchSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* 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.
*
*
* @param createXssMatchSetRequest
* A request to create an XssMatchSet.
* @return A Java Future containing the result of the CreateXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.CreateXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future 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 a
* CreateXssMatchSet request.
*
*
* -
*
* Submit a CreateXssMatchSet request.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* 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.
*
*
* @param createXssMatchSetRequest
* A request to create an XssMatchSet.
* @param 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.
* @return A Java Future containing the result of the CreateXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.CreateXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future createXssMatchSetAsync(CreateXssMatchSetRequest createXssMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes a ByteMatchSet. You can't delete a ByteMatchSet if it's still used in any
* Rules or if it still includes any ByteMatchTuple objects (any filters).
*
*
* If you just want to remove a ByteMatchSet from a Rule, 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 a
* DeleteByteMatchSet request.
*
*
* -
*
* Submit a DeleteByteMatchSet request.
*
*
*
*
* @param deleteByteMatchSetRequest
* @return A Java Future containing the result of the DeleteByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteByteMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteByteMatchSetAsync(DeleteByteMatchSetRequest deleteByteMatchSetRequest);
/**
*
* Permanently deletes a ByteMatchSet. You can't delete a ByteMatchSet if it's still used in any
* Rules or if it still includes any ByteMatchTuple objects (any filters).
*
*
* If you just want to remove a ByteMatchSet from a Rule, 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 a
* DeleteByteMatchSet request.
*
*
* -
*
* Submit a DeleteByteMatchSet request.
*
*
*
*
* @param deleteByteMatchSetRequest
* @param 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.
* @return A Java Future containing the result of the DeleteByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteByteMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteByteMatchSetAsync(DeleteByteMatchSetRequest deleteByteMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes an IPSet. You can't delete an IPSet if it's still used in any
* Rules or if it still includes any IP addresses.
*
*
* If you just want to remove an IPSet from a Rule, 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 a
* DeleteIPSet request.
*
*
* -
*
* Submit a DeleteIPSet request.
*
*
*
*
* @param deleteIPSetRequest
* @return A Java Future containing the result of the DeleteIPSet operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteIPSetAsync(DeleteIPSetRequest deleteIPSetRequest);
/**
*
* Permanently deletes an IPSet. You can't delete an IPSet if it's still used in any
* Rules or if it still includes any IP addresses.
*
*
* If you just want to remove an IPSet from a Rule, 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 a
* DeleteIPSet request.
*
*
* -
*
* Submit a DeleteIPSet request.
*
*
*
*
* @param deleteIPSetRequest
* @param 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.
* @return A Java Future containing the result of the DeleteIPSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteIPSetAsync(DeleteIPSetRequest deleteIPSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes a Rule. You can't delete a Rule if it's still used in any
* WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.
*
*
* If you just want to remove a Rule from a WebACL, 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 a
* DeleteRule request.
*
*
* -
*
* Submit a DeleteRule request.
*
*
*
*
* @param deleteRuleRequest
* @return A Java Future containing the result of the DeleteRule operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteRuleAsync(DeleteRuleRequest deleteRuleRequest);
/**
*
* Permanently deletes a Rule. You can't delete a Rule if it's still used in any
* WebACL objects or if it still includes any predicates, such as ByteMatchSet objects.
*
*
* If you just want to remove a Rule from a WebACL, 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 a
* DeleteRule request.
*
*
* -
*
* Submit a DeleteRule request.
*
*
*
*
* @param deleteRuleRequest
* @param 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.
* @return A Java Future containing the result of the DeleteRule operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteRuleAsync(DeleteRuleRequest deleteRuleRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes a SizeConstraintSet. You can't delete a SizeConstraintSet if it's still
* used in any Rules or if it still includes any SizeConstraint objects (any filters).
*
*
* If you just want to remove a SizeConstraintSet from a Rule, 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 a
* DeleteSizeConstraintSet request.
*
*
* -
*
* Submit a DeleteSizeConstraintSet request.
*
*
*
*
* @param deleteSizeConstraintSetRequest
* @return A Java Future containing the result of the DeleteSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteSizeConstraintSetAsync(DeleteSizeConstraintSetRequest deleteSizeConstraintSetRequest);
/**
*
* Permanently deletes a SizeConstraintSet. You can't delete a SizeConstraintSet if it's still
* used in any Rules or if it still includes any SizeConstraint objects (any filters).
*
*
* If you just want to remove a SizeConstraintSet from a Rule, 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 a
* DeleteSizeConstraintSet request.
*
*
* -
*
* Submit a DeleteSizeConstraintSet request.
*
*
*
*
* @param deleteSizeConstraintSetRequest
* @param 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.
* @return A Java Future containing the result of the DeleteSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteSizeConstraintSetAsync(DeleteSizeConstraintSetRequest deleteSizeConstraintSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes a SqlInjectionMatchSet. You can't delete a SqlInjectionMatchSet if it's
* still used in any Rules or if it still contains any SqlInjectionMatchTuple objects.
*
*
* If you just want to remove a SqlInjectionMatchSet from a Rule, 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 a
* DeleteSqlInjectionMatchSet request.
*
*
* -
*
* Submit a DeleteSqlInjectionMatchSet request.
*
*
*
*
* @param deleteSqlInjectionMatchSetRequest
* A request to delete a SqlInjectionMatchSet from AWS WAF.
* @return A Java Future containing the result of the DeleteSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteSqlInjectionMatchSetAsync(
DeleteSqlInjectionMatchSetRequest deleteSqlInjectionMatchSetRequest);
/**
*
* Permanently deletes a SqlInjectionMatchSet. You can't delete a SqlInjectionMatchSet if it's
* still used in any Rules or if it still contains any SqlInjectionMatchTuple objects.
*
*
* If you just want to remove a SqlInjectionMatchSet from a Rule, 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 a
* DeleteSqlInjectionMatchSet request.
*
*
* -
*
* Submit a DeleteSqlInjectionMatchSet request.
*
*
*
*
* @param deleteSqlInjectionMatchSetRequest
* A request to delete a SqlInjectionMatchSet from AWS WAF.
* @param 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.
* @return A Java Future containing the result of the DeleteSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future deleteSqlInjectionMatchSetAsync(
DeleteSqlInjectionMatchSetRequest deleteSqlInjectionMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes a WebACL. You can't delete a WebACL if it still contains any
* Rules.
*
*
* To delete a WebACL, perform the following steps:
*
*
* -
*
* Update the WebACL to remove Rules, if any. For more information, see
* UpdateWebACL.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a
* DeleteWebACL request.
*
*
* -
*
* Submit a DeleteWebACL request.
*
*
*
*
* @param deleteWebACLRequest
* @return A Java Future containing the result of the DeleteWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteWebACLAsync(DeleteWebACLRequest deleteWebACLRequest);
/**
*
* Permanently deletes a WebACL. You can't delete a WebACL if it still contains any
* Rules.
*
*
* To delete a WebACL, perform the following steps:
*
*
* -
*
* Update the WebACL to remove Rules, if any. For more information, see
* UpdateWebACL.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken parameter of a
* DeleteWebACL request.
*
*
* -
*
* Submit a DeleteWebACL request.
*
*
*
*
* @param deleteWebACLRequest
* @param 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.
* @return A Java Future containing the result of the DeleteWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future deleteWebACLAsync(DeleteWebACLRequest deleteWebACLRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Permanently deletes an XssMatchSet. You can't delete an XssMatchSet if it's still used in any
* Rules or if it still contains any XssMatchTuple objects.
*
*
* If you just want to remove an XssMatchSet from a Rule, 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 a
* DeleteXssMatchSet request.
*
*
* -
*
* Submit a DeleteXssMatchSet request.
*
*
*
*
* @param deleteXssMatchSetRequest
* A request to delete an XssMatchSet from AWS WAF.
* @return A Java Future containing the result of the DeleteXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.DeleteXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future deleteXssMatchSetAsync(DeleteXssMatchSetRequest deleteXssMatchSetRequest);
/**
*
* Permanently deletes an XssMatchSet. You can't delete an XssMatchSet if it's still used in any
* Rules or if it still contains any XssMatchTuple objects.
*
*
* If you just want to remove an XssMatchSet from a Rule, 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 a
* DeleteXssMatchSet request.
*
*
* -
*
* Submit a DeleteXssMatchSet request.
*
*
*
*
* @param deleteXssMatchSetRequest
* A request to delete an XssMatchSet from AWS WAF.
* @param 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.
* @return A Java Future containing the result of the DeleteXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DeleteXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future deleteXssMatchSetAsync(DeleteXssMatchSetRequest deleteXssMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Removes a web ACL from the specified resource.
*
*
* @param disassociateWebACLRequest
* @return A Java Future containing the result of the DisassociateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.DisassociateWebACL
* @see AWS API Documentation
*/
java.util.concurrent.Future disassociateWebACLAsync(DisassociateWebACLRequest disassociateWebACLRequest);
/**
*
* Removes a web ACL from the specified resource.
*
*
* @param disassociateWebACLRequest
* @param 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.
* @return A Java Future containing the result of the DisassociateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.DisassociateWebACL
* @see AWS API Documentation
*/
java.util.concurrent.Future disassociateWebACLAsync(DisassociateWebACLRequest disassociateWebACLRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the ByteMatchSet specified by ByteMatchSetId.
*
*
* @param getByteMatchSetRequest
* @return A Java Future containing the result of the GetByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.GetByteMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getByteMatchSetAsync(GetByteMatchSetRequest getByteMatchSetRequest);
/**
*
* Returns the ByteMatchSet specified by ByteMatchSetId.
*
*
* @param getByteMatchSetRequest
* @param 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.
* @return A Java Future containing the result of the GetByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetByteMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getByteMatchSetAsync(GetByteMatchSetRequest getByteMatchSetRequest,
com.amazonaws.handlers.AsyncHandler 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 second GetChangeToken request before
* submitting a create, update, or delete request, the second GetChangeToken request returns the same
* value as the first GetChangeToken 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. Use
* GetChangeTokenStatus to determine the status of your change token.
*
*
* @param getChangeTokenRequest
* @return A Java Future containing the result of the GetChangeToken operation returned by the service.
* @sample AWSWAFRegionalAsync.GetChangeToken
* @see AWS
* API Documentation
*/
java.util.concurrent.Future 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 second GetChangeToken request before
* submitting a create, update, or delete request, the second GetChangeToken request returns the same
* value as the first GetChangeToken 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. Use
* GetChangeTokenStatus to determine the status of your change token.
*
*
* @param getChangeTokenRequest
* @param 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.
* @return A Java Future containing the result of the GetChangeToken operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetChangeToken
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getChangeTokenAsync(GetChangeTokenRequest getChangeTokenRequest,
com.amazonaws.handlers.AsyncHandler 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 calling GetChangeToken, 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.
*
*
*
*
* @param getChangeTokenStatusRequest
* @return A Java Future containing the result of the GetChangeTokenStatus operation returned by the service.
* @sample AWSWAFRegionalAsync.GetChangeTokenStatus
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 calling GetChangeToken, 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.
*
*
*
*
* @param getChangeTokenStatusRequest
* @param 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.
* @return A Java Future containing the result of the GetChangeTokenStatus operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetChangeTokenStatus
* @see AWS API Documentation
*/
java.util.concurrent.Future getChangeTokenStatusAsync(GetChangeTokenStatusRequest getChangeTokenStatusRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the IPSet that is specified by IPSetId.
*
*
* @param getIPSetRequest
* @return A Java Future containing the result of the GetIPSet operation returned by the service.
* @sample AWSWAFRegionalAsync.GetIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getIPSetAsync(GetIPSetRequest getIPSetRequest);
/**
*
* Returns the IPSet that is specified by IPSetId.
*
*
* @param getIPSetRequest
* @param 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.
* @return A Java Future containing the result of the GetIPSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getIPSetAsync(GetIPSetRequest getIPSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the Rule that is specified by the RuleId that you included in the
* GetRule request.
*
*
* @param getRuleRequest
* @return A Java Future containing the result of the GetRule operation returned by the service.
* @sample AWSWAFRegionalAsync.GetRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getRuleAsync(GetRuleRequest getRuleRequest);
/**
*
* Returns the Rule that is specified by the RuleId that you included in the
* GetRule request.
*
*
* @param getRuleRequest
* @param 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.
* @return A Java Future containing the result of the GetRule operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getRuleAsync(GetRuleRequest getRuleRequest,
com.amazonaws.handlers.AsyncHandler 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.
*
*
* @param getSampledRequestsRequest
* @return A Java Future containing the result of the GetSampledRequests operation returned by the service.
* @sample AWSWAFRegionalAsync.GetSampledRequests
* @see AWS API Documentation
*/
java.util.concurrent.Future 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.
*
*
* @param getSampledRequestsRequest
* @param 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.
* @return A Java Future containing the result of the GetSampledRequests operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetSampledRequests
* @see AWS API Documentation
*/
java.util.concurrent.Future getSampledRequestsAsync(GetSampledRequestsRequest getSampledRequestsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the SizeConstraintSet specified by SizeConstraintSetId.
*
*
* @param getSizeConstraintSetRequest
* @return A Java Future containing the result of the GetSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsync.GetSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future getSizeConstraintSetAsync(GetSizeConstraintSetRequest getSizeConstraintSetRequest);
/**
*
* Returns the SizeConstraintSet specified by SizeConstraintSetId.
*
*
* @param getSizeConstraintSetRequest
* @param 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.
* @return A Java Future containing the result of the GetSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future getSizeConstraintSetAsync(GetSizeConstraintSetRequest getSizeConstraintSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the SqlInjectionMatchSet that is specified by SqlInjectionMatchSetId.
*
*
* @param getSqlInjectionMatchSetRequest
* A request to get a SqlInjectionMatchSet.
* @return A Java Future containing the result of the GetSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.GetSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future getSqlInjectionMatchSetAsync(GetSqlInjectionMatchSetRequest getSqlInjectionMatchSetRequest);
/**
*
* Returns the SqlInjectionMatchSet that is specified by SqlInjectionMatchSetId.
*
*
* @param getSqlInjectionMatchSetRequest
* A request to get a SqlInjectionMatchSet.
* @param 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.
* @return A Java Future containing the result of the GetSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future getSqlInjectionMatchSetAsync(GetSqlInjectionMatchSetRequest getSqlInjectionMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the WebACL that is specified by WebACLId.
*
*
* @param getWebACLRequest
* @return A Java Future containing the result of the GetWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.GetWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getWebACLAsync(GetWebACLRequest getWebACLRequest);
/**
*
* Returns the WebACL that is specified by WebACLId.
*
*
* @param getWebACLRequest
* @param 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.
* @return A Java Future containing the result of the GetWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future getWebACLAsync(GetWebACLRequest getWebACLRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the web ACL for the specified resource.
*
*
* @param getWebACLForResourceRequest
* @return A Java Future containing the result of the GetWebACLForResource operation returned by the service.
* @sample AWSWAFRegionalAsync.GetWebACLForResource
* @see AWS API Documentation
*/
java.util.concurrent.Future getWebACLForResourceAsync(GetWebACLForResourceRequest getWebACLForResourceRequest);
/**
*
* Returns the web ACL for the specified resource.
*
*
* @param getWebACLForResourceRequest
* @param 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.
* @return A Java Future containing the result of the GetWebACLForResource operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetWebACLForResource
* @see AWS API Documentation
*/
java.util.concurrent.Future getWebACLForResourceAsync(GetWebACLForResourceRequest getWebACLForResourceRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns the XssMatchSet that is specified by XssMatchSetId.
*
*
* @param getXssMatchSetRequest
* A request to get an XssMatchSet.
* @return A Java Future containing the result of the GetXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.GetXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getXssMatchSetAsync(GetXssMatchSetRequest getXssMatchSetRequest);
/**
*
* Returns the XssMatchSet that is specified by XssMatchSetId.
*
*
* @param getXssMatchSetRequest
* A request to get an XssMatchSet.
* @param 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.
* @return A Java Future containing the result of the GetXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.GetXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future getXssMatchSetAsync(GetXssMatchSetRequest getXssMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of ByteMatchSetSummary objects.
*
*
* @param listByteMatchSetsRequest
* @return A Java Future containing the result of the ListByteMatchSets operation returned by the service.
* @sample AWSWAFRegionalAsync.ListByteMatchSets
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listByteMatchSetsAsync(ListByteMatchSetsRequest listByteMatchSetsRequest);
/**
*
* Returns an array of ByteMatchSetSummary objects.
*
*
* @param listByteMatchSetsRequest
* @param 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.
* @return A Java Future containing the result of the ListByteMatchSets operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListByteMatchSets
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listByteMatchSetsAsync(ListByteMatchSetsRequest listByteMatchSetsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of IPSetSummary objects in the response.
*
*
* @param listIPSetsRequest
* @return A Java Future containing the result of the ListIPSets operation returned by the service.
* @sample AWSWAFRegionalAsync.ListIPSets
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listIPSetsAsync(ListIPSetsRequest listIPSetsRequest);
/**
*
* Returns an array of IPSetSummary objects in the response.
*
*
* @param listIPSetsRequest
* @param 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.
* @return A Java Future containing the result of the ListIPSets operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListIPSets
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listIPSetsAsync(ListIPSetsRequest listIPSetsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of resources associated with the specified web ACL.
*
*
* @param listResourcesForWebACLRequest
* @return A Java Future containing the result of the ListResourcesForWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.ListResourcesForWebACL
* @see AWS API Documentation
*/
java.util.concurrent.Future listResourcesForWebACLAsync(ListResourcesForWebACLRequest listResourcesForWebACLRequest);
/**
*
* Returns an array of resources associated with the specified web ACL.
*
*
* @param listResourcesForWebACLRequest
* @param 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.
* @return A Java Future containing the result of the ListResourcesForWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListResourcesForWebACL
* @see AWS API Documentation
*/
java.util.concurrent.Future listResourcesForWebACLAsync(ListResourcesForWebACLRequest listResourcesForWebACLRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of RuleSummary objects.
*
*
* @param listRulesRequest
* @return A Java Future containing the result of the ListRules operation returned by the service.
* @sample AWSWAFRegionalAsync.ListRules
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listRulesAsync(ListRulesRequest listRulesRequest);
/**
*
* Returns an array of RuleSummary objects.
*
*
* @param listRulesRequest
* @param 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.
* @return A Java Future containing the result of the ListRules operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListRules
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listRulesAsync(ListRulesRequest listRulesRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of SizeConstraintSetSummary objects.
*
*
* @param listSizeConstraintSetsRequest
* @return A Java Future containing the result of the ListSizeConstraintSets operation returned by the service.
* @sample AWSWAFRegionalAsync.ListSizeConstraintSets
* @see AWS API Documentation
*/
java.util.concurrent.Future listSizeConstraintSetsAsync(ListSizeConstraintSetsRequest listSizeConstraintSetsRequest);
/**
*
* Returns an array of SizeConstraintSetSummary objects.
*
*
* @param listSizeConstraintSetsRequest
* @param 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.
* @return A Java Future containing the result of the ListSizeConstraintSets operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListSizeConstraintSets
* @see AWS API Documentation
*/
java.util.concurrent.Future listSizeConstraintSetsAsync(ListSizeConstraintSetsRequest listSizeConstraintSetsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of SqlInjectionMatchSet objects.
*
*
* @param listSqlInjectionMatchSetsRequest
* A request to list the SqlInjectionMatchSet objects created by the current AWS account.
* @return A Java Future containing the result of the ListSqlInjectionMatchSets operation returned by the service.
* @sample AWSWAFRegionalAsync.ListSqlInjectionMatchSets
* @see AWS API Documentation
*/
java.util.concurrent.Future listSqlInjectionMatchSetsAsync(
ListSqlInjectionMatchSetsRequest listSqlInjectionMatchSetsRequest);
/**
*
* Returns an array of SqlInjectionMatchSet objects.
*
*
* @param listSqlInjectionMatchSetsRequest
* A request to list the SqlInjectionMatchSet objects created by the current AWS account.
* @param 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.
* @return A Java Future containing the result of the ListSqlInjectionMatchSets operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListSqlInjectionMatchSets
* @see AWS API Documentation
*/
java.util.concurrent.Future listSqlInjectionMatchSetsAsync(
ListSqlInjectionMatchSetsRequest listSqlInjectionMatchSetsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of WebACLSummary objects in the response.
*
*
* @param listWebACLsRequest
* @return A Java Future containing the result of the ListWebACLs operation returned by the service.
* @sample AWSWAFRegionalAsync.ListWebACLs
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listWebACLsAsync(ListWebACLsRequest listWebACLsRequest);
/**
*
* Returns an array of WebACLSummary objects in the response.
*
*
* @param listWebACLsRequest
* @param 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.
* @return A Java Future containing the result of the ListWebACLs operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListWebACLs
* @see AWS API
* Documentation
*/
java.util.concurrent.Future listWebACLsAsync(ListWebACLsRequest listWebACLsRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Returns an array of XssMatchSet objects.
*
*
* @param listXssMatchSetsRequest
* A request to list the XssMatchSet objects created by the current AWS account.
* @return A Java Future containing the result of the ListXssMatchSets operation returned by the service.
* @sample AWSWAFRegionalAsync.ListXssMatchSets
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listXssMatchSetsAsync(ListXssMatchSetsRequest listXssMatchSetsRequest);
/**
*
* Returns an array of XssMatchSet objects.
*
*
* @param listXssMatchSetsRequest
* A request to list the XssMatchSet objects created by the current AWS account.
* @param 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.
* @return A Java Future containing the result of the ListXssMatchSets operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.ListXssMatchSets
* @see AWS
* API Documentation
*/
java.util.concurrent.Future listXssMatchSetsAsync(ListXssMatchSetsRequest listXssMatchSetsRequest,
com.amazonaws.handlers.AsyncHandler 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 which
* User-Agent headers contain the string BadBot. 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
* an UpdateByteMatchSet 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.
*
*
* @param updateByteMatchSetRequest
* @return A Java Future containing the result of the UpdateByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateByteMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 which
* User-Agent headers contain the string BadBot. 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
* an UpdateByteMatchSet 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.
*
*
* @param updateByteMatchSetRequest
* @param 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.
* @return A Java Future containing the result of the UpdateByteMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateByteMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future updateByteMatchSetAsync(UpdateByteMatchSetRequest updateByteMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Inserts or deletes IPSetDescriptor objects in an IPSet. For each IPSetDescriptor
* 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 or IPv6.
*
*
* -
*
* The IP address in CIDR notation, for example, 192.0.2.0/24 (for the range of IP addresses from
* 192.0.2.0 to 192.0.2.255) or 192.0.2.44/32 (for the individual IP address
* 192.0.2.44).
*
*
*
*
* AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6.
* For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
*
*
* IPv6 addresses can be represented using any of the following formats:
*
*
* -
*
* 1111:0000:0000:0000:0000:0000:0000:0111/128
*
*
* -
*
* 1111:0:0:0:0:0:0:0111/128
*
*
* -
*
* 1111::0111/128
*
*
* -
*
* 1111::111/128
*
*
*
*
* 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 an IPSet 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.
*
*
* @param updateIPSetRequest
* @return A Java Future containing the result of the UpdateIPSet operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateIPSetAsync(UpdateIPSetRequest updateIPSetRequest);
/**
*
* Inserts or deletes IPSetDescriptor objects in an IPSet. For each IPSetDescriptor
* 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 or IPv6.
*
*
* -
*
* The IP address in CIDR notation, for example, 192.0.2.0/24 (for the range of IP addresses from
* 192.0.2.0 to 192.0.2.255) or 192.0.2.44/32 (for the individual IP address
* 192.0.2.44).
*
*
*
*
* AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6.
* For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
*
*
* IPv6 addresses can be represented using any of the following formats:
*
*
* -
*
* 1111:0000:0000:0000:0000:0000:0000:0111/128
*
*
* -
*
* 1111:0:0:0:0:0:0:0111/128
*
*
* -
*
* 1111::0111/128
*
*
* -
*
* 1111::111/128
*
*
*
*
* 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 an IPSet 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.
*
*
* @param updateIPSetRequest
* @param 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.
* @return A Java Future containing the result of the UpdateIPSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateIPSet
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateIPSetAsync(UpdateIPSetRequest updateIPSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Inserts or deletes Predicate objects in a Rule. Each Predicate 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 a Rule, a request must match all of
* the specifications to be allowed, blocked, or counted. For example, suppose you add the following to a
* Rule:
*
*
* -
*
* A ByteMatchSet that matches the value BadBot in the User-Agent header
*
*
* -
*
* An IPSet that matches the IP address 192.0.2.44
*
*
*
*
* You then add the Rule to a WebACL and specify that you want to block requests that
* satisfy the Rule. For a request to be blocked, the User-Agent header in the request
* must contain the value BadBot 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 the ChangeToken
* parameter of an UpdateRule request.
*
*
* -
*
* Submit an UpdateRule request to add predicates to the Rule.
*
*
* -
*
* Create and update a WebACL that contains the Rule. See CreateWebACL.
*
*
*
*
* If you want to replace one ByteMatchSet or IPSet 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.
*
*
* @param updateRuleRequest
* @return A Java Future containing the result of the UpdateRule operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateRuleAsync(UpdateRuleRequest updateRuleRequest);
/**
*
* Inserts or deletes Predicate objects in a Rule. Each Predicate 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 a Rule, a request must match all of
* the specifications to be allowed, blocked, or counted. For example, suppose you add the following to a
* Rule:
*
*
* -
*
* A ByteMatchSet that matches the value BadBot in the User-Agent header
*
*
* -
*
* An IPSet that matches the IP address 192.0.2.44
*
*
*
*
* You then add the Rule to a WebACL and specify that you want to block requests that
* satisfy the Rule. For a request to be blocked, the User-Agent header in the request
* must contain the value BadBot 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 the ChangeToken
* parameter of an UpdateRule request.
*
*
* -
*
* Submit an UpdateRule request to add predicates to the Rule.
*
*
* -
*
* Create and update a WebACL that contains the Rule. See CreateWebACL.
*
*
*
*
* If you want to replace one ByteMatchSet or IPSet 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.
*
*
* @param updateRuleRequest
* @param 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.
* @return A Java Future containing the result of the UpdateRule operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateRule
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateRuleAsync(UpdateRuleRequest updateRuleRequest,
com.amazonaws.handlers.AsyncHandler 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 specified
* Size, 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 the User-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
* an UpdateSizeConstraintSet 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.
*
*
* @param updateSizeConstraintSetRequest
* @return A Java Future containing the result of the UpdateSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 specified
* Size, 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 the User-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
* an UpdateSizeConstraintSet 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.
*
*
* @param updateSizeConstraintSetRequest
* @param 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.
* @return A Java Future containing the result of the UpdateSizeConstraintSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateSizeConstraintSet
* @see AWS API Documentation
*/
java.util.concurrent.Future updateSizeConstraintSetAsync(UpdateSizeConstraintSetRequest updateSizeConstraintSetRequest,
com.amazonaws.handlers.AsyncHandler 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 a
* SqlInjectionMatchTuple, 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 a SqlInjectionMatchSet 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.
*
*
* @param updateSqlInjectionMatchSetRequest
* A request to update a SqlInjectionMatchSet.
* @return A Java Future containing the result of the UpdateSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future 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 a
* SqlInjectionMatchTuple, 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 a SqlInjectionMatchSet 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.
*
*
* @param updateSqlInjectionMatchSetRequest
* A request to update a SqlInjectionMatchSet.
* @param 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.
* @return A Java Future containing the result of the UpdateSqlInjectionMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateSqlInjectionMatchSet
* @see AWS API Documentation
*/
java.util.concurrent.Future updateSqlInjectionMatchSetAsync(
UpdateSqlInjectionMatchSetRequest updateSqlInjectionMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
/**
*
* Inserts or deletes ActivatedRule objects in a WebACL. Each Rule identifies web
* requests that you want to allow, block, or count. When you update a WebACL, you specify the
* following values:
*
*
* -
*
* A default action for the WebACL, either ALLOW or BLOCK. AWS WAF performs
* the default action if a request doesn't match the criteria in any of the Rules in a
* WebACL.
*
*
* -
*
* The Rules that you want to add and/or delete. If you want to replace one Rule with
* another, you delete the existing Rule 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 the Rule.
*
*
* -
*
* The order in which you want AWS WAF to evaluate the Rules in a WebACL. If you add more
* than one Rule to a WebACL, AWS WAF evaluates each request against the
* Rules in order based on the value of Priority. (The Rule that has the
* lowest value for Priority is evaluated first.) When a web request matches all of the predicates
* (such as ByteMatchSets and IPSets) in a Rule, AWS WAF immediately takes
* the corresponding action, allow or block, and doesn't evaluate the request against the remaining
* Rules in the WebACL, 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 the WebACL. For more
* information, see CreateRule and UpdateRule.
*
*
* -
*
* Create a WebACL. See CreateWebACL.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateWebACL request.
*
*
* -
*
* Submit an UpdateWebACL request to specify the Rules that you want to include in the
* WebACL, to specify the default action, and to associate the WebACL 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.
*
*
* @param updateWebACLRequest
* @return A Java Future containing the result of the UpdateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateWebACLAsync(UpdateWebACLRequest updateWebACLRequest);
/**
*
* Inserts or deletes ActivatedRule objects in a WebACL. Each Rule identifies web
* requests that you want to allow, block, or count. When you update a WebACL, you specify the
* following values:
*
*
* -
*
* A default action for the WebACL, either ALLOW or BLOCK. AWS WAF performs
* the default action if a request doesn't match the criteria in any of the Rules in a
* WebACL.
*
*
* -
*
* The Rules that you want to add and/or delete. If you want to replace one Rule with
* another, you delete the existing Rule 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 the Rule.
*
*
* -
*
* The order in which you want AWS WAF to evaluate the Rules in a WebACL. If you add more
* than one Rule to a WebACL, AWS WAF evaluates each request against the
* Rules in order based on the value of Priority. (The Rule that has the
* lowest value for Priority is evaluated first.) When a web request matches all of the predicates
* (such as ByteMatchSets and IPSets) in a Rule, AWS WAF immediately takes
* the corresponding action, allow or block, and doesn't evaluate the request against the remaining
* Rules in the WebACL, 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 the WebACL. For more
* information, see CreateRule and UpdateRule.
*
*
* -
*
* Create a WebACL. See CreateWebACL.
*
*
* -
*
* Use GetChangeToken to get the change token that you provide in the ChangeToken
* parameter of an UpdateWebACL request.
*
*
* -
*
* Submit an UpdateWebACL request to specify the Rules that you want to include in the
* WebACL, to specify the default action, and to associate the WebACL 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.
*
*
* @param updateWebACLRequest
* @param 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.
* @return A Java Future containing the result of the UpdateWebACL operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateWebACL
* @see AWS API
* Documentation
*/
java.util.concurrent.Future updateWebACLAsync(UpdateWebACLRequest updateWebACLRequest,
com.amazonaws.handlers.AsyncHandler 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 a
* XssMatchTuple, 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 an XssMatchSet 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.
*
*
* @param updateXssMatchSetRequest
* A request to update an XssMatchSet.
* @return A Java Future containing the result of the UpdateXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsync.UpdateXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future 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 a
* XssMatchTuple, 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 an XssMatchSet 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.
*
*
* @param updateXssMatchSetRequest
* A request to update an XssMatchSet.
* @param 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.
* @return A Java Future containing the result of the UpdateXssMatchSet operation returned by the service.
* @sample AWSWAFRegionalAsyncHandler.UpdateXssMatchSet
* @see AWS
* API Documentation
*/
java.util.concurrent.Future updateXssMatchSetAsync(UpdateXssMatchSetRequest updateXssMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}