WebAclRuleGroupAssociation class

Associates a WAFv2 Rule Group (custom or managed) with a Web ACL by adding a rule that references the Rule Group. Use this resource to apply the rules defined in a Rule Group to a Web ACL without duplicating rule definitions.

This resource supports both:

  • Custom Rule Groups: User-created rule groups that you manage within your AWS account
  • Managed Rule Groups: Pre-configured rule groups provided by AWS or third-party vendors

> Warning: Verify the rule names in your ruleActionOverrides carefully. With managed rule groups, WAF silently ignores any override that uses an invalid rule name. With customer-owned rule groups, invalid rule names in your overrides will cause web ACL updates to fail. An invalid rule name is any name that doesn't exactly match the case-sensitive name of an existing rule in the rule group.

> Warning: Using this resource will cause the associated Web ACL resource to show configuration drift in the rule argument unless you add lifecycle { ignoreChanges = [rule] } to the Web ACL resource configuration. This is because this resource modifies the Web ACL's rules outside of the Web ACL resource's direct management.

> Note: This resource creates a rule within the Web ACL that references the entire Rule Group. The rule group's individual rules are evaluated as a unit when requests are processed by the Web ACL.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

// Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
const example = new aws.wafv2.WebAcl("example", {
    defaultAction: {
        allow: {},
    },
    visibilityConfig: {
        cloudwatchMetricsEnabled: true,
        metricName: "example-web-acl",
        sampledRequestsEnabled: true,
    },
    name: "example-web-acl",
    scope: "REGIONAL",
}, {
    ignoreChanges: ["rules"],
});
// Associate a custom rule group
const exampleWebAclRuleGroupAssociation = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    ruleGroupReference: {
        arn: exampleAwsWafv2RuleGroup.arn,
    },
    ruleName: "example-rule-group-rule",
    priority: 100,
    webAclArn: example.arn,
});
import pulumi
import pulumi_aws as aws

# Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
example = aws.wafv2.WebAcl("example",
    default_action={
        "allow": {},
    },
    visibility_config={
        "cloudwatch_metrics_enabled": True,
        "metric_name": "example-web-acl",
        "sampled_requests_enabled": True,
    },
    name="example-web-acl",
    scope="REGIONAL",
    opts = pulumi.ResourceOptions(ignore_changes=["rules"]))
# Associate a custom rule group
example_web_acl_rule_group_association = aws.wafv2.WebAclRuleGroupAssociation("example",
    rule_group_reference={
        "arn": example_aws_wafv2_rule_group["arn"],
    },
    rule_name="example-rule-group-rule",
    priority=100,
    web_acl_arn=example.arn)
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    // Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
    var example = new Aws.WafV2.WebAcl("example", new()
    {
        DefaultAction = new Aws.WafV2.Inputs.WebAclDefaultActionArgs
        {
            Allow = null,
        },
        VisibilityConfig = new Aws.WafV2.Inputs.WebAclVisibilityConfigArgs
        {
            CloudwatchMetricsEnabled = true,
            MetricName = "example-web-acl",
            SampledRequestsEnabled = true,
        },
        Name = "example-web-acl",
        Scope = "REGIONAL",
    }, new CustomResourceOptions
    {
        IgnoreChanges =
        {
            "rules",
        },
    });

    // Associate a custom rule group
    var exampleWebAclRuleGroupAssociation = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        RuleGroupReference = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs
        {
            Arn = exampleAwsWafv2RuleGroup.Arn,
        },
        RuleName = "example-rule-group-rule",
        Priority = 100,
        WebAclArn = example.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
		example, err := wafv2.NewWebAcl(ctx, "example", &wafv2.WebAclArgs{
			DefaultAction: &wafv2.WebAclDefaultActionArgs{
				Allow: &wafv2.WebAclDefaultActionAllowArgs{},
			},
			VisibilityConfig: &wafv2.WebAclVisibilityConfigArgs{
				CloudwatchMetricsEnabled: pulumi.Bool(true),
				MetricName:               pulumi.String("example-web-acl"),
				SampledRequestsEnabled:   pulumi.Bool(true),
			},
			Name:  pulumi.String("example-web-acl"),
			Scope: pulumi.String("REGIONAL"),
		}, pulumi.IgnoreChanges([]string{
			"rules",
		}))
		if err != nil {
			return err
		}
		// Associate a custom rule group
		_, err = wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			RuleGroupReference: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceArgs{
				Arn: pulumi.Any(exampleAwsWafv2RuleGroup.Arn),
			},
			RuleName:  pulumi.String("example-rule-group-rule"),
			Priority:  pulumi.Int(100),
			WebAclArn: example.Arn,
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

# Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
resource "aws_wafv2_webacl" "example" {
  lifecycle {
    ignore_changes = [rules]
  }
  default_action = {
    allow = {}
  }
  visibility_config = {
    cloudwatch_metrics_enabled = true
    metric_name                = "example-web-acl"
    sampled_requests_enabled   = true
  }
  name  = "example-web-acl"
  scope = "REGIONAL"
}
# Associate a custom rule group
resource "aws_wafv2_webaclrulegroupassociation" "example" {
  rule_group_reference = {
    arn = exampleAwsWafv2RuleGroup.arn
  }
  rule_name   = "example-rule-group-rule"
  priority    = 100
  web_acl_arn = aws_wafv2_webacl.example.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAcl;
import com.pulumi.aws.wafv2.WebAclArgs;
import com.pulumi.aws.wafv2.inputs.WebAclDefaultActionArgs;
import com.pulumi.aws.wafv2.inputs.WebAclDefaultActionAllowArgs;
import com.pulumi.aws.wafv2.inputs.WebAclVisibilityConfigArgs;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs;
import com.pulumi.resources.CustomResourceOptions;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        // Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
        var example = new WebAcl("example", WebAclArgs.builder()
            .defaultAction(WebAclDefaultActionArgs.builder()
                .allow(WebAclDefaultActionAllowArgs.builder()
                    .build())
                .build())
            .visibilityConfig(WebAclVisibilityConfigArgs.builder()
                .cloudwatchMetricsEnabled(true)
                .metricName("example-web-acl")
                .sampledRequestsEnabled(true)
                .build())
            .name("example-web-acl")
            .scope("REGIONAL")
            .build(), CustomResourceOptions.builder()
                .ignoreChanges("rules")
                .build());

        // Associate a custom rule group
        var exampleWebAclRuleGroupAssociation = new WebAclRuleGroupAssociation("exampleWebAclRuleGroupAssociation", WebAclRuleGroupAssociationArgs.builder()
            .ruleGroupReference(WebAclRuleGroupAssociationRuleGroupReferenceArgs.builder()
                .arn(exampleAwsWafv2RuleGroup.arn())
                .build())
            .ruleName("example-rule-group-rule")
            .priority(100)
            .webAclArn(example.arn())
            .build());

    }
}
resources:
  # Web ACL must use lifecycle.ignore_changes to prevent drift from this resource
  example:
    type: aws:wafv2:WebAcl
    properties:
      defaultAction:
        allow: {}
      visibilityConfig:
        cloudwatchMetricsEnabled: true
        metricName: example-web-acl
        sampledRequestsEnabled: true
      name: example-web-acl
      scope: REGIONAL
    options:
      ignoreChanges:
        - rules
  # Associate a custom rule group
  exampleWebAclRuleGroupAssociation:
    type: aws:wafv2:WebAclRuleGroupAssociation
    name: example
    properties:
      ruleGroupReference:
        arn: ${exampleAwsWafv2RuleGroup.arn}
      ruleName: example-rule-group-rule
      priority: 100
      webAclArn: ${example.arn}

Managed Rule Group

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    managedRuleGroup: {
        name: "AWSManagedRulesCommonRuleSet",
        vendorName: "AWS",
    },
    ruleName: "aws-common-rule-set",
    priority: 50,
    webAclArn: exampleAwsWafv2WebAcl.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    managed_rule_group={
        "name": "AWSManagedRulesCommonRuleSet",
        "vendor_name": "AWS",
    },
    rule_name="aws-common-rule-set",
    priority=50,
    web_acl_arn=example_aws_wafv2_web_acl["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        ManagedRuleGroup = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs
        {
            Name = "AWSManagedRulesCommonRuleSet",
            VendorName = "AWS",
        },
        RuleName = "aws-common-rule-set",
        Priority = 50,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			ManagedRuleGroup: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupArgs{
				Name:       pulumi.String("AWSManagedRulesCommonRuleSet"),
				VendorName: pulumi.String("AWS"),
			},
			RuleName:  pulumi.String("aws-common-rule-set"),
			Priority:  pulumi.Int(50),
			WebAclArn: pulumi.Any(exampleAwsWafv2WebAcl.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  managed_rule_group = {
    name        = "AWSManagedRulesCommonRuleSet"
    vendor_name = "AWS"
  }
  rule_name   = "aws-common-rule-set"
  priority    = 50
  web_acl_arn = exampleAwsWafv2WebAcl.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .managedRuleGroup(WebAclRuleGroupAssociationManagedRuleGroupArgs.builder()
                .name("AWSManagedRulesCommonRuleSet")
                .vendorName("AWS")
                .build())
            .ruleName("aws-common-rule-set")
            .priority(50)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      managedRuleGroup:
        name: AWSManagedRulesCommonRuleSet
        vendorName: AWS
      ruleName: aws-common-rule-set
      priority: 50
      webAclArn: ${exampleAwsWafv2WebAcl.arn}

Managed Rule Group With Version

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    managedRuleGroup: {
        name: "AWSManagedRulesCommonRuleSet",
        vendorName: "AWS",
        version: "Version_1.0",
    },
    ruleName: "aws-common-rule-set-versioned",
    priority: 60,
    webAclArn: exampleAwsWafv2WebAcl.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    managed_rule_group={
        "name": "AWSManagedRulesCommonRuleSet",
        "vendor_name": "AWS",
        "version": "Version_1.0",
    },
    rule_name="aws-common-rule-set-versioned",
    priority=60,
    web_acl_arn=example_aws_wafv2_web_acl["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        ManagedRuleGroup = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs
        {
            Name = "AWSManagedRulesCommonRuleSet",
            VendorName = "AWS",
            Version = "Version_1.0",
        },
        RuleName = "aws-common-rule-set-versioned",
        Priority = 60,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			ManagedRuleGroup: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupArgs{
				Name:       pulumi.String("AWSManagedRulesCommonRuleSet"),
				VendorName: pulumi.String("AWS"),
				Version:    pulumi.String("Version_1.0"),
			},
			RuleName:  pulumi.String("aws-common-rule-set-versioned"),
			Priority:  pulumi.Int(60),
			WebAclArn: pulumi.Any(exampleAwsWafv2WebAcl.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  managed_rule_group = {
    name        = "AWSManagedRulesCommonRuleSet"
    vendor_name = "AWS"
    version     = "Version_1.0"
  }
  rule_name   = "aws-common-rule-set-versioned"
  priority    = 60
  web_acl_arn = exampleAwsWafv2WebAcl.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .managedRuleGroup(WebAclRuleGroupAssociationManagedRuleGroupArgs.builder()
                .name("AWSManagedRulesCommonRuleSet")
                .vendorName("AWS")
                .version("Version_1.0")
                .build())
            .ruleName("aws-common-rule-set-versioned")
            .priority(60)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      managedRuleGroup:
        name: AWSManagedRulesCommonRuleSet
        vendorName: AWS
        version: Version_1.0
      ruleName: aws-common-rule-set-versioned
      priority: 60
      webAclArn: ${exampleAwsWafv2WebAcl.arn}

Managed Rule Group With Rule Action Overrides

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    managedRuleGroup: {
        ruleActionOverrides: [
            {
                actionToUse: {
                    count: {
                        customRequestHandling: {
                            insertHeaders: [{
                                name: "X-RFI-Override",
                                value: "counted",
                            }],
                        },
                    },
                },
                name: "GenericRFI_BODY",
            },
            {
                actionToUse: {
                    captcha: {},
                },
                name: "SizeRestrictions_BODY",
            },
        ],
        name: "AWSManagedRulesCommonRuleSet",
        vendorName: "AWS",
    },
    ruleName: "aws-common-rule-set-with-overrides",
    priority: 70,
    webAclArn: exampleAwsWafv2WebAcl.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    managed_rule_group={
        "rule_action_overrides": [
            {
                "action_to_use": {
                    "count": {
                        "custom_request_handling": {
                            "insert_headers": [{
                                "name": "X-RFI-Override",
                                "value": "counted",
                            }],
                        },
                    },
                },
                "name": "GenericRFI_BODY",
            },
            {
                "action_to_use": {
                    "captcha": {},
                },
                "name": "SizeRestrictions_BODY",
            },
        ],
        "name": "AWSManagedRulesCommonRuleSet",
        "vendor_name": "AWS",
    },
    rule_name="aws-common-rule-set-with-overrides",
    priority=70,
    web_acl_arn=example_aws_wafv2_web_acl["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        ManagedRuleGroup = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs
        {
            RuleActionOverrides = new[]
            {
                new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs
                {
                    ActionToUse = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs
                    {
                        Count = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountArgs
                        {
                            CustomRequestHandling = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingArgs
                            {
                                InsertHeaders = new[]
                                {
                                    new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs
                                    {
                                        Name = "X-RFI-Override",
                                        Value = "counted",
                                    },
                                },
                            },
                        },
                    },
                    Name = "GenericRFI_BODY",
                },
                new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs
                {
                    ActionToUse = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs
                    {
                        Captcha = null,
                    },
                    Name = "SizeRestrictions_BODY",
                },
            },
            Name = "AWSManagedRulesCommonRuleSet",
            VendorName = "AWS",
        },
        RuleName = "aws-common-rule-set-with-overrides",
        Priority = 70,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			ManagedRuleGroup: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupArgs{
				RuleActionOverrides: wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArray{
					&wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs{
						ActionToUse: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs{
							Count: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountArgs{
								CustomRequestHandling: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingArgs{
									InsertHeaders: wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArray{
										&wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs{
											Name:  pulumi.String("X-RFI-Override"),
											Value: pulumi.String("counted"),
										},
									},
								},
							},
						},
						Name: pulumi.String("GenericRFI_BODY"),
					},
					&wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs{
						ActionToUse: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs{
							Captcha: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCaptchaArgs{},
						},
						Name: pulumi.String("SizeRestrictions_BODY"),
					},
				},
				Name:       pulumi.String("AWSManagedRulesCommonRuleSet"),
				VendorName: pulumi.String("AWS"),
			},
			RuleName:  pulumi.String("aws-common-rule-set-with-overrides"),
			Priority:  pulumi.Int(70),
			WebAclArn: pulumi.Any(exampleAwsWafv2WebAcl.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  managed_rule_group = {
    rule_action_overrides = [{
      "actionToUse" = {
        "count" = {
          "customRequestHandling" = {
            "insertHeaders" = [{
              "name"  = "X-RFI-Override"
              "value" = "counted"
            }]
          }
        }
      }
      "name" = "GenericRFI_BODY"
      }, {
      "actionToUse" = {
        "captcha" = {}
      }
      "name" = "SizeRestrictions_BODY"
    }]
    name        = "AWSManagedRulesCommonRuleSet"
    vendor_name = "AWS"
  }
  rule_name   = "aws-common-rule-set-with-overrides"
  priority    = 70
  web_acl_arn = exampleAwsWafv2WebAcl.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCaptchaArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .managedRuleGroup(WebAclRuleGroupAssociationManagedRuleGroupArgs.builder()
                .ruleActionOverrides(
                    WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs.builder()
                        .actionToUse(WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs.builder()
                            .count(WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountArgs.builder()
                                .customRequestHandling(WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingArgs.builder()
                                    .insertHeaders(WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs.builder()
                                        .name("X-RFI-Override")
                                        .value("counted")
                                        .build())
                                    .build())
                                .build())
                            .build())
                        .name("GenericRFI_BODY")
                        .build(),
                    WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideArgs.builder()
                        .actionToUse(WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseArgs.builder()
                            .captcha(WebAclRuleGroupAssociationManagedRuleGroupRuleActionOverrideActionToUseCaptchaArgs.builder()
                                .build())
                            .build())
                        .name("SizeRestrictions_BODY")
                        .build())
                .name("AWSManagedRulesCommonRuleSet")
                .vendorName("AWS")
                .build())
            .ruleName("aws-common-rule-set-with-overrides")
            .priority(70)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      managedRuleGroup:
        ruleActionOverrides:
          - actionToUse:
              count:
                customRequestHandling:
                  insertHeaders:
                    - name: X-RFI-Override
                      value: counted
            name: GenericRFI_BODY
          - actionToUse:
              captcha: {}
            name: SizeRestrictions_BODY
        name: AWSManagedRulesCommonRuleSet
        vendorName: AWS
      ruleName: aws-common-rule-set-with-overrides
      priority: 70
      webAclArn: ${exampleAwsWafv2WebAcl.arn}

Managed Rule Group With Managed Rule Group Configs

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    managedRuleGroup: {
        managedRuleGroupConfigs: {
            awsManagedRulesAcfpRuleSet: {
                requestInspection: {
                    emailField: {
                        identifier: "/email",
                    },
                    passwordField: {
                        identifier: "/password",
                    },
                    phoneNumberFields: {
                        identifiers: [
                            "/phone1",
                            "/phone2",
                        ],
                    },
                    addressFields: {
                        identifiers: [
                            "home",
                            "work",
                        ],
                    },
                    usernameField: {
                        identifier: "/username",
                    },
                    payloadType: "JSON",
                },
                creationPath: "/creation",
                registrationPagePath: "/registration",
            },
        },
        name: "AWSManagedRulesACFPRuleSet",
        vendorName: "AWS",
    },
    visibilityConfig: {
        cloudwatchMetricsEnabled: true,
        metricName: "friendly-metric-name",
        sampledRequestsEnabled: true,
    },
    ruleName: "acfp-ruleset-with-rule-config",
    priority: 70,
    webAclArn: exampleAwsWafv2WebAcl.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    managed_rule_group={
        "managed_rule_group_configs": {
            "aws_managed_rules_acfp_rule_set": {
                "request_inspection": {
                    "email_field": {
                        "identifier": "/email",
                    },
                    "password_field": {
                        "identifier": "/password",
                    },
                    "phone_number_fields": {
                        "identifiers": [
                            "/phone1",
                            "/phone2",
                        ],
                    },
                    "address_fields": {
                        "identifiers": [
                            "home",
                            "work",
                        ],
                    },
                    "username_field": {
                        "identifier": "/username",
                    },
                    "payload_type": "JSON",
                },
                "creation_path": "/creation",
                "registration_page_path": "/registration",
            },
        },
        "name": "AWSManagedRulesACFPRuleSet",
        "vendor_name": "AWS",
    },
    visibility_config={
        "cloudwatch_metrics_enabled": True,
        "metric_name": "friendly-metric-name",
        "sampled_requests_enabled": True,
    },
    rule_name="acfp-ruleset-with-rule-config",
    priority=70,
    web_acl_arn=example_aws_wafv2_web_acl["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        ManagedRuleGroup = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs
        {
            ManagedRuleGroupConfigs = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsArgs
            {
                AwsManagedRulesAcfpRuleSet = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetArgs
                {
                    RequestInspection = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionArgs
                    {
                        EmailField = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionEmailFieldArgs
                        {
                            Identifier = "/email",
                        },
                        PasswordField = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPasswordFieldArgs
                        {
                            Identifier = "/password",
                        },
                        PhoneNumberFields = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPhoneNumberFieldsArgs
                        {
                            Identifiers = new[]
                            {
                                "/phone1",
                                "/phone2",
                            },
                        },
                        AddressFields = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionAddressFieldsArgs
                        {
                            Identifiers = new[]
                            {
                                "home",
                                "work",
                            },
                        },
                        UsernameField = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionUsernameFieldArgs
                        {
                            Identifier = "/username",
                        },
                        PayloadType = "JSON",
                    },
                    CreationPath = "/creation",
                    RegistrationPagePath = "/registration",
                },
            },
            Name = "AWSManagedRulesACFPRuleSet",
            VendorName = "AWS",
        },
        VisibilityConfig = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationVisibilityConfigArgs
        {
            CloudwatchMetricsEnabled = true,
            MetricName = "friendly-metric-name",
            SampledRequestsEnabled = true,
        },
        RuleName = "acfp-ruleset-with-rule-config",
        Priority = 70,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			ManagedRuleGroup: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupArgs{
				ManagedRuleGroupConfigs: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsArgs{
					AwsManagedRulesAcfpRuleSet: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetArgs{
						RequestInspection: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionArgs{
							EmailField: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionEmailFieldArgs{
								Identifier: pulumi.String("/email"),
							},
							PasswordField: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPasswordFieldArgs{
								Identifier: pulumi.String("/password"),
							},
							PhoneNumberFields: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPhoneNumberFieldsArgs{
								Identifiers: pulumi.StringArray{
									pulumi.String("/phone1"),
									pulumi.String("/phone2"),
								},
							},
							AddressFields: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionAddressFieldsArgs{
								Identifiers: pulumi.StringArray{
									pulumi.String("home"),
									pulumi.String("work"),
								},
							},
							UsernameField: &wafv2.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionUsernameFieldArgs{
								Identifier: pulumi.String("/username"),
							},
							PayloadType: pulumi.String("JSON"),
						},
						CreationPath:         pulumi.String("/creation"),
						RegistrationPagePath: pulumi.String("/registration"),
					},
				},
				Name:       pulumi.String("AWSManagedRulesACFPRuleSet"),
				VendorName: pulumi.String("AWS"),
			},
			VisibilityConfig: &wafv2.WebAclRuleGroupAssociationVisibilityConfigArgs{
				CloudwatchMetricsEnabled: pulumi.Bool(true),
				MetricName:               pulumi.String("friendly-metric-name"),
				SampledRequestsEnabled:   pulumi.Bool(true),
			},
			RuleName:  pulumi.String("acfp-ruleset-with-rule-config"),
			Priority:  pulumi.Int(70),
			WebAclArn: pulumi.Any(exampleAwsWafv2WebAcl.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  managed_rule_group = {
    managed_rule_group_configs = {
      aws_managed_rules_acfp_rule_set = {
        request_inspection = {
          email_field = {
            identifier = "/email"
          }
          password_field = {
            identifier = "/password"
          }
          phone_number_fields = {
            identifiers = ["/phone1", "/phone2"]
          }
          address_fields = {
            identifiers = ["home", "work"]
          }
          username_field = {
            identifier = "/username"
          }
          payload_type = "JSON"
        }
        creation_path          = "/creation"
        registration_page_path = "/registration"
      }
    }
    name        = "AWSManagedRulesACFPRuleSet"
    vendor_name = "AWS"
  }
  visibility_config = {
    cloudwatch_metrics_enabled = true
    metric_name                = "friendly-metric-name"
    sampled_requests_enabled   = true
  }
  rule_name   = "acfp-ruleset-with-rule-config"
  priority    = 70
  web_acl_arn = exampleAwsWafv2WebAcl.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionEmailFieldArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPasswordFieldArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPhoneNumberFieldsArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionAddressFieldsArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionUsernameFieldArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationVisibilityConfigArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .managedRuleGroup(WebAclRuleGroupAssociationManagedRuleGroupArgs.builder()
                .managedRuleGroupConfigs(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsArgs.builder()
                    .awsManagedRulesAcfpRuleSet(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetArgs.builder()
                        .requestInspection(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionArgs.builder()
                            .emailField(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionEmailFieldArgs.builder()
                                .identifier("/email")
                                .build())
                            .passwordField(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPasswordFieldArgs.builder()
                                .identifier("/password")
                                .build())
                            .phoneNumberFields(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionPhoneNumberFieldsArgs.builder()
                                .identifiers(
                                    "/phone1",
                                    "/phone2")
                                .build())
                            .addressFields(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionAddressFieldsArgs.builder()
                                .identifiers(
                                    "home",
                                    "work")
                                .build())
                            .usernameField(WebAclRuleGroupAssociationManagedRuleGroupManagedRuleGroupConfigsAwsManagedRulesAcfpRuleSetRequestInspectionUsernameFieldArgs.builder()
                                .identifier("/username")
                                .build())
                            .payloadType("JSON")
                            .build())
                        .creationPath("/creation")
                        .registrationPagePath("/registration")
                        .build())
                    .build())
                .name("AWSManagedRulesACFPRuleSet")
                .vendorName("AWS")
                .build())
            .visibilityConfig(WebAclRuleGroupAssociationVisibilityConfigArgs.builder()
                .cloudwatchMetricsEnabled(true)
                .metricName("friendly-metric-name")
                .sampledRequestsEnabled(true)
                .build())
            .ruleName("acfp-ruleset-with-rule-config")
            .priority(70)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      managedRuleGroup:
        managedRuleGroupConfigs:
          awsManagedRulesAcfpRuleSet:
            requestInspection:
              emailField:
                identifier: /email
              passwordField:
                identifier: /password
              phoneNumberFields:
                identifiers:
                  - /phone1
                  - /phone2
              addressFields:
                identifiers:
                  - home
                  - work
              usernameField:
                identifier: /username
              payloadType: JSON
            creationPath: /creation
            registrationPagePath: /registration
        name: AWSManagedRulesACFPRuleSet
        vendorName: AWS
      visibilityConfig:
        cloudwatchMetricsEnabled: true
        metricName: friendly-metric-name
        sampledRequestsEnabled: true
      ruleName: acfp-ruleset-with-rule-config
      priority: 70
      webAclArn: ${exampleAwsWafv2WebAcl.arn}

Custom Rule Group With Override Action

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    ruleGroupReference: {
        arn: exampleAwsWafv2RuleGroup.arn,
    },
    ruleName: "example-rule-group-rule",
    priority: 100,
    webAclArn: exampleAwsWafv2WebAcl.arn,
    overrideAction: "count",
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    rule_group_reference={
        "arn": example_aws_wafv2_rule_group["arn"],
    },
    rule_name="example-rule-group-rule",
    priority=100,
    web_acl_arn=example_aws_wafv2_web_acl["arn"],
    override_action="count")
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        RuleGroupReference = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs
        {
            Arn = exampleAwsWafv2RuleGroup.Arn,
        },
        RuleName = "example-rule-group-rule",
        Priority = 100,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
        OverrideAction = "count",
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			RuleGroupReference: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceArgs{
				Arn: pulumi.Any(exampleAwsWafv2RuleGroup.Arn),
			},
			RuleName:       pulumi.String("example-rule-group-rule"),
			Priority:       pulumi.Int(100),
			WebAclArn:      pulumi.Any(exampleAwsWafv2WebAcl.Arn),
			OverrideAction: pulumi.String("count"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  rule_group_reference = {
    arn = exampleAwsWafv2RuleGroup.arn
  }
  rule_name       = "example-rule-group-rule"
  priority        = 100
  web_acl_arn     = exampleAwsWafv2WebAcl.arn
  override_action = "count"
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .ruleGroupReference(WebAclRuleGroupAssociationRuleGroupReferenceArgs.builder()
                .arn(exampleAwsWafv2RuleGroup.arn())
                .build())
            .ruleName("example-rule-group-rule")
            .priority(100)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .overrideAction("count")
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      ruleGroupReference:
        arn: ${exampleAwsWafv2RuleGroup.arn}
      ruleName: example-rule-group-rule
      priority: 100
      webAclArn: ${exampleAwsWafv2WebAcl.arn}
      overrideAction: count

Custom Rule Group With Rule Action Overrides

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    ruleGroupReference: {
        ruleActionOverrides: [
            {
                actionToUse: {
                    count: {
                        customRequestHandling: {
                            insertHeaders: [{
                                name: "X-Geo-Block-Override",
                                value: "counted",
                            }],
                        },
                    },
                },
                name: "geo-block-rule",
            },
            {
                actionToUse: {
                    captcha: {
                        customRequestHandling: {
                            insertHeaders: [{
                                name: "X-Rate-Limit-Override",
                                value: "captcha-required",
                            }],
                        },
                    },
                },
                name: "rate-limit-rule",
            },
        ],
        arn: exampleAwsWafv2RuleGroup.arn,
    },
    ruleName: "example-rule-group-rule",
    priority: 100,
    webAclArn: exampleAwsWafv2WebAcl.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    rule_group_reference={
        "rule_action_overrides": [
            {
                "action_to_use": {
                    "count": {
                        "custom_request_handling": {
                            "insert_headers": [{
                                "name": "X-Geo-Block-Override",
                                "value": "counted",
                            }],
                        },
                    },
                },
                "name": "geo-block-rule",
            },
            {
                "action_to_use": {
                    "captcha": {
                        "custom_request_handling": {
                            "insert_headers": [{
                                "name": "X-Rate-Limit-Override",
                                "value": "captcha-required",
                            }],
                        },
                    },
                },
                "name": "rate-limit-rule",
            },
        ],
        "arn": example_aws_wafv2_rule_group["arn"],
    },
    rule_name="example-rule-group-rule",
    priority=100,
    web_acl_arn=example_aws_wafv2_web_acl["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        RuleGroupReference = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs
        {
            RuleActionOverrides = new[]
            {
                new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs
                {
                    ActionToUse = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs
                    {
                        Count = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountArgs
                        {
                            CustomRequestHandling = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingArgs
                            {
                                InsertHeaders = new[]
                                {
                                    new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs
                                    {
                                        Name = "X-Geo-Block-Override",
                                        Value = "counted",
                                    },
                                },
                            },
                        },
                    },
                    Name = "geo-block-rule",
                },
                new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs
                {
                    ActionToUse = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs
                    {
                        Captcha = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaArgs
                        {
                            CustomRequestHandling = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingArgs
                            {
                                InsertHeaders = new[]
                                {
                                    new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingInsertHeaderArgs
                                    {
                                        Name = "X-Rate-Limit-Override",
                                        Value = "captcha-required",
                                    },
                                },
                            },
                        },
                    },
                    Name = "rate-limit-rule",
                },
            },
            Arn = exampleAwsWafv2RuleGroup.Arn,
        },
        RuleName = "example-rule-group-rule",
        Priority = 100,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			RuleGroupReference: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceArgs{
				RuleActionOverrides: wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArray{
					&wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs{
						ActionToUse: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs{
							Count: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountArgs{
								CustomRequestHandling: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingArgs{
									InsertHeaders: wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArray{
										&wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs{
											Name:  pulumi.String("X-Geo-Block-Override"),
											Value: pulumi.String("counted"),
										},
									},
								},
							},
						},
						Name: pulumi.String("geo-block-rule"),
					},
					&wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs{
						ActionToUse: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs{
							Captcha: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaArgs{
								CustomRequestHandling: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingArgs{
									InsertHeaders: wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingInsertHeaderArray{
										&wafv2.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingInsertHeaderArgs{
											Name:  pulumi.String("X-Rate-Limit-Override"),
											Value: pulumi.String("captcha-required"),
										},
									},
								},
							},
						},
						Name: pulumi.String("rate-limit-rule"),
					},
				},
				Arn: pulumi.Any(exampleAwsWafv2RuleGroup.Arn),
			},
			RuleName:  pulumi.String("example-rule-group-rule"),
			Priority:  pulumi.Int(100),
			WebAclArn: pulumi.Any(exampleAwsWafv2WebAcl.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  rule_group_reference = {
    rule_action_overrides = [{
      "actionToUse" = {
        "count" = {
          "customRequestHandling" = {
            "insertHeaders" = [{
              "name"  = "X-Geo-Block-Override"
              "value" = "counted"
            }]
          }
        }
      }
      "name" = "geo-block-rule"
      }, {
      "actionToUse" = {
        "captcha" = {
          "customRequestHandling" = {
            "insertHeaders" = [{
              "name"  = "X-Rate-Limit-Override"
              "value" = "captcha-required"
            }]
          }
        }
      }
      "name" = "rate-limit-rule"
    }]
    arn = exampleAwsWafv2RuleGroup.arn
  }
  rule_name   = "example-rule-group-rule"
  priority    = 100
  web_acl_arn = exampleAwsWafv2WebAcl.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingInsertHeaderArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .ruleGroupReference(WebAclRuleGroupAssociationRuleGroupReferenceArgs.builder()
                .ruleActionOverrides(
                    WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs.builder()
                        .actionToUse(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs.builder()
                            .count(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountArgs.builder()
                                .customRequestHandling(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingArgs.builder()
                                    .insertHeaders(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCountCustomRequestHandlingInsertHeaderArgs.builder()
                                        .name("X-Geo-Block-Override")
                                        .value("counted")
                                        .build())
                                    .build())
                                .build())
                            .build())
                        .name("geo-block-rule")
                        .build(),
                    WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideArgs.builder()
                        .actionToUse(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseArgs.builder()
                            .captcha(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaArgs.builder()
                                .customRequestHandling(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingArgs.builder()
                                    .insertHeaders(WebAclRuleGroupAssociationRuleGroupReferenceRuleActionOverrideActionToUseCaptchaCustomRequestHandlingInsertHeaderArgs.builder()
                                        .name("X-Rate-Limit-Override")
                                        .value("captcha-required")
                                        .build())
                                    .build())
                                .build())
                            .build())
                        .name("rate-limit-rule")
                        .build())
                .arn(exampleAwsWafv2RuleGroup.arn())
                .build())
            .ruleName("example-rule-group-rule")
            .priority(100)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      ruleGroupReference:
        ruleActionOverrides:
          - actionToUse:
              count:
                customRequestHandling:
                  insertHeaders:
                    - name: X-Geo-Block-Override
                      value: counted
            name: geo-block-rule
          - actionToUse:
              captcha:
                customRequestHandling:
                  insertHeaders:
                    - name: X-Rate-Limit-Override
                      value: captcha-required
            name: rate-limit-rule
        arn: ${exampleAwsWafv2RuleGroup.arn}
      ruleName: example-rule-group-rule
      priority: 100
      webAclArn: ${exampleAwsWafv2WebAcl.arn}

CloudFront Web ACL

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.wafv2.WebAclRuleGroupAssociation("example", {
    ruleGroupReference: {
        arn: exampleAwsWafv2RuleGroup.arn,
    },
    ruleName: "cloudfront-rule-group-rule",
    priority: 50,
    webAclArn: exampleAwsWafv2WebAcl.arn,
});
import pulumi
import pulumi_aws as aws

example = aws.wafv2.WebAclRuleGroupAssociation("example",
    rule_group_reference={
        "arn": example_aws_wafv2_rule_group["arn"],
    },
    rule_name="cloudfront-rule-group-rule",
    priority=50,
    web_acl_arn=example_aws_wafv2_web_acl["arn"])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.WafV2.WebAclRuleGroupAssociation("example", new()
    {
        RuleGroupReference = new Aws.WafV2.Inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs
        {
            Arn = exampleAwsWafv2RuleGroup.Arn,
        },
        RuleName = "cloudfront-rule-group-rule",
        Priority = 50,
        WebAclArn = exampleAwsWafv2WebAcl.Arn,
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/wafv2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := wafv2.NewWebAclRuleGroupAssociation(ctx, "example", &wafv2.WebAclRuleGroupAssociationArgs{
			RuleGroupReference: &wafv2.WebAclRuleGroupAssociationRuleGroupReferenceArgs{
				Arn: pulumi.Any(exampleAwsWafv2RuleGroup.Arn),
			},
			RuleName:  pulumi.String("cloudfront-rule-group-rule"),
			Priority:  pulumi.Int(50),
			WebAclArn: pulumi.Any(exampleAwsWafv2WebAcl.Arn),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_wafv2_webaclrulegroupassociation" "example" {
  rule_group_reference = {
    arn = exampleAwsWafv2RuleGroup.arn
  }
  rule_name   = "cloudfront-rule-group-rule"
  priority    = 50
  web_acl_arn = exampleAwsWafv2WebAcl.arn
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociation;
import com.pulumi.aws.wafv2.WebAclRuleGroupAssociationArgs;
import com.pulumi.aws.wafv2.inputs.WebAclRuleGroupAssociationRuleGroupReferenceArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new WebAclRuleGroupAssociation("example", WebAclRuleGroupAssociationArgs.builder()
            .ruleGroupReference(WebAclRuleGroupAssociationRuleGroupReferenceArgs.builder()
                .arn(exampleAwsWafv2RuleGroup.arn())
                .build())
            .ruleName("cloudfront-rule-group-rule")
            .priority(50)
            .webAclArn(exampleAwsWafv2WebAcl.arn())
            .build());

    }
}
resources:
  example:
    type: aws:wafv2:WebAclRuleGroupAssociation
    properties:
      ruleGroupReference:
        arn: ${exampleAwsWafv2RuleGroup.arn}
      ruleName: cloudfront-rule-group-rule
      priority: 50
      webAclArn: ${exampleAwsWafv2WebAcl.arn}

Import

Using pulumi import, import WAFv2 web ACL custom rule group associations using WebACLARN,RuleName,RuleGroupType,RuleGroupARN, where RuleGroupType is custom. For example:

$ pulumi import aws:wafv2/webAclRuleGroupAssociation:WebAclRuleGroupAssociation example "arn:aws:wafv2:us-east-1:123456789012:regional/webacl/example-web-acl/12345678-1234-1234-1234-123456789012,example-rule-group-rule,custom,arn:aws:wafv2:us-east-1:123456789012:regional/rulegroup/example-rule-group/87654321-4321-4321-4321-210987654321"

Using pulumi import, import WAFv2 web ACL managed rule group associations using WebACLARN,RuleName,RuleGroupType,VendorName:RuleGroupName[:Version], where RuleGroupType is managed. For example:

$ pulumi import aws:wafv2/webAclRuleGroupAssociation:WebAclRuleGroupAssociation managed_example "arn:aws:wafv2:us-east-1:123456789012:regional/webacl/example-web-acl/12345678-1234-1234-1234-123456789012,aws-common-rule-set,managed,AWS:AWSManagedRulesCommonRuleSet"

Constructors

WebAclRuleGroupAssociation(String name, {WebAclRuleGroupAssociationArgs? args, CustomResourceOptions? options})
Creates a new WebAclRuleGroupAssociation. name The Pulumi resource name. args Arguments used to configure this WebAclRuleGroupAssociation. The set of arguments for WebAclRuleGroupAssociation. options Resource options controlling this resource's behavior.
WebAclRuleGroupAssociation.reference(String urn)
Creates a typed reference to an existing WebAclRuleGroupAssociation resource.

Properties

childResources → Set<Resource>
finalinherited
completionSources ↔ Map<String, IOutputCompletionSource>
latefinalinherited
hashCode → int
The hash code for this object.
no setterinherited
id ↔ Output<String>
getter/setter pairinherited
isCustom → bool
Returns whether this resource is provider-managed.
no setterinherited
isProtected → bool
Returns whether this resource is protected from deletion.
no setterinherited
isRemote → bool
Whether this resource is registered as remote.
no setterinherited
isResourceReference → bool
Whether this instance represents a resource value returned over RPC.
finalinherited
managedRuleGroup ↔ Output<WebAclRuleGroupAssociationManagedRuleGroup?>
Managed Rule Group configuration. One of ruleGroupReference or managedRuleGroup is required. Conflicts with ruleGroupReference. See below.
latefinal
overrideAction ↔ Output<String>
Override action for the rule group. Valid values are none and count. Defaults to none. When set to count, the actions defined in the rule group rules are overridden to count matches instead of blocking or allowing requests.
latefinal
priority ↔ Output<int>
Priority of the rule within the Web ACL. Rules are evaluated in order of priority, with lower numbers evaluated first.
latefinal
region ↔ Output<String>
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
ruleGroupReference ↔ Output<WebAclRuleGroupAssociationRuleGroupReference?>
Custom Rule Group reference configuration. One of ruleGroupReference or managedRuleGroup is required. Conflicts with managedRuleGroup. See below.
latefinal
ruleName ↔ Output<String>
Name of the rule to create in the Web ACL that references the rule group. Must be between 1 and 128 characters.
latefinal
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
timeouts ↔ Output<WebAclRuleGroupAssociationTimeouts?>
latefinal
transformations → List<ResourceTransformation>
Inherited/explicit legacy transformations.
no setterinherited
urn ↔ Output<String>
latefinalinherited
visibilityConfig ↔ Output<WebAclRuleGroupAssociationVisibilityConfig?>
Defines and enables Amazon CloudWatch metrics and web request sample collection. See below.
latefinal
webAclArn ↔ Output<String>
ARN of the Web ACL to associate the Rule Group with.
latefinal

Methods

failId(Object error) → void
Completes this resource ID with an error when registration fails.
inherited
failOutputs(Object error) → void
Completes all output properties with error.
inherited
failUrn(Object error) → void
Completes this resource URN with an error when registration fails.
inherited
getProvider(String moduleMember) → ProviderResource?
Returns provider for moduleMember's package, if configured.
inherited
getResourceName() → String
Returns this resource's logical name.
inherited
getResourceType() → String
Returns this resource's Pulumi type token.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
registerOutput<T>(String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output<T>
Registers a dynamic output property for this resource.
inherited
resolveId(String? value, {required bool isKnown}) → void
Resolves the provider-assigned ID for this resource.
inherited
resolveOutputs(Struct outputs) → void
Resolves all output properties from a monitor response payload.
inherited
resolveUrn(String value) → void
Resolves this resource's URN once assigned by the engine.
inherited
serializeProperties(Map<String, dynamic> properties) → Future<Struct>
Serializes resource properties for RPC transmission.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

get(String name, Input<String> id, {WebAclRuleGroupAssociationState? state, CustomResourceOptions? options}) → WebAclRuleGroupAssociation
Gets an existing WebAclRuleGroupAssociation resource's state with the given name and id.