We recommend new projects start with resources from the AWS provider.
AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
aws-native.wafv2.getLoggingConfiguration
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi
A WAFv2 Logging Configuration Resource Provider
Using getLoggingConfiguration
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getLoggingConfiguration(args: GetLoggingConfigurationArgs, opts?: InvokeOptions): Promise<GetLoggingConfigurationResult>
function getLoggingConfigurationOutput(args: GetLoggingConfigurationOutputArgs, opts?: InvokeOptions): Output<GetLoggingConfigurationResult>
def get_logging_configuration(resource_arn: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetLoggingConfigurationResult
def get_logging_configuration_output(resource_arn: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetLoggingConfigurationResult]
func LookupLoggingConfiguration(ctx *Context, args *LookupLoggingConfigurationArgs, opts ...InvokeOption) (*LookupLoggingConfigurationResult, error)
func LookupLoggingConfigurationOutput(ctx *Context, args *LookupLoggingConfigurationOutputArgs, opts ...InvokeOption) LookupLoggingConfigurationResultOutput
> Note: This function is named LookupLoggingConfiguration
in the Go SDK.
public static class GetLoggingConfiguration
{
public static Task<GetLoggingConfigurationResult> InvokeAsync(GetLoggingConfigurationArgs args, InvokeOptions? opts = null)
public static Output<GetLoggingConfigurationResult> Invoke(GetLoggingConfigurationInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetLoggingConfigurationResult> getLoggingConfiguration(GetLoggingConfigurationArgs args, InvokeOptions options)
public static Output<GetLoggingConfigurationResult> getLoggingConfiguration(GetLoggingConfigurationArgs args, InvokeOptions options)
fn::invoke:
function: aws-native:wafv2:getLoggingConfiguration
arguments:
# arguments dictionary
The following arguments are supported:
- Resource
Arn This property is required. string - The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
- Resource
Arn This property is required. string - The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
- resource
Arn This property is required. String - The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
- resource
Arn This property is required. string - The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
- resource_
arn This property is required. str - The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
- resource
Arn This property is required. String - The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
getLoggingConfiguration Result
The following output properties are available:
- Log
Destination List<string>Configs - The Amazon Resource Names (ARNs) of the logging destinations that you want to associate with the web ACL.
- Logging
Filter Pulumi.Aws Native. Wa Fv2. Outputs. Logging Filter Properties - Filtering that specifies which web requests are kept in the logs and which are dropped. You can filter on the rule action and on the web request labels that were applied by matching rules during web ACL evaluation.
- Managed
By boolFirewall Manager - Indicates whether the logging configuration was created by AWS Firewall Manager, as part of an AWS WAF policy configuration. If true, only Firewall Manager can modify or delete the configuration.
- Redacted
Fields List<Pulumi.Aws Native. Wa Fv2. Outputs. Logging Configuration Field To Match> - The parts of the request that you want to keep out of the logs. For example, if you redact the HEADER field, the HEADER field in the firehose will be xxx.
- Log
Destination []stringConfigs - The Amazon Resource Names (ARNs) of the logging destinations that you want to associate with the web ACL.
- Logging
Filter LoggingFilter Properties - Filtering that specifies which web requests are kept in the logs and which are dropped. You can filter on the rule action and on the web request labels that were applied by matching rules during web ACL evaluation.
- Managed
By boolFirewall Manager - Indicates whether the logging configuration was created by AWS Firewall Manager, as part of an AWS WAF policy configuration. If true, only Firewall Manager can modify or delete the configuration.
- Redacted
Fields []LoggingConfiguration Field To Match - The parts of the request that you want to keep out of the logs. For example, if you redact the HEADER field, the HEADER field in the firehose will be xxx.
- log
Destination List<String>Configs - The Amazon Resource Names (ARNs) of the logging destinations that you want to associate with the web ACL.
- logging
Filter LoggingFilter Properties - Filtering that specifies which web requests are kept in the logs and which are dropped. You can filter on the rule action and on the web request labels that were applied by matching rules during web ACL evaluation.
- managed
By BooleanFirewall Manager - Indicates whether the logging configuration was created by AWS Firewall Manager, as part of an AWS WAF policy configuration. If true, only Firewall Manager can modify or delete the configuration.
- redacted
Fields List<LoggingConfiguration Field To Match> - The parts of the request that you want to keep out of the logs. For example, if you redact the HEADER field, the HEADER field in the firehose will be xxx.
- log
Destination string[]Configs - The Amazon Resource Names (ARNs) of the logging destinations that you want to associate with the web ACL.
- logging
Filter LoggingFilter Properties - Filtering that specifies which web requests are kept in the logs and which are dropped. You can filter on the rule action and on the web request labels that were applied by matching rules during web ACL evaluation.
- managed
By booleanFirewall Manager - Indicates whether the logging configuration was created by AWS Firewall Manager, as part of an AWS WAF policy configuration. If true, only Firewall Manager can modify or delete the configuration.
- redacted
Fields LoggingConfiguration Field To Match[] - The parts of the request that you want to keep out of the logs. For example, if you redact the HEADER field, the HEADER field in the firehose will be xxx.
- log_
destination_ Sequence[str]configs - The Amazon Resource Names (ARNs) of the logging destinations that you want to associate with the web ACL.
- logging_
filter LoggingFilter Properties - Filtering that specifies which web requests are kept in the logs and which are dropped. You can filter on the rule action and on the web request labels that were applied by matching rules during web ACL evaluation.
- managed_
by_ boolfirewall_ manager - Indicates whether the logging configuration was created by AWS Firewall Manager, as part of an AWS WAF policy configuration. If true, only Firewall Manager can modify or delete the configuration.
- redacted_
fields Sequence[LoggingConfiguration Field To Match] - The parts of the request that you want to keep out of the logs. For example, if you redact the HEADER field, the HEADER field in the firehose will be xxx.
- log
Destination List<String>Configs - The Amazon Resource Names (ARNs) of the logging destinations that you want to associate with the web ACL.
- logging
Filter Property Map - Filtering that specifies which web requests are kept in the logs and which are dropped. You can filter on the rule action and on the web request labels that were applied by matching rules during web ACL evaluation.
- managed
By BooleanFirewall Manager - Indicates whether the logging configuration was created by AWS Firewall Manager, as part of an AWS WAF policy configuration. If true, only Firewall Manager can modify or delete the configuration.
- redacted
Fields List<Property Map> - The parts of the request that you want to keep out of the logs. For example, if you redact the HEADER field, the HEADER field in the firehose will be xxx.
Supporting Types
LoggingConfigurationCondition
- Action
Condition Pulumi.Aws Native. Wa Fv2. Inputs. Logging Configuration Condition Action Condition Properties - A single action condition.
- Label
Name Pulumi.Condition Aws Native. Wa Fv2. Inputs. Logging Configuration Condition Label Name Condition Properties - A single label name condition.
- Action
Condition LoggingConfiguration Condition Action Condition Properties - A single action condition.
- Label
Name LoggingCondition Configuration Condition Label Name Condition Properties - A single label name condition.
- action
Condition LoggingConfiguration Condition Action Condition Properties - A single action condition.
- label
Name LoggingCondition Configuration Condition Label Name Condition Properties - A single label name condition.
- action
Condition LoggingConfiguration Condition Action Condition Properties - A single action condition.
- label
Name LoggingCondition Configuration Condition Label Name Condition Properties - A single label name condition.
- action_
condition LoggingConfiguration Condition Action Condition Properties - A single action condition.
- label_
name_ Loggingcondition Configuration Condition Label Name Condition Properties - A single label name condition.
- action
Condition Property Map - A single action condition.
- label
Name Property MapCondition - A single label name condition.
LoggingConfigurationConditionActionConditionProperties
- Action
This property is required. Pulumi.Aws Native. Wa Fv2. Logging Configuration Condition Action Condition Properties Action - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- Action
This property is required. LoggingConfiguration Condition Action Condition Properties Action - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- action
This property is required. LoggingConfiguration Condition Action Condition Properties Action - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- action
This property is required. LoggingConfiguration Condition Action Condition Properties Action - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- action
This property is required. LoggingConfiguration Condition Action Condition Properties Action - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- action
This property is required. "ALLOW" | "BLOCK" | "COUNT" | "CAPTCHA" | "CHALLENGE" | "EXCLUDED_AS_COUNT" - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
LoggingConfigurationConditionActionConditionPropertiesAction
LoggingConfigurationConditionLabelNameConditionProperties
- Label
Name This property is required. string - The label name that a log record must contain in order to meet the condition. This must be a fully qualified label name. Fully qualified labels have a prefix, optional namespaces, and label name. The prefix identifies the rule group or web ACL context of the rule that added the label.
- Label
Name This property is required. string - The label name that a log record must contain in order to meet the condition. This must be a fully qualified label name. Fully qualified labels have a prefix, optional namespaces, and label name. The prefix identifies the rule group or web ACL context of the rule that added the label.
- label
Name This property is required. String - The label name that a log record must contain in order to meet the condition. This must be a fully qualified label name. Fully qualified labels have a prefix, optional namespaces, and label name. The prefix identifies the rule group or web ACL context of the rule that added the label.
- label
Name This property is required. string - The label name that a log record must contain in order to meet the condition. This must be a fully qualified label name. Fully qualified labels have a prefix, optional namespaces, and label name. The prefix identifies the rule group or web ACL context of the rule that added the label.
- label_
name This property is required. str - The label name that a log record must contain in order to meet the condition. This must be a fully qualified label name. Fully qualified labels have a prefix, optional namespaces, and label name. The prefix identifies the rule group or web ACL context of the rule that added the label.
- label
Name This property is required. String - The label name that a log record must contain in order to meet the condition. This must be a fully qualified label name. Fully qualified labels have a prefix, optional namespaces, and label name. The prefix identifies the rule group or web ACL context of the rule that added the label.
LoggingConfigurationFieldToMatch
- Method object
- Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.
- Query
String object - Inspect the query string. This is the part of a URL that appears after a ? character, if any.
- Single
Header Pulumi.Aws Native. Wa Fv2. Inputs. Logging Configuration Field To Match Single Header Properties - Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.
- Uri
Path object - Inspect the request URI path. This is the part of a web request that identifies a resource, for example, /images/daily-ad.jpg.
- Method interface{}
- Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.
- Query
String interface{} - Inspect the query string. This is the part of a URL that appears after a ? character, if any.
- Single
Header LoggingConfiguration Field To Match Single Header Properties - Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.
- Uri
Path interface{} - Inspect the request URI path. This is the part of a web request that identifies a resource, for example, /images/daily-ad.jpg.
- method Object
- Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.
- query
String Object - Inspect the query string. This is the part of a URL that appears after a ? character, if any.
- single
Header LoggingConfiguration Field To Match Single Header Properties - Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.
- uri
Path Object - Inspect the request URI path. This is the part of a web request that identifies a resource, for example, /images/daily-ad.jpg.
- method any
- Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.
- query
String any - Inspect the query string. This is the part of a URL that appears after a ? character, if any.
- single
Header LoggingConfiguration Field To Match Single Header Properties - Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.
- uri
Path any - Inspect the request URI path. This is the part of a web request that identifies a resource, for example, /images/daily-ad.jpg.
- method Any
- Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.
- query_
string Any - Inspect the query string. This is the part of a URL that appears after a ? character, if any.
- single_
header LoggingConfiguration Field To Match Single Header Properties - Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.
- uri_
path Any - Inspect the request URI path. This is the part of a web request that identifies a resource, for example, /images/daily-ad.jpg.
- method Any
- Inspect the HTTP method. The method indicates the type of operation that the request is asking the origin to perform.
- query
String Any - Inspect the query string. This is the part of a URL that appears after a ? character, if any.
- single
Header Property Map - Inspect a single header. Provide the name of the header to inspect, for example, User-Agent or Referer. This setting isn't case sensitive.
- uri
Path Any - Inspect the request URI path. This is the part of a web request that identifies a resource, for example, /images/daily-ad.jpg.
LoggingConfigurationFieldToMatchSingleHeaderProperties
- Name
This property is required. string - The name of the query header to inspect.
- Name
This property is required. string - The name of the query header to inspect.
- name
This property is required. String - The name of the query header to inspect.
- name
This property is required. string - The name of the query header to inspect.
- name
This property is required. str - The name of the query header to inspect.
- name
This property is required. String - The name of the query header to inspect.
LoggingConfigurationFilter
- Behavior
This property is required. Pulumi.Aws Native. Wa Fv2. Logging Configuration Filter Behavior - How to handle logs that satisfy the filter's conditions and requirement.
- Conditions
This property is required. List<Pulumi.Aws Native. Wa Fv2. Inputs. Logging Configuration Condition> - Match conditions for the filter.
- Requirement
This property is required. Pulumi.Aws Native. Wa Fv2. Logging Configuration Filter Requirement - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- Behavior
This property is required. LoggingConfiguration Filter Behavior - How to handle logs that satisfy the filter's conditions and requirement.
- Conditions
This property is required. []LoggingConfiguration Condition - Match conditions for the filter.
- Requirement
This property is required. LoggingConfiguration Filter Requirement - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- behavior
This property is required. LoggingConfiguration Filter Behavior - How to handle logs that satisfy the filter's conditions and requirement.
- conditions
This property is required. List<LoggingConfiguration Condition> - Match conditions for the filter.
- requirement
This property is required. LoggingConfiguration Filter Requirement - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- behavior
This property is required. LoggingConfiguration Filter Behavior - How to handle logs that satisfy the filter's conditions and requirement.
- conditions
This property is required. LoggingConfiguration Condition[] - Match conditions for the filter.
- requirement
This property is required. LoggingConfiguration Filter Requirement - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- behavior
This property is required. LoggingConfiguration Filter Behavior - How to handle logs that satisfy the filter's conditions and requirement.
- conditions
This property is required. Sequence[LoggingConfiguration Condition] - Match conditions for the filter.
- requirement
This property is required. LoggingConfiguration Filter Requirement - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
- behavior
This property is required. "KEEP" | "DROP" - How to handle logs that satisfy the filter's conditions and requirement.
- conditions
This property is required. List<Property Map> - Match conditions for the filter.
- requirement
This property is required. "MEETS_ALL" | "MEETS_ANY" - Logic to apply to the filtering conditions. You can specify that, in order to satisfy the filter, a log must match all conditions or must match at least one condition.
LoggingConfigurationFilterBehavior
LoggingConfigurationFilterRequirement
LoggingConfigurationLoggingFilterPropertiesDefaultBehavior
LoggingFilterProperties
- Default
Behavior This property is required. Pulumi.Aws Native. Wa Fv2. Logging Configuration Logging Filter Properties Default Behavior - Default handling for logs that don't match any of the specified filtering conditions.
- Filters
This property is required. List<Pulumi.Aws Native. Wa Fv2. Inputs. Logging Configuration Filter> - The filters that you want to apply to the logs.
- Default
Behavior This property is required. LoggingConfiguration Logging Filter Properties Default Behavior - Default handling for logs that don't match any of the specified filtering conditions.
- Filters
This property is required. []LoggingConfiguration Filter - The filters that you want to apply to the logs.
- default
Behavior This property is required. LoggingConfiguration Logging Filter Properties Default Behavior - Default handling for logs that don't match any of the specified filtering conditions.
- filters
This property is required. List<LoggingConfiguration Filter> - The filters that you want to apply to the logs.
- default
Behavior This property is required. LoggingConfiguration Logging Filter Properties Default Behavior - Default handling for logs that don't match any of the specified filtering conditions.
- filters
This property is required. LoggingConfiguration Filter[] - The filters that you want to apply to the logs.
- default_
behavior This property is required. LoggingConfiguration Logging Filter Properties Default Behavior - Default handling for logs that don't match any of the specified filtering conditions.
- filters
This property is required. Sequence[LoggingConfiguration Filter] - The filters that you want to apply to the logs.
- default
Behavior This property is required. "KEEP" | "DROP" - Default handling for logs that don't match any of the specified filtering conditions.
- filters
This property is required. List<Property Map> - The filters that you want to apply to the logs.
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
AWS Cloud Control v1.27.0 published on Monday, Apr 14, 2025 by Pulumi