Skip to content

Commit 2b37799

Browse files
author
awstools
committed
feat(client-wafv2): This SDK release provide customers ability to add sensitivity level for WAF SQLI Match Statements.
1 parent 91e2660 commit 2b37799

File tree

13 files changed

+441
-311
lines changed

13 files changed

+441
-311
lines changed

clients/client-wafv2/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ see the <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapt
2626
</note>
2727
<p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
2828
requests that are forwarded to Amazon CloudFront, an Amazon API Gateway REST API, an Application Load Balancer, or an AppSync
29-
GraphQL API. WAF also lets you control access to your content. Based on conditions that
29+
GraphQL API. WAF also lets you control access to your content. Based on criteria that
3030
you specify, such as the IP addresses that requests originate from or the values of query
3131
strings, the Amazon API Gateway REST API, CloudFront distribution, the Application Load Balancer, or the AppSync GraphQL
3232
API responds to requests either with the requested content or with an HTTP 403 status code

clients/client-wafv2/src/WAFV2.ts

Lines changed: 30 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ import { WAFV2Client } from "./WAFV2Client";
228228
* </note>
229229
* <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
230230
* requests that are forwarded to Amazon CloudFront, an Amazon API Gateway REST API, an Application Load Balancer, or an AppSync
231-
* GraphQL API. WAF also lets you control access to your content. Based on conditions that
231+
* GraphQL API. WAF also lets you control access to your content. Based on criteria that
232232
* you specify, such as the IP addresses that requests originate from or the values of query
233233
* strings, the Amazon API Gateway REST API, CloudFront distribution, the Application Load Balancer, or the AppSync GraphQL
234234
* API responds to requests either with the requested content or with an HTTP 403 status code
@@ -672,18 +672,19 @@ export class WAFV2 extends WAFV2Client {
672672
* <p>Deletes the specified <a>WebACL</a>. </p>
673673
* <p>You can only use this if <code>ManagedByFirewallManager</code> is false in the specified
674674
* <a>WebACL</a>. </p>
675-
* <note>
675+
* <note>
676676
* <p>Before deleting any web ACL, first disassociate it from all resources.</p>
677677
* <ul>
678678
* <li>
679-
* <p>To retrieve a list of the resources that are associated with a web ACL, use the following calls:</p>
679+
* <p>To retrieve a list of the resources that are associated with a web ACL, use the
680+
* following calls:</p>
680681
* <ul>
681682
* <li>
682683
* <p>For regional resources, call <a>ListResourcesForWebACL</a>.</p>
683684
* </li>
684685
* <li>
685-
* <p>For Amazon CloudFront distributions, use the CloudFront call <code>ListDistributionsByWebACLId</code>.
686-
* For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>.</p>
686+
* <p>For Amazon CloudFront distributions, use the CloudFront call
687+
* <code>ListDistributionsByWebACLId</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>.</p>
687688
* </li>
688689
* </ul>
689690
* </li>
@@ -695,7 +696,7 @@ export class WAFV2 extends WAFV2Client {
695696
* </li>
696697
* <li>
697698
* <p>For Amazon CloudFront distributions, provide an empty web ACL ID in the CloudFront call
698-
* <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
699+
* <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
699700
* </li>
700701
* </ul>
701702
* </li>
@@ -762,8 +763,8 @@ export class WAFV2 extends WAFV2Client {
762763
}
763764

764765
/**
765-
* <p>Disassociates the specified regional application resource from any existing web ACL association. A resource can have at most one
766-
* web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, or an AppSync GraphQL API. </p>
766+
* <p>Disassociates the specified regional application resource from any existing web ACL
767+
* association. A resource can have at most one web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, or an AppSync GraphQL API. </p>
767768
* <p>For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To
768769
* disassociate a web ACL, provide an empty web ACL ID in the CloudFront call
769770
* <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
@@ -926,7 +927,8 @@ export class WAFV2 extends WAFV2Client {
926927
}
927928

928929
/**
929-
* <p>Retrieves information for the specified mobile SDK release, including release notes and tags.</p>
930+
* <p>Retrieves information for the specified mobile SDK release, including release notes and
931+
* tags.</p>
930932
* <p>The mobile SDK is not generally available. Customers who have access to the mobile SDK can use it to establish and manage Security Token Service (STS) security tokens for use in HTTP(S) requests from a mobile device to WAF. For more information, see
931933
* <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html">WAF client application integration</a> in the <i>WAF Developer Guide</i>.</p>
932934
*/
@@ -993,9 +995,20 @@ export class WAFV2 extends WAFV2Client {
993995
}
994996

995997
/**
996-
* <p>Retrieves the keys that are currently blocked by a rate-based rule instance. The maximum number of managed keys that can be blocked for a single rate-based rule instance is 10,000. If more than 10,000 addresses exceed the rate limit, those with the highest rates are blocked.</p>
997-
* <p>For a rate-based rule that you've defined inside a rule group, provide the name of the rule group reference statement in your request, in addition to the rate-based rule name and the web ACL name. </p>
998-
* <p>WAF monitors web requests and manages keys independently for each unique combination of web ACL, optional rule group, and rate-based rule. For example, if you define a rate-based rule inside a rule group, and then use the rule group in a web ACL, WAF monitors web requests and manages keys for that web ACL, rule group reference statement, and rate-based rule instance. If you use the same rule group in a second web ACL, WAF monitors web requests and manages keys for this second usage completely independent of your first. </p>
998+
* <p>Retrieves the keys that are currently blocked by a rate-based rule instance. The maximum
999+
* number of managed keys that can be blocked for a single rate-based rule instance is 10,000.
1000+
* If more than 10,000 addresses exceed the rate limit, those with the highest rates are
1001+
* blocked.</p>
1002+
* <p>For a rate-based rule that you've defined inside a rule group, provide the name of the
1003+
* rule group reference statement in your request, in addition to the rate-based rule name and
1004+
* the web ACL name. </p>
1005+
* <p>WAF monitors web requests and manages keys independently for each unique combination
1006+
* of web ACL, optional rule group, and rate-based rule. For example, if you define a
1007+
* rate-based rule inside a rule group, and then use the rule group in a web ACL, WAF
1008+
* monitors web requests and manages keys for that web ACL, rule group reference statement,
1009+
* and rate-based rule instance. If you use the same rule group in a second web ACL, WAF
1010+
* monitors web requests and manages keys for this second usage completely independent of your
1011+
* first. </p>
9991012
*/
10001013
public getRateBasedStatementManagedKeys(
10011014
args: GetRateBasedStatementManagedKeysCommandInput,
@@ -1350,7 +1363,8 @@ export class WAFV2 extends WAFV2Client {
13501363
}
13511364

13521365
/**
1353-
* <p>Retrieves a list of the available releases for the mobile SDK and the specified device platform. </p>
1366+
* <p>Retrieves a list of the available releases for the mobile SDK and the specified device
1367+
* platform. </p>
13541368
* <p>The mobile SDK is not generally available. Customers who have access to the mobile SDK can use it to establish and manage Security Token Service (STS) security tokens for use in HTTP(S) requests from a mobile device to WAF. For more information, see
13551369
* <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html">WAF client application integration</a> in the <i>WAF Developer Guide</i>.</p>
13561370
*/
@@ -1802,7 +1816,7 @@ export class WAFV2 extends WAFV2Client {
18021816
/**
18031817
* <p>Updates the expiration information for your managed rule set. Use this to initiate the
18041818
* expiration of a managed rule group version. After you initiate expiration for a version,
1805-
* WAF excludes it from the reponse to <a>ListAvailableManagedRuleGroupVersions</a> for the managed rule group. </p>
1819+
* WAF excludes it from the response to <a>ListAvailableManagedRuleGroupVersions</a> for the managed rule group. </p>
18061820
* <note>
18071821
* <p>This is intended for use only by vendors of managed rule sets. Vendors are Amazon Web Services and Amazon Web Services Marketplace sellers. </p>
18081822
* <p>Vendors, you can use the managed rule set APIs to provide controlled rollout of your versioned managed rule group offerings for your customers. The APIs are <code>ListManagedRuleSets</code>, <code>GetManagedRuleSet</code>, <code>PutManagedRuleSetVersions</code>, and <code>UpdateManagedRuleSetVersionExpiryDate</code>.</p>
@@ -1915,7 +1929,8 @@ export class WAFV2 extends WAFV2Client {
19151929
}
19161930

19171931
/**
1918-
* <p>Updates the specified <a>WebACL</a>. While updating a web ACL, WAF provides continous coverage to the resources that you have associated with the web ACL. </p>
1932+
* <p>Updates the specified <a>WebACL</a>. While updating a web ACL, WAF provides
1933+
* continuous coverage to the resources that you have associated with the web ACL. </p>
19191934
*
19201935
* <p>When you make changes to web ACLs or web ACL components, like rules and rule groups, WAF propagates the changes everywhere that the web ACL and its components are stored and used. Your changes are applied within seconds, but there might be a brief period of inconsistency when the changes have arrived in some places and not in others. So, for example, if you change a rule action setting, the action might be the old action in one area and the new action in another area. Or if you add an IP address to an IP set used in a blocking rule, the new address might briefly be blocked in one area while still allowed in another. This temporary inconsistency can occur when you first associate a web ACL with an Amazon Web Services resource and when you change a web ACL that is already associated with a resource. Generally, any inconsistencies of this type last only a few seconds.</p>
19211936
* <note>

clients/client-wafv2/src/WAFV2Client.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -448,7 +448,7 @@ export interface WAFV2ClientResolvedConfig extends WAFV2ClientResolvedConfigType
448448
* </note>
449449
* <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
450450
* requests that are forwarded to Amazon CloudFront, an Amazon API Gateway REST API, an Application Load Balancer, or an AppSync
451-
* GraphQL API. WAF also lets you control access to your content. Based on conditions that
451+
* GraphQL API. WAF also lets you control access to your content. Based on criteria that
452452
* you specify, such as the IP addresses that requests originate from or the values of query
453453
* strings, the Amazon API Gateway REST API, CloudFront distribution, the Application Load Balancer, or the AppSync GraphQL
454454
* API responds to requests either with the requested content or with an HTTP 403 status code

clients/client-wafv2/src/commands/DeleteWebACLCommand.ts

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,18 +26,19 @@ export interface DeleteWebACLCommandOutput extends DeleteWebACLResponse, __Metad
2626
* <p>Deletes the specified <a>WebACL</a>. </p>
2727
* <p>You can only use this if <code>ManagedByFirewallManager</code> is false in the specified
2828
* <a>WebACL</a>. </p>
29-
* <note>
29+
* <note>
3030
* <p>Before deleting any web ACL, first disassociate it from all resources.</p>
3131
* <ul>
3232
* <li>
33-
* <p>To retrieve a list of the resources that are associated with a web ACL, use the following calls:</p>
33+
* <p>To retrieve a list of the resources that are associated with a web ACL, use the
34+
* following calls:</p>
3435
* <ul>
3536
* <li>
3637
* <p>For regional resources, call <a>ListResourcesForWebACL</a>.</p>
3738
* </li>
3839
* <li>
39-
* <p>For Amazon CloudFront distributions, use the CloudFront call <code>ListDistributionsByWebACLId</code>.
40-
* For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>.</p>
40+
* <p>For Amazon CloudFront distributions, use the CloudFront call
41+
* <code>ListDistributionsByWebACLId</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListDistributionsByWebACLId.html">ListDistributionsByWebACLId</a>.</p>
4142
* </li>
4243
* </ul>
4344
* </li>
@@ -49,7 +50,7 @@ export interface DeleteWebACLCommandOutput extends DeleteWebACLResponse, __Metad
4950
* </li>
5051
* <li>
5152
* <p>For Amazon CloudFront distributions, provide an empty web ACL ID in the CloudFront call
52-
* <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
53+
* <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>
5354
* </li>
5455
* </ul>
5556
* </li>

clients/client-wafv2/src/commands/DisassociateWebACLCommand.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ export interface DisassociateWebACLCommandInput extends DisassociateWebACLReques
2323
export interface DisassociateWebACLCommandOutput extends DisassociateWebACLResponse, __MetadataBearer {}
2424

2525
/**
26-
* <p>Disassociates the specified regional application resource from any existing web ACL association. A resource can have at most one
27-
* web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, or an AppSync GraphQL API. </p>
26+
* <p>Disassociates the specified regional application resource from any existing web ACL
27+
* association. A resource can have at most one web ACL association. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, or an AppSync GraphQL API. </p>
2828
* <p>For Amazon CloudFront, don't use this call. Instead, use your CloudFront distribution configuration. To
2929
* disassociate a web ACL, provide an empty web ACL ID in the CloudFront call
3030
* <code>UpdateDistribution</code>. For information, see <a href="https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_UpdateDistribution.html">UpdateDistribution</a>.</p>

clients/client-wafv2/src/commands/GetMobileSdkReleaseCommand.ts

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@ export interface GetMobileSdkReleaseCommandInput extends GetMobileSdkReleaseRequ
2323
export interface GetMobileSdkReleaseCommandOutput extends GetMobileSdkReleaseResponse, __MetadataBearer {}
2424

2525
/**
26-
* <p>Retrieves information for the specified mobile SDK release, including release notes and tags.</p>
26+
* <p>Retrieves information for the specified mobile SDK release, including release notes and
27+
* tags.</p>
2728
* <p>The mobile SDK is not generally available. Customers who have access to the mobile SDK can use it to establish and manage Security Token Service (STS) security tokens for use in HTTP(S) requests from a mobile device to WAF. For more information, see
2829
* <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html">WAF client application integration</a> in the <i>WAF Developer Guide</i>.</p>
2930
* @example

clients/client-wafv2/src/commands/GetRateBasedStatementManagedKeysCommand.ts

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,20 @@ export interface GetRateBasedStatementManagedKeysCommandOutput
2525
__MetadataBearer {}
2626

2727
/**
28-
* <p>Retrieves the keys that are currently blocked by a rate-based rule instance. The maximum number of managed keys that can be blocked for a single rate-based rule instance is 10,000. If more than 10,000 addresses exceed the rate limit, those with the highest rates are blocked.</p>
29-
* <p>For a rate-based rule that you've defined inside a rule group, provide the name of the rule group reference statement in your request, in addition to the rate-based rule name and the web ACL name. </p>
30-
* <p>WAF monitors web requests and manages keys independently for each unique combination of web ACL, optional rule group, and rate-based rule. For example, if you define a rate-based rule inside a rule group, and then use the rule group in a web ACL, WAF monitors web requests and manages keys for that web ACL, rule group reference statement, and rate-based rule instance. If you use the same rule group in a second web ACL, WAF monitors web requests and manages keys for this second usage completely independent of your first. </p>
28+
* <p>Retrieves the keys that are currently blocked by a rate-based rule instance. The maximum
29+
* number of managed keys that can be blocked for a single rate-based rule instance is 10,000.
30+
* If more than 10,000 addresses exceed the rate limit, those with the highest rates are
31+
* blocked.</p>
32+
* <p>For a rate-based rule that you've defined inside a rule group, provide the name of the
33+
* rule group reference statement in your request, in addition to the rate-based rule name and
34+
* the web ACL name. </p>
35+
* <p>WAF monitors web requests and manages keys independently for each unique combination
36+
* of web ACL, optional rule group, and rate-based rule. For example, if you define a
37+
* rate-based rule inside a rule group, and then use the rule group in a web ACL, WAF
38+
* monitors web requests and manages keys for that web ACL, rule group reference statement,
39+
* and rate-based rule instance. If you use the same rule group in a second web ACL, WAF
40+
* monitors web requests and manages keys for this second usage completely independent of your
41+
* first. </p>
3142
* @example
3243
* Use a bare-bones client and the command you need to make an API call.
3344
* ```javascript

clients/client-wafv2/src/commands/ListMobileSdkReleasesCommand.ts

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@ export interface ListMobileSdkReleasesCommandInput extends ListMobileSdkReleases
2323
export interface ListMobileSdkReleasesCommandOutput extends ListMobileSdkReleasesResponse, __MetadataBearer {}
2424

2525
/**
26-
* <p>Retrieves a list of the available releases for the mobile SDK and the specified device platform. </p>
26+
* <p>Retrieves a list of the available releases for the mobile SDK and the specified device
27+
* platform. </p>
2728
* <p>The mobile SDK is not generally available. Customers who have access to the mobile SDK can use it to establish and manage Security Token Service (STS) security tokens for use in HTTP(S) requests from a mobile device to WAF. For more information, see
2829
* <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html">WAF client application integration</a> in the <i>WAF Developer Guide</i>.</p>
2930
* @example

0 commit comments

Comments
 (0)