com.amazonaws.services.wafv2.AWSWAFV2 Maven / Gradle / Ivy
/*
* Copyright 2015-2020 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.wafv2;
import javax.annotation.Generated;
import com.amazonaws.*;
import com.amazonaws.regions.*;
import com.amazonaws.services.wafv2.model.*;
/**
* Interface for accessing WAFV2.
*
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
* {@link com.amazonaws.services.wafv2.AbstractAWSWAFV2} instead.
*
*
*
*
* This is the latest version of the AWS WAF API, released in November, 2019. The names of the entities that you
* use to access this API, like endpoints and namespaces, all have the versioning information added, like "V2" or "v2",
* to distinguish from the prior version. We recommend migrating your resources to this version, because it has a number
* of significant improvements.
*
*
* If you used AWS WAF prior to this release, you can't use this AWS WAFV2 API to access any AWS WAF resources that you
* created before. You can access your old rules, web ACLs, and other AWS WAF resources only through the AWS WAF Classic
* APIs. The AWS WAF Classic APIs have retained the prior names, endpoints, and namespaces.
*
*
* For information, including how to migrate your AWS WAF resources to this version, see the AWS WAF Developer Guide.
*
*
*
* AWS WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to Amazon
* CloudFront, an Amazon API Gateway API, or an Application Load Balancer. AWS WAF also lets you control access to your
* content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of
* query strings, API Gateway, CloudFront, or the Application Load Balancer responds to requests either with the
* requested content or with an HTTP 403 status code (Forbidden). You also can configure CloudFront to return a custom
* error page when a request is blocked.
*
*
* This API guide is for developers who need detailed information about AWS WAF API actions, data types, and errors. For
* detailed information about AWS WAF features and an overview of how to use AWS WAF, see the AWS WAF Developer Guide.
*
*
* You can make calls using the endpoints listed in AWS Service Endpoints for AWS WAF.
*
*
* -
*
* For regional applications, you can use any of the endpoints in the list. A regional application can be an Application
* Load Balancer (ALB) or an API Gateway stage.
*
*
* -
*
* For AWS CloudFront applications, you must use the API endpoint listed for US East (N. Virginia): us-east-1.
*
*
*
*
* Alternatively, you can use one of the AWS SDKs to access an API that's tailored to the programming language or
* platform that you're using. For more information, see AWS SDKs.
*
*
* We currently provide two versions of the AWS WAF API: this API and the prior versions, the classic AWS WAF APIs. This
* new API provides the same functionality as the older versions, with the following major improvements:
*
*
* -
*
* You use one API for both global and regional applications. Where you need to distinguish the scope, you specify a
* Scope parameter and set it to CLOUDFRONT or REGIONAL.
*
*
* -
*
* You can define a Web ACL or rule group with a single call, and update it with a single call. You define all rule
* specifications in JSON format, and pass them to your rule group or Web ACL calls.
*
*
* -
*
* The limits AWS WAF places on the use of rules more closely reflects the cost of running each type of rule. Rule
* groups include capacity settings, so you know the maximum cost of a rule group when you use it.
*
*
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AWSWAFV2 {
/**
* The region metadata service name for computing region endpoints. You can use this value to retrieve metadata
* (such as supported regions) of the service.
*
* @see RegionUtils#getRegionsForService(String)
*/
String ENDPOINT_PREFIX = "wafv2";
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Associates a Web ACL with a regional application resource, to protect the resource. A regional application can be
* an Application Load Balancer (ALB) or an API Gateway stage.
*
*
* For AWS CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To associate a
* Web ACL, in the CloudFront call UpdateDistribution, set the web ACL ID to the Amazon Resource Name
* (ARN) of the Web ACL. For information, see UpdateDistribution.
*
*
* @param associateWebACLRequest
* @return Result of the AssociateWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.AssociateWebACL
* @see AWS API
* Documentation
*/
AssociateWebACLResult associateWebACL(AssociateWebACLRequest associateWebACLRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Returns the web ACL capacity unit (WCU) requirements for a specified scope and set of rules. You can use this to
* check the capacity requirements for the rules you want to use in a RuleGroup or WebACL.
*
*
* AWS WAF uses WCUs to calculate and control the operating resources that are used to run your rules, rule groups,
* and web ACLs. AWS WAF calculates capacity differently for each rule type, to reflect the relative cost of each
* rule. Simple rules that cost little to run use fewer WCUs than more complex rules that use more processing power.
* Rule group capacity is fixed at creation, which helps users plan their web ACL WCU usage when they use a rule
* group. The WCU limit for web ACLs is 1,500.
*
*
* @param checkCapacityRequest
* @return Result of the CheckCapacity operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFInvalidResourceException
* AWS WAF couldn’t perform the operation because the resource that you requested isn’t valid. Check the
* resource, and try again.
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFSubscriptionNotFoundException
* @sample AWSWAFV2.CheckCapacity
* @see AWS API
* Documentation
*/
CheckCapacityResult checkCapacity(CheckCapacityRequest checkCapacityRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Creates an IPSet, which you use to identify web requests that originate from specific IP addresses or
* ranges of IP addresses. For example, if you're receiving a lot of requests from a ranges of IP addresses, you can
* configure AWS WAF to block them using an IPSet that lists those IP addresses.
*
*
* @param createIPSetRequest
* @return Result of the CreateIPSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.CreateIPSet
* @see AWS API
* Documentation
*/
CreateIPSetResult createIPSet(CreateIPSetRequest createIPSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Creates a RegexPatternSet, which you reference in a RegexPatternSetReferenceStatement, to have AWS
* WAF inspect a web request component for the specified patterns.
*
*
* @param createRegexPatternSetRequest
* @return Result of the CreateRegexPatternSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.CreateRegexPatternSet
* @see AWS
* API Documentation
*/
CreateRegexPatternSetResult createRegexPatternSet(CreateRegexPatternSetRequest createRegexPatternSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Creates a RuleGroup per the specifications provided.
*
*
* A rule group defines a collection of rules to inspect and control web requests that you can use in a
* WebACL. When you create a rule group, you define an immutable capacity limit. If you update a rule group,
* you must stay within the capacity. This allows others to reuse the rule group with confidence in its capacity
* requirements.
*
*
* @param createRuleGroupRequest
* @return Result of the CreateRuleGroup operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFSubscriptionNotFoundException
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.CreateRuleGroup
* @see AWS API
* Documentation
*/
CreateRuleGroupResult createRuleGroup(CreateRuleGroupRequest createRuleGroupRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Creates a WebACL per the specifications provided.
*
*
* A Web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action
* defined (allow, block, or count) for requests that match the statement of the rule. In the Web ACL, you assign a
* default action to take (allow, block) for any request that does not match any of the rules. The rules in a Web
* ACL can be a combination of the types Rule, RuleGroup, and managed rule group. You can associate a
* Web ACL with one or more AWS resources to protect. The resources can be Amazon CloudFront, an Amazon API Gateway
* API, or an Application Load Balancer.
*
*
* @param createWebACLRequest
* @return Result of the CreateWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFInvalidResourceException
* AWS WAF couldn’t perform the operation because the resource that you requested isn’t valid. Check the
* resource, and try again.
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFSubscriptionNotFoundException
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.CreateWebACL
* @see AWS API
* Documentation
*/
CreateWebACLResult createWebACL(CreateWebACLRequest createWebACLRequest);
/**
*
* Deletes all rule groups that are managed by AWS Firewall Manager for the specified web ACL.
*
*
* You can only use this if ManagedByFirewallManager is false in the specified WebACL.
*
*
* @param deleteFirewallManagerRuleGroupsRequest
* @return Result of the DeleteFirewallManagerRuleGroups operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DeleteFirewallManagerRuleGroups
* @see AWS API Documentation
*/
DeleteFirewallManagerRuleGroupsResult deleteFirewallManagerRuleGroups(DeleteFirewallManagerRuleGroupsRequest deleteFirewallManagerRuleGroupsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Deletes the specified IPSet.
*
*
* @param deleteIPSetRequest
* @return Result of the DeleteIPSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFAssociatedItemException
* AWS WAF couldn’t perform the operation because your resource is being used by another resource or it’s
* associated with another resource.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DeleteIPSet
* @see AWS API
* Documentation
*/
DeleteIPSetResult deleteIPSet(DeleteIPSetRequest deleteIPSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Deletes the LoggingConfiguration from the specified web ACL.
*
*
* @param deleteLoggingConfigurationRequest
* @return Result of the DeleteLoggingConfiguration operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DeleteLoggingConfiguration
* @see AWS API Documentation
*/
DeleteLoggingConfigurationResult deleteLoggingConfiguration(DeleteLoggingConfigurationRequest deleteLoggingConfigurationRequest);
/**
*
* Permanently deletes an IAM policy from the specified rule group.
*
*
* You must be the owner of the rule group to perform this operation.
*
*
* @param deletePermissionPolicyRequest
* @return Result of the DeletePermissionPolicy operation returned by the service.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @sample AWSWAFV2.DeletePermissionPolicy
* @see AWS
* API Documentation
*/
DeletePermissionPolicyResult deletePermissionPolicy(DeletePermissionPolicyRequest deletePermissionPolicyRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Deletes the specified RegexPatternSet.
*
*
* @param deleteRegexPatternSetRequest
* @return Result of the DeleteRegexPatternSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFAssociatedItemException
* AWS WAF couldn’t perform the operation because your resource is being used by another resource or it’s
* associated with another resource.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DeleteRegexPatternSet
* @see AWS
* API Documentation
*/
DeleteRegexPatternSetResult deleteRegexPatternSet(DeleteRegexPatternSetRequest deleteRegexPatternSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Deletes the specified RuleGroup.
*
*
* @param deleteRuleGroupRequest
* @return Result of the DeleteRuleGroup operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFAssociatedItemException
* AWS WAF couldn’t perform the operation because your resource is being used by another resource or it’s
* associated with another resource.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DeleteRuleGroup
* @see AWS API
* Documentation
*/
DeleteRuleGroupResult deleteRuleGroup(DeleteRuleGroupRequest deleteRuleGroupRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Deletes the specified WebACL.
*
*
* You can only use this if ManagedByFirewallManager is false in the specified WebACL.
*
*
* @param deleteWebACLRequest
* @return Result of the DeleteWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFAssociatedItemException
* AWS WAF couldn’t perform the operation because your resource is being used by another resource or it’s
* associated with another resource.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DeleteWebACL
* @see AWS API
* Documentation
*/
DeleteWebACLResult deleteWebACL(DeleteWebACLRequest deleteWebACLRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Provides high-level information for a managed rule group, including descriptions of the rules.
*
*
* @param describeManagedRuleGroupRequest
* @return Result of the DescribeManagedRuleGroup operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidResourceException
* AWS WAF couldn’t perform the operation because the resource that you requested isn’t valid. Check the
* resource, and try again.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DescribeManagedRuleGroup
* @see AWS
* API Documentation
*/
DescribeManagedRuleGroupResult describeManagedRuleGroup(DescribeManagedRuleGroupRequest describeManagedRuleGroupRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Disassociates a Web ACL from a regional application resource. A regional application can be an Application Load
* Balancer (ALB) or an API Gateway stage.
*
*
* For AWS CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To disassociate
* a Web ACL, provide an empty web ACL ID in the CloudFront call UpdateDistribution. For information,
* see
* UpdateDistribution.
*
*
* @param disassociateWebACLRequest
* @return Result of the DisassociateWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.DisassociateWebACL
* @see AWS API
* Documentation
*/
DisassociateWebACLResult disassociateWebACL(DisassociateWebACLRequest disassociateWebACLRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the specified IPSet.
*
*
* @param getIPSetRequest
* @return Result of the GetIPSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetIPSet
* @see AWS API
* Documentation
*/
GetIPSetResult getIPSet(GetIPSetRequest getIPSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Returns the LoggingConfiguration for the specified web ACL.
*
*
* @param getLoggingConfigurationRequest
* @return Result of the GetLoggingConfiguration operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetLoggingConfiguration
* @see AWS
* API Documentation
*/
GetLoggingConfigurationResult getLoggingConfiguration(GetLoggingConfigurationRequest getLoggingConfigurationRequest);
/**
*
* Returns the IAM policy that is attached to the specified rule group.
*
*
* You must be the owner of the rule group to perform this operation.
*
*
* @param getPermissionPolicyRequest
* @return Result of the GetPermissionPolicy operation returned by the service.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @sample AWSWAFV2.GetPermissionPolicy
* @see AWS API
* Documentation
*/
GetPermissionPolicyResult getPermissionPolicy(GetPermissionPolicyRequest getPermissionPolicyRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the keys that are currently blocked by a rate-based rule. The maximum number of managed keys that can
* be blocked for a single rate-based rule is 10,000. If more than 10,000 addresses exceed the rate limit, those
* with the highest rates are blocked.
*
*
* @param getRateBasedStatementManagedKeysRequest
* @return Result of the GetRateBasedStatementManagedKeys operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetRateBasedStatementManagedKeys
* @see AWS API Documentation
*/
GetRateBasedStatementManagedKeysResult getRateBasedStatementManagedKeys(GetRateBasedStatementManagedKeysRequest getRateBasedStatementManagedKeysRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the specified RegexPatternSet.
*
*
* @param getRegexPatternSetRequest
* @return Result of the GetRegexPatternSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetRegexPatternSet
* @see AWS API
* Documentation
*/
GetRegexPatternSetResult getRegexPatternSet(GetRegexPatternSetRequest getRegexPatternSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the specified RuleGroup.
*
*
* @param getRuleGroupRequest
* @return Result of the GetRuleGroup operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetRuleGroup
* @see AWS API
* Documentation
*/
GetRuleGroupResult getRuleGroup(GetRuleGroupRequest getRuleGroupRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* 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 500 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 Result of the GetSampledRequests operation returned by the service.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @sample AWSWAFV2.GetSampledRequests
* @see AWS API
* Documentation
*/
GetSampledRequestsResult getSampledRequests(GetSampledRequestsRequest getSampledRequestsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the specified WebACL.
*
*
* @param getWebACLRequest
* @return Result of the GetWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetWebACL
* @see AWS API
* Documentation
*/
GetWebACLResult getWebACL(GetWebACLRequest getWebACLRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the WebACL for the specified resource.
*
*
* @param getWebACLForResourceRequest
* @return Result of the GetWebACLForResource operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.GetWebACLForResource
* @see AWS API
* Documentation
*/
GetWebACLForResourceResult getWebACLForResource(GetWebACLForResourceRequest getWebACLForResourceRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of managed rule groups that are available for you to use. This list includes all AWS Managed
* Rules rule groups and the AWS Marketplace managed rule groups that you're subscribed to.
*
*
* @param listAvailableManagedRuleGroupsRequest
* @return Result of the ListAvailableManagedRuleGroups operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListAvailableManagedRuleGroups
* @see AWS API Documentation
*/
ListAvailableManagedRuleGroupsResult listAvailableManagedRuleGroups(ListAvailableManagedRuleGroupsRequest listAvailableManagedRuleGroupsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of IPSetSummary objects for the IP sets that you manage.
*
*
* @param listIPSetsRequest
* @return Result of the ListIPSets operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListIPSets
* @see AWS API
* Documentation
*/
ListIPSetsResult listIPSets(ListIPSetsRequest listIPSetsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of your LoggingConfiguration objects.
*
*
* @param listLoggingConfigurationsRequest
* @return Result of the ListLoggingConfigurations operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListLoggingConfigurations
* @see AWS API Documentation
*/
ListLoggingConfigurationsResult listLoggingConfigurations(ListLoggingConfigurationsRequest listLoggingConfigurationsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of RegexPatternSetSummary objects for the regex pattern sets that you manage.
*
*
* @param listRegexPatternSetsRequest
* @return Result of the ListRegexPatternSets operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListRegexPatternSets
* @see AWS API
* Documentation
*/
ListRegexPatternSetsResult listRegexPatternSets(ListRegexPatternSetsRequest listRegexPatternSetsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of the Amazon Resource Names (ARNs) for the regional resources that are associated with the
* specified web ACL. If you want the list of AWS CloudFront resources, use the AWS CloudFront call
* ListDistributionsByWebACLId.
*
*
* @param listResourcesForWebACLRequest
* @return Result of the ListResourcesForWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListResourcesForWebACL
* @see AWS
* API Documentation
*/
ListResourcesForWebACLResult listResourcesForWebACL(ListResourcesForWebACLRequest listResourcesForWebACLRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of RuleGroupSummary objects for the rule groups that you manage.
*
*
* @param listRuleGroupsRequest
* @return Result of the ListRuleGroups operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListRuleGroups
* @see AWS API
* Documentation
*/
ListRuleGroupsResult listRuleGroups(ListRuleGroupsRequest listRuleGroupsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves the TagInfoForResource for the specified resource.
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListTagsForResource
* @see AWS API
* Documentation
*/
ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Retrieves an array of WebACLSummary objects for the web ACLs that you manage.
*
*
* @param listWebACLsRequest
* @return Result of the ListWebACLs operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.ListWebACLs
* @see AWS API
* Documentation
*/
ListWebACLsResult listWebACLs(ListWebACLsRequest listWebACLsRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Enables the specified LoggingConfiguration, to start logging from a web ACL, according to the
* configuration provided.
*
*
* You can access information about all traffic that AWS WAF inspects using the following steps:
*
*
* -
*
* Create an Amazon Kinesis Data Firehose.
*
*
* Create the data firehose with a PUT source and in the Region that you are operating. If you are capturing logs
* for Amazon CloudFront, always create the firehose in US East (N. Virginia).
*
*
*
* Do not create the data firehose using a Kinesis stream as your source.
*
*
* -
*
* Associate that firehose to your web ACL using a PutLoggingConfiguration request.
*
*
*
*
* When you successfully enable logging using a PutLoggingConfiguration request, AWS WAF will create a
* service linked role with the necessary permissions to write logs to the Amazon Kinesis Data Firehose. For more
* information, see Logging Web ACL
* Traffic Information in the AWS WAF Developer Guide.
*
*
* @param putLoggingConfigurationRequest
* @return Result of the PutLoggingConfiguration operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFServiceLinkedRoleErrorException
* AWS WAF is not able to access the service linked role. This can be caused by a previous
* PutLoggingConfiguration request, which can lock the service linked role for about 20
* seconds. Please try your request again. The service linked role can also be locked by a previous
* DeleteServiceLinkedRole request, which can lock the role for 15 minutes or more. If you
* recently made a call to DeleteServiceLinkedRole, wait at least 15 minutes and try the
* request again. If you receive this same exception again, you will have to wait additional time until the
* role is unlocked.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.PutLoggingConfiguration
* @see AWS
* API Documentation
*/
PutLoggingConfigurationResult putLoggingConfiguration(PutLoggingConfigurationRequest putLoggingConfigurationRequest);
/**
*
* Attaches an IAM policy to the specified resource. Use this to share a rule group across accounts.
*
*
* You must be the owner of the rule group to perform this operation.
*
*
* This action is subject to the following restrictions:
*
*
* -
*
* You can attach only one policy with each PutPermissionPolicy request.
*
*
* -
*
* The ARN in the request must be a valid WAF RuleGroup ARN and the rule group must exist in the same region.
*
*
* -
*
* The user making the request must be the owner of the rule group.
*
*
*
*
* @param putPermissionPolicyRequest
* @return Result of the PutPermissionPolicy operation returned by the service.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFInvalidPermissionPolicyException
* The operation failed because the specified policy isn't in the proper format.
*
* The policy specifications must conform to the following:
*
*
* -
*
* The policy must be composed using IAM Policy version 2012-10-17 or version 2015-01-01.
*
*
* -
*
* The policy must include specifications for Effect, Action, and
* Principal.
*
*
* -
*
* Effect must specify Allow.
*
*
* -
*
* Action must specify wafv2:CreateWebACL, wafv2:UpdateWebACL, and
* wafv2:PutFirewallManagerRuleGroups. AWS WAF rejects any extra actions or wildcard actions in
* the policy.
*
*
* -
*
* The policy must not include a Resource parameter.
*
*
*
*
* For more information, see IAM Policies.
* @sample AWSWAFV2.PutPermissionPolicy
* @see AWS API
* Documentation
*/
PutPermissionPolicyResult putPermissionPolicy(PutPermissionPolicyRequest putPermissionPolicyRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Associates tags with the specified AWS resource. Tags are key:value pairs that you can associate with AWS
* resources. For example, the tag key might be "customer" and the tag value might be "companyA." You can specify
* one or more tags to add to each container. You can add up to 50 tags to each AWS resource.
*
*
* @param tagResourceRequest
* @return Result of the TagResource operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.TagResource
* @see AWS API
* Documentation
*/
TagResourceResult tagResource(TagResourceRequest tagResourceRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Disassociates tags from an AWS resource. Tags are key:value pairs that you can associate with AWS resources. For
* example, the tag key might be "customer" and the tag value might be "companyA." You can specify one or more tags
* to add to each container. You can add up to 50 tags to each AWS resource.
*
*
* @param untagResourceRequest
* @return Result of the UntagResource operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFTagOperationException
* An error occurred during the tagging operation. Retry your request.
* @throws WAFTagOperationInternalErrorException
* AWS WAF couldn’t perform your tagging operation because of an internal error. Retry your request.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.UntagResource
* @see AWS API
* Documentation
*/
UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Updates the specified IPSet.
*
*
* @param updateIPSetRequest
* @return Result of the UpdateIPSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.UpdateIPSet
* @see AWS API
* Documentation
*/
UpdateIPSetResult updateIPSet(UpdateIPSetRequest updateIPSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Updates the specified RegexPatternSet.
*
*
* @param updateRegexPatternSetRequest
* @return Result of the UpdateRegexPatternSet operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.UpdateRegexPatternSet
* @see AWS
* API Documentation
*/
UpdateRegexPatternSetResult updateRegexPatternSet(UpdateRegexPatternSetRequest updateRegexPatternSetRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Updates the specified RuleGroup.
*
*
* A rule group defines a collection of rules to inspect and control web requests that you can use in a
* WebACL. When you create a rule group, you define an immutable capacity limit. If you update a rule group,
* you must stay within the capacity. This allows others to reuse the rule group with confidence in its capacity
* requirements.
*
*
* @param updateRuleGroupRequest
* @return Result of the UpdateRuleGroup operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFSubscriptionNotFoundException
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.UpdateRuleGroup
* @see AWS API
* Documentation
*/
UpdateRuleGroupResult updateRuleGroup(UpdateRuleGroupRequest updateRuleGroupRequest);
/**
*
*
* This is the latest version of AWS WAF, named AWS WAFV2, released in November, 2019. For information,
* including how to migrate your AWS WAF resources from the prior release, see the AWS WAF Developer Guide.
*
*
*
* Updates the specified WebACL.
*
*
* A Web ACL defines a collection of rules to use to inspect and control web requests. Each rule has an action
* defined (allow, block, or count) for requests that match the statement of the rule. In the Web ACL, you assign a
* default action to take (allow, block) for any request that does not match any of the rules. The rules in a Web
* ACL can be a combination of the types Rule, RuleGroup, and managed rule group. You can associate a
* Web ACL with one or more AWS resources to protect. The resources can be Amazon CloudFront, an Amazon API Gateway
* API, or an Application Load Balancer.
*
*
* @param updateWebACLRequest
* @return Result of the UpdateWebACL operation returned by the service.
* @throws WAFInternalErrorException
* Your request is valid, but AWS WAF couldn’t perform the operation because of a system problem. Retry your
* request.
* @throws WAFInvalidParameterException
* The operation failed because AWS WAF didn't recognize a parameter in the request. For example:
*
* -
*
* You specified an invalid parameter name or value.
*
*
* -
*
* Your nested statement isn't valid. You might have tried to nest a statement that can’t be nested.
*
*
* -
*
* You tried to update a WebACL with a DefaultAction that isn't among the types
* available at DefaultAction.
*
*
* -
*
* Your request references an ARN that is malformed, or corresponds to a resource with which a Web ACL
* cannot be associated.
*
*
* @throws WAFNonexistentItemException
* AWS WAF couldn’t perform the operation because your resource doesn’t exist.
* @throws WAFDuplicateItemException
* AWS WAF couldn’t perform the operation because the resource that you tried to save is a duplicate of an
* existing one.
* @throws WAFOptimisticLockException
* AWS WAF couldn’t save your changes because you tried to update or delete a resource that has changed
* since you last retrieved it. Get the resource again, make any changes you need to make to the new copy,
* and retry your operation.
* @throws WAFLimitsExceededException
* AWS WAF couldn’t perform the operation because you exceeded your resource limit. For example, the maximum
* number of WebACL objects that you can create for an AWS account. For more information, see
* Limits in the AWS WAF
* Developer Guide.
* @throws WAFInvalidResourceException
* AWS WAF couldn’t perform the operation because the resource that you requested isn’t valid. Check the
* resource, and try again.
* @throws WAFUnavailableEntityException
* AWS WAF couldn’t retrieve the resource that you requested. Retry your request.
* @throws WAFSubscriptionNotFoundException
* @throws WAFInvalidOperationException
* The operation isn't valid.
* @sample AWSWAFV2.UpdateWebACL
* @see AWS API
* Documentation
*/
UpdateWebACLResult updateWebACL(UpdateWebACLRequest updateWebACLRequest);
/**
* Shuts down this client object, releasing any resources that might be held open. This is an optional method, and
* callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client
* has been shutdown, it should not be used to make any more requests.
*/
void shutdown();
/**
* Returns additional metadata for a previously executed successful request, typically used for debugging issues
* where a service isn't acting as expected. This data isn't considered part of the result data returned by an
* operation, so it's available through this separate, diagnostic interface.
*
* Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic
* information for an executed request, you should use this method to retrieve it as soon as possible after
* executing a request.
*
* @param request
* The originally executed request.
*
* @return The response metadata for the specified request, or null if none is available.
*/
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request);
}