@aws-sdk/client-wafv2 3.675.0 → 3.676.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -15,10 +15,8 @@ like endpoints and namespaces, all have the versioning information added, like "
15
15
  "v2", to distinguish from the prior version. We recommend migrating your resources to
16
16
  this version, because it has a number of significant improvements.</p>
17
17
  <p>If you used WAF prior to this release, you can't use this WAFV2 API to access any
18
- WAF resources that you created before. You can access your old rules, web ACLs, and
19
- other WAF resources only through the WAF Classic APIs. The WAF Classic APIs
20
- have retained the prior names, endpoints, and namespaces. </p>
21
- <p>For information, including how to migrate your WAF resources to this version,
18
+ WAF resources that you created before. WAF Classic support will end on September 30, 2025. </p>
19
+ <p>For information about WAF, including how to migrate your WAF Classic resources to this version,
22
20
  see the <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html">WAF Developer Guide</a>. </p>
23
21
  </note>
24
22
  <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
@@ -45,26 +43,6 @@ US East (N. Virginia): us-east-1.</p>
45
43
  </ul>
46
44
  <p>Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the
47
45
  programming language or platform that you're using. For more information, see <a href="http://aws.amazon.com/tools/#SDKs">Amazon Web Services SDKs</a>.</p>
48
- <p>We currently provide two versions of the WAF API: this API and the prior versions,
49
- the classic WAF APIs. This new API provides the same functionality as the older versions,
50
- with the following major improvements:</p>
51
- <ul>
52
- <li>
53
- <p>You use one API for both global and regional applications. Where you need to
54
- distinguish the scope, you specify a <code>Scope</code> parameter and set it to
55
- <code>CLOUDFRONT</code> or <code>REGIONAL</code>. </p>
56
- </li>
57
- <li>
58
- <p>You can define a web ACL or rule group with a single call, and update it with a
59
- single call. You define all rule specifications in JSON format, and pass them to your
60
- rule group or web ACL calls.</p>
61
- </li>
62
- <li>
63
- <p>The limits WAF places on the use of rules more closely reflects the cost of
64
- running each type of rule. Rule groups include capacity settings, so you know the
65
- maximum cost of a rule group when you use it.</p>
66
- </li>
67
- </ul>
68
46
 
69
47
  ## Installing
70
48
 
package/dist-cjs/index.js CHANGED
@@ -2877,6 +2877,7 @@ var de_WebACL = /* @__PURE__ */ __name((output, context) => {
2877
2877
  Name: import_smithy_client.expectString,
2878
2878
  PostProcessFirewallManagerRuleGroups: (_) => de_FirewallManagerRuleGroups(_, context),
2879
2879
  PreProcessFirewallManagerRuleGroups: (_) => de_FirewallManagerRuleGroups(_, context),
2880
+ RetrofittedByFirewallManager: import_smithy_client.expectBoolean,
2880
2881
  Rules: (_) => de_Rules(_, context),
2881
2882
  TokenDomains: import_smithy_client._json,
2882
2883
  VisibilityConfig: import_smithy_client._json
@@ -1777,6 +1777,7 @@ const de_WebACL = (output, context) => {
1777
1777
  Name: __expectString,
1778
1778
  PostProcessFirewallManagerRuleGroups: (_) => de_FirewallManagerRuleGroups(_, context),
1779
1779
  PreProcessFirewallManagerRuleGroups: (_) => de_FirewallManagerRuleGroups(_, context),
1780
+ RetrofittedByFirewallManager: __expectBoolean,
1780
1781
  Rules: (_) => de_Rules(_, context),
1781
1782
  TokenDomains: _json,
1782
1783
  VisibilityConfig: _json,
@@ -390,10 +390,8 @@ export interface WAFV2 {
390
390
  * "v2", to distinguish from the prior version. We recommend migrating your resources to
391
391
  * this version, because it has a number of significant improvements.</p>
392
392
  * <p>If you used WAF prior to this release, you can't use this WAFV2 API to access any
393
- * WAF resources that you created before. You can access your old rules, web ACLs, and
394
- * other WAF resources only through the WAF Classic APIs. The WAF Classic APIs
395
- * have retained the prior names, endpoints, and namespaces. </p>
396
- * <p>For information, including how to migrate your WAF resources to this version,
393
+ * WAF resources that you created before. WAF Classic support will end on September 30, 2025. </p>
394
+ * <p>For information about WAF, including how to migrate your WAF Classic resources to this version,
397
395
  * see the <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html">WAF Developer Guide</a>. </p>
398
396
  * </note>
399
397
  * <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
@@ -420,26 +418,6 @@ export interface WAFV2 {
420
418
  * </ul>
421
419
  * <p>Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the
422
420
  * programming language or platform that you're using. For more information, see <a href="http://aws.amazon.com/tools/#SDKs">Amazon Web Services SDKs</a>.</p>
423
- * <p>We currently provide two versions of the WAF API: this API and the prior versions,
424
- * the classic WAF APIs. This new API provides the same functionality as the older versions,
425
- * with the following major improvements:</p>
426
- * <ul>
427
- * <li>
428
- * <p>You use one API for both global and regional applications. Where you need to
429
- * distinguish the scope, you specify a <code>Scope</code> parameter and set it to
430
- * <code>CLOUDFRONT</code> or <code>REGIONAL</code>. </p>
431
- * </li>
432
- * <li>
433
- * <p>You can define a web ACL or rule group with a single call, and update it with a
434
- * single call. You define all rule specifications in JSON format, and pass them to your
435
- * rule group or web ACL calls.</p>
436
- * </li>
437
- * <li>
438
- * <p>The limits WAF places on the use of rules more closely reflects the cost of
439
- * running each type of rule. Rule groups include capacity settings, so you know the
440
- * maximum cost of a rule group when you use it.</p>
441
- * </li>
442
- * </ul>
443
421
  * @public
444
422
  */
445
423
  export declare class WAFV2 extends WAFV2Client implements WAFV2 {
@@ -213,10 +213,8 @@ export interface WAFV2ClientResolvedConfig extends WAFV2ClientResolvedConfigType
213
213
  * "v2", to distinguish from the prior version. We recommend migrating your resources to
214
214
  * this version, because it has a number of significant improvements.</p>
215
215
  * <p>If you used WAF prior to this release, you can't use this WAFV2 API to access any
216
- * WAF resources that you created before. You can access your old rules, web ACLs, and
217
- * other WAF resources only through the WAF Classic APIs. The WAF Classic APIs
218
- * have retained the prior names, endpoints, and namespaces. </p>
219
- * <p>For information, including how to migrate your WAF resources to this version,
216
+ * WAF resources that you created before. WAF Classic support will end on September 30, 2025. </p>
217
+ * <p>For information about WAF, including how to migrate your WAF Classic resources to this version,
220
218
  * see the <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html">WAF Developer Guide</a>. </p>
221
219
  * </note>
222
220
  * <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
@@ -243,26 +241,6 @@ export interface WAFV2ClientResolvedConfig extends WAFV2ClientResolvedConfigType
243
241
  * </ul>
244
242
  * <p>Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the
245
243
  * programming language or platform that you're using. For more information, see <a href="http://aws.amazon.com/tools/#SDKs">Amazon Web Services SDKs</a>.</p>
246
- * <p>We currently provide two versions of the WAF API: this API and the prior versions,
247
- * the classic WAF APIs. This new API provides the same functionality as the older versions,
248
- * with the following major improvements:</p>
249
- * <ul>
250
- * <li>
251
- * <p>You use one API for both global and regional applications. Where you need to
252
- * distinguish the scope, you specify a <code>Scope</code> parameter and set it to
253
- * <code>CLOUDFRONT</code> or <code>REGIONAL</code>. </p>
254
- * </li>
255
- * <li>
256
- * <p>You can define a web ACL or rule group with a single call, and update it with a
257
- * single call. You define all rule specifications in JSON format, and pass them to your
258
- * rule group or web ACL calls.</p>
259
- * </li>
260
- * <li>
261
- * <p>The limits WAF places on the use of rules more closely reflects the cost of
262
- * running each type of rule. Rule groups include capacity settings, so you know the
263
- * maximum cost of a rule group when you use it.</p>
264
- * </li>
265
- * </ul>
266
244
  * @public
267
245
  */
268
246
  export declare class WAFV2Client extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, WAFV2ClientResolvedConfig> {
@@ -27,9 +27,8 @@ declare const DeleteFirewallManagerRuleGroupsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Deletes all rule groups that are managed by Firewall Manager for the specified web ACL. </p>
31
- * <p>You can only use this if <code>ManagedByFirewallManager</code> is false in the specified
32
- * <a>WebACL</a>. </p>
30
+ * <p>Deletes all rule groups that are managed by Firewall Manager from the specified <a>WebACL</a>. </p>
31
+ * <p>You can only use this if <code>ManagedByFirewallManager</code> and <code>RetrofittedByFirewallManager</code> are both false in the web ACL. </p>
33
32
  * @example
34
33
  * Use a bare-bones client and the command you need to make an API call.
35
34
  * ```javascript
@@ -28,8 +28,7 @@ declare const DeleteWebACLCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <p>Deletes the specified <a>WebACL</a>. </p>
31
- * <p>You can only use this if <code>ManagedByFirewallManager</code> is false in the specified
32
- * <a>WebACL</a>. </p>
31
+ * <p>You can only use this if <code>ManagedByFirewallManager</code> is false in the web ACL. </p>
33
32
  * <note>
34
33
  * <p>Before deleting any web ACL, first disassociate it from all resources.</p>
35
34
  * <ul>
@@ -1216,6 +1216,7 @@ declare const GetWebACLCommand_base: {
1216
1216
  * // },
1217
1217
  * // },
1218
1218
  * // },
1219
+ * // RetrofittedByFirewallManager: true || false,
1219
1220
  * // },
1220
1221
  * // LockToken: "STRING_VALUE",
1221
1222
  * // ApplicationIntegrationURL: "STRING_VALUE",
@@ -1224,6 +1224,7 @@ declare const GetWebACLForResourceCommand_base: {
1224
1224
  * // },
1225
1225
  * // },
1226
1226
  * // },
1227
+ * // RetrofittedByFirewallManager: true || false,
1227
1228
  * // },
1228
1229
  * // };
1229
1230
  *
@@ -7,10 +7,8 @@
7
7
  * "v2", to distinguish from the prior version. We recommend migrating your resources to
8
8
  * this version, because it has a number of significant improvements.</p>
9
9
  * <p>If you used WAF prior to this release, you can't use this WAFV2 API to access any
10
- * WAF resources that you created before. You can access your old rules, web ACLs, and
11
- * other WAF resources only through the WAF Classic APIs. The WAF Classic APIs
12
- * have retained the prior names, endpoints, and namespaces. </p>
13
- * <p>For information, including how to migrate your WAF resources to this version,
10
+ * WAF resources that you created before. WAF Classic support will end on September 30, 2025. </p>
11
+ * <p>For information about WAF, including how to migrate your WAF Classic resources to this version,
14
12
  * see the <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html">WAF Developer Guide</a>. </p>
15
13
  * </note>
16
14
  * <p>WAF is a web application firewall that lets you monitor the HTTP and HTTPS
@@ -37,26 +35,6 @@
37
35
  * </ul>
38
36
  * <p>Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the
39
37
  * programming language or platform that you're using. For more information, see <a href="http://aws.amazon.com/tools/#SDKs">Amazon Web Services SDKs</a>.</p>
40
- * <p>We currently provide two versions of the WAF API: this API and the prior versions,
41
- * the classic WAF APIs. This new API provides the same functionality as the older versions,
42
- * with the following major improvements:</p>
43
- * <ul>
44
- * <li>
45
- * <p>You use one API for both global and regional applications. Where you need to
46
- * distinguish the scope, you specify a <code>Scope</code> parameter and set it to
47
- * <code>CLOUDFRONT</code> or <code>REGIONAL</code>. </p>
48
- * </li>
49
- * <li>
50
- * <p>You can define a web ACL or rule group with a single call, and update it with a
51
- * single call. You define all rule specifications in JSON format, and pass them to your
52
- * rule group or web ACL calls.</p>
53
- * </li>
54
- * <li>
55
- * <p>The limits WAF places on the use of rules more closely reflects the cost of
56
- * running each type of rule. Rule groups include capacity settings, so you know the
57
- * maximum cost of a rule group when you use it.</p>
58
- * </li>
59
- * </ul>
60
38
  *
61
39
  * @packageDocumentation
62
40
  */
@@ -4834,7 +4834,11 @@ export interface LoggingConfiguration {
4834
4834
  /**
4835
4835
  * <p>Indicates whether the logging configuration was created by Firewall Manager, as part of an
4836
4836
  * WAF policy configuration. If true, only Firewall Manager can modify or delete the
4837
- * configuration. </p>
4837
+ * configuration. </p>
4838
+ * <p>The logging configuration can be created by Firewall Manager for use with any web ACL that Firewall Manager is using for an WAF policy.
4839
+ * Web ACLs that Firewall Manager creates and uses have their <code>ManagedByFirewallManager</code> property set to true. Web ACLs that were created
4840
+ * by a customer account and then retrofitted by Firewall Manager for use by a policy have their <code>RetrofittedByFirewallManager</code> property set to true.
4841
+ * For either case, any corresponding logging configuration will indicate <code>ManagedByFirewallManager</code>.</p>
4838
4842
  * @public
4839
4843
  */
4840
4844
  ManagedByFirewallManager?: boolean;
@@ -8080,8 +8084,9 @@ export interface WebACL {
8080
8084
  */
8081
8085
  PostProcessFirewallManagerRuleGroups?: FirewallManagerRuleGroup[];
8082
8086
  /**
8083
- * <p>Indicates whether this web ACL is managed by Firewall Manager. If true, then only Firewall Manager can
8084
- * delete the web ACL or any Firewall Manager rule groups in the web ACL. </p>
8087
+ * <p>Indicates whether this web ACL was created by Firewall Manager and is being managed by Firewall Manager. If true, then only Firewall Manager can
8088
+ * delete the web ACL or any Firewall Manager rule groups in the web ACL.
8089
+ * See also the properties <code>RetrofittedByFirewallManager</code>, <code>PreProcessFirewallManagerRuleGroups</code>, and <code>PostProcessFirewallManagerRuleGroups</code>. </p>
8085
8090
  * @public
8086
8091
  */
8087
8092
  ManagedByFirewallManager?: boolean;
@@ -8141,6 +8146,13 @@ export interface WebACL {
8141
8146
  * @public
8142
8147
  */
8143
8148
  AssociationConfig?: AssociationConfig;
8149
+ /**
8150
+ * <p>Indicates whether this web ACL was created by a customer account and then retrofitted by Firewall Manager. If true, then the web ACL is currently being
8151
+ * managed by a Firewall Manager WAF policy, and only Firewall Manager can manage any Firewall Manager rule groups in the web ACL.
8152
+ * See also the properties <code>ManagedByFirewallManager</code>, <code>PreProcessFirewallManagerRuleGroups</code>, and <code>PostProcessFirewallManagerRuleGroups</code>. </p>
8153
+ * @public
8154
+ */
8155
+ RetrofittedByFirewallManager?: boolean;
8144
8156
  }
8145
8157
  /**
8146
8158
  * @public
@@ -1782,6 +1782,7 @@ export interface WebACL {
1782
1782
  ChallengeConfig?: ChallengeConfig;
1783
1783
  TokenDomains?: string[];
1784
1784
  AssociationConfig?: AssociationConfig;
1785
+ RetrofittedByFirewallManager?: boolean;
1785
1786
  }
1786
1787
  export interface GetWebACLForResourceResponse {
1787
1788
  WebACL?: WebACL;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-wafv2",
3
3
  "description": "AWS SDK for JavaScript Wafv2 Client for Node.js, Browser and React Native",
4
- "version": "3.675.0",
4
+ "version": "3.676.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-wafv2",