libZSservicesZSamazonka-wafZSamazonka-waf
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.WAF.GetSampledRequests

Description

This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide.

For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use.

Gets detailed information about a specified number of requests--a sample--that AWS WAF randomly selects from among the first 5,000 requests that your AWS resource received during a time range that you choose. You can specify a sample size of up to 500 requests, and you can specify any time range in the previous three hours.

GetSampledRequests returns a time range, which is usually the time range that you specified. However, if your resource (such as a CloudFront distribution) received 5,000 requests before the specified time range elapsed, GetSampledRequests returns an updated time range. This new time range indicates the actual period during which AWS WAF selected the requests in the sample.

Synopsis

Creating a Request

data GetSampledRequests Source #

See: newGetSampledRequests smart constructor.

Constructors

GetSampledRequests' 

Fields

  • webAclId :: Text

    The WebACLId of the WebACL for which you want GetSampledRequests to return a sample of requests.

  • ruleId :: Text

    RuleId is one of three values:

    • The RuleId of the Rule or the RuleGroupId of the RuleGroup for which you want GetSampledRequests to return a sample of requests.
    • Default_Action, which causes GetSampledRequests to return a sample of the requests that didn't match any of the rules in the specified WebACL.
  • timeWindow :: TimeWindow

    The start date and time and the end date and time of the range for which you want GetSampledRequests to return a sample of requests. You must specify the times in Coordinated Universal Time (UTC) format. UTC format includes the special designator, Z. For example, "2016-09-27T14:50Z". You can specify any time range in the previous three hours.

  • maxItems :: Natural

    The number of requests that you want AWS WAF to return from among the first 5,000 requests that your AWS resource received during the time range. If your resource received fewer requests than the value of MaxItems, GetSampledRequests returns information about all of them.

Instances

Instances details
Eq GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Read GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Show GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Generic GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Associated Types

type Rep GetSampledRequests :: Type -> Type #

NFData GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Methods

rnf :: GetSampledRequests -> () #

Hashable GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

ToJSON GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

AWSRequest GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Associated Types

type AWSResponse GetSampledRequests #

ToHeaders GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

ToPath GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

ToQuery GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

type Rep GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

type Rep GetSampledRequests = D1 ('MetaData "GetSampledRequests" "Amazonka.WAF.GetSampledRequests" "libZSservicesZSamazonka-wafZSamazonka-waf" 'False) (C1 ('MetaCons "GetSampledRequests'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "webAclId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "ruleId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :*: (S1 ('MetaSel ('Just "timeWindow") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 TimeWindow) :*: S1 ('MetaSel ('Just "maxItems") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Natural))))
type AWSResponse GetSampledRequests Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

newGetSampledRequests Source #

Create a value of GetSampledRequests with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:webAclId:GetSampledRequests', getSampledRequests_webAclId - The WebACLId of the WebACL for which you want GetSampledRequests to return a sample of requests.

$sel:ruleId:GetSampledRequests', getSampledRequests_ruleId - RuleId is one of three values:

  • The RuleId of the Rule or the RuleGroupId of the RuleGroup for which you want GetSampledRequests to return a sample of requests.
  • Default_Action, which causes GetSampledRequests to return a sample of the requests that didn't match any of the rules in the specified WebACL.

$sel:timeWindow:GetSampledRequests', getSampledRequests_timeWindow - The start date and time and the end date and time of the range for which you want GetSampledRequests to return a sample of requests. You must specify the times in Coordinated Universal Time (UTC) format. UTC format includes the special designator, Z. For example, "2016-09-27T14:50Z". You can specify any time range in the previous three hours.

$sel:maxItems:GetSampledRequests', getSampledRequests_maxItems - The number of requests that you want AWS WAF to return from among the first 5,000 requests that your AWS resource received during the time range. If your resource received fewer requests than the value of MaxItems, GetSampledRequests returns information about all of them.

Request Lenses

getSampledRequests_webAclId :: Lens' GetSampledRequests Text Source #

The WebACLId of the WebACL for which you want GetSampledRequests to return a sample of requests.

getSampledRequests_ruleId :: Lens' GetSampledRequests Text Source #

RuleId is one of three values:

  • The RuleId of the Rule or the RuleGroupId of the RuleGroup for which you want GetSampledRequests to return a sample of requests.
  • Default_Action, which causes GetSampledRequests to return a sample of the requests that didn't match any of the rules in the specified WebACL.

getSampledRequests_timeWindow :: Lens' GetSampledRequests TimeWindow Source #

The start date and time and the end date and time of the range for which you want GetSampledRequests to return a sample of requests. You must specify the times in Coordinated Universal Time (UTC) format. UTC format includes the special designator, Z. For example, "2016-09-27T14:50Z". You can specify any time range in the previous three hours.

getSampledRequests_maxItems :: Lens' GetSampledRequests Natural Source #

The number of requests that you want AWS WAF to return from among the first 5,000 requests that your AWS resource received during the time range. If your resource received fewer requests than the value of MaxItems, GetSampledRequests returns information about all of them.

Destructuring the Response

data GetSampledRequestsResponse Source #

See: newGetSampledRequestsResponse smart constructor.

Constructors

GetSampledRequestsResponse' 

Fields

  • sampledRequests :: Maybe [SampledHTTPRequest]

    A complex type that contains detailed information about each of the requests in the sample.

  • populationSize :: Maybe Integer

    The total number of requests from which GetSampledRequests got a sample of MaxItems requests. If PopulationSize is less than MaxItems, the sample includes every request that your AWS resource received during the specified time range.

  • timeWindow :: Maybe TimeWindow

    Usually, TimeWindow is the time range that you specified in the GetSampledRequests request. However, if your AWS resource received more than 5,000 requests during the time range that you specified in the request, GetSampledRequests returns the time range for the first 5,000 requests. Times are in Coordinated Universal Time (UTC) format.

  • httpStatus :: Int

    The response's http status code.

Instances

Instances details
Eq GetSampledRequestsResponse Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Read GetSampledRequestsResponse Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Show GetSampledRequestsResponse Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Generic GetSampledRequestsResponse Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

Associated Types

type Rep GetSampledRequestsResponse :: Type -> Type #

NFData GetSampledRequestsResponse Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

type Rep GetSampledRequestsResponse Source # 
Instance details

Defined in Amazonka.WAF.GetSampledRequests

type Rep GetSampledRequestsResponse = D1 ('MetaData "GetSampledRequestsResponse" "Amazonka.WAF.GetSampledRequests" "libZSservicesZSamazonka-wafZSamazonka-waf" 'False) (C1 ('MetaCons "GetSampledRequestsResponse'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "sampledRequests") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [SampledHTTPRequest])) :*: S1 ('MetaSel ('Just "populationSize") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Integer))) :*: (S1 ('MetaSel ('Just "timeWindow") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe TimeWindow)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))

newGetSampledRequestsResponse Source #

Create a value of GetSampledRequestsResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:sampledRequests:GetSampledRequestsResponse', getSampledRequestsResponse_sampledRequests - A complex type that contains detailed information about each of the requests in the sample.

$sel:populationSize:GetSampledRequestsResponse', getSampledRequestsResponse_populationSize - The total number of requests from which GetSampledRequests got a sample of MaxItems requests. If PopulationSize is less than MaxItems, the sample includes every request that your AWS resource received during the specified time range.

$sel:timeWindow:GetSampledRequests', getSampledRequestsResponse_timeWindow - Usually, TimeWindow is the time range that you specified in the GetSampledRequests request. However, if your AWS resource received more than 5,000 requests during the time range that you specified in the request, GetSampledRequests returns the time range for the first 5,000 requests. Times are in Coordinated Universal Time (UTC) format.

$sel:httpStatus:GetSampledRequestsResponse', getSampledRequestsResponse_httpStatus - The response's http status code.

Response Lenses

getSampledRequestsResponse_sampledRequests :: Lens' GetSampledRequestsResponse (Maybe [SampledHTTPRequest]) Source #

A complex type that contains detailed information about each of the requests in the sample.

getSampledRequestsResponse_populationSize :: Lens' GetSampledRequestsResponse (Maybe Integer) Source #

The total number of requests from which GetSampledRequests got a sample of MaxItems requests. If PopulationSize is less than MaxItems, the sample includes every request that your AWS resource received during the specified time range.

getSampledRequestsResponse_timeWindow :: Lens' GetSampledRequestsResponse (Maybe TimeWindow) Source #

Usually, TimeWindow is the time range that you specified in the GetSampledRequests request. However, if your AWS resource received more than 5,000 requests during the time range that you specified in the request, GetSampledRequests returns the time range for the first 5,000 requests. Times are in Coordinated Universal Time (UTC) format.