1. Registry
  2. Packages
  3. Volcenginecc Provider
  4. API Docs
  5. waf
  6. IpGroup
Viewing docs for volcenginecc v0.0.60
published on Thursday, Sep 3, 2026 by Volcengine
volcenginecc logo
Viewing docs for volcenginecc v0.0.60
published on Thursday, Sep 3, 2026 by Volcengine

    WAF IP Address Group

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcenginecc from "@volcengine/pulumi-volcenginecc";
    
    const example = new volcenginecc.waf.IpGroup("example", {
        name: "ccapi-ipgroup-full",
        ipLists: [
            "2.2.2.2",
            "10.0.0.0/8",
        ],
    });
    
    import pulumi
    import pulumi_volcenginecc as volcenginecc
    
    example = volcenginecc.waf.IpGroup("example",
        name="ccapi-ipgroup-full",
        ip_lists=[
            "2.2.2.2",
            "10.0.0.0/8",
        ])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/volcengine/pulumi-volcenginecc/sdk/go/volcenginecc/waf"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := waf.NewIpGroup(ctx, "example", &waf.IpGroupArgs{
    			Name: pulumi.String("ccapi-ipgroup-full"),
    			IpLists: pulumi.StringArray{
    				pulumi.String("2.2.2.2"),
    				pulumi.String("10.0.0.0/8"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Volcenginecc = Volcengine.Pulumi.Volcenginecc;
    
    return await Deployment.RunAsync(() => 
    {
        var example = new Volcenginecc.Waf.IpGroup("example", new()
        {
            Name = "ccapi-ipgroup-full",
            IpLists = new[]
            {
                "2.2.2.2",
                "10.0.0.0/8",
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.volcengine.volcenginecc.waf.IpGroup;
    import com.volcengine.volcenginecc.waf.IpGroupArgs;
    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 IpGroup("example", IpGroupArgs.builder()
                .name("ccapi-ipgroup-full")
                .ipLists(            
                    "2.2.2.2",
                    "10.0.0.0/8")
                .build());
    
        }
    }
    
    resources:
      example:
        type: volcenginecc:waf:IpGroup
        properties:
          name: ccapi-ipgroup-full
          ipLists:
            - 2.2.2.2
            - 10.0.0.0/8
    
    pulumi {
      required_providers {
        volcenginecc = {
          source = "pulumi/volcenginecc"
        }
      }
    }
    
    resource "volcenginecc_waf_ipgroup" "example" {
      name     = "ccapi-ipgroup-full"
      ip_lists = ["2.2.2.2", "10.0.0.0/8"]
    }
    

    Create IpGroup Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new IpGroup(name: string, args: IpGroupArgs, opts?: CustomResourceOptions);
    @overload
    def IpGroup(resource_name: str,
                args: IpGroupArgs,
                opts: Optional[ResourceOptions] = None)
    
    @overload
    def IpGroup(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                ip_lists: Optional[Sequence[str]] = None,
                name: Optional[str] = None)
    func NewIpGroup(ctx *Context, name string, args IpGroupArgs, opts ...ResourceOption) (*IpGroup, error)
    public IpGroup(string name, IpGroupArgs args, CustomResourceOptions? opts = null)
    public IpGroup(String name, IpGroupArgs args)
    public IpGroup(String name, IpGroupArgs args, CustomResourceOptions options)
    
    type: volcenginecc:waf:IpGroup
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "volcenginecc_waf_ip_group" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args IpGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args IpGroupArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args IpGroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IpGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IpGroupArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var ipGroupResource = new Volcenginecc.Waf.IpGroup("ipGroupResource", new()
    {
        IpLists = new[]
        {
            "string",
        },
        Name = "string",
    });
    
    example, err := waf.NewIpGroup(ctx, "ipGroupResource", &waf.IpGroupArgs{
    	IpLists: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Name: pulumi.String("string"),
    })
    
    resource "volcenginecc_waf_ip_group" "ipGroupResource" {
      lifecycle {
        create_before_destroy = true
      }
      ip_lists = ["string"]
      name     = "string"
    }
    
    var ipGroupResource = new IpGroup("ipGroupResource", IpGroupArgs.builder()
        .ipLists("string")
        .name("string")
        .build());
    
    ip_group_resource = volcenginecc.waf.IpGroup("ipGroupResource",
        ip_lists=["string"],
        name="string")
    
    const ipGroupResource = new volcenginecc.waf.IpGroup("ipGroupResource", {
        ipLists: ["string"],
        name: "string",
    });
    
    type: volcenginecc:waf:IpGroup
    properties:
        ipLists:
            - string
        name: string
    

    IpGroup Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The IpGroup resource accepts the following input properties:

    IpLists List<string>
    IP Address or Address Range List
    Name string
    IP Address Group Name
    IpLists []string
    IP Address or Address Range List
    Name string
    IP Address Group Name
    ip_lists list(string)
    IP Address or Address Range List
    name string
    IP Address Group Name
    ipLists List<String>
    IP Address or Address Range List
    name String
    IP Address Group Name
    ipLists string[]
    IP Address or Address Range List
    name string
    IP Address Group Name
    ip_lists Sequence[str]
    IP Address or Address Range List
    name str
    IP Address Group Name
    ipLists List<String>
    IP Address or Address Range List
    name String
    IP Address Group Name

    Outputs

    All input properties are implicitly available as output properties. Additionally, the IpGroup resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    IpCount int
    Number of IPs in the IP Address Group
    IpGroupId string
    IP Address Group ID
    RelatedRules List<Volcengine.IpGroupRelatedRule>
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    UpdateTime string
    Last Updated
    Id string
    The provider-assigned unique ID for this managed resource.
    IpCount int
    Number of IPs in the IP Address Group
    IpGroupId string
    IP Address Group ID
    RelatedRules []IpGroupRelatedRule
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    UpdateTime string
    Last Updated
    id string
    The provider-assigned unique ID for this managed resource.
    ip_count number
    Number of IPs in the IP Address Group
    ip_group_id string
    IP Address Group ID
    related_rules list(object)
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    update_time string
    Last Updated
    id String
    The provider-assigned unique ID for this managed resource.
    ipCount Integer
    Number of IPs in the IP Address Group
    ipGroupId String
    IP Address Group ID
    relatedRules List<IpGroupRelatedRule>
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updateTime String
    Last Updated
    id string
    The provider-assigned unique ID for this managed resource.
    ipCount number
    Number of IPs in the IP Address Group
    ipGroupId string
    IP Address Group ID
    relatedRules IpGroupRelatedRule[]
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updateTime string
    Last Updated
    id str
    The provider-assigned unique ID for this managed resource.
    ip_count int
    Number of IPs in the IP Address Group
    ip_group_id str
    IP Address Group ID
    related_rules Sequence[IpGroupRelatedRule]
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    update_time str
    Last Updated
    id String
    The provider-assigned unique ID for this managed resource.
    ipCount Number
    Number of IPs in the IP Address Group
    ipGroupId String
    IP Address Group ID
    relatedRules List<Property Map>
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updateTime String
    Last Updated

    Look up Existing IpGroup Resource

    Get an existing IpGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: IpGroupState, opts?: CustomResourceOptions): IpGroup
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            ip_count: Optional[int] = None,
            ip_group_id: Optional[str] = None,
            ip_lists: Optional[Sequence[str]] = None,
            name: Optional[str] = None,
            related_rules: Optional[Sequence[IpGroupRelatedRuleArgs]] = None,
            update_time: Optional[str] = None) -> IpGroup
    func GetIpGroup(ctx *Context, name string, id IDInput, state *IpGroupState, opts ...ResourceOption) (*IpGroup, error)
    public static IpGroup Get(string name, Input<string> id, IpGroupState? state, CustomResourceOptions? opts = null)
    public static IpGroup get(String name, Output<String> id, IpGroupState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:waf:IpGroup    get:      id: ${id}
    import {
      to = volcenginecc_waf_ip_group.example
      id = "${id}"
    }
    
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    IpCount int
    Number of IPs in the IP Address Group
    IpGroupId string
    IP Address Group ID
    IpLists List<string>
    IP Address or Address Range List
    Name string
    IP Address Group Name
    RelatedRules List<Volcengine.IpGroupRelatedRule>
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    UpdateTime string
    Last Updated
    IpCount int
    Number of IPs in the IP Address Group
    IpGroupId string
    IP Address Group ID
    IpLists []string
    IP Address or Address Range List
    Name string
    IP Address Group Name
    RelatedRules []IpGroupRelatedRuleArgs
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    UpdateTime string
    Last Updated
    ip_count number
    Number of IPs in the IP Address Group
    ip_group_id string
    IP Address Group ID
    ip_lists list(string)
    IP Address or Address Range List
    name string
    IP Address Group Name
    related_rules list(object)
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    update_time string
    Last Updated
    ipCount Integer
    Number of IPs in the IP Address Group
    ipGroupId String
    IP Address Group ID
    ipLists List<String>
    IP Address or Address Range List
    name String
    IP Address Group Name
    relatedRules List<IpGroupRelatedRule>
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updateTime String
    Last Updated
    ipCount number
    Number of IPs in the IP Address Group
    ipGroupId string
    IP Address Group ID
    ipLists string[]
    IP Address or Address Range List
    name string
    IP Address Group Name
    relatedRules IpGroupRelatedRule[]
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updateTime string
    Last Updated
    ip_count int
    Number of IPs in the IP Address Group
    ip_group_id str
    IP Address Group ID
    ip_lists Sequence[str]
    IP Address or Address Range List
    name str
    IP Address Group Name
    related_rules Sequence[IpGroupRelatedRuleArgs]
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    update_time str
    Last Updated
    ipCount Number
    Number of IPs in the IP Address Group
    ipGroupId String
    IP Address Group ID
    ipLists List<String>
    IP Address or Address Range List
    name String
    IP Address Group Name
    relatedRules List<Property Map>
    Associated Rule Important Note: When using SetNestedAttribute, you must fully define all attributes of its nested structure. Incomplete definitions may cause Terraform to detect unexpected differences during plan comparison, triggering unnecessary resource updates and affecting resource stability and predictability.
    updateTime String
    Last Updated

    Supporting Types

    IpGroupRelatedRule, IpGroupRelatedRuleArgs

    RuleName string
    Rule Name
    RuleTag string
    Rule ID
    RuleType string
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.
    RuleName string
    Rule Name
    RuleTag string
    Rule ID
    RuleType string
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.
    rule_name string
    Rule Name
    rule_tag string
    Rule ID
    rule_type string
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.
    ruleName String
    Rule Name
    ruleTag String
    Rule ID
    ruleType String
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.
    ruleName string
    Rule Name
    ruleTag string
    Rule ID
    ruleType string
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.
    rule_name str
    Rule Name
    rule_tag str
    Rule ID
    rule_type str
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.
    ruleName String
    Rule Name
    ruleTag String
    Rule ID
    ruleType String
    Rule type. Allow indicates an allowlist; Block indicates a blocklist.

    Import

    $ pulumi import volcenginecc:waf/ipGroup:IpGroup example "ip_group_id"
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    volcenginecc volcengine/pulumi-volcenginecc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the volcenginecc Terraform Provider.
    volcenginecc logo
    Viewing docs for volcenginecc v0.0.60
    published on Thursday, Sep 3, 2026 by Volcengine

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial