NAME

Paws::WAFV2::CheckCapacity - Arguments for method CheckCapacity on Paws::WAFV2

DESCRIPTION

This class represents the parameters used for calling the method CheckCapacity on the AWS WAFV2 service. Use the attributes of this class as arguments to method CheckCapacity.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CheckCapacity.

SYNOPSIS

my $wafv2 = Paws->service('WAFV2');
my $CheckCapacityResponse = $wafv2->CheckCapacity(
  Rules => [
    {
      Name      => 'MyEntityName',    # min: 1, max: 128
      Priority  => 1,
      Statement => {
        AndStatement => {
          Statements => [ <Statement>, ... ],

        },                            # OPTIONAL
        ByteMatchStatement => {
          FieldToMatch => {
            AllQueryArguments => {

            },    # OPTIONAL
            Body => {

            },    # OPTIONAL
            JsonBody => {
              MatchPattern => {
                All => {

                },    # OPTIONAL
                IncludedPaths => [
                  'MyJsonPointerPath', ...    # min: 1, max: 512
                ],    # min: 1; OPTIONAL
              },
              MatchScope              => 'ALL',    # values: ALL, KEY, VALUE
              InvalidFallbackBehavior => 'MATCH'
              ,    # values: MATCH, NO_MATCH, EVALUATE_AS_STRING; OPTIONAL
            },    # OPTIONAL
            Method => {

            },    # OPTIONAL
            QueryString => {

            },    # OPTIONAL
            SingleHeader => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            SingleQueryArgument => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            UriPath => {

            },    # OPTIONAL
          },
          PositionalConstraint => 'EXACTLY'
          , # values: EXACTLY, STARTS_WITH, ENDS_WITH, CONTAINS, CONTAINS_WORD
          SearchString        => 'BlobSearchString',
          TextTransformations => [
            {
              Priority => 1,
              Type     => 'NONE'
              , # values: NONE, COMPRESS_WHITE_SPACE, HTML_ENTITY_DECODE, LOWERCASE, CMD_LINE, URL_DECODE, BASE64_DECODE, HEX_DECODE, MD5, REPLACE_COMMENTS, ESCAPE_SEQ_DECODE, SQL_HEX_DECODE, CSS_DECODE, JS_DECODE, NORMALIZE_PATH, NORMALIZE_PATH_WIN, REMOVE_NULLS, REPLACE_NULLS, BASE64_DECODE_EXT, URL_DECODE_UNI, UTF8_TO_UNICODE

            },
            ...
          ],    # min: 1

        },    # OPTIONAL
        GeoMatchStatement => {
          CountryCodes => [
            'AF',
            ... # 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
          ],    # min: 1; OPTIONAL
          ForwardedIPConfig => {
            FallbackBehavior => 'MATCH',    # values: MATCH, NO_MATCH
            HeaderName => 'MyForwardedIPHeaderName',    # min: 1, max: 255

          },    # OPTIONAL
        },    # OPTIONAL
        IPSetReferenceStatement => {
          ARN                    => 'MyResourceArn',    # min: 20, max: 2048
          IPSetForwardedIPConfig => {
            FallbackBehavior => 'MATCH',    # values: MATCH, NO_MATCH
            HeaderName => 'MyForwardedIPHeaderName',    # min: 1, max: 255
            Position   => 'FIRST',    # values: FIRST, LAST, ANY

          },    # OPTIONAL
        },    # OPTIONAL
        LabelMatchStatement => {
          Key   => 'MyLabelMatchKey',    # min: 1, max: 1024
          Scope => 'LABEL',              # values: LABEL, NAMESPACE

        },    # OPTIONAL
        ManagedRuleGroupStatement => {
          Name          => 'MyEntityName',    # min: 1, max: 128
          VendorName    => 'MyVendorName',    # min: 1, max: 128
          ExcludedRules => [
            {
              Name => 'MyEntityName',         # min: 1, max: 128

            },
            ...
          ],    # OPTIONAL
          ScopeDownStatement => <Statement>,
        },    # OPTIONAL
        NotStatement => {
          Statement => <Statement>,

        },    # OPTIONAL
        OrStatement => {
          Statements => [ <Statement>, ... ],

        },    # OPTIONAL
        RateBasedStatement => {
          AggregateKeyType  => 'IP',    # values: IP, FORWARDED_IP
          Limit             => 1,       # min: 100, max: 2000000000
          ForwardedIPConfig => {
            FallbackBehavior => 'MATCH',    # values: MATCH, NO_MATCH
            HeaderName => 'MyForwardedIPHeaderName',    # min: 1, max: 255

          },    # OPTIONAL
          ScopeDownStatement => <Statement>,
        },    # OPTIONAL
        RegexPatternSetReferenceStatement => {
          ARN          => 'MyResourceArn',    # min: 20, max: 2048
          FieldToMatch => {
            AllQueryArguments => {

            },                                # OPTIONAL
            Body => {

            },                                # OPTIONAL
            JsonBody => {
              MatchPattern => {
                All => {

                },    # OPTIONAL
                IncludedPaths => [
                  'MyJsonPointerPath', ...    # min: 1, max: 512
                ],    # min: 1; OPTIONAL
              },
              MatchScope              => 'ALL',    # values: ALL, KEY, VALUE
              InvalidFallbackBehavior => 'MATCH'
              ,    # values: MATCH, NO_MATCH, EVALUATE_AS_STRING; OPTIONAL
            },    # OPTIONAL
            Method => {

            },    # OPTIONAL
            QueryString => {

            },    # OPTIONAL
            SingleHeader => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            SingleQueryArgument => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            UriPath => {

            },    # OPTIONAL
          },
          TextTransformations => [
            {
              Priority => 1,
              Type     => 'NONE'
              , # values: NONE, COMPRESS_WHITE_SPACE, HTML_ENTITY_DECODE, LOWERCASE, CMD_LINE, URL_DECODE, BASE64_DECODE, HEX_DECODE, MD5, REPLACE_COMMENTS, ESCAPE_SEQ_DECODE, SQL_HEX_DECODE, CSS_DECODE, JS_DECODE, NORMALIZE_PATH, NORMALIZE_PATH_WIN, REMOVE_NULLS, REPLACE_NULLS, BASE64_DECODE_EXT, URL_DECODE_UNI, UTF8_TO_UNICODE

            },
            ...
          ],    # min: 1

        },    # OPTIONAL
        RuleGroupReferenceStatement => {
          ARN           => 'MyResourceArn',    # min: 20, max: 2048
          ExcludedRules => [
            {
              Name => 'MyEntityName',          # min: 1, max: 128

            },
            ...
          ],    # OPTIONAL
        },    # OPTIONAL
        SizeConstraintStatement => {
          ComparisonOperator => 'EQ',    # values: EQ, NE, LE, LT, GE, GT
          FieldToMatch       => {
            AllQueryArguments => {

            },                           # OPTIONAL
            Body => {

            },                           # OPTIONAL
            JsonBody => {
              MatchPattern => {
                All => {

                },    # OPTIONAL
                IncludedPaths => [
                  'MyJsonPointerPath', ...    # min: 1, max: 512
                ],    # min: 1; OPTIONAL
              },
              MatchScope              => 'ALL',    # values: ALL, KEY, VALUE
              InvalidFallbackBehavior => 'MATCH'
              ,    # values: MATCH, NO_MATCH, EVALUATE_AS_STRING; OPTIONAL
            },    # OPTIONAL
            Method => {

            },    # OPTIONAL
            QueryString => {

            },    # OPTIONAL
            SingleHeader => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            SingleQueryArgument => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            UriPath => {

            },    # OPTIONAL
          },
          Size                => 1,    # max: 21474836480
          TextTransformations => [
            {
              Priority => 1,
              Type     => 'NONE'
              , # values: NONE, COMPRESS_WHITE_SPACE, HTML_ENTITY_DECODE, LOWERCASE, CMD_LINE, URL_DECODE, BASE64_DECODE, HEX_DECODE, MD5, REPLACE_COMMENTS, ESCAPE_SEQ_DECODE, SQL_HEX_DECODE, CSS_DECODE, JS_DECODE, NORMALIZE_PATH, NORMALIZE_PATH_WIN, REMOVE_NULLS, REPLACE_NULLS, BASE64_DECODE_EXT, URL_DECODE_UNI, UTF8_TO_UNICODE

            },
            ...
          ],    # min: 1

        },    # OPTIONAL
        SqliMatchStatement => {
          FieldToMatch => {
            AllQueryArguments => {

            },    # OPTIONAL
            Body => {

            },    # OPTIONAL
            JsonBody => {
              MatchPattern => {
                All => {

                },    # OPTIONAL
                IncludedPaths => [
                  'MyJsonPointerPath', ...    # min: 1, max: 512
                ],    # min: 1; OPTIONAL
              },
              MatchScope              => 'ALL',    # values: ALL, KEY, VALUE
              InvalidFallbackBehavior => 'MATCH'
              ,    # values: MATCH, NO_MATCH, EVALUATE_AS_STRING; OPTIONAL
            },    # OPTIONAL
            Method => {

            },    # OPTIONAL
            QueryString => {

            },    # OPTIONAL
            SingleHeader => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            SingleQueryArgument => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            UriPath => {

            },    # OPTIONAL
          },
          TextTransformations => [
            {
              Priority => 1,
              Type     => 'NONE'
              , # values: NONE, COMPRESS_WHITE_SPACE, HTML_ENTITY_DECODE, LOWERCASE, CMD_LINE, URL_DECODE, BASE64_DECODE, HEX_DECODE, MD5, REPLACE_COMMENTS, ESCAPE_SEQ_DECODE, SQL_HEX_DECODE, CSS_DECODE, JS_DECODE, NORMALIZE_PATH, NORMALIZE_PATH_WIN, REMOVE_NULLS, REPLACE_NULLS, BASE64_DECODE_EXT, URL_DECODE_UNI, UTF8_TO_UNICODE

            },
            ...
          ],    # min: 1

        },    # OPTIONAL
        XssMatchStatement => {
          FieldToMatch => {
            AllQueryArguments => {

            },    # OPTIONAL
            Body => {

            },    # OPTIONAL
            JsonBody => {
              MatchPattern => {
                All => {

                },    # OPTIONAL
                IncludedPaths => [
                  'MyJsonPointerPath', ...    # min: 1, max: 512
                ],    # min: 1; OPTIONAL
              },
              MatchScope              => 'ALL',    # values: ALL, KEY, VALUE
              InvalidFallbackBehavior => 'MATCH'
              ,    # values: MATCH, NO_MATCH, EVALUATE_AS_STRING; OPTIONAL
            },    # OPTIONAL
            Method => {

            },    # OPTIONAL
            QueryString => {

            },    # OPTIONAL
            SingleHeader => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            SingleQueryArgument => {
              Name => 'MyFieldToMatchData',    # min: 1, max: 64

            },    # OPTIONAL
            UriPath => {

            },    # OPTIONAL
          },
          TextTransformations => [
            {
              Priority => 1,
              Type     => 'NONE'
              , # values: NONE, COMPRESS_WHITE_SPACE, HTML_ENTITY_DECODE, LOWERCASE, CMD_LINE, URL_DECODE, BASE64_DECODE, HEX_DECODE, MD5, REPLACE_COMMENTS, ESCAPE_SEQ_DECODE, SQL_HEX_DECODE, CSS_DECODE, JS_DECODE, NORMALIZE_PATH, NORMALIZE_PATH_WIN, REMOVE_NULLS, REPLACE_NULLS, BASE64_DECODE_EXT, URL_DECODE_UNI, UTF8_TO_UNICODE

            },
            ...
          ],    # min: 1

        },    # OPTIONAL
      },
      VisibilityConfig => {
        CloudWatchMetricsEnabled => 1,
        MetricName               => 'MyMetricName',    # min: 1, max: 255
        SampledRequestsEnabled   => 1,

      },
      Action => {
        Allow => {
          CustomRequestHandling => {
            InsertHeaders => [
              {
                Name  => 'MyCustomHTTPHeaderName',     # min: 1, max: 64
                Value => 'MyCustomHTTPHeaderValue',    # min: 1, max: 255

              },
              ...
            ],    # min: 1

          },    # OPTIONAL
        },    # OPTIONAL
        Block => {
          CustomResponse => {
            ResponseCode          => 1,                 # min: 200, max: 600
            CustomResponseBodyKey => 'MyEntityName',    # min: 1, max: 128
            ResponseHeaders       => [
              {
                Name  => 'MyCustomHTTPHeaderName',     # min: 1, max: 64
                Value => 'MyCustomHTTPHeaderValue',    # min: 1, max: 255

              },
              ...
            ],    # min: 1
          },    # OPTIONAL
        },    # OPTIONAL
        Count => {
          CustomRequestHandling => {
            InsertHeaders => [
              {
                Name  => 'MyCustomHTTPHeaderName',     # min: 1, max: 64
                Value => 'MyCustomHTTPHeaderValue',    # min: 1, max: 255

              },
              ...
            ],    # min: 1

          },    # OPTIONAL
        },    # OPTIONAL
      },    # OPTIONAL
      OverrideAction => {
        Count => {
          CustomRequestHandling => {
            InsertHeaders => [
              {
                Name  => 'MyCustomHTTPHeaderName',     # min: 1, max: 64
                Value => 'MyCustomHTTPHeaderValue',    # min: 1, max: 255

              },
              ...
            ],    # min: 1

          },    # OPTIONAL
        },    # OPTIONAL
        None => {

        },    # OPTIONAL
      },    # OPTIONAL
      RuleLabels => [
        {
          Name => 'MyLabelName',    # min: 1, max: 1024

        },
        ...
      ],    # OPTIONAL
    },
    ...
  ],
  Scope => 'CLOUDFRONT',

);

# Results:
my $Capacity = $CheckCapacityResponse->Capacity;

# Returns a L<Paws::WAFV2::CheckCapacityResponse> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/wafv2/CheckCapacity

ATTRIBUTES

REQUIRED Rules => ArrayRef[Paws::WAFV2::Rule]

An array of Rule that you're configuring to use in a rule group or web ACL.

REQUIRED Scope => Str

Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, or an AppSync GraphQL API.

To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows:

  • CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1.

  • API and SDKs - For all calls, use the Region endpoint us-east-1.

Valid values are: "CLOUDFRONT", "REGIONAL"

SEE ALSO

This class forms part of Paws, documenting arguments for method CheckCapacity in Paws::WAFV2

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues