@aws-sdk/client-wafv2 3.52.0 → 3.53.0

package/dist-types/WAFV2.d.ts

@@ -232,7 +232,8 @@ export declare class WAFV2 extends WAFV2Client {
     disassociateWebACL(args: DisassociateWebACLCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DisassociateWebACLCommandOutput) => void): void;
     /**
      * <p>Generates a presigned download URL for the specified release of the mobile SDK.</p>
-     *          <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. </p>
+     *          <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
+     * <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>
      */
     generateMobileSdkReleaseUrl(args: GenerateMobileSdkReleaseUrlCommandInput, options?: __HttpHandlerOptions): Promise<GenerateMobileSdkReleaseUrlCommandOutput>;
     generateMobileSdkReleaseUrl(args: GenerateMobileSdkReleaseUrlCommandInput, cb: (err: any, data?: GenerateMobileSdkReleaseUrlCommandOutput) => void): void;
@@ -261,7 +262,8 @@ export declare class WAFV2 extends WAFV2Client {
     getManagedRuleSet(args: GetManagedRuleSetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetManagedRuleSetCommandOutput) => void): void;
     /**
      * <p>Retrieves information for the specified mobile SDK release, including release notes and tags.</p>
-     *          <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. </p>
+     *          <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
+     * <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>
      */
     getMobileSdkRelease(args: GetMobileSdkReleaseCommandInput, options?: __HttpHandlerOptions): Promise<GetMobileSdkReleaseCommandOutput>;
     getMobileSdkRelease(args: GetMobileSdkReleaseCommandInput, cb: (err: any, data?: GetMobileSdkReleaseCommandOutput) => void): void;
@@ -359,7 +361,8 @@ export declare class WAFV2 extends WAFV2Client {
     listManagedRuleSets(args: ListManagedRuleSetsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListManagedRuleSetsCommandOutput) => void): void;
     /**
      * <p>Retrieves a list of the available releases for the mobile SDK and the specified device platform. </p>
-     *          <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. </p>
+     *          <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
+     * <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>
      */
     listMobileSdkReleases(args: ListMobileSdkReleasesCommandInput, options?: __HttpHandlerOptions): Promise<ListMobileSdkReleasesCommandOutput>;
     listMobileSdkReleases(args: ListMobileSdkReleasesCommandInput, cb: (err: any, data?: ListMobileSdkReleasesCommandOutput) => void): void;
@@ -408,8 +411,11 @@ export declare class WAFV2 extends WAFV2Client {
     listWebACLs(args: ListWebACLsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListWebACLsCommandOutput) => void): void;
     /**
      * <p>Enables the specified <a>LoggingConfiguration</a>, to start logging from a
-     *          web ACL, according to the configuration provided.</p>
-     *          <p>You can access information about all traffic that WAF inspects using the following
+     *          web ACL, according to the configuration provided. </p>
+     *          <note>
+     *             <p>You can define one logging destination per web ACL.</p>
+     *          </note>
+     *          <p>You can access information about the traffic that WAF inspects using the following
      *          steps:</p>
      *          <ol>
      *             <li>
@@ -427,6 +433,9 @@ export declare class WAFV2 extends WAFV2Client {
      *           request, WAF creates an additional role or policy that is required to write
      *               logs to the logging destination. For an Amazon CloudWatch Logs log group, WAF creates a resource policy on the log group.
      *           For an Amazon S3 bucket, WAF creates a bucket policy. For an Amazon Kinesis Data Firehose, WAF creates a service-linked role.</p>
+     *          <p>For additional information about web ACL logging, see
+     *            <a href="https://docs.aws.amazon.com/waf/latest/developerguide/logging.html">Logging web ACL traffic information</a>
+     *                in the <i>WAF Developer Guide</i>.</p>
      *          <note>
      *             <p>This operation completely replaces the mutable specifications that you already have for the logging configuration with the ones that you provide to this call. To modify the logging configuration, retrieve it by calling <a>GetLoggingConfiguration</a>, update the settings as needed, and then provide the complete logging configuration specification to this call.</p>
      *          </note>

package/dist-types/commands/GenerateMobileSdkReleaseUrlCommand.d.ts

@@ -8,7 +8,8 @@ export interface GenerateMobileSdkReleaseUrlCommandOutput extends GenerateMobile
 }
 /**
  * <p>Generates a presigned download URL for the specified release of the mobile SDK.</p>
- *          <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. </p>
+ *          <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
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetMobileSdkReleaseCommand.d.ts

@@ -8,7 +8,8 @@ export interface GetMobileSdkReleaseCommandOutput extends GetMobileSdkReleaseRes
 }
 /**
  * <p>Retrieves information for the specified mobile SDK release, including release notes and tags.</p>
- *          <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. </p>
+ *          <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
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListMobileSdkReleasesCommand.d.ts

@@ -8,7 +8,8 @@ export interface ListMobileSdkReleasesCommandOutput extends ListMobileSdkRelease
 }
 /**
  * <p>Retrieves a list of the available releases for the mobile SDK and the specified device platform. </p>
- *          <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. </p>
+ *          <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
+ * <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>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PutLoggingConfigurationCommand.d.ts

@@ -8,8 +8,11 @@ export interface PutLoggingConfigurationCommandOutput extends PutLoggingConfigur
 }
 /**
  * <p>Enables the specified <a>LoggingConfiguration</a>, to start logging from a
- *          web ACL, according to the configuration provided.</p>
- *          <p>You can access information about all traffic that WAF inspects using the following
+ *          web ACL, according to the configuration provided. </p>
+ *          <note>
+ *             <p>You can define one logging destination per web ACL.</p>
+ *          </note>
+ *          <p>You can access information about the traffic that WAF inspects using the following
  *          steps:</p>
  *          <ol>
  *             <li>
@@ -27,6 +30,9 @@ export interface PutLoggingConfigurationCommandOutput extends PutLoggingConfigur
  *           request, WAF creates an additional role or policy that is required to write
  *               logs to the logging destination. For an Amazon CloudWatch Logs log group, WAF creates a resource policy on the log group.
  *           For an Amazon S3 bucket, WAF creates a bucket policy. For an Amazon Kinesis Data Firehose, WAF creates a service-linked role.</p>
+ *          <p>For additional information about web ACL logging, see
+ *            <a href="https://docs.aws.amazon.com/waf/latest/developerguide/logging.html">Logging web ACL traffic information</a>
+ *                in the <i>WAF Developer Guide</i>.</p>
  *          <note>
  *             <p>This operation completely replaces the mutable specifications that you already have for the logging configuration with the ones that you provide to this call. To modify the logging configuration, retrieve it by calling <a>GetLoggingConfiguration</a>, update the settings as needed, and then provide the complete logging configuration specification to this call.</p>
  *          </note>

package/dist-types/index.d.ts

@@ -2,3 +2,4 @@ export * from "./WAFV2";
 export * from "./WAFV2Client";
 export * from "./commands";
 export * from "./models";
+export { WAFV2ServiceException } from "./models/WAFV2ServiceException";

package/dist-types/models/WAFV2ServiceException.d.ts

@@ -0,0 +1,10 @@
+import { ServiceException as __ServiceException, ServiceExceptionOptions as __ServiceExceptionOptions } from "@aws-sdk/smithy-client";
+/**
+ * Base exception class for all service exceptions from WAFV2 service.
+ */
+export declare class WAFV2ServiceException extends __ServiceException {
+    /**
+     * @internal
+     */
+    constructor(options: __ServiceExceptionOptions);
+}

package/dist-types/models/models_0.d.ts

@@ -1,4 +1,5 @@
-import { MetadataBearer as $MetadataBearer, SmithyException as __SmithyException } from "@aws-sdk/types";
+import { ExceptionOptionType as __ExceptionOptionType } from "@aws-sdk/smithy-client";
+import { WAFV2ServiceException as __BaseException } from "./WAFV2ServiceException";
 export declare enum ActionValue {
     ALLOW = "ALLOW",
     BLOCK = "BLOCK",
@@ -1241,7 +1242,7 @@ export declare namespace UsernameField {
  */
 export interface ManagedRuleGroupConfig {
     /**
-     * <p>The login endpoint for your application. For example <code>https://example.com/web/login</code>.</p>
+     * <p>The path of the login endpoint for your application. For example, for the URL <code>https://example.com/web/login</code>, you would provide the path <code>/web/login</code>.</p>
      */
     LoginPath?: string;
     /**
@@ -1475,18 +1476,26 @@ export declare namespace AssociateWebACLResponse {
  * <p>Your request is valid, but WAF couldn’t perform the operation because of a system
  *          problem. Retry your request. </p>
  */
-export interface WAFInternalErrorException extends __SmithyException, $MetadataBearer {
-    name: "WAFInternalErrorException";
-    $fault: "server";
+export declare class WAFInternalErrorException extends __BaseException {
+    readonly name: "WAFInternalErrorException";
+    readonly $fault: "server";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFInternalErrorException, __BaseException>);
 }
 /**
  * <p>The operation isn't valid. </p>
  */
-export interface WAFInvalidOperationException extends __SmithyException, $MetadataBearer {
-    name: "WAFInvalidOperationException";
-    $fault: "client";
+export declare class WAFInvalidOperationException extends __BaseException {
+    readonly name: "WAFInvalidOperationException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFInvalidOperationException, __BaseException>);
 }
 export declare enum ParameterExceptionField {
     AND_STATEMENT = "AND_STATEMENT",
@@ -1569,10 +1578,9 @@ export declare enum ParameterExceptionField {
  *             </li>
  *          </ul>
  */
-export interface WAFInvalidParameterException extends __SmithyException, $MetadataBearer {
-    name: "WAFInvalidParameterException";
-    $fault: "client";
-    message?: string;
+export declare class WAFInvalidParameterException extends __BaseException {
+    readonly name: "WAFInvalidParameterException";
+    readonly $fault: "client";
     /**
      * <p>The settings where the invalid parameter was found. </p>
      */
@@ -1585,22 +1593,34 @@ export interface WAFInvalidParameterException extends __SmithyException, $Metada
      * <p>Additional information about the exception.</p>
      */
     Reason?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFInvalidParameterException, __BaseException>);
 }
 /**
  * <p>WAF couldn’t perform the operation because your resource doesn’t exist. </p>
  */
-export interface WAFNonexistentItemException extends __SmithyException, $MetadataBearer {
-    name: "WAFNonexistentItemException";
-    $fault: "client";
+export declare class WAFNonexistentItemException extends __BaseException {
+    readonly name: "WAFNonexistentItemException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFNonexistentItemException, __BaseException>);
 }
 /**
  * <p>WAF couldn’t retrieve the resource that you requested. Retry your request.</p>
  */
-export interface WAFUnavailableEntityException extends __SmithyException, $MetadataBearer {
-    name: "WAFUnavailableEntityException";
-    $fault: "client";
+export declare class WAFUnavailableEntityException extends __BaseException {
+    readonly name: "WAFUnavailableEntityException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFUnavailableEntityException, __BaseException>);
 }
 /**
  * <p>A custom response to send to the client. You can define a custom response for rule
@@ -1888,19 +1908,27 @@ export declare namespace CheckCapacityResponse {
  *          expired. You can retrieve the available versions for the managed rule group by calling
  *             <a>ListAvailableManagedRuleGroupVersions</a>.</p>
  */
-export interface WAFExpiredManagedRuleGroupVersionException extends __SmithyException, $MetadataBearer {
-    name: "WAFExpiredManagedRuleGroupVersionException";
-    $fault: "client";
+export declare class WAFExpiredManagedRuleGroupVersionException extends __BaseException {
+    readonly name: "WAFExpiredManagedRuleGroupVersionException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFExpiredManagedRuleGroupVersionException, __BaseException>);
 }
 /**
  * <p>WAF couldn’t perform the operation because the resource that you requested isn’t
  *          valid. Check the resource, and try again.</p>
  */
-export interface WAFInvalidResourceException extends __SmithyException, $MetadataBearer {
-    name: "WAFInvalidResourceException";
-    $fault: "client";
+export declare class WAFInvalidResourceException extends __BaseException {
+    readonly name: "WAFInvalidResourceException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFInvalidResourceException, __BaseException>);
 }
 /**
  * <p>WAF couldn’t perform the operation because you exceeded your resource limit. For
@@ -1908,19 +1936,27 @@ export interface WAFInvalidResourceException extends __SmithyException, $Metadat
  *          account. For more information, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/limits.html">WAF quotas</a> in the
  *             <i>WAF Developer Guide</i>.</p>
  */
-export interface WAFLimitsExceededException extends __SmithyException, $MetadataBearer {
-    name: "WAFLimitsExceededException";
-    $fault: "client";
+export declare class WAFLimitsExceededException extends __BaseException {
+    readonly name: "WAFLimitsExceededException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFLimitsExceededException, __BaseException>);
 }
 /**
  * <p>You tried to use a managed rule group that's available by subscription, but you aren't
  *          subscribed to it yet. </p>
  */
-export interface WAFSubscriptionNotFoundException extends __SmithyException, $MetadataBearer {
-    name: "WAFSubscriptionNotFoundException";
-    $fault: "client";
+export declare class WAFSubscriptionNotFoundException extends __BaseException {
+    readonly name: "WAFSubscriptionNotFoundException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFSubscriptionNotFoundException, __BaseException>);
 }
 export declare enum IPAddressVersion {
     IPV4 = "IPV4",
@@ -1984,8 +2020,8 @@ export interface CreateIPSetRequest {
      */
     IPAddressVersion: IPAddressVersion | string | undefined;
     /**
-     * <p>Contains an array of strings that specify one or more IP addresses or blocks of IP addresses in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. </p>
-     *          <p>Examples: </p>
+     * <p>Contains an array of strings that specifies zero or more IP addresses or blocks of IP addresses in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. </p>
+     *          <p>Example address strings: </p>
      *          <ul>
      *             <li>
      *                <p>To configure WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify <code>192.0.2.44/32</code>.</p>
@@ -2002,6 +2038,24 @@ export interface CreateIPSetRequest {
      *             </li>
      *          </ul>
      *          <p>For more information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless Inter-Domain Routing</a>.</p>
+     *          <p>Example JSON <code>Addresses</code> specifications: </p>
+     *          <ul>
+     *             <li>
+     *                <p>Empty array: <code>"Addresses": []</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>Array with one address: <code>"Addresses": ["192.0.2.44/32"]</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>Array with three addresses: <code>"Addresses": ["192.0.2.44/32", "192.0.2.0/24", "192.0.0.0/16"]</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>INVALID specification: <code>"Addresses": [""]</code> INVALID </p>
+     *             </li>
+     *          </ul>
      */
     Addresses: string[] | undefined;
     /**
@@ -2062,37 +2116,53 @@ export declare namespace CreateIPSetResponse {
  * <p>WAF couldn’t perform the operation because the resource that you tried to save is
  *          a duplicate of an existing one.</p>
  */
-export interface WAFDuplicateItemException extends __SmithyException, $MetadataBearer {
-    name: "WAFDuplicateItemException";
-    $fault: "client";
+export declare class WAFDuplicateItemException extends __BaseException {
+    readonly name: "WAFDuplicateItemException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFDuplicateItemException, __BaseException>);
 }
 /**
  * <p>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. </p>
  */
-export interface WAFOptimisticLockException extends __SmithyException, $MetadataBearer {
-    name: "WAFOptimisticLockException";
-    $fault: "client";
+export declare class WAFOptimisticLockException extends __BaseException {
+    readonly name: "WAFOptimisticLockException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFOptimisticLockException, __BaseException>);
 }
 /**
  * <p>An error occurred during the tagging operation. Retry your request.</p>
  */
-export interface WAFTagOperationException extends __SmithyException, $MetadataBearer {
-    name: "WAFTagOperationException";
-    $fault: "client";
+export declare class WAFTagOperationException extends __BaseException {
+    readonly name: "WAFTagOperationException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFTagOperationException, __BaseException>);
 }
 /**
  * <p>WAF couldn’t perform your tagging operation because of an internal error. Retry
  *          your request.</p>
  */
-export interface WAFTagOperationInternalErrorException extends __SmithyException, $MetadataBearer {
-    name: "WAFTagOperationInternalErrorException";
-    $fault: "server";
+export declare class WAFTagOperationInternalErrorException extends __BaseException {
+    readonly name: "WAFTagOperationInternalErrorException";
+    readonly $fault: "server";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFTagOperationInternalErrorException, __BaseException>);
 }
 /**
  * <p>A single regular expression. This is used in a <a>RegexPatternSet</a>.</p>
@@ -2400,10 +2470,14 @@ export declare namespace DeleteIPSetResponse {
  * <p>WAF couldn’t perform the operation because your resource is being used by another
  *          resource or it’s associated with another resource. </p>
  */
-export interface WAFAssociatedItemException extends __SmithyException, $MetadataBearer {
-    name: "WAFAssociatedItemException";
-    $fault: "client";
+export declare class WAFAssociatedItemException extends __BaseException {
+    readonly name: "WAFAssociatedItemException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFAssociatedItemException, __BaseException>);
 }
 export interface DeleteLoggingConfigurationRequest {
     /**
@@ -2813,7 +2887,7 @@ export declare namespace GetIPSetRequest {
     const filterSensitiveLog: (obj: GetIPSetRequest) => any;
 }
 /**
- * <p>Contains one or more IP addresses or blocks of IP addresses specified in Classless
+ * <p>Contains zero or more IP addresses or blocks of IP addresses specified in Classless
  *          Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges
  *          except for /0. For information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless
  *             Inter-Domain Routing</a>. </p>
@@ -2842,8 +2916,8 @@ export interface IPSet {
      */
     IPAddressVersion: IPAddressVersion | string | undefined;
     /**
-     * <p>Contains an array of strings that specify one or more IP addresses or blocks of IP addresses in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. </p>
-     *          <p>Examples: </p>
+     * <p>Contains an array of strings that specifies zero or more IP addresses or blocks of IP addresses in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. </p>
+     *          <p>Example address strings: </p>
      *          <ul>
      *             <li>
      *                <p>To configure WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify <code>192.0.2.44/32</code>.</p>
@@ -2860,6 +2934,24 @@ export interface IPSet {
      *             </li>
      *          </ul>
      *          <p>For more information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless Inter-Domain Routing</a>.</p>
+     *          <p>Example JSON <code>Addresses</code> specifications: </p>
+     *          <ul>
+     *             <li>
+     *                <p>Empty array: <code>"Addresses": []</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>Array with one address: <code>"Addresses": ["192.0.2.44/32"]</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>Array with three addresses: <code>"Addresses": ["192.0.2.44/32", "192.0.2.0/24", "192.0.0.0/16"]</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>INVALID specification: <code>"Addresses": [""]</code> INVALID </p>
+     *             </li>
+     *          </ul>
      */
     Addresses: string[] | undefined;
 }
@@ -2994,7 +3086,28 @@ export declare namespace LoggingFilter {
  *          resource, for logging from WAF. As part of the association, you can specify parts of
  *          the standard logging fields to keep out of the logs and you can specify filters so that you
  *          log only a subset of the logging records. </p>
- *          <p>For information about configuring web ACL logging destinations, see
+ *          <note>
+ *             <p>You can define one logging destination per web ACL.</p>
+ *          </note>
+ *          <p>You can access information about the traffic that WAF inspects using the following
+ *          steps:</p>
+ *          <ol>
+ *             <li>
+ *                <p>Create your logging destination. You can use an Amazon CloudWatch Logs log group, an Amazon Simple Storage Service (Amazon S3) bucket, or an Amazon Kinesis Data Firehose.
+ *                  For information about configuring logging destinations and the permissions that are required for each, see
+ *                  <a href="https://docs.aws.amazon.com/waf/latest/developerguide/logging.html">Logging web ACL traffic information</a>
+ *                  in the <i>WAF Developer Guide</i>.</p>
+ *             </li>
+ *             <li>
+ *                <p>Associate your logging destination to your web ACL using a
+ *                   <code>PutLoggingConfiguration</code> request.</p>
+ *             </li>
+ *          </ol>
+ *          <p>When you successfully enable logging using a <code>PutLoggingConfiguration</code>
+ *           request, WAF creates an additional role or policy that is required to write
+ *               logs to the logging destination. For an Amazon CloudWatch Logs log group, WAF creates a resource policy on the log group.
+ *           For an Amazon S3 bucket, WAF creates a bucket policy. For an Amazon Kinesis Data Firehose, WAF creates a service-linked role.</p>
+ *          <p>For additional information about web ACL logging, see
  *            <a href="https://docs.aws.amazon.com/waf/latest/developerguide/logging.html">Logging web ACL traffic information</a>
  *                in the <i>WAF Developer Guide</i>.</p>
  */
@@ -3005,8 +3118,11 @@ export interface LoggingConfiguration {
      */
     ResourceArn: string | undefined;
     /**
-     * <p>The Amazon Resource Names (ARNs) of the logging destinations that you want to associate
+     * <p>The logging destination configuration that you want to associate
      *          with the web ACL.</p>
+     *          <note>
+     *             <p>You can associate one logging destination to a web ACL.</p>
+     *          </note>
      */
     LogDestinationConfigs: string[] | undefined;
     /**
@@ -3225,7 +3341,8 @@ export declare namespace GetMobileSdkReleaseRequest {
 }
 /**
  * <p>Information for a release of the mobile SDK, including release notes and tags.</p>
- *          <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. </p>
+ *          <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
+ * <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>
  */
 export interface MobileSdkRelease {
     /**
@@ -4506,10 +4623,14 @@ export declare namespace PutLoggingConfigurationResponse {
  *            <a href="https://docs.aws.amazon.com/waf/latest/developerguide/logging.html">Logging web ACL traffic information</a>
  *                in the <i>WAF Developer Guide</i>.</p>
  */
-export interface WAFLogDestinationPermissionIssueException extends __SmithyException, $MetadataBearer {
-    name: "WAFLogDestinationPermissionIssueException";
-    $fault: "client";
+export declare class WAFLogDestinationPermissionIssueException extends __BaseException {
+    readonly name: "WAFLogDestinationPermissionIssueException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFLogDestinationPermissionIssueException, __BaseException>);
 }
 /**
  * <p>WAF is not able to access the service linked role. This can be caused by a
@@ -4521,10 +4642,13 @@ export interface WAFLogDestinationPermissionIssueException extends __SmithyExcep
  *          again. If you receive this same exception again, you will have to wait additional time
  *          until the role is unlocked.</p>
  */
-export interface WAFServiceLinkedRoleErrorException extends __SmithyException, $MetadataBearer {
-    name: "WAFServiceLinkedRoleErrorException";
-    $fault: "client";
-    message?: string;
+export declare class WAFServiceLinkedRoleErrorException extends __BaseException {
+    readonly name: "WAFServiceLinkedRoleErrorException";
+    readonly $fault: "client";
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFServiceLinkedRoleErrorException, __BaseException>);
 }
 /**
  * <p>A version of the named managed rule group, that the rule group's vendor publishes for
@@ -4682,10 +4806,14 @@ export declare namespace PutPermissionPolicyResponse {
  *          </ul>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html">IAM Policies</a>.  </p>
  */
-export interface WAFInvalidPermissionPolicyException extends __SmithyException, $MetadataBearer {
-    name: "WAFInvalidPermissionPolicyException";
-    $fault: "client";
+export declare class WAFInvalidPermissionPolicyException extends __BaseException {
+    readonly name: "WAFInvalidPermissionPolicyException";
+    readonly $fault: "client";
     Message?: string;
+    /**
+     * @internal
+     */
+    constructor(opts: __ExceptionOptionType<WAFInvalidPermissionPolicyException, __BaseException>);
 }
 export interface TagResourceRequest {
     /**
@@ -4762,8 +4890,8 @@ export interface UpdateIPSetRequest {
      */
     Description?: string;
     /**
-     * <p>Contains an array of strings that specify one or more IP addresses or blocks of IP addresses in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. </p>
-     *          <p>Examples: </p>
+     * <p>Contains an array of strings that specifies zero or more IP addresses or blocks of IP addresses in Classless Inter-Domain Routing (CIDR) notation. WAF supports all IPv4 and IPv6 CIDR ranges except for /0. </p>
+     *          <p>Example address strings: </p>
      *          <ul>
      *             <li>
      *                <p>To configure WAF to allow, block, or count requests that originated from the IP address 192.0.2.44, specify <code>192.0.2.44/32</code>.</p>
@@ -4780,6 +4908,24 @@ export interface UpdateIPSetRequest {
      *             </li>
      *          </ul>
      *          <p>For more information about CIDR notation, see the Wikipedia entry <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">Classless Inter-Domain Routing</a>.</p>
+     *          <p>Example JSON <code>Addresses</code> specifications: </p>
+     *          <ul>
+     *             <li>
+     *                <p>Empty array: <code>"Addresses": []</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>Array with one address: <code>"Addresses": ["192.0.2.44/32"]</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>Array with three addresses: <code>"Addresses": ["192.0.2.44/32", "192.0.2.0/24", "192.0.0.0/16"]</code>
+     *                </p>
+     *             </li>
+     *             <li>
+     *                <p>INVALID specification: <code>"Addresses": [""]</code> INVALID </p>
+     *             </li>
+     *          </ul>
      */
     Addresses: string[] | undefined;
     /**
@@ -5878,7 +6024,7 @@ export interface GetWebACLResponse {
      */
     LockToken?: string;
     /**
-     * <p>The URL to use in SDK integrations with Amazon Web Services managed rule groups. For example, you can use the integration SDKs with the account takeover prevention managed rule group <code>AWSManagedRulesATPRuleSet</code>. This is only populated if you are using a rule group in your web ACL that integrates with your applications in this way. For more information, see <a href="https://docs.aws.amazon.com/waf/latest/developerguide/waf-application-integration.html">WAF application integration</a> in the <i>WAF Developer Guide</i>.</p>
+     * <p>The URL to use in SDK integrations with Amazon Web Services managed rule groups. For example, you can use the integration SDKs with the account takeover prevention managed rule group <code>AWSManagedRulesATPRuleSet</code>. This is only populated if you are using a rule group in your web ACL that integrates with your applications in this way. For more information, see <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>
      */
     ApplicationIntegrationURL?: string;
 }

package/dist-types/ts3.4/index.d.ts

@@ -2,3 +2,4 @@ export * from "./WAFV2";
 export * from "./WAFV2Client";
 export * from "./commands";
 export * from "./models";
+export { WAFV2ServiceException } from "./models/WAFV2ServiceException";

package/dist-types/ts3.4/models/WAFV2ServiceException.d.ts

@@ -0,0 +1,6 @@
+import { ServiceException as __ServiceException, ServiceExceptionOptions as __ServiceExceptionOptions } from "@aws-sdk/smithy-client";
+
+export declare class WAFV2ServiceException extends __ServiceException {
+    
+    constructor(options: __ServiceExceptionOptions);
+}