Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Enables the specified LoggingConfiguration, to start logging from a web ACL, according to the configuration provided.
You can define one logging destination per web ACL.
You can access information about the traffic that WAF inspects using the following steps:
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.
The name that you give the destination must start with
aws-waf-logs-
. Depending on the type of destination, you might need to configure additional settings or permissions.For configuration requirements and pricing information for each destination type, see Logging web ACL traffic in the WAF Developer Guide.
- Associate your logging destination to your web ACL using a
PutLoggingConfiguration
request.
When you successfully enable logging using a PutLoggingConfiguration
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.
For additional information about web ACL logging, see Logging web ACL traffic information in the WAF Developer Guide.
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 GetLoggingConfiguration, update the settings as needed, and then provide the complete logging configuration specification to this call.
Synopsis
- data PutLoggingConfiguration = PutLoggingConfiguration' {}
- newPutLoggingConfiguration :: LoggingConfiguration -> PutLoggingConfiguration
- putLoggingConfiguration_loggingConfiguration :: Lens' PutLoggingConfiguration LoggingConfiguration
- data PutLoggingConfigurationResponse = PutLoggingConfigurationResponse' {}
- newPutLoggingConfigurationResponse :: Int -> PutLoggingConfigurationResponse
- putLoggingConfigurationResponse_loggingConfiguration :: Lens' PutLoggingConfigurationResponse (Maybe LoggingConfiguration)
- putLoggingConfigurationResponse_httpStatus :: Lens' PutLoggingConfigurationResponse Int
Creating a Request
data PutLoggingConfiguration Source #
See: newPutLoggingConfiguration
smart constructor.
Instances
newPutLoggingConfiguration Source #
Create a value of PutLoggingConfiguration
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:
PutLoggingConfiguration
, putLoggingConfiguration_loggingConfiguration
-
Request Lenses
putLoggingConfiguration_loggingConfiguration :: Lens' PutLoggingConfiguration LoggingConfiguration Source #
Destructuring the Response
data PutLoggingConfigurationResponse Source #
See: newPutLoggingConfigurationResponse
smart constructor.
PutLoggingConfigurationResponse' | |
|
Instances
Generic PutLoggingConfigurationResponse Source # | |
Read PutLoggingConfigurationResponse Source # | |
Show PutLoggingConfigurationResponse Source # | |
Defined in Amazonka.WAFV2.PutLoggingConfiguration | |
NFData PutLoggingConfigurationResponse Source # | |
Defined in Amazonka.WAFV2.PutLoggingConfiguration rnf :: PutLoggingConfigurationResponse -> () # | |
Eq PutLoggingConfigurationResponse Source # | |
type Rep PutLoggingConfigurationResponse Source # | |
Defined in Amazonka.WAFV2.PutLoggingConfiguration type Rep PutLoggingConfigurationResponse = D1 ('MetaData "PutLoggingConfigurationResponse" "Amazonka.WAFV2.PutLoggingConfiguration" "amazonka-wafv2-2.0-3v3WgpYn7RT5hSd6MsT5dN" 'False) (C1 ('MetaCons "PutLoggingConfigurationResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "loggingConfiguration") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LoggingConfiguration)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))) |
newPutLoggingConfigurationResponse Source #
Create a value of PutLoggingConfigurationResponse
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:
PutLoggingConfiguration
, putLoggingConfigurationResponse_loggingConfiguration
-
$sel:httpStatus:PutLoggingConfigurationResponse'
, putLoggingConfigurationResponse_httpStatus
- The response's http status code.
Response Lenses
putLoggingConfigurationResponse_loggingConfiguration :: Lens' PutLoggingConfigurationResponse (Maybe LoggingConfiguration) Source #
putLoggingConfigurationResponse_httpStatus :: Lens' PutLoggingConfigurationResponse Int Source #
The response's http status code.