1. Registry
  2. Packages
  3. Volcenginecc Provider
  4. API Docs
  5. vpc
  6. IpPoolCidrBlock
Viewing docs for volcenginecc v0.0.57
published on Monday, Aug 24, 2026 by Volcengine
volcenginecc logo
Viewing docs for volcenginecc v0.0.57
published on Monday, Aug 24, 2026 by Volcengine

    IP address pool subnet.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as volcenginecc from "@volcengine/pulumi-volcenginecc";
    
    const example = new volcenginecc.vpc.IpPoolCidrBlock("example", {
        ipAddressPoolId: "ippool-xxxxxxxxxxxxxxxxxxxx",
        cidrBlock: "198.51.100.0/28",
    });
    
    import pulumi
    import pulumi_volcenginecc as volcenginecc
    
    example = volcenginecc.vpc.IpPoolCidrBlock("example",
        ip_address_pool_id="ippool-xxxxxxxxxxxxxxxxxxxx",
        cidr_block="198.51.100.0/28")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/volcengine/pulumi-volcenginecc/sdk/go/volcenginecc/vpc"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := vpc.NewIpPoolCidrBlock(ctx, "example", &vpc.IpPoolCidrBlockArgs{
    			IpAddressPoolId: pulumi.String("ippool-xxxxxxxxxxxxxxxxxxxx"),
    			CidrBlock:       pulumi.String("198.51.100.0/28"),
    		})
    		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.Vpc.IpPoolCidrBlock("example", new()
        {
            IpAddressPoolId = "ippool-xxxxxxxxxxxxxxxxxxxx",
            CidrBlock = "198.51.100.0/28",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.volcengine.volcenginecc.vpc.IpPoolCidrBlock;
    import com.volcengine.volcenginecc.vpc.IpPoolCidrBlockArgs;
    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 IpPoolCidrBlock("example", IpPoolCidrBlockArgs.builder()
                .ipAddressPoolId("ippool-xxxxxxxxxxxxxxxxxxxx")
                .cidrBlock("198.51.100.0/28")
                .build());
    
        }
    }
    
    resources:
      example:
        type: volcenginecc:vpc:IpPoolCidrBlock
        properties:
          ipAddressPoolId: ippool-xxxxxxxxxxxxxxxxxxxx
          cidrBlock: 198.51.100.0/28
    
    pulumi {
      required_providers {
        volcenginecc = {
          source = "pulumi/volcenginecc"
        }
      }
    }
    
    resource "volcenginecc_vpc_ippoolcidrblock" "example" {
      ip_address_pool_id = "ippool-xxxxxxxxxxxxxxxxxxxx"
      cidr_block         = "198.51.100.0/28"
    }
    

    Create IpPoolCidrBlock Resource

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

    Constructor syntax

    new IpPoolCidrBlock(name: string, args: IpPoolCidrBlockArgs, opts?: CustomResourceOptions);
    @overload
    def IpPoolCidrBlock(resource_name: str,
                        args: IpPoolCidrBlockArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def IpPoolCidrBlock(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        ip_address_pool_id: Optional[str] = None,
                        cidr_block: Optional[str] = None,
                        cidr_mask: Optional[int] = None)
    func NewIpPoolCidrBlock(ctx *Context, name string, args IpPoolCidrBlockArgs, opts ...ResourceOption) (*IpPoolCidrBlock, error)
    public IpPoolCidrBlock(string name, IpPoolCidrBlockArgs args, CustomResourceOptions? opts = null)
    public IpPoolCidrBlock(String name, IpPoolCidrBlockArgs args)
    public IpPoolCidrBlock(String name, IpPoolCidrBlockArgs args, CustomResourceOptions options)
    
    type: volcenginecc:vpc:IpPoolCidrBlock
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "volcenginecc_vpc_ip_pool_cidr_block" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args IpPoolCidrBlockArgs
    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 IpPoolCidrBlockArgs
    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 IpPoolCidrBlockArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IpPoolCidrBlockArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IpPoolCidrBlockArgs
    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 ipPoolCidrBlockResource = new Volcenginecc.Vpc.IpPoolCidrBlock("ipPoolCidrBlockResource", new()
    {
        IpAddressPoolId = "string",
        CidrBlock = "string",
        CidrMask = 0,
    });
    
    example, err := vpc.NewIpPoolCidrBlock(ctx, "ipPoolCidrBlockResource", &vpc.IpPoolCidrBlockArgs{
    	IpAddressPoolId: pulumi.String("string"),
    	CidrBlock:       pulumi.String("string"),
    	CidrMask:        pulumi.Int(0),
    })
    
    resource "volcenginecc_vpc_ip_pool_cidr_block" "ipPoolCidrBlockResource" {
      lifecycle {
        create_before_destroy = true
      }
      ip_address_pool_id = "string"
      cidr_block         = "string"
      cidr_mask          = 0
    }
    
    var ipPoolCidrBlockResource = new IpPoolCidrBlock("ipPoolCidrBlockResource", IpPoolCidrBlockArgs.builder()
        .ipAddressPoolId("string")
        .cidrBlock("string")
        .cidrMask(0)
        .build());
    
    ip_pool_cidr_block_resource = volcenginecc.vpc.IpPoolCidrBlock("ipPoolCidrBlockResource",
        ip_address_pool_id="string",
        cidr_block="string",
        cidr_mask=0)
    
    const ipPoolCidrBlockResource = new volcenginecc.vpc.IpPoolCidrBlock("ipPoolCidrBlockResource", {
        ipAddressPoolId: "string",
        cidrBlock: "string",
        cidrMask: 0,
    });
    
    type: volcenginecc:vpc:IpPoolCidrBlock
    properties:
        cidrBlock: string
        cidrMask: 0
        ipAddressPoolId: string
    

    IpPoolCidrBlock 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 IpPoolCidrBlock resource accepts the following input properties:

    IpAddressPoolId string
    ID of the IP address pool.
    CidrBlock string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    CidrMask int
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    IpAddressPoolId string
    ID of the IP address pool.
    CidrBlock string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    CidrMask int
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    ip_address_pool_id string
    ID of the IP address pool.
    cidr_block string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidr_mask number
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    ipAddressPoolId String
    ID of the IP address pool.
    cidrBlock String
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidrMask Integer
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    ipAddressPoolId string
    ID of the IP address pool.
    cidrBlock string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidrMask number
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    ip_address_pool_id str
    ID of the IP address pool.
    cidr_block str
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidr_mask int
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    ipAddressPoolId String
    ID of the IP address pool.
    cidrBlock String
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidrMask Number
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.

    Outputs

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

    CreationTime string
    Creation time of the IP address pool subnet.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    TotalIpCount int
    Total number of IP addresses in the IP address pool.
    UsedIpCount int
    Number of used IP addresses in the IP address pool subnet.
    CreationTime string
    Creation time of the IP address pool subnet.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    TotalIpCount int
    Total number of IP addresses in the IP address pool.
    UsedIpCount int
    Number of used IP addresses in the IP address pool subnet.
    creation_time string
    Creation time of the IP address pool subnet.
    id string
    The provider-assigned unique ID for this managed resource.
    status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    total_ip_count number
    Total number of IP addresses in the IP address pool.
    used_ip_count number
    Number of used IP addresses in the IP address pool subnet.
    creationTime String
    Creation time of the IP address pool subnet.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    totalIpCount Integer
    Total number of IP addresses in the IP address pool.
    usedIpCount Integer
    Number of used IP addresses in the IP address pool subnet.
    creationTime string
    Creation time of the IP address pool subnet.
    id string
    The provider-assigned unique ID for this managed resource.
    status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    totalIpCount number
    Total number of IP addresses in the IP address pool.
    usedIpCount number
    Number of used IP addresses in the IP address pool subnet.
    creation_time str
    Creation time of the IP address pool subnet.
    id str
    The provider-assigned unique ID for this managed resource.
    status str
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    total_ip_count int
    Total number of IP addresses in the IP address pool.
    used_ip_count int
    Number of used IP addresses in the IP address pool subnet.
    creationTime String
    Creation time of the IP address pool subnet.
    id String
    The provider-assigned unique ID for this managed resource.
    status String
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    totalIpCount Number
    Total number of IP addresses in the IP address pool.
    usedIpCount Number
    Number of used IP addresses in the IP address pool subnet.

    Look up Existing IpPoolCidrBlock Resource

    Get an existing IpPoolCidrBlock 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?: IpPoolCidrBlockState, opts?: CustomResourceOptions): IpPoolCidrBlock
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            cidr_block: Optional[str] = None,
            cidr_mask: Optional[int] = None,
            creation_time: Optional[str] = None,
            ip_address_pool_id: Optional[str] = None,
            status: Optional[str] = None,
            total_ip_count: Optional[int] = None,
            used_ip_count: Optional[int] = None) -> IpPoolCidrBlock
    func GetIpPoolCidrBlock(ctx *Context, name string, id IDInput, state *IpPoolCidrBlockState, opts ...ResourceOption) (*IpPoolCidrBlock, error)
    public static IpPoolCidrBlock Get(string name, Input<string> id, IpPoolCidrBlockState? state, CustomResourceOptions? opts = null)
    public static IpPoolCidrBlock get(String name, Output<String> id, IpPoolCidrBlockState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:vpc:IpPoolCidrBlock    get:      id: ${id}
    import {
      to = volcenginecc_vpc_ip_pool_cidr_block.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:
    CidrBlock string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    CidrMask int
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    CreationTime string
    Creation time of the IP address pool subnet.
    IpAddressPoolId string
    ID of the IP address pool.
    Status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    TotalIpCount int
    Total number of IP addresses in the IP address pool.
    UsedIpCount int
    Number of used IP addresses in the IP address pool subnet.
    CidrBlock string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    CidrMask int
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    CreationTime string
    Creation time of the IP address pool subnet.
    IpAddressPoolId string
    ID of the IP address pool.
    Status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    TotalIpCount int
    Total number of IP addresses in the IP address pool.
    UsedIpCount int
    Number of used IP addresses in the IP address pool subnet.
    cidr_block string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidr_mask number
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    creation_time string
    Creation time of the IP address pool subnet.
    ip_address_pool_id string
    ID of the IP address pool.
    status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    total_ip_count number
    Total number of IP addresses in the IP address pool.
    used_ip_count number
    Number of used IP addresses in the IP address pool subnet.
    cidrBlock String
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidrMask Integer
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    creationTime String
    Creation time of the IP address pool subnet.
    ipAddressPoolId String
    ID of the IP address pool.
    status String
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    totalIpCount Integer
    Total number of IP addresses in the IP address pool.
    usedIpCount Integer
    Number of used IP addresses in the IP address pool subnet.
    cidrBlock string
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidrMask number
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    creationTime string
    Creation time of the IP address pool subnet.
    ipAddressPoolId string
    ID of the IP address pool.
    status string
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    totalIpCount number
    Total number of IP addresses in the IP address pool.
    usedIpCount number
    Number of used IP addresses in the IP address pool subnet.
    cidr_block str
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidr_mask int
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    creation_time str
    Creation time of the IP address pool subnet.
    ip_address_pool_id str
    ID of the IP address pool.
    status str
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    total_ip_count int
    Total number of IP addresses in the IP address pool.
    used_ip_count int
    Number of used IP addresses in the IP address pool subnet.
    cidrBlock String
    IP address subnet. Only IPv4 subnets are supported and cannot start with 0; mask value range is 23 to 30. Only one of CidrBlock or CidrMask can be configured during creation.
    cidrMask Number
    IP address subnet mask; value range is 24 to 28. After entering the mask, the IP address subnet will be automatically assigned. Only one of CidrBlock or CidrMask can be configured during creation.
    creationTime String
    Creation time of the IP address pool subnet.
    ipAddressPoolId String
    ID of the IP address pool.
    status String
    Status of the IP address pool subnet. Creating: In progress. Available: Available. Deleting: In progress. Pending: Configuring.
    totalIpCount Number
    Total number of IP addresses in the IP address pool.
    usedIpCount Number
    Number of used IP addresses in the IP address pool subnet.

    Import

    $ pulumi import volcenginecc:vpc/ipPoolCidrBlock:IpPoolCidrBlock example "ip_address_pool_id|cidr_block"
    

    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.57
    published on Monday, Aug 24, 2026 by Volcengine

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial