@datafire/amazonaws_waf_regional
Client library for AWS WAF Regional
Installation and Usage
npm install --save @datafire/amazonaws_waf_regional
let amazonaws_waf_regional = require('@datafire/amazonaws_waf_regional').create({
accessKeyId: "",
secretAccessKey: "",
region: ""
});
amazonaws_waf_regional.AssociateWebACL({
"WebACLId": "",
"ResourceArn": ""
}).then(data => {
console.log(data);
});
Description
This is the AWS WAF Regional API Reference for using AWS WAF with Elastic Load Balancing (ELB) Application Load Balancers. The AWS WAF actions and data types listed in the reference are available for protecting Application Load Balancers. You can use these actions and data types by means of the endpoints listed in AWS Regions and Endpoints. This guide is for developers who need detailed information about the AWS WAF API actions, data types, and errors. For detailed information about AWS WAF features and an overview of how to use the AWS WAF API, see the AWS WAF Developer Guide.
Actions
AssociateWebACL
amazonaws_waf_regional.AssociateWebACL({
"WebACLId": "",
"ResourceArn": ""
}, context)
Input
Output
CreateByteMatchSet
amazonaws_waf_regional.CreateByteMatchSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateGeoMatchSet
amazonaws_waf_regional.CreateGeoMatchSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateIPSet
amazonaws_waf_regional.CreateIPSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateRateBasedRule
amazonaws_waf_regional.CreateRateBasedRule({
"Name": "",
"MetricName": "",
"RateKey": "",
"RateLimit": 0,
"ChangeToken": ""
}, context)
Input
Output
CreateRegexMatchSet
amazonaws_waf_regional.CreateRegexMatchSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateRegexPatternSet
amazonaws_waf_regional.CreateRegexPatternSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateRule
amazonaws_waf_regional.CreateRule({
"Name": "",
"MetricName": "",
"ChangeToken": ""
}, context)
Input
Output
CreateRuleGroup
amazonaws_waf_regional.CreateRuleGroup({
"Name": "",
"MetricName": "",
"ChangeToken": ""
}, context)
Input
Output
CreateSizeConstraintSet
amazonaws_waf_regional.CreateSizeConstraintSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateSqlInjectionMatchSet
amazonaws_waf_regional.CreateSqlInjectionMatchSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
CreateWebACL
amazonaws_waf_regional.CreateWebACL({
"Name": "",
"MetricName": "",
"DefaultAction": {
"Type": ""
},
"ChangeToken": ""
}, context)
Input
Output
CreateXssMatchSet
amazonaws_waf_regional.CreateXssMatchSet({
"Name": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteByteMatchSet
amazonaws_waf_regional.DeleteByteMatchSet({
"ByteMatchSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteGeoMatchSet
amazonaws_waf_regional.DeleteGeoMatchSet({
"GeoMatchSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteIPSet
amazonaws_waf_regional.DeleteIPSet({
"IPSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteRateBasedRule
amazonaws_waf_regional.DeleteRateBasedRule({
"RuleId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteRegexMatchSet
amazonaws_waf_regional.DeleteRegexMatchSet({
"RegexMatchSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteRegexPatternSet
amazonaws_waf_regional.DeleteRegexPatternSet({
"RegexPatternSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteRule
amazonaws_waf_regional.DeleteRule({
"RuleId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteRuleGroup
amazonaws_waf_regional.DeleteRuleGroup({
"RuleGroupId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteSizeConstraintSet
amazonaws_waf_regional.DeleteSizeConstraintSet({
"SizeConstraintSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteSqlInjectionMatchSet
amazonaws_waf_regional.DeleteSqlInjectionMatchSet({
"SqlInjectionMatchSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteWebACL
amazonaws_waf_regional.DeleteWebACL({
"WebACLId": "",
"ChangeToken": ""
}, context)
Input
Output
DeleteXssMatchSet
amazonaws_waf_regional.DeleteXssMatchSet({
"XssMatchSetId": "",
"ChangeToken": ""
}, context)
Input
Output
DisassociateWebACL
amazonaws_waf_regional.DisassociateWebACL({
"ResourceArn": ""
}, context)
Input
Output
GetByteMatchSet
amazonaws_waf_regional.GetByteMatchSet({
"ByteMatchSetId": ""
}, context)
Input
Output
GetChangeToken
amazonaws_waf_regional.GetChangeToken({}, context)
Input
Output
GetChangeTokenStatus
amazonaws_waf_regional.GetChangeTokenStatus({
"ChangeToken": ""
}, context)
Input
Output
GetGeoMatchSet
amazonaws_waf_regional.GetGeoMatchSet({
"GeoMatchSetId": ""
}, context)
Input
Output
GetIPSet
amazonaws_waf_regional.GetIPSet({
"IPSetId": ""
}, context)
Input
Output
GetRateBasedRule
amazonaws_waf_regional.GetRateBasedRule({
"RuleId": ""
}, context)
Input
Output
GetRateBasedRuleManagedKeys
amazonaws_waf_regional.GetRateBasedRuleManagedKeys({
"RuleId": ""
}, context)
Input
Output
GetRegexMatchSet
amazonaws_waf_regional.GetRegexMatchSet({
"RegexMatchSetId": ""
}, context)
Input
Output
GetRegexPatternSet
amazonaws_waf_regional.GetRegexPatternSet({
"RegexPatternSetId": ""
}, context)
Input
Output
GetRule
amazonaws_waf_regional.GetRule({
"RuleId": ""
}, context)
Input
Output
GetRuleGroup
amazonaws_waf_regional.GetRuleGroup({
"RuleGroupId": ""
}, context)
Input
Output
GetSampledRequests
amazonaws_waf_regional.GetSampledRequests({
"WebAclId": "",
"RuleId": "",
"TimeWindow": {
"StartTime": "",
"EndTime": ""
},
"MaxItems": 0
}, context)
Input
Output
GetSizeConstraintSet
amazonaws_waf_regional.GetSizeConstraintSet({
"SizeConstraintSetId": ""
}, context)
Input
Output
GetSqlInjectionMatchSet
amazonaws_waf_regional.GetSqlInjectionMatchSet({
"SqlInjectionMatchSetId": ""
}, context)
Input
Output
GetWebACL
amazonaws_waf_regional.GetWebACL({
"WebACLId": ""
}, context)
Input
Output
GetWebACLForResource
amazonaws_waf_regional.GetWebACLForResource({
"ResourceArn": ""
}, context)
Input
Output
GetXssMatchSet
amazonaws_waf_regional.GetXssMatchSet({
"XssMatchSetId": ""
}, context)
Input
Output
ListActivatedRulesInRuleGroup
amazonaws_waf_regional.ListActivatedRulesInRuleGroup({}, context)
Input
Output
ListByteMatchSets
amazonaws_waf_regional.ListByteMatchSets({}, context)
Input
Output
ListGeoMatchSets
amazonaws_waf_regional.ListGeoMatchSets({}, context)
Input
Output
ListIPSets
amazonaws_waf_regional.ListIPSets({}, context)
Input
Output
ListRateBasedRules
amazonaws_waf_regional.ListRateBasedRules({}, context)
Input
Output
ListRegexMatchSets
amazonaws_waf_regional.ListRegexMatchSets({}, context)
Input
Output
ListRegexPatternSets
amazonaws_waf_regional.ListRegexPatternSets({}, context)
Input
Output
ListResourcesForWebACL
amazonaws_waf_regional.ListResourcesForWebACL({
"WebACLId": ""
}, context)
Input
Output
ListRuleGroups
amazonaws_waf_regional.ListRuleGroups({}, context)
Input
Output
ListRules
amazonaws_waf_regional.ListRules({}, context)
Input
Output
ListSizeConstraintSets
amazonaws_waf_regional.ListSizeConstraintSets({}, context)
Input
Output
ListSqlInjectionMatchSets
amazonaws_waf_regional.ListSqlInjectionMatchSets({}, context)
Input
Output
ListSubscribedRuleGroups
amazonaws_waf_regional.ListSubscribedRuleGroups({}, context)
Input
Output
ListWebACLs
amazonaws_waf_regional.ListWebACLs({}, context)
Input
Output
ListXssMatchSets
amazonaws_waf_regional.ListXssMatchSets({}, context)
Input
Output
UpdateByteMatchSet
amazonaws_waf_regional.UpdateByteMatchSet({
"ByteMatchSetId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
UpdateGeoMatchSet
amazonaws_waf_regional.UpdateGeoMatchSet({
"GeoMatchSetId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
UpdateIPSet
amazonaws_waf_regional.UpdateIPSet({
"IPSetId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
UpdateRateBasedRule
amazonaws_waf_regional.UpdateRateBasedRule({
"RuleId": "",
"ChangeToken": "",
"Updates": [],
"RateLimit": 0
}, context)
Input
Output
UpdateRegexMatchSet
amazonaws_waf_regional.UpdateRegexMatchSet({
"RegexMatchSetId": "",
"Updates": [],
"ChangeToken": ""
}, context)
Input
Output
UpdateRegexPatternSet
amazonaws_waf_regional.UpdateRegexPatternSet({
"RegexPatternSetId": "",
"Updates": [],
"ChangeToken": ""
}, context)
Input
Output
UpdateRule
amazonaws_waf_regional.UpdateRule({
"RuleId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
UpdateRuleGroup
amazonaws_waf_regional.UpdateRuleGroup({
"RuleGroupId": "",
"Updates": [],
"ChangeToken": ""
}, context)
Input
Output
UpdateSizeConstraintSet
amazonaws_waf_regional.UpdateSizeConstraintSet({
"SizeConstraintSetId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
UpdateSqlInjectionMatchSet
amazonaws_waf_regional.UpdateSqlInjectionMatchSet({
"SqlInjectionMatchSetId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
UpdateWebACL
amazonaws_waf_regional.UpdateWebACL({
"WebACLId": "",
"ChangeToken": ""
}, context)
Input
Output
UpdateXssMatchSet
amazonaws_waf_regional.UpdateXssMatchSet({
"XssMatchSetId": "",
"ChangeToken": "",
"Updates": []
}, context)
Input
Output
Definitions
Action
ActivatedRule
- ActivatedRule
object
: The ActivatedRule
object in an UpdateWebACL request specifies a Rule
that you want to insert or delete, the priority of the Rule
in the WebACL
, and the action that you want AWS WAF to take when a web request matches the Rule
(ALLOW
, BLOCK
, or COUNT
).
To specify whether to insert or delete a Rule
, use the Action
parameter in the WebACLUpdate data type.
ActivatedRules
AssociateWebACLRequest
- AssociateWebACLRequest
object
AssociateWebACLResponse
- AssociateWebACLResponse
object
ByteMatchSet
- ByteMatchSet
object
: In a GetByteMatchSet request, ByteMatchSet
is a complex type that contains the ByteMatchSetId
and Name
of a ByteMatchSet
, and the values that you specified when you updated the ByteMatchSet
.
A complex type that contains ByteMatchTuple
objects, which specify the parts of web requests that you want AWS WAF to inspect and the values that you want AWS WAF to search for. If a ByteMatchSet
contains more than one ByteMatchTuple
object, a request needs to match the settings in only one ByteMatchTuple
to be considered a match.
ByteMatchSetSummaries
- ByteMatchSetSummaries
array
ByteMatchSetSummary
- ByteMatchSetSummary
object
: Returned by ListByteMatchSets. Each ByteMatchSetSummary
object includes the Name
and ByteMatchSetId
for one ByteMatchSet.
ByteMatchSetUpdate
- ByteMatchSetUpdate
object
: In an UpdateByteMatchSet request, ByteMatchSetUpdate
specifies whether to insert or delete a ByteMatchTuple and includes the settings for the ByteMatchTuple
.
ByteMatchSetUpdates
- ByteMatchSetUpdates
array
ByteMatchTargetString
- ByteMatchTargetString
string
ByteMatchTuple
- ByteMatchTuple
object
: The bytes (typically a string that corresponds with ASCII characters) that you want AWS WAF to search for in web requests, the location in requests that you want AWS WAF to search, and other settings.
ByteMatchTuples
ChangeAction
- ChangeAction
string
(values: INSERT, DELETE)
ChangeToken
ChangeTokenStatus
- ChangeTokenStatus
string
(values: PROVISIONED, PENDING, INSYNC)
ComparisonOperator
- ComparisonOperator
string
(values: EQ, NE, LE, LT, GE, GT)
Country
CreateByteMatchSetRequest
- CreateByteMatchSetRequest
object
CreateByteMatchSetResponse
- CreateByteMatchSetResponse
object
CreateGeoMatchSetRequest
- CreateGeoMatchSetRequest
object
CreateGeoMatchSetResponse
- CreateGeoMatchSetResponse
object
CreateIPSetRequest
- CreateIPSetRequest
object
CreateIPSetResponse
- CreateIPSetResponse
object
CreateRateBasedRuleRequest
- CreateRateBasedRuleRequest
object
CreateRateBasedRuleResponse
- CreateRateBasedRuleResponse
object
CreateRegexMatchSetRequest
- CreateRegexMatchSetRequest
object
CreateRegexMatchSetResponse
- CreateRegexMatchSetResponse
object
CreateRegexPatternSetRequest
- CreateRegexPatternSetRequest
object
CreateRegexPatternSetResponse
- CreateRegexPatternSetResponse
object
CreateRuleGroupRequest
- CreateRuleGroupRequest
object
CreateRuleGroupResponse
- CreateRuleGroupResponse
object
CreateRuleRequest
CreateRuleResponse
- CreateRuleResponse
object
CreateSizeConstraintSetRequest
- CreateSizeConstraintSetRequest
object
CreateSizeConstraintSetResponse
- CreateSizeConstraintSetResponse
object
CreateSqlInjectionMatchSetRequest
CreateSqlInjectionMatchSetResponse
- CreateSqlInjectionMatchSetResponse
object
: The response to a CreateSqlInjectionMatchSet
request.
CreateWebACLRequest
- CreateWebACLRequest
object
CreateWebACLResponse
- CreateWebACLResponse
object
CreateXssMatchSetRequest
- CreateXssMatchSetRequest
object
: A request to create an XssMatchSet.
CreateXssMatchSetResponse
- CreateXssMatchSetResponse
object
: The response to a CreateXssMatchSet
request.
DeleteByteMatchSetRequest
- DeleteByteMatchSetRequest
object
DeleteByteMatchSetResponse
- DeleteByteMatchSetResponse
object
DeleteGeoMatchSetRequest
- DeleteGeoMatchSetRequest
object
DeleteGeoMatchSetResponse
- DeleteGeoMatchSetResponse
object
DeleteIPSetRequest
- DeleteIPSetRequest
object
DeleteIPSetResponse
- DeleteIPSetResponse
object
DeleteRateBasedRuleRequest
- DeleteRateBasedRuleRequest
object
DeleteRateBasedRuleResponse
- DeleteRateBasedRuleResponse
object
DeleteRegexMatchSetRequest
- DeleteRegexMatchSetRequest
object
DeleteRegexMatchSetResponse
- DeleteRegexMatchSetResponse
object
DeleteRegexPatternSetRequest
- DeleteRegexPatternSetRequest
object
DeleteRegexPatternSetResponse
- DeleteRegexPatternSetResponse
object
DeleteRuleGroupRequest
- DeleteRuleGroupRequest
object
DeleteRuleGroupResponse
- DeleteRuleGroupResponse
object
DeleteRuleRequest
DeleteRuleResponse
- DeleteRuleResponse
object
DeleteSizeConstraintSetRequest
- DeleteSizeConstraintSetRequest
object
DeleteSizeConstraintSetResponse
- DeleteSizeConstraintSetResponse
object
DeleteSqlInjectionMatchSetRequest
DeleteSqlInjectionMatchSetResponse
- DeleteSqlInjectionMatchSetResponse
object
: The response to a request to delete a SqlInjectionMatchSet from AWS WAF.
DeleteWebACLRequest
- DeleteWebACLRequest
object
DeleteWebACLResponse
- DeleteWebACLResponse
object
DeleteXssMatchSetRequest
- DeleteXssMatchSetRequest
object
: A request to delete an XssMatchSet from AWS WAF.
DeleteXssMatchSetResponse
- DeleteXssMatchSetResponse
object
: The response to a request to delete an XssMatchSet from AWS WAF.
DisassociateWebACLRequest
- DisassociateWebACLRequest
object
DisassociateWebACLResponse
- DisassociateWebACLResponse
object
FieldToMatch
- FieldToMatch
object
: Specifies where in a web request to look for TargetString
.
GeoMatchConstraint
- GeoMatchConstraint
object
: The country from which web requests originate that you want AWS WAF to search for.
GeoMatchConstraintType
- GeoMatchConstraintType
string
(values: Country)
GeoMatchConstraintValue
- GeoMatchConstraintValue
string
(values: AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BQ, BA, BW, BV, BR, IO, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CU, CW, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GG, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JE, JO, KZ, KE, KI, KP, KR, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, ME, MS, MA, MZ, MM, NA, NR, NP, NL, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, BL, SH, KN, LC, MF, PM, VC, WS, SM, ST, SA, SN, RS, SC, SL, SG, SX, SK, SI, SB, SO, ZA, GS, SS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, ZW)
GeoMatchConstraints
- GeoMatchConstraints
array
GeoMatchSet
- GeoMatchSet
object
: Contains one or more countries that AWS WAF will search for.
GeoMatchSetSummaries
- GeoMatchSetSummaries
array
GeoMatchSetSummary
- GeoMatchSetSummary
object
: Contains the identifier and the name of the GeoMatchSet
.
GeoMatchSetUpdate
GeoMatchSetUpdates
GetByteMatchSetRequest
- GetByteMatchSetRequest
object
GetByteMatchSetResponse
- GetByteMatchSetResponse
object
GetChangeTokenRequest
- GetChangeTokenRequest
object
GetChangeTokenResponse
- GetChangeTokenResponse
object
GetChangeTokenStatusRequest
- GetChangeTokenStatusRequest
object
GetChangeTokenStatusResponse
- GetChangeTokenStatusResponse
object
GetGeoMatchSetRequest
- GetGeoMatchSetRequest
object
GetGeoMatchSetResponse
- GetGeoMatchSetResponse
object
GetIPSetRequest
GetIPSetResponse
GetRateBasedRuleManagedKeysRequest
- GetRateBasedRuleManagedKeysRequest
object
GetRateBasedRuleManagedKeysResponse
- GetRateBasedRuleManagedKeysResponse
object
GetRateBasedRuleRequest
- GetRateBasedRuleRequest
object
GetRateBasedRuleResponse
- GetRateBasedRuleResponse
object
GetRegexMatchSetRequest
- GetRegexMatchSetRequest
object
GetRegexMatchSetResponse
- GetRegexMatchSetResponse
object
GetRegexPatternSetRequest
- GetRegexPatternSetRequest
object
GetRegexPatternSetResponse
- GetRegexPatternSetResponse
object
GetRuleGroupRequest
- GetRuleGroupRequest
object
GetRuleGroupResponse
- GetRuleGroupResponse
object
GetRuleRequest
GetRuleResponse
GetSampledRequestsMaxItems
- GetSampledRequestsMaxItems
integer
GetSampledRequestsRequest
- GetSampledRequestsRequest
object
GetSampledRequestsResponse
- GetSampledRequestsResponse
object
GetSizeConstraintSetRequest
- GetSizeConstraintSetRequest
object
GetSizeConstraintSetResponse
- GetSizeConstraintSetResponse
object
GetSqlInjectionMatchSetRequest
GetSqlInjectionMatchSetResponse
GetWebACLForResourceRequest
- GetWebACLForResourceRequest
object
GetWebACLForResourceResponse
- GetWebACLForResourceResponse
object
GetWebACLRequest
GetWebACLResponse
GetXssMatchSetRequest
- GetXssMatchSetRequest
object
: A request to get an XssMatchSet.
GetXssMatchSetResponse
- GetXssMatchSetResponse
object
: The response to a GetXssMatchSet request.
- HTTPHeader
object
: The response from a GetSampledRequests request includes an HTTPHeader
complex type that appears as Headers
in the response syntax. HTTPHeader
contains the names and values of all of the headers that appear in one of the web requests that were returned by GetSampledRequests
.
HTTPMethod
HTTPRequest
- HTTPRequest
object
: The response from a GetSampledRequests request includes an HTTPRequest
complex type that appears as Request
in the response syntax. HTTPRequest
contains information about one of the web requests that were returned by GetSampledRequests
.
HTTPVersion
IPSet
- IPSet
object
: Contains one or more IP addresses or blocks of IP addresses specified in Classless Inter-Domain Routing (CIDR) notation. AWS WAF supports /8, /16, /24, and /32 IP address ranges for IPv4, and /24, /32, /48, /56, /64 and /128 for IPv6.
To specify an individual IP address, you specify the four-part IP address followed by a /32
, for example, 192.0.2.0/31. To block a range of IP addresses, you can specify a /128
, /64
, /56
, /48
, /32
, /24
, /16
, or /8
CIDR. For more information about CIDR notation, see the Wikipedia entry Classless Inter-Domain Routing.
IPSetDescriptor
- IPSetDescriptor
object
: Specifies the IP address type (IPV4
or IPV6
) and the IP address range (in CIDR format) that web requests originate from.
IPSetDescriptorType
- IPSetDescriptorType
string
(values: IPV4, IPV6)
IPSetDescriptorValue
- IPSetDescriptorValue
string
IPSetDescriptors
IPSetSummaries
IPSetSummary
- IPSetSummary
object
: Contains the identifier and the name of the IPSet
.
IPSetUpdate
- IPSetUpdate
object
: Specifies the type of update to perform to an IPSet with UpdateIPSet.
IPSetUpdates
IPString
ListActivatedRulesInRuleGroupRequest
- ListActivatedRulesInRuleGroupRequest
object
ListActivatedRulesInRuleGroupResponse
- ListActivatedRulesInRuleGroupResponse
object
ListByteMatchSetsRequest
- ListByteMatchSetsRequest
object
ListByteMatchSetsResponse
- ListByteMatchSetsResponse
object
ListGeoMatchSetsRequest
- ListGeoMatchSetsRequest
object
ListGeoMatchSetsResponse
- ListGeoMatchSetsResponse
object
ListIPSetsRequest
ListIPSetsResponse
- ListIPSetsResponse
object
ListRateBasedRulesRequest
- ListRateBasedRulesRequest
object
ListRateBasedRulesResponse
- ListRateBasedRulesResponse
object
ListRegexMatchSetsRequest
- ListRegexMatchSetsRequest
object
ListRegexMatchSetsResponse
- ListRegexMatchSetsResponse
object
ListRegexPatternSetsRequest
- ListRegexPatternSetsRequest
object
ListRegexPatternSetsResponse
- ListRegexPatternSetsResponse
object
ListResourcesForWebACLRequest
- ListResourcesForWebACLRequest
object
ListResourcesForWebACLResponse
- ListResourcesForWebACLResponse
object
ListRuleGroupsRequest
- ListRuleGroupsRequest
object
ListRuleGroupsResponse
- ListRuleGroupsResponse
object
ListRulesRequest
ListRulesResponse
ListSizeConstraintSetsRequest
- ListSizeConstraintSetsRequest
object
ListSizeConstraintSetsResponse
- ListSizeConstraintSetsResponse
object
ListSqlInjectionMatchSetsRequest
- ListSqlInjectionMatchSetsRequest
object
: A request to list the SqlInjectionMatchSet objects created by the current AWS account.
ListSqlInjectionMatchSetsResponse
ListSubscribedRuleGroupsRequest
- ListSubscribedRuleGroupsRequest
object
ListSubscribedRuleGroupsResponse
- ListSubscribedRuleGroupsResponse
object
ListWebACLsRequest
- ListWebACLsRequest
object
ListWebACLsResponse
- ListWebACLsResponse
object
ListXssMatchSetsRequest
- ListXssMatchSetsRequest
object
: A request to list the XssMatchSet objects created by the current AWS account.
ListXssMatchSetsResponse
ManagedKey
ManagedKeys
MatchFieldData
MatchFieldType
- MatchFieldType
string
(values: URI, QUERY_STRING, HEADER, METHOD, BODY)
MetricName
Negated
NextMarker
ParameterExceptionField
- ParameterExceptionField
string
(values: CHANGE_ACTION, WAF_ACTION, WAF_OVERRIDE_ACTION, PREDICATE_TYPE, IPSET_TYPE, BYTE_MATCH_FIELD_TYPE, SQL_INJECTION_MATCH_FIELD_TYPE, BYTE_MATCH_TEXT_TRANSFORMATION, BYTE_MATCH_POSITIONAL_CONSTRAINT, SIZE_CONSTRAINT_COMPARISON_OPERATOR, GEO_MATCH_LOCATION_TYPE, GEO_MATCH_LOCATION_VALUE, RATE_KEY, RULE_TYPE, NEXT_MARKER)
ParameterExceptionParameter
- ParameterExceptionParameter
string
ParameterExceptionReason
- ParameterExceptionReason
string
(values: INVALID_OPTION, ILLEGAL_COMBINATION)
PopulationSize
PositionalConstraint
- PositionalConstraint
string
(values: EXACTLY, STARTS_WITH, ENDS_WITH, CONTAINS, CONTAINS_WORD)
Predicate
- Predicate
object
: Specifies the ByteMatchSet, IPSet, SqlInjectionMatchSet, XssMatchSet, RegexMatchSet, GeoMatchSet, and SizeConstraintSet objects that you want to add to a Rule
and, for each object, indicates whether you want to negate the settings, for example, requests that do NOT originate from the IP address 192.0.2.44.
PredicateType
- PredicateType
string
(values: IPMatch, ByteMatch, SqlInjectionMatch, GeoMatch, SizeConstraint, XssMatch, RegexMatch)
Predicates
RateBasedRule
- RateBasedRule
object
: A RateBasedRule
is identical to a regular Rule, with one addition: a RateBasedRule
counts the number of requests that arrive from a specified IP address every five minutes. For example, based on recent requests that you've seen from an attacker, you might create a RateBasedRule
that includes the following conditions:
In the rule, you also define the rate limit as 15,000.
Requests that meet both of these conditions and exceed 15,000 requests every five minutes trigger the rule's action (block or count), which is defined in the web ACL.
RateKey
- RateKey
string
(values: IP)
RateLimit
RegexMatchSet
- RegexMatchSet
object
: In a GetRegexMatchSet request, RegexMatchSet
is a complex type that contains the RegexMatchSetId
and Name
of a RegexMatchSet
, and the values that you specified when you updated the RegexMatchSet
.
The values are contained in a RegexMatchTuple
object, which specify the parts of web requests that you want AWS WAF to inspect and the values that you want AWS WAF to search for. If a RegexMatchSet
contains more than one RegexMatchTuple
object, a request needs to match the settings in only one ByteMatchTuple
to be considered a match.
RegexMatchSetSummaries
- RegexMatchSetSummaries
array
RegexMatchSetSummary
RegexMatchSetUpdate
- RegexMatchSetUpdate
object
: In an UpdateRegexMatchSet request, RegexMatchSetUpdate
specifies whether to insert or delete a RegexMatchTuple and includes the settings for the RegexMatchTuple
.
RegexMatchSetUpdates
- RegexMatchSetUpdates
array
RegexMatchTuple
RegexMatchTuples
RegexPatternSet
- RegexPatternSet
object
: The RegexPatternSet
specifies the regular expression (regex) pattern that you want AWS WAF to search for, such as B[a@]dB[o0]t
. You can then configure AWS WAF to reject those requests.
RegexPatternSetSummaries
- RegexPatternSetSummaries
array
RegexPatternSetSummary
RegexPatternSetUpdate
- RegexPatternSetUpdate
object
: In an UpdateRegexPatternSet request, RegexPatternSetUpdate
specifies whether to insert or delete a RegexPatternString
and includes the settings for the RegexPatternString
.
RegexPatternSetUpdates
- RegexPatternSetUpdates
array
RegexPatternString
- RegexPatternString
string
RegexPatternStrings
- RegexPatternStrings
array
ResourceArn
ResourceArns
ResourceId
ResourceName
Rule
- Rule
object
: A combination of ByteMatchSet, IPSet, and/or SqlInjectionMatchSet objects that identify the web requests that you want to allow, block, or count. For example, you might create a Rule
that includes the following predicates:
-
An IPSet
that causes AWS WAF to search for web requests that originate from the IP address 192.0.2.44
-
A ByteMatchSet
that causes AWS WAF to search for web requests for which the value of the User-Agent
header is BadBot
.
To match the settings in this Rule
, a request must originate from 192.0.2.44
AND include a User-Agent
header for which the value is BadBot
.
RuleGroup
RuleGroupSummaries
RuleGroupSummary
- RuleGroupSummary
object
: Contains the identifier and the friendly name or description of the RuleGroup
.
RuleGroupUpdate
- RuleGroupUpdate
object
: Specifies an ActivatedRule
and indicates whether you want to add it to a RuleGroup
or delete it from a RuleGroup
.
RuleGroupUpdates
RulePriority
RuleSummaries
RuleSummary
- RuleSummary
object
: Contains the identifier and the friendly name or description of the Rule
.
RuleUpdate
- RuleUpdate
object
: Specifies a Predicate
(such as an IPSet
) and indicates whether you want to add it to a Rule
or delete it from a Rule
.
RuleUpdates
SampleWeight
SampledHTTPRequest
- SampledHTTPRequest
object
: The response from a GetSampledRequests request includes a SampledHTTPRequests
complex type that appears as SampledRequests
in the response syntax. SampledHTTPRequests
contains one SampledHTTPRequest
object for each web request that is returned by GetSampledRequests
.
SampledHTTPRequests
- SampledHTTPRequests
array
Size
SizeConstraint
- SizeConstraint
object
: Specifies a constraint on the size of a part of the web request. AWS WAF uses the Size
, ComparisonOperator
, and FieldToMatch
to build an expression in the form of "Size
ComparisonOperator
size in bytes of FieldToMatch
". If that expression is true, the SizeConstraint
is considered to match.
SizeConstraintSet
- SizeConstraintSet
object
: A complex type that contains SizeConstraint
objects, which specify the parts of web requests that you want AWS WAF to inspect the size of. If a SizeConstraintSet
contains more than one SizeConstraint
object, a request only needs to match one constraint to be considered a match.
SizeConstraintSetSummaries
- SizeConstraintSetSummaries
array
SizeConstraintSetSummary
- SizeConstraintSetSummary
object
: The Id
and Name
of a SizeConstraintSet
.
SizeConstraintSetUpdate
- SizeConstraintSetUpdate
object
: Specifies the part of a web request that you want to inspect the size of and indicates whether you want to add the specification to a SizeConstraintSet or delete it from a SizeConstraintSet
.
SizeConstraintSetUpdates
- SizeConstraintSetUpdates
array
SizeConstraints
SqlInjectionMatchSet
- SqlInjectionMatchSet
object
: A complex type that contains SqlInjectionMatchTuple
objects, which specify the parts of web requests that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header. If a SqlInjectionMatchSet
contains more than one SqlInjectionMatchTuple
object, a request needs to include snippets of SQL code in only one of the specified parts of the request to be considered a match.
SqlInjectionMatchSetSummaries
- SqlInjectionMatchSetSummaries
array
SqlInjectionMatchSetSummary
- SqlInjectionMatchSetSummary
object
: The Id
and Name
of a SqlInjectionMatchSet
.
SqlInjectionMatchSetUpdate
- SqlInjectionMatchSetUpdate
object
: Specifies the part of a web request that you want to inspect for snippets of malicious SQL code and indicates whether you want to add the specification to a SqlInjectionMatchSet or delete it from a SqlInjectionMatchSet
.
SqlInjectionMatchSetUpdates
- SqlInjectionMatchSetUpdates
array
SqlInjectionMatchTuple
- SqlInjectionMatchTuple
object
: Specifies the part of a web request that you want AWS WAF to inspect for snippets of malicious SQL code and, if you want AWS WAF to inspect a header, the name of the header.
SqlInjectionMatchTuples
- SqlInjectionMatchTuples
array
SubscribedRuleGroupSummaries
- SubscribedRuleGroupSummaries
array
SubscribedRuleGroupSummary
- SubscribedRuleGroupSummary
object
: A summary of the rule groups you are subscribed to.
TextTransformation
- TextTransformation
string
(values: NONE, COMPRESS_WHITE_SPACE, HTML_ENTITY_DECODE, LOWERCASE, CMD_LINE, URL_DECODE)
TimeWindow
- TimeWindow
object
: In a GetSampledRequests request, the StartTime
and EndTime
objects specify the time range for which you want AWS WAF to return a sample of web requests.
In a GetSampledRequests response, the StartTime
and EndTime
objects specify the time range for which AWS WAF actually returned a sample of web requests. AWS WAF gets the specified number of requests from among the first 5,000 requests that your AWS resource receives during the specified time period. If your resource receives more than 5,000 requests during that period, AWS WAF stops sampling after the 5,000th request. In that case, EndTime
is the time that AWS WAF received the 5,000th request.
Timestamp
URIString
UpdateByteMatchSetRequest
- UpdateByteMatchSetRequest
object
UpdateByteMatchSetResponse
- UpdateByteMatchSetResponse
object
UpdateGeoMatchSetRequest
- UpdateGeoMatchSetRequest
object
UpdateGeoMatchSetResponse
- UpdateGeoMatchSetResponse
object
UpdateIPSetRequest
- UpdateIPSetRequest
object
UpdateIPSetResponse
- UpdateIPSetResponse
object
UpdateRateBasedRuleRequest
- UpdateRateBasedRuleRequest
object
UpdateRateBasedRuleResponse
- UpdateRateBasedRuleResponse
object
UpdateRegexMatchSetRequest
- UpdateRegexMatchSetRequest
object
UpdateRegexMatchSetResponse
- UpdateRegexMatchSetResponse
object
UpdateRegexPatternSetRequest
- UpdateRegexPatternSetRequest
object
UpdateRegexPatternSetResponse
- UpdateRegexPatternSetResponse
object
UpdateRuleGroupRequest
- UpdateRuleGroupRequest
object
UpdateRuleGroupResponse
- UpdateRuleGroupResponse
object
UpdateRuleRequest
UpdateRuleResponse
- UpdateRuleResponse
object
UpdateSizeConstraintSetRequest
- UpdateSizeConstraintSetRequest
object
UpdateSizeConstraintSetResponse
- UpdateSizeConstraintSetResponse
object
UpdateSqlInjectionMatchSetRequest
UpdateSqlInjectionMatchSetResponse
UpdateWebACLRequest
- UpdateWebACLRequest
object
UpdateWebACLResponse
- UpdateWebACLResponse
object
UpdateXssMatchSetRequest
- UpdateXssMatchSetRequest
object
: A request to update an XssMatchSet.
UpdateXssMatchSetResponse
WAFDisallowedNameException
- WAFDisallowedNameException
object
: The name specified is invalid.
WAFInternalErrorException
- WAFInternalErrorException
object
: The operation failed because of a system problem, even though the request was valid. Retry your request.
WAFInvalidAccountException
- WAFInvalidAccountException
object
: The operation failed because you tried to create, update, or delete an object by using an invalid account identifier.
WAFInvalidOperationException
WAFInvalidParameterException
WAFInvalidRegexPatternException
- WAFInvalidRegexPatternException
object
: The regular expression (regex) you specified in RegexPatternString
is invalid.
WAFLimitsExceededException
- WAFLimitsExceededException
object
: The operation exceeds a 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.
WAFNonEmptyEntityException
WAFNonexistentContainerException
WAFNonexistentItemException
- WAFNonexistentItemException
object
: The operation failed because the referenced object doesn't exist.
WAFReferencedItemException
WAFStaleDataException
- WAFStaleDataException
object
: The operation failed because you tried to create, update, or delete an object by using a change token that has already been used.
WAFSubscriptionNotFoundException
- WAFSubscriptionNotFoundException
object
: The specified subscription does not exist.
WAFUnavailableEntityException
- WAFUnavailableEntityException
object
: The operation failed because the entity referenced is temporarily unavailable. Retry your request.
WafAction
- WafAction
object
: For the action that is associated with a rule in a WebACL
, specifies the action that you want AWS WAF to perform when a web request matches all of the conditions in a rule. For the default action in a WebACL
, specifies the action that you want AWS WAF to take when a web request doesn't match all of the conditions in any of the rules in a WebACL
.
WafActionType
- WafActionType
string
(values: BLOCK, ALLOW, COUNT)
WafOverrideAction
- WafOverrideAction
object
: The action to take if any rule within the RuleGroup
matches a request.
WafOverrideActionType
- WafOverrideActionType
string
(values: NONE, COUNT)
WafRuleType
- WafRuleType
string
(values: REGULAR, RATE_BASED, GROUP)
WebACL
- WebACL
object
: Contains the Rules
that identify the requests that you want to allow, block, or count. In a WebACL
, you also specify a default action (ALLOW
or BLOCK
), and the action for each Rule
that you add to a WebACL
, for example, block requests from specified IP addresses or block requests from specified referrers. You also associate the WebACL
with a CloudFront distribution to identify the requests that you want AWS WAF to filter. If you add more than one Rule
to a WebACL
, a request needs to match only one of the specifications to be allowed, blocked, or counted. For more information, see UpdateWebACL.
WebACLSummaries
WebACLSummary
- WebACLSummary
object
: Contains the identifier and the name or description of the WebACL.
WebACLUpdate
- WebACLUpdate
object
: Specifies whether to insert a Rule
into or delete a Rule
from a WebACL
.
WebACLUpdates
XssMatchSet
- XssMatchSet
object
: A complex type that contains XssMatchTuple
objects, which specify the parts of web requests that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header. If a XssMatchSet
contains more than one XssMatchTuple
object, a request needs to include cross-site scripting attacks in only one of the specified parts of the request to be considered a match.
XssMatchSetSummaries
- XssMatchSetSummaries
array
XssMatchSetSummary
- XssMatchSetSummary
object
: The Id
and Name
of an XssMatchSet
.
XssMatchSetUpdate
- XssMatchSetUpdate
object
: Specifies the part of a web request that you want to inspect for cross-site scripting attacks and indicates whether you want to add the specification to an XssMatchSet or delete it from an XssMatchSet
.
XssMatchSetUpdates
XssMatchTuple
- XssMatchTuple
object
: Specifies the part of a web request that you want AWS WAF to inspect for cross-site scripting attacks and, if you want AWS WAF to inspect a header, the name of the header.
XssMatchTuples
errorMessage