1. Packages
  2. AWS
  3. API Docs
  4. wafv2
  5. getManagedRuleGroup
Viewing docs for AWS v7.22.0
published on Wednesday, Mar 11, 2026 by Pulumi
aws logo
Viewing docs for AWS v7.22.0
published on Wednesday, Mar 11, 2026 by Pulumi

    High-level information for a managed rule group.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const example = aws.wafv2.getManagedRuleGroup({
        name: "AWSManagedRulesCommonRuleSet",
        scope: "REGIONAL",
        vendorName: "AWS",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    example = aws.wafv2.get_managed_rule_group(name="AWSManagedRulesCommonRuleSet",
        scope="REGIONAL",
        vendor_name="AWS")
    
    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.GetManagedRuleGroup(ctx, &wafv2.GetManagedRuleGroupArgs{
    			Name:       "AWSManagedRulesCommonRuleSet",
    			Scope:      "REGIONAL",
    			VendorName: "AWS",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Aws.WafV2.GetManagedRuleGroup.Invoke(new()
        {
            Name = "AWSManagedRulesCommonRuleSet",
            Scope = "REGIONAL",
            VendorName = "AWS",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.wafv2.Wafv2Functions;
    import com.pulumi.aws.wafv2.inputs.GetManagedRuleGroupArgs;
    import java.util.List;
    import java.util.ArrayList;
    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) {
            final var example = Wafv2Functions.getManagedRuleGroup(GetManagedRuleGroupArgs.builder()
                .name("AWSManagedRulesCommonRuleSet")
                .scope("REGIONAL")
                .vendorName("AWS")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: aws:wafv2:getManagedRuleGroup
          arguments:
            name: AWSManagedRulesCommonRuleSet
            scope: REGIONAL
            vendorName: AWS
    

    Using getManagedRuleGroup

    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 getManagedRuleGroup(args: GetManagedRuleGroupArgs, opts?: InvokeOptions): Promise<GetManagedRuleGroupResult>
    function getManagedRuleGroupOutput(args: GetManagedRuleGroupOutputArgs, opts?: InvokeOptions): Output<GetManagedRuleGroupResult>
    def get_managed_rule_group(name: Optional[str] = None,
                               region: Optional[str] = None,
                               scope: Optional[str] = None,
                               vendor_name: Optional[str] = None,
                               version_name: Optional[str] = None,
                               opts: Optional[InvokeOptions] = None) -> GetManagedRuleGroupResult
    def get_managed_rule_group_output(name: Optional[pulumi.Input[str]] = None,
                               region: Optional[pulumi.Input[str]] = None,
                               scope: Optional[pulumi.Input[str]] = None,
                               vendor_name: Optional[pulumi.Input[str]] = None,
                               version_name: Optional[pulumi.Input[str]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetManagedRuleGroupResult]
    func GetManagedRuleGroup(ctx *Context, args *GetManagedRuleGroupArgs, opts ...InvokeOption) (*GetManagedRuleGroupResult, error)
    func GetManagedRuleGroupOutput(ctx *Context, args *GetManagedRuleGroupOutputArgs, opts ...InvokeOption) GetManagedRuleGroupResultOutput

    > Note: This function is named GetManagedRuleGroup in the Go SDK.

    public static class GetManagedRuleGroup 
    {
        public static Task<GetManagedRuleGroupResult> InvokeAsync(GetManagedRuleGroupArgs args, InvokeOptions? opts = null)
        public static Output<GetManagedRuleGroupResult> Invoke(GetManagedRuleGroupInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetManagedRuleGroupResult> getManagedRuleGroup(GetManagedRuleGroupArgs args, InvokeOptions options)
    public static Output<GetManagedRuleGroupResult> getManagedRuleGroup(GetManagedRuleGroupArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws:wafv2/getManagedRuleGroup:getManagedRuleGroup
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Name string
    Managed rule group name.
    Scope string
    Whether this is for a global resource type, such as a Amazon CloudFront distribution. For an AWS Amplify application, use CLOUDFRONT. Valid values: CLOUDFRONT, REGIONAL.
    VendorName string
    Managed rule group vendor name.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    VersionName string
    Version of the rule group.
    Name string
    Managed rule group name.
    Scope string
    Whether this is for a global resource type, such as a Amazon CloudFront distribution. For an AWS Amplify application, use CLOUDFRONT. Valid values: CLOUDFRONT, REGIONAL.
    VendorName string
    Managed rule group vendor name.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    VersionName string
    Version of the rule group.
    name String
    Managed rule group name.
    scope String
    Whether this is for a global resource type, such as a Amazon CloudFront distribution. For an AWS Amplify application, use CLOUDFRONT. Valid values: CLOUDFRONT, REGIONAL.
    vendorName String
    Managed rule group vendor name.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    versionName String
    Version of the rule group.
    name string
    Managed rule group name.
    scope string
    Whether this is for a global resource type, such as a Amazon CloudFront distribution. For an AWS Amplify application, use CLOUDFRONT. Valid values: CLOUDFRONT, REGIONAL.
    vendorName string
    Managed rule group vendor name.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    versionName string
    Version of the rule group.
    name str
    Managed rule group name.
    scope str
    Whether this is for a global resource type, such as a Amazon CloudFront distribution. For an AWS Amplify application, use CLOUDFRONT. Valid values: CLOUDFRONT, REGIONAL.
    vendor_name str
    Managed rule group vendor name.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    version_name str
    Version of the rule group.
    name String
    Managed rule group name.
    scope String
    Whether this is for a global resource type, such as a Amazon CloudFront distribution. For an AWS Amplify application, use CLOUDFRONT. Valid values: CLOUDFRONT, REGIONAL.
    vendorName String
    Managed rule group vendor name.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    versionName String
    Version of the rule group.

    getManagedRuleGroup Result

    The following output properties are available:

    AvailableLabels List<GetManagedRuleGroupAvailableLabel>
    Labels that one or more rules in this rule group add to matching web requests. See Labels below for details.
    Capacity int
    WCUs required for this rule group.
    ConsumedLabels List<GetManagedRuleGroupConsumedLabel>
    Labels that one or more rules in this rule group match against in label match statements. See Labels below for details.
    Id string
    The provider-assigned unique ID for this managed resource.
    LabelNamespace string
    Label namespace prefix for this rule group. All labels added by rules in this rule group have this prefix.
    Name string
    Name of the rule.
    Region string
    Rules List<GetManagedRuleGroupRule>
    High-level information about the rules. See Rules below for details.
    Scope string
    SnsTopicArn string
    ARN of the SNS topic that's used to provide notification of changes to the managed rule group.
    VendorName string
    VersionName string
    AvailableLabels []GetManagedRuleGroupAvailableLabel
    Labels that one or more rules in this rule group add to matching web requests. See Labels below for details.
    Capacity int
    WCUs required for this rule group.
    ConsumedLabels []GetManagedRuleGroupConsumedLabel
    Labels that one or more rules in this rule group match against in label match statements. See Labels below for details.
    Id string
    The provider-assigned unique ID for this managed resource.
    LabelNamespace string
    Label namespace prefix for this rule group. All labels added by rules in this rule group have this prefix.
    Name string
    Name of the rule.
    Region string
    Rules []GetManagedRuleGroupRule
    High-level information about the rules. See Rules below for details.
    Scope string
    SnsTopicArn string
    ARN of the SNS topic that's used to provide notification of changes to the managed rule group.
    VendorName string
    VersionName string
    availableLabels List<GetManagedRuleGroupAvailableLabel>
    Labels that one or more rules in this rule group add to matching web requests. See Labels below for details.
    capacity Integer
    WCUs required for this rule group.
    consumedLabels List<GetManagedRuleGroupConsumedLabel>
    Labels that one or more rules in this rule group match against in label match statements. See Labels below for details.
    id String
    The provider-assigned unique ID for this managed resource.
    labelNamespace String
    Label namespace prefix for this rule group. All labels added by rules in this rule group have this prefix.
    name String
    Name of the rule.
    region String
    rules List<GetManagedRuleGroupRule>
    High-level information about the rules. See Rules below for details.
    scope String
    snsTopicArn String
    ARN of the SNS topic that's used to provide notification of changes to the managed rule group.
    vendorName String
    versionName String
    availableLabels GetManagedRuleGroupAvailableLabel[]
    Labels that one or more rules in this rule group add to matching web requests. See Labels below for details.
    capacity number
    WCUs required for this rule group.
    consumedLabels GetManagedRuleGroupConsumedLabel[]
    Labels that one or more rules in this rule group match against in label match statements. See Labels below for details.
    id string
    The provider-assigned unique ID for this managed resource.
    labelNamespace string
    Label namespace prefix for this rule group. All labels added by rules in this rule group have this prefix.
    name string
    Name of the rule.
    region string
    rules GetManagedRuleGroupRule[]
    High-level information about the rules. See Rules below for details.
    scope string
    snsTopicArn string
    ARN of the SNS topic that's used to provide notification of changes to the managed rule group.
    vendorName string
    versionName string
    available_labels Sequence[GetManagedRuleGroupAvailableLabel]
    Labels that one or more rules in this rule group add to matching web requests. See Labels below for details.
    capacity int
    WCUs required for this rule group.
    consumed_labels Sequence[GetManagedRuleGroupConsumedLabel]
    Labels that one or more rules in this rule group match against in label match statements. See Labels below for details.
    id str
    The provider-assigned unique ID for this managed resource.
    label_namespace str
    Label namespace prefix for this rule group. All labels added by rules in this rule group have this prefix.
    name str
    Name of the rule.
    region str
    rules Sequence[GetManagedRuleGroupRule]
    High-level information about the rules. See Rules below for details.
    scope str
    sns_topic_arn str
    ARN of the SNS topic that's used to provide notification of changes to the managed rule group.
    vendor_name str
    version_name str
    availableLabels List<Property Map>
    Labels that one or more rules in this rule group add to matching web requests. See Labels below for details.
    capacity Number
    WCUs required for this rule group.
    consumedLabels List<Property Map>
    Labels that one or more rules in this rule group match against in label match statements. See Labels below for details.
    id String
    The provider-assigned unique ID for this managed resource.
    labelNamespace String
    Label namespace prefix for this rule group. All labels added by rules in this rule group have this prefix.
    name String
    Name of the rule.
    region String
    rules List<Property Map>
    High-level information about the rules. See Rules below for details.
    scope String
    snsTopicArn String
    ARN of the SNS topic that's used to provide notification of changes to the managed rule group.
    vendorName String
    versionName String

    Supporting Types

    GetManagedRuleGroupAvailableLabel

    Name string
    Managed rule group name.
    Name string
    Managed rule group name.
    name String
    Managed rule group name.
    name string
    Managed rule group name.
    name str
    Managed rule group name.
    name String
    Managed rule group name.

    GetManagedRuleGroupConsumedLabel

    Name string
    Managed rule group name.
    Name string
    Managed rule group name.
    name String
    Managed rule group name.
    name string
    Managed rule group name.
    name str
    Managed rule group name.
    name String
    Managed rule group name.

    GetManagedRuleGroupRule

    Actions List<GetManagedRuleGroupRuleAction>
    Action taken on a web request when it matches a rule's statement. See action_to_use for details.
    Name string
    Managed rule group name.
    Actions []GetManagedRuleGroupRuleAction
    Action taken on a web request when it matches a rule's statement. See action_to_use for details.
    Name string
    Managed rule group name.
    actions List<GetManagedRuleGroupRuleAction>
    Action taken on a web request when it matches a rule's statement. See action_to_use for details.
    name String
    Managed rule group name.
    actions GetManagedRuleGroupRuleAction[]
    Action taken on a web request when it matches a rule's statement. See action_to_use for details.
    name string
    Managed rule group name.
    actions Sequence[GetManagedRuleGroupRuleAction]
    Action taken on a web request when it matches a rule's statement. See action_to_use for details.
    name str
    Managed rule group name.
    actions List<Property Map>
    Action taken on a web request when it matches a rule's statement. See action_to_use for details.
    name String
    Managed rule group name.

    GetManagedRuleGroupRuleAction

    GetManagedRuleGroupRuleActionAllow

    GetManagedRuleGroupRuleActionAllowCustomRequestHandling

    GetManagedRuleGroupRuleActionAllowCustomRequestHandlingInsertHeader

    Name string
    Managed rule group name.
    Value string
    Name string
    Managed rule group name.
    Value string
    name String
    Managed rule group name.
    value String
    name string
    Managed rule group name.
    value string
    name str
    Managed rule group name.
    value str
    name String
    Managed rule group name.
    value String

    GetManagedRuleGroupRuleActionBlock

    GetManagedRuleGroupRuleActionBlockCustomResponse

    GetManagedRuleGroupRuleActionBlockCustomResponseResponseHeader

    Name string
    Managed rule group name.
    Value string
    Name string
    Managed rule group name.
    Value string
    name String
    Managed rule group name.
    value String
    name string
    Managed rule group name.
    value string
    name str
    Managed rule group name.
    value str
    name String
    Managed rule group name.
    value String

    GetManagedRuleGroupRuleActionCaptcha

    GetManagedRuleGroupRuleActionCaptchaCustomRequestHandling

    GetManagedRuleGroupRuleActionCaptchaCustomRequestHandlingInsertHeader

    Name string
    Managed rule group name.
    Value string
    Name string
    Managed rule group name.
    Value string
    name String
    Managed rule group name.
    value String
    name string
    Managed rule group name.
    value string
    name str
    Managed rule group name.
    value str
    name String
    Managed rule group name.
    value String

    GetManagedRuleGroupRuleActionChallenge

    GetManagedRuleGroupRuleActionChallengeCustomRequestHandling

    GetManagedRuleGroupRuleActionChallengeCustomRequestHandlingInsertHeader

    Name string
    Managed rule group name.
    Value string
    Name string
    Managed rule group name.
    Value string
    name String
    Managed rule group name.
    value String
    name string
    Managed rule group name.
    value string
    name str
    Managed rule group name.
    value str
    name String
    Managed rule group name.
    value String

    GetManagedRuleGroupRuleActionCount

    GetManagedRuleGroupRuleActionCountCustomRequestHandling

    GetManagedRuleGroupRuleActionCountCustomRequestHandlingInsertHeader

    Name string
    Managed rule group name.
    Value string
    Name string
    Managed rule group name.
    Value string
    name String
    Managed rule group name.
    value String
    name string
    Managed rule group name.
    value string
    name str
    Managed rule group name.
    value str
    name String
    Managed rule group name.
    value String

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    Viewing docs for AWS v7.22.0
    published on Wednesday, Mar 11, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.