public class AWSWAFAsyncClient extends AWSWAFClient implements AWSWAFAsync
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.
jsonErrorUnmarshallers
client, clientConfiguration, endpoint, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffset
Constructor and Description |
---|
AWSWAFAsyncClient()
Constructs a new asynchronous client to invoke service methods on WAF.
|
AWSWAFAsyncClient(AWSCredentials awsCredentials)
Constructs a new asynchronous client to invoke service methods on WAF
using the specified AWS account credentials.
|
AWSWAFAsyncClient(AWSCredentials awsCredentials,
ClientConfiguration clientConfiguration,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on WAF
using the specified AWS account credentials, executor service, and client
configuration options.
|
AWSWAFAsyncClient(AWSCredentials awsCredentials,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on WAF
using the specified AWS account credentials and executor service.
|
AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new asynchronous client to invoke service methods on WAF
using the specified AWS account credentials provider.
|
AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration)
Constructs a new asynchronous client to invoke service methods on WAF
using the provided AWS account credentials provider and client
configuration options.
|
AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
ClientConfiguration clientConfiguration,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on WAF
using the specified AWS account credentials provider, executor service,
and client configuration options.
|
AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider,
ExecutorService executorService)
Constructs a new asynchronous client to invoke service methods on WAF
using the specified AWS account credentials provider and executor
service.
|
AWSWAFAsyncClient(ClientConfiguration clientConfiguration)
Constructs a new asynchronous client to invoke service methods on WAF.
|
createByteMatchSet, createIPSet, createRule, createSqlInjectionMatchSet, createWebACL, deleteByteMatchSet, deleteIPSet, deleteRule, deleteSqlInjectionMatchSet, deleteWebACL, getByteMatchSet, getCachedResponseMetadata, getChangeToken, getChangeTokenStatus, getIPSet, getRule, getSampledRequests, getSqlInjectionMatchSet, getWebACL, listByteMatchSets, listIPSets, listRules, listSqlInjectionMatchSets, listWebACLs, updateByteMatchSet, updateIPSet, updateRule, updateSqlInjectionMatchSet, updateWebACL
addRequestHandler, addRequestHandler, beforeMarshalling, configSigner, configSigner, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, endClientExecution, endClientExecution, findRequestMetricCollector, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerRegionOverride, getTimeOffset, isProfilingEnabled, isRequestMetricsEnabled, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
createByteMatchSet, createIPSet, createRule, createSqlInjectionMatchSet, createWebACL, deleteByteMatchSet, deleteIPSet, deleteRule, deleteSqlInjectionMatchSet, deleteWebACL, getByteMatchSet, getCachedResponseMetadata, getChangeToken, getChangeTokenStatus, getIPSet, getRule, getSampledRequests, getSqlInjectionMatchSet, getWebACL, listByteMatchSets, listIPSets, listRules, listSqlInjectionMatchSets, listWebACLs, setEndpoint, setRegion, updateByteMatchSet, updateIPSet, updateRule, updateSqlInjectionMatchSet, updateWebACL
public AWSWAFAsyncClient()
Asynchronous methods are delegated to a fixed-size thread pool containing 50 threads (to match the default maximum number of concurrent connections to the service).
public AWSWAFAsyncClient(ClientConfiguration clientConfiguration)
Asynchronous methods are delegated to a fixed-size thread pool containing
a number of threads equal to the maximum number of concurrent connections
configured via ClientConfiguration.getMaxConnections()
.
clientConfiguration
- The client configuration options controlling how this client
connects to WAF (ex: proxy settings, retry counts, etc).DefaultAWSCredentialsProviderChain
,
Executors.newFixedThreadPool(int)
public AWSWAFAsyncClient(AWSCredentials awsCredentials)
Asynchronous methods are delegated to a fixed-size thread pool containing 50 threads (to match the default maximum number of concurrent connections to the service).
awsCredentials
- The AWS credentials (access key ID and secret key) to use when
authenticating with AWS services.Executors.newFixedThreadPool(int)
public AWSWAFAsyncClient(AWSCredentials awsCredentials, ExecutorService executorService)
awsCredentials
- The AWS credentials (access key ID and secret key) to use when
authenticating with AWS services.executorService
- The executor service by which all asynchronous requests will be
executed.public AWSWAFAsyncClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration, ExecutorService executorService)
awsCredentials
- The AWS credentials (access key ID and secret key) to use when
authenticating with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy settings,
etc).executorService
- The executor service by which all asynchronous requests will be
executed.public AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider)
Asynchronous methods are delegated to a fixed-size thread pool containing 50 threads (to match the default maximum number of concurrent connections to the service).
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.Executors.newFixedThreadPool(int)
public AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
Asynchronous methods are delegated to a fixed-size thread pool containing
a number of threads equal to the maximum number of concurrent connections
configured via ClientConfiguration.getMaxConnections()
.
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy settings,
etc).DefaultAWSCredentialsProviderChain
,
Executors.newFixedThreadPool(int)
public AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ExecutorService executorService)
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.executorService
- The executor service by which all asynchronous requests will be
executed.public AWSWAFAsyncClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, ExecutorService executorService)
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to
authenticate requests with AWS services.clientConfiguration
- Client configuration options (ex: max retry limit, proxy settings,
etc).executorService
- The executor service by which all asynchronous requests will be
executed.public ExecutorService getExecutorService()
public Future<CreateByteMatchSetResult> createByteMatchSetAsync(CreateByteMatchSetRequest request)
AWSWAFAsync
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:
ChangeToken
parameter of a
CreateByteMatchSet
request.CreateByteMatchSet
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateByteMatchSet
request.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
createByteMatchSetAsync
in interface AWSWAFAsync
public Future<CreateByteMatchSetResult> createByteMatchSetAsync(CreateByteMatchSetRequest request, AsyncHandler<CreateByteMatchSetRequest,CreateByteMatchSetResult> asyncHandler)
AWSWAFAsync
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:
ChangeToken
parameter of a
CreateByteMatchSet
request.CreateByteMatchSet
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateByteMatchSet
request.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
createByteMatchSetAsync
in interface AWSWAFAsync
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.public Future<CreateIPSetResult> createIPSetAsync(CreateIPSetRequest request)
AWSWAFAsync
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:
ChangeToken
parameter of a CreateIPSet
request.CreateIPSet
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateIPSet request.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.
createIPSetAsync
in interface AWSWAFAsync
public Future<CreateIPSetResult> createIPSetAsync(CreateIPSetRequest request, AsyncHandler<CreateIPSetRequest,CreateIPSetResult> asyncHandler)
AWSWAFAsync
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:
ChangeToken
parameter of a CreateIPSet
request.CreateIPSet
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateIPSet request.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.
createIPSetAsync
in interface AWSWAFAsync
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.public Future<CreateRuleResult> createRuleAsync(CreateRuleRequest request)
AWSWAFAsync
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
:
IPSet
that matches the IP address
192.0.2.44/32
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:
Rule
. For more information, see CreateByteMatchSet,
CreateIPSet, and CreateSqlInjectionMatchSet.ChangeToken
parameter of a CreateRule
request.CreateRule
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an UpdateRule
request.UpdateRule
request to specify the predicates
that you want to include in the Rule
.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.
createRuleAsync
in interface AWSWAFAsync
public Future<CreateRuleResult> createRuleAsync(CreateRuleRequest request, AsyncHandler<CreateRuleRequest,CreateRuleResult> asyncHandler)
AWSWAFAsync
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
:
IPSet
that matches the IP address
192.0.2.44/32
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:
Rule
. For more information, see CreateByteMatchSet,
CreateIPSet, and CreateSqlInjectionMatchSet.ChangeToken
parameter of a CreateRule
request.CreateRule
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an UpdateRule
request.UpdateRule
request to specify the predicates
that you want to include in the Rule
.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.
createRuleAsync
in interface AWSWAFAsync
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.public Future<CreateSqlInjectionMatchSetResult> createSqlInjectionMatchSetAsync(CreateSqlInjectionMatchSetRequest request)
AWSWAFAsync
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:
ChangeToken
parameter of a
CreateSqlInjectionMatchSet
request.CreateSqlInjectionMatchSet
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateSqlInjectionMatchSet request.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
createSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to create a SqlInjectionMatchSet.public Future<CreateSqlInjectionMatchSetResult> createSqlInjectionMatchSetAsync(CreateSqlInjectionMatchSetRequest request, AsyncHandler<CreateSqlInjectionMatchSetRequest,CreateSqlInjectionMatchSetResult> asyncHandler)
AWSWAFAsync
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:
ChangeToken
parameter of a
CreateSqlInjectionMatchSet
request.CreateSqlInjectionMatchSet
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateSqlInjectionMatchSet request.For more information about how to use the AWS WAF API to allow or block HTTP requests, see the AWS WAF Developer Guide.
createSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to create a SqlInjectionMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the
request. Users can provide an implementation of the callback
methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CreateWebACLResult> createWebACLAsync(CreateWebACLRequest request)
AWSWAFAsync
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:
ByteMatchSet
objects and other
predicates that you want to include in Rules
. For more
information, see CreateByteMatchSet, UpdateByteMatchSet,
CreateIPSet, UpdateIPSet,
CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.
Rules
that you want to include in
the WebACL
. For more information, see CreateRule and
UpdateRule.ChangeToken
parameter of a CreateWebACL
request.CreateWebACL
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateWebACL request.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.
createWebACLAsync
in interface AWSWAFAsync
public Future<CreateWebACLResult> createWebACLAsync(CreateWebACLRequest request, AsyncHandler<CreateWebACLRequest,CreateWebACLResult> asyncHandler)
AWSWAFAsync
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:
ByteMatchSet
objects and other
predicates that you want to include in Rules
. For more
information, see CreateByteMatchSet, UpdateByteMatchSet,
CreateIPSet, UpdateIPSet,
CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.
Rules
that you want to include in
the WebACL
. For more information, see CreateRule and
UpdateRule.ChangeToken
parameter of a CreateWebACL
request.CreateWebACL
request.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateWebACL request.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.
createWebACLAsync
in interface AWSWAFAsync
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.public Future<DeleteByteMatchSetResult> deleteByteMatchSetAsync(DeleteByteMatchSetRequest request)
AWSWAFAsync
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:
ByteMatchSet
to remove filters, if any. For
more information, see UpdateByteMatchSet.ChangeToken
parameter of a
DeleteByteMatchSet
request.DeleteByteMatchSet
request.deleteByteMatchSetAsync
in interface AWSWAFAsync
public Future<DeleteByteMatchSetResult> deleteByteMatchSetAsync(DeleteByteMatchSetRequest request, AsyncHandler<DeleteByteMatchSetRequest,DeleteByteMatchSetResult> asyncHandler)
AWSWAFAsync
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:
ByteMatchSet
to remove filters, if any. For
more information, see UpdateByteMatchSet.ChangeToken
parameter of a
DeleteByteMatchSet
request.DeleteByteMatchSet
request.deleteByteMatchSetAsync
in interface AWSWAFAsync
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.public Future<DeleteIPSetResult> deleteIPSetAsync(DeleteIPSetRequest request)
AWSWAFAsync
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:
IPSet
to remove IP address ranges, if any.
For more information, see UpdateIPSet.ChangeToken
parameter of a DeleteIPSet
request.DeleteIPSet
request.deleteIPSetAsync
in interface AWSWAFAsync
public Future<DeleteIPSetResult> deleteIPSetAsync(DeleteIPSetRequest request, AsyncHandler<DeleteIPSetRequest,DeleteIPSetResult> asyncHandler)
AWSWAFAsync
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:
IPSet
to remove IP address ranges, if any.
For more information, see UpdateIPSet.ChangeToken
parameter of a DeleteIPSet
request.DeleteIPSet
request.deleteIPSetAsync
in interface AWSWAFAsync
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.public Future<DeleteRuleResult> deleteRuleAsync(DeleteRuleRequest request)
AWSWAFAsync
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:
Rule
to remove predicates, if any. For more
information, see UpdateRule.ChangeToken
parameter of a DeleteRule
request.DeleteRule
request.deleteRuleAsync
in interface AWSWAFAsync
public Future<DeleteRuleResult> deleteRuleAsync(DeleteRuleRequest request, AsyncHandler<DeleteRuleRequest,DeleteRuleResult> asyncHandler)
AWSWAFAsync
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:
Rule
to remove predicates, if any. For more
information, see UpdateRule.ChangeToken
parameter of a DeleteRule
request.DeleteRule
request.deleteRuleAsync
in interface AWSWAFAsync
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.public Future<DeleteSqlInjectionMatchSetResult> deleteSqlInjectionMatchSetAsync(DeleteSqlInjectionMatchSetRequest request)
AWSWAFAsync
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:
SqlInjectionMatchSet
to remove filters, if
any. For more information, see UpdateSqlInjectionMatchSet.ChangeToken
parameter of a
DeleteSqlInjectionMatchSet
request.DeleteSqlInjectionMatchSet
request.deleteSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to delete a SqlInjectionMatchSet from AWS WAF.public Future<DeleteSqlInjectionMatchSetResult> deleteSqlInjectionMatchSetAsync(DeleteSqlInjectionMatchSetRequest request, AsyncHandler<DeleteSqlInjectionMatchSetRequest,DeleteSqlInjectionMatchSetResult> asyncHandler)
AWSWAFAsync
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:
SqlInjectionMatchSet
to remove filters, if
any. For more information, see UpdateSqlInjectionMatchSet.ChangeToken
parameter of a
DeleteSqlInjectionMatchSet
request.DeleteSqlInjectionMatchSet
request.deleteSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to delete a SqlInjectionMatchSet from AWS WAF.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the
request. Users can provide an implementation of the callback
methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<DeleteWebACLResult> deleteWebACLAsync(DeleteWebACLRequest request)
AWSWAFAsync
Permanently deletes a WebACL. You can't delete a
WebACL
if it still contains any Rules
.
To delete a WebACL
, perform the following steps:
WebACL
to remove Rules
, if any.
For more information, see UpdateWebACL.ChangeToken
parameter of a DeleteWebACL
request.DeleteWebACL
request.deleteWebACLAsync
in interface AWSWAFAsync
public Future<DeleteWebACLResult> deleteWebACLAsync(DeleteWebACLRequest request, AsyncHandler<DeleteWebACLRequest,DeleteWebACLResult> asyncHandler)
AWSWAFAsync
Permanently deletes a WebACL. You can't delete a
WebACL
if it still contains any Rules
.
To delete a WebACL
, perform the following steps:
WebACL
to remove Rules
, if any.
For more information, see UpdateWebACL.ChangeToken
parameter of a DeleteWebACL
request.DeleteWebACL
request.deleteWebACLAsync
in interface AWSWAFAsync
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.public Future<GetByteMatchSetResult> getByteMatchSetAsync(GetByteMatchSetRequest request)
AWSWAFAsync
Returns the ByteMatchSet specified by ByteMatchSetId
.
getByteMatchSetAsync
in interface AWSWAFAsync
public Future<GetByteMatchSetResult> getByteMatchSetAsync(GetByteMatchSetRequest request, AsyncHandler<GetByteMatchSetRequest,GetByteMatchSetResult> asyncHandler)
AWSWAFAsync
Returns the ByteMatchSet specified by ByteMatchSetId
.
getByteMatchSetAsync
in interface AWSWAFAsync
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.public Future<GetChangeTokenResult> getChangeTokenAsync(GetChangeTokenRequest request)
AWSWAFAsync
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.
getChangeTokenAsync
in interface AWSWAFAsync
public Future<GetChangeTokenResult> getChangeTokenAsync(GetChangeTokenRequest request, AsyncHandler<GetChangeTokenRequest,GetChangeTokenResult> asyncHandler)
AWSWAFAsync
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.
getChangeTokenAsync
in interface AWSWAFAsync
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.public Future<GetChangeTokenStatusResult> getChangeTokenStatusAsync(GetChangeTokenStatusRequest request)
AWSWAFAsync
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.getChangeTokenStatusAsync
in interface AWSWAFAsync
public Future<GetChangeTokenStatusResult> getChangeTokenStatusAsync(GetChangeTokenStatusRequest request, AsyncHandler<GetChangeTokenStatusRequest,GetChangeTokenStatusResult> asyncHandler)
AWSWAFAsync
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.getChangeTokenStatusAsync
in interface AWSWAFAsync
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.public Future<GetIPSetResult> getIPSetAsync(GetIPSetRequest request)
AWSWAFAsync
Returns the IPSet that is specified by IPSetId
.
getIPSetAsync
in interface AWSWAFAsync
public Future<GetIPSetResult> getIPSetAsync(GetIPSetRequest request, AsyncHandler<GetIPSetRequest,GetIPSetResult> asyncHandler)
AWSWAFAsync
Returns the IPSet that is specified by IPSetId
.
getIPSetAsync
in interface AWSWAFAsync
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.public Future<GetRuleResult> getRuleAsync(GetRuleRequest request)
AWSWAFAsync
Returns the Rule that is specified by the RuleId
that
you included in the GetRule
request.
getRuleAsync
in interface AWSWAFAsync
public Future<GetRuleResult> getRuleAsync(GetRuleRequest request, AsyncHandler<GetRuleRequest,GetRuleResult> asyncHandler)
AWSWAFAsync
Returns the Rule that is specified by the RuleId
that
you included in the GetRule
request.
getRuleAsync
in interface AWSWAFAsync
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.public Future<GetSampledRequestsResult> getSampledRequestsAsync(GetSampledRequestsRequest request)
AWSWAFAsync
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.
getSampledRequestsAsync
in interface AWSWAFAsync
public Future<GetSampledRequestsResult> getSampledRequestsAsync(GetSampledRequestsRequest request, AsyncHandler<GetSampledRequestsRequest,GetSampledRequestsResult> asyncHandler)
AWSWAFAsync
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.
getSampledRequestsAsync
in interface AWSWAFAsync
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.public Future<GetSqlInjectionMatchSetResult> getSqlInjectionMatchSetAsync(GetSqlInjectionMatchSetRequest request)
AWSWAFAsync
Returns the SqlInjectionMatchSet that is specified by
SqlInjectionMatchSetId
.
getSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to get a SqlInjectionMatchSet.public Future<GetSqlInjectionMatchSetResult> getSqlInjectionMatchSetAsync(GetSqlInjectionMatchSetRequest request, AsyncHandler<GetSqlInjectionMatchSetRequest,GetSqlInjectionMatchSetResult> asyncHandler)
AWSWAFAsync
Returns the SqlInjectionMatchSet that is specified by
SqlInjectionMatchSetId
.
getSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to get a SqlInjectionMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the
request. Users can provide an implementation of the callback
methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<GetWebACLResult> getWebACLAsync(GetWebACLRequest request)
AWSWAFAsync
Returns the WebACL that is specified by WebACLId
.
getWebACLAsync
in interface AWSWAFAsync
public Future<GetWebACLResult> getWebACLAsync(GetWebACLRequest request, AsyncHandler<GetWebACLRequest,GetWebACLResult> asyncHandler)
AWSWAFAsync
Returns the WebACL that is specified by WebACLId
.
getWebACLAsync
in interface AWSWAFAsync
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.public Future<ListByteMatchSetsResult> listByteMatchSetsAsync(ListByteMatchSetsRequest request)
AWSWAFAsync
Returns an array of ByteMatchSetSummary objects.
listByteMatchSetsAsync
in interface AWSWAFAsync
public Future<ListByteMatchSetsResult> listByteMatchSetsAsync(ListByteMatchSetsRequest request, AsyncHandler<ListByteMatchSetsRequest,ListByteMatchSetsResult> asyncHandler)
AWSWAFAsync
Returns an array of ByteMatchSetSummary objects.
listByteMatchSetsAsync
in interface AWSWAFAsync
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.public Future<ListIPSetsResult> listIPSetsAsync(ListIPSetsRequest request)
AWSWAFAsync
Returns an array of IPSetSummary objects in the response.
listIPSetsAsync
in interface AWSWAFAsync
public Future<ListIPSetsResult> listIPSetsAsync(ListIPSetsRequest request, AsyncHandler<ListIPSetsRequest,ListIPSetsResult> asyncHandler)
AWSWAFAsync
Returns an array of IPSetSummary objects in the response.
listIPSetsAsync
in interface AWSWAFAsync
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.public Future<ListRulesResult> listRulesAsync(ListRulesRequest request)
AWSWAFAsync
Returns an array of RuleSummary objects.
listRulesAsync
in interface AWSWAFAsync
public Future<ListRulesResult> listRulesAsync(ListRulesRequest request, AsyncHandler<ListRulesRequest,ListRulesResult> asyncHandler)
AWSWAFAsync
Returns an array of RuleSummary objects.
listRulesAsync
in interface AWSWAFAsync
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.public Future<ListSqlInjectionMatchSetsResult> listSqlInjectionMatchSetsAsync(ListSqlInjectionMatchSetsRequest request)
AWSWAFAsync
Returns an array of SqlInjectionMatchSet objects.
listSqlInjectionMatchSetsAsync
in interface AWSWAFAsync
request
- A request to list the SqlInjectionMatchSet objects created
by the current AWS account.public Future<ListSqlInjectionMatchSetsResult> listSqlInjectionMatchSetsAsync(ListSqlInjectionMatchSetsRequest request, AsyncHandler<ListSqlInjectionMatchSetsRequest,ListSqlInjectionMatchSetsResult> asyncHandler)
AWSWAFAsync
Returns an array of SqlInjectionMatchSet objects.
listSqlInjectionMatchSetsAsync
in interface AWSWAFAsync
request
- A request to list the SqlInjectionMatchSet objects created
by the current AWS account.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the
request. Users can provide an implementation of the callback
methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ListWebACLsResult> listWebACLsAsync(ListWebACLsRequest request)
AWSWAFAsync
Returns an array of WebACLSummary objects in the response.
listWebACLsAsync
in interface AWSWAFAsync
public Future<ListWebACLsResult> listWebACLsAsync(ListWebACLsRequest request, AsyncHandler<ListWebACLsRequest,ListWebACLsResult> asyncHandler)
AWSWAFAsync
Returns an array of WebACLSummary objects in the response.
listWebACLsAsync
in interface AWSWAFAsync
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.public Future<UpdateByteMatchSetResult> updateByteMatchSetAsync(UpdateByteMatchSetRequest request)
AWSWAFAsync
Inserts or deletes ByteMatchTuple objects (filters) in a
ByteMatchSet. For each ByteMatchTuple
object, you
specify the following values:
ByteMatchSetUpdate
object, you delete the existing
object and add a new one.User-Agent
header.TargetString
in the ByteMatchTuple data type.
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:
ByteMatchSet.
For more information, see
CreateByteMatchSet.ChangeToken
parameter of an
UpdateByteMatchSet
request.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.
updateByteMatchSetAsync
in interface AWSWAFAsync
public Future<UpdateByteMatchSetResult> updateByteMatchSetAsync(UpdateByteMatchSetRequest request, AsyncHandler<UpdateByteMatchSetRequest,UpdateByteMatchSetResult> asyncHandler)
AWSWAFAsync
Inserts or deletes ByteMatchTuple objects (filters) in a
ByteMatchSet. For each ByteMatchTuple
object, you
specify the following values:
ByteMatchSetUpdate
object, you delete the existing
object and add a new one.User-Agent
header.TargetString
in the ByteMatchTuple data type.
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:
ByteMatchSet.
For more information, see
CreateByteMatchSet.ChangeToken
parameter of an
UpdateByteMatchSet
request.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.
updateByteMatchSetAsync
in interface AWSWAFAsync
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.public Future<UpdateIPSetResult> updateIPSetAsync(UpdateIPSetRequest request)
AWSWAFAsync
Inserts or deletes IPSetDescriptor objects in an
IPSet
. For each IPSetDescriptor
object, you
specify the following values:
IPSetDescriptor
object, you delete the existing
object and add a new one.IPv4
.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:
ChangeToken
parameter of an UpdateIPSet request.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.
updateIPSetAsync
in interface AWSWAFAsync
public Future<UpdateIPSetResult> updateIPSetAsync(UpdateIPSetRequest request, AsyncHandler<UpdateIPSetRequest,UpdateIPSetResult> asyncHandler)
AWSWAFAsync
Inserts or deletes IPSetDescriptor objects in an
IPSet
. For each IPSetDescriptor
object, you
specify the following values:
IPSetDescriptor
object, you delete the existing
object and add a new one.IPv4
.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:
ChangeToken
parameter of an UpdateIPSet request.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.
updateIPSetAsync
in interface AWSWAFAsync
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.public Future<UpdateRuleResult> updateRuleAsync(UpdateRuleRequest request)
AWSWAFAsync
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
:
ByteMatchSet
that matches the value
BadBot
in the User-Agent
headerIPSet
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:
Rule
.Rule
. See CreateRule.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an UpdateRule
request.UpdateRule
request to add predicates to the
Rule
.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.
updateRuleAsync
in interface AWSWAFAsync
public Future<UpdateRuleResult> updateRuleAsync(UpdateRuleRequest request, AsyncHandler<UpdateRuleRequest,UpdateRuleResult> asyncHandler)
AWSWAFAsync
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
:
ByteMatchSet
that matches the value
BadBot
in the User-Agent
headerIPSet
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:
Rule
.Rule
. See CreateRule.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an UpdateRule
request.UpdateRule
request to add predicates to the
Rule
.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.
updateRuleAsync
in interface AWSWAFAsync
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.public Future<UpdateSqlInjectionMatchSetResult> updateSqlInjectionMatchSetAsync(UpdateSqlInjectionMatchSetRequest request)
AWSWAFAsync
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:
ChangeToken
parameter of an UpdateIPSet request.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.
updateSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to update a SqlInjectionMatchSet.public Future<UpdateSqlInjectionMatchSetResult> updateSqlInjectionMatchSetAsync(UpdateSqlInjectionMatchSetRequest request, AsyncHandler<UpdateSqlInjectionMatchSetRequest,UpdateSqlInjectionMatchSetResult> asyncHandler)
AWSWAFAsync
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:
ChangeToken
parameter of an UpdateIPSet request.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.
updateSqlInjectionMatchSetAsync
in interface AWSWAFAsync
request
- A request to update a SqlInjectionMatchSet.asyncHandler
- Asynchronous callback handler for events in the lifecycle of the
request. Users can provide an implementation of the callback
methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<UpdateWebACLResult> updateWebACLAsync(UpdateWebACLRequest request)
AWSWAFAsync
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:
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
.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.Rule
, whether you want AWS WAF to allow
requests, block requests, or count requests that match the conditions in
the Rule
.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.WebACL
.
To create and configure a WebACL
, perform the following
steps:
Rules
. For more information, see CreateByteMatchSet,
UpdateByteMatchSet, CreateIPSet, UpdateIPSet,
CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.
Rules
that you want to include in
the WebACL
. For more information, see CreateRule and
UpdateRule.WebACL
. See CreateWebACL.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateWebACL request.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.
updateWebACLAsync
in interface AWSWAFAsync
public Future<UpdateWebACLResult> updateWebACLAsync(UpdateWebACLRequest request, AsyncHandler<UpdateWebACLRequest,UpdateWebACLResult> asyncHandler)
AWSWAFAsync
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:
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
.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.Rule
, whether you want AWS WAF to allow
requests, block requests, or count requests that match the conditions in
the Rule
.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.WebACL
.
To create and configure a WebACL
, perform the following
steps:
Rules
. For more information, see CreateByteMatchSet,
UpdateByteMatchSet, CreateIPSet, UpdateIPSet,
CreateSqlInjectionMatchSet, and UpdateSqlInjectionMatchSet.
Rules
that you want to include in
the WebACL
. For more information, see CreateRule and
UpdateRule.WebACL
. See CreateWebACL.GetChangeToken
to get the change token that you
provide in the ChangeToken
parameter of an
UpdateWebACL request.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.
updateWebACLAsync
in interface AWSWAFAsync
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.public void shutdown()
getExecutorService().shutdown()
followed by
getExecutorService().awaitTermination()
prior to calling this
method.shutdown
in interface AWSWAF
shutdown
in class AmazonWebServiceClient
Copyright © 2015. All rights reserved.