com.amazonaws.services.waf.AWSWAFAsync Maven / Gradle / Ivy
/*
* Copyright 2010-2016 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 com.amazonaws.services.waf.model.*;
/**
* Interface for accessing WAF 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.
*
*
* This is the AWS WAF API Reference. This guide is for developers who
* need detailed information about the AWS WAF API actions, data types, and
* errors. For detailed information about AWS WAF features and an overview of
* how to use the AWS WAF API, see the AWS WAF
* Developer Guide.
*
*/
public interface AWSWAFAsync extends AWSWAF {
/**
*
* 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 AWSWAFAsync.CreateByteMatchSet
*/
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 AWSWAFAsyncHandler.CreateByteMatchSet
*/
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 AWSWAFAsync.CreateIPSet
*/
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 AWSWAFAsyncHandler.CreateIPSet
*/
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 AWSWAFAsync.CreateRule
*/
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 AWSWAFAsyncHandler.CreateRule
*/
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 AWSWAFAsync.CreateSizeConstraintSet
*/
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 AWSWAFAsyncHandler.CreateSizeConstraintSet
*/
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 AWSWAFAsync.CreateSqlInjectionMatchSet
*/
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 AWSWAFAsyncHandler.CreateSqlInjectionMatchSet
*/
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 AWSWAFAsync.CreateWebACL
*/
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 AWSWAFAsyncHandler.CreateWebACL
*/
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 AWSWAFAsync.CreateXssMatchSet
*/
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 AWSWAFAsyncHandler.CreateXssMatchSet
*/
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 AWSWAFAsync.DeleteByteMatchSet
*/
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 AWSWAFAsyncHandler.DeleteByteMatchSet
*/
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 AWSWAFAsync.DeleteIPSet
*/
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 AWSWAFAsyncHandler.DeleteIPSet
*/
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 AWSWAFAsync.DeleteRule
*/
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 AWSWAFAsyncHandler.DeleteRule
*/
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 AWSWAFAsync.DeleteSizeConstraintSet
*/
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 AWSWAFAsyncHandler.DeleteSizeConstraintSet
*/
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 AWSWAFAsync.DeleteSqlInjectionMatchSet
*/
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 AWSWAFAsyncHandler.DeleteSqlInjectionMatchSet
*/
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 AWSWAFAsync.DeleteWebACL
*/
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 AWSWAFAsyncHandler.DeleteWebACL
*/
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 AWSWAFAsync.DeleteXssMatchSet
*/
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 AWSWAFAsyncHandler.DeleteXssMatchSet
*/
java.util.concurrent.Future deleteXssMatchSetAsync(
DeleteXssMatchSetRequest deleteXssMatchSetRequest,
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 AWSWAFAsync.GetByteMatchSet
*/
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 AWSWAFAsyncHandler.GetByteMatchSet
*/
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 AWSWAFAsync.GetChangeToken
*/
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 AWSWAFAsyncHandler.GetChangeToken
*/
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 AWSWAFAsync.GetChangeTokenStatus
*/
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 AWSWAFAsyncHandler.GetChangeTokenStatus
*/
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 AWSWAFAsync.GetIPSet
*/
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 AWSWAFAsyncHandler.GetIPSet
*/
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 AWSWAFAsync.GetRule
*/
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 AWSWAFAsyncHandler.GetRule
*/
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 AWSWAFAsync.GetSampledRequests
*/
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 AWSWAFAsyncHandler.GetSampledRequests
*/
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 AWSWAFAsync.GetSizeConstraintSet
*/
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 AWSWAFAsyncHandler.GetSizeConstraintSet
*/
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 AWSWAFAsync.GetSqlInjectionMatchSet
*/
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 AWSWAFAsyncHandler.GetSqlInjectionMatchSet
*/
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 AWSWAFAsync.GetWebACL
*/
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 AWSWAFAsyncHandler.GetWebACL
*/
java.util.concurrent.Future getWebACLAsync(
GetWebACLRequest getWebACLRequest,
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 AWSWAFAsync.GetXssMatchSet
*/
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 AWSWAFAsyncHandler.GetXssMatchSet
*/
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 AWSWAFAsync.ListByteMatchSets
*/
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 AWSWAFAsyncHandler.ListByteMatchSets
*/
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 AWSWAFAsync.ListIPSets
*/
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 AWSWAFAsyncHandler.ListIPSets
*/
java.util.concurrent.Future listIPSetsAsync(
ListIPSetsRequest listIPSetsRequest,
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 AWSWAFAsync.ListRules
*/
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 AWSWAFAsyncHandler.ListRules
*/
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 AWSWAFAsync.ListSizeConstraintSets
*/
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 AWSWAFAsyncHandler.ListSizeConstraintSets
*/
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 AWSWAFAsync.ListSqlInjectionMatchSets
*/
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 AWSWAFAsyncHandler.ListSqlInjectionMatchSets
*/
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 AWSWAFAsync.ListWebACLs
*/
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 AWSWAFAsyncHandler.ListWebACLs
*/
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 AWSWAFAsync.ListXssMatchSets
*/
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 AWSWAFAsyncHandler.ListXssMatchSets
*/
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 AWSWAFAsync.UpdateByteMatchSet
*/
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 AWSWAFAsyncHandler.UpdateByteMatchSet
*/
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
.
* - 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 more
* information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
*
*
* You use an IPSet
to specify which web requests you want to
* allow or block based on the IP addresses that the requests originated
* from. For example, if you're receiving a lot of requests from one or a
* small number of IP addresses and you want to block the requests, you can
* create 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 AWSWAFAsync.UpdateIPSet
*/
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
.
* - 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 more
* information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
*
*
* You use an IPSet
to specify which web requests you want to
* allow or block based on the IP addresses that the requests originated
* from. For example, if you're receiving a lot of requests from one or a
* small number of IP addresses and you want to block the requests, you can
* create 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 AWSWAFAsyncHandler.UpdateIPSet
*/
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 AWSWAFAsync.UpdateRule
*/
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 AWSWAFAsyncHandler.UpdateRule
*/
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 AWSWAFAsync.UpdateSizeConstraintSet
*/
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 AWSWAFAsyncHandler.UpdateSizeConstraintSet
*/
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 AWSWAFAsync.UpdateSqlInjectionMatchSet
*/
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 AWSWAFAsyncHandler.UpdateSqlInjectionMatchSet
*/
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 AWSWAFAsync.UpdateWebACL
*/
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 AWSWAFAsyncHandler.UpdateWebACL
*/
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 AWSWAFAsync.UpdateXssMatchSet
*/
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 AWSWAFAsyncHandler.UpdateXssMatchSet
*/
java.util.concurrent.Future updateXssMatchSetAsync(
UpdateXssMatchSetRequest updateXssMatchSetRequest,
com.amazonaws.handlers.AsyncHandler asyncHandler);
}