1. Packages
  2. Ibm Provider
  3. API Docs
  4. IsPublicAddressRange
ibm 1.81.1 published on Wednesday, Aug 6, 2025 by ibm-cloud

ibm.IsPublicAddressRange

Explore with Pulumi AI

ibm logo
ibm 1.81.1 published on Wednesday, Aug 6, 2025 by ibm-cloud

    Create, update, and delete a public address range. For more information, see creating public address range.

    Note: The Public Address Range feature is currently available only with the Select Availability.

    Note: VPC infrastructure services are a regional specific based endpoint, by default targets to us-south. Please make sure to target right region in the provider block as shown in the provider.tf file, if VPC service is created in region other than us-south.

    provider.tf

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    
    return await Deployment.RunAsync(() => 
    {
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    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) {
        }
    }
    
    {}
    

    Example Usage

    The following example shows how you can create a public address range for a vpc that are located in a specific zone.

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const publicAddressRangeInstance = new ibm.IsPublicAddressRange("publicAddressRangeInstance", {
        ipv4AddressCount: 16,
        resourceGroup: {
            id: "11caaa983d9c4beb82690daab18717e9",
        },
        target: {
            vpc: {
                id: ibm_is_vpc.testacc_vpc.id,
            },
            zone: {
                name: "us-south-3",
            },
        },
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    public_address_range_instance = ibm.IsPublicAddressRange("publicAddressRangeInstance",
        ipv4_address_count=16,
        resource_group={
            "id": "11caaa983d9c4beb82690daab18717e9",
        },
        target={
            "vpc": {
                "id": ibm_is_vpc["testacc_vpc"]["id"],
            },
            "zone": {
                "name": "us-south-3",
            },
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.NewIsPublicAddressRange(ctx, "publicAddressRangeInstance", &ibm.IsPublicAddressRangeArgs{
    			Ipv4AddressCount: pulumi.Float64(16),
    			ResourceGroup: &ibm.IsPublicAddressRangeResourceGroupArgs{
    				Id: pulumi.String("11caaa983d9c4beb82690daab18717e9"),
    			},
    			Target: &ibm.IsPublicAddressRangeTargetArgs{
    				Vpc: &ibm.IsPublicAddressRangeTargetVpcArgs{
    					Id: pulumi.Any(ibm_is_vpc.Testacc_vpc.Id),
    				},
    				Zone: &ibm.IsPublicAddressRangeTargetZoneArgs{
    					Name: pulumi.String("us-south-3"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var publicAddressRangeInstance = new Ibm.IsPublicAddressRange("publicAddressRangeInstance", new()
        {
            Ipv4AddressCount = 16,
            ResourceGroup = new Ibm.Inputs.IsPublicAddressRangeResourceGroupArgs
            {
                Id = "11caaa983d9c4beb82690daab18717e9",
            },
            Target = new Ibm.Inputs.IsPublicAddressRangeTargetArgs
            {
                Vpc = new Ibm.Inputs.IsPublicAddressRangeTargetVpcArgs
                {
                    Id = ibm_is_vpc.Testacc_vpc.Id,
                },
                Zone = new Ibm.Inputs.IsPublicAddressRangeTargetZoneArgs
                {
                    Name = "us-south-3",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsPublicAddressRange;
    import com.pulumi.ibm.IsPublicAddressRangeArgs;
    import com.pulumi.ibm.inputs.IsPublicAddressRangeResourceGroupArgs;
    import com.pulumi.ibm.inputs.IsPublicAddressRangeTargetArgs;
    import com.pulumi.ibm.inputs.IsPublicAddressRangeTargetVpcArgs;
    import com.pulumi.ibm.inputs.IsPublicAddressRangeTargetZoneArgs;
    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) {
            var publicAddressRangeInstance = new IsPublicAddressRange("publicAddressRangeInstance", IsPublicAddressRangeArgs.builder()
                .ipv4AddressCount("16")
                .resourceGroup(IsPublicAddressRangeResourceGroupArgs.builder()
                    .id("11caaa983d9c4beb82690daab18717e9")
                    .build())
                .target(IsPublicAddressRangeTargetArgs.builder()
                    .vpc(IsPublicAddressRangeTargetVpcArgs.builder()
                        .id(ibm_is_vpc.testacc_vpc().id())
                        .build())
                    .zone(IsPublicAddressRangeTargetZoneArgs.builder()
                        .name("us-south-3")
                        .build())
                    .build())
                .build());
    
        }
    }
    
    resources:
      publicAddressRangeInstance:
        type: ibm:IsPublicAddressRange
        properties:
          ipv4AddressCount: '16'
          resourceGroup:
            id: 11caaa983d9c4beb82690daab18717e9
          target:
            vpc:
              id: ${ibm_is_vpc.testacc_vpc.id}
            zone:
              name: us-south-3
    

    An example shows how you can create public address range not attached to vpc and zone

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const publicAddressRangeInstance = new ibm.IsPublicAddressRange("publicAddressRangeInstance", {
        ipv4AddressCount: 16,
        resourceGroup: {
            id: "11caaa983d9c4beb82690daab08717e9",
        },
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    public_address_range_instance = ibm.IsPublicAddressRange("publicAddressRangeInstance",
        ipv4_address_count=16,
        resource_group={
            "id": "11caaa983d9c4beb82690daab08717e9",
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ibm.NewIsPublicAddressRange(ctx, "publicAddressRangeInstance", &ibm.IsPublicAddressRangeArgs{
    			Ipv4AddressCount: pulumi.Float64(16),
    			ResourceGroup: &ibm.IsPublicAddressRangeResourceGroupArgs{
    				Id: pulumi.String("11caaa983d9c4beb82690daab08717e9"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ibm = Pulumi.Ibm;
    
    return await Deployment.RunAsync(() => 
    {
        var publicAddressRangeInstance = new Ibm.IsPublicAddressRange("publicAddressRangeInstance", new()
        {
            Ipv4AddressCount = 16,
            ResourceGroup = new Ibm.Inputs.IsPublicAddressRangeResourceGroupArgs
            {
                Id = "11caaa983d9c4beb82690daab08717e9",
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IsPublicAddressRange;
    import com.pulumi.ibm.IsPublicAddressRangeArgs;
    import com.pulumi.ibm.inputs.IsPublicAddressRangeResourceGroupArgs;
    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) {
            var publicAddressRangeInstance = new IsPublicAddressRange("publicAddressRangeInstance", IsPublicAddressRangeArgs.builder()
                .ipv4AddressCount("16")
                .resourceGroup(IsPublicAddressRangeResourceGroupArgs.builder()
                    .id("11caaa983d9c4beb82690daab08717e9")
                    .build())
                .build());
    
        }
    }
    
    resources:
      publicAddressRangeInstance:
        type: ibm:IsPublicAddressRange
        properties:
          ipv4AddressCount: '16'
          resourceGroup:
            id: 11caaa983d9c4beb82690daab08717e9
    

    Create IsPublicAddressRange Resource

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

    Constructor syntax

    new IsPublicAddressRange(name: string, args: IsPublicAddressRangeArgs, opts?: CustomResourceOptions);
    @overload
    def IsPublicAddressRange(resource_name: str,
                             args: IsPublicAddressRangeArgs,
                             opts: Optional[ResourceOptions] = None)
    
    @overload
    def IsPublicAddressRange(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             ipv4_address_count: Optional[float] = None,
                             access_tags: Optional[Sequence[str]] = None,
                             is_public_address_range_id: Optional[str] = None,
                             name: Optional[str] = None,
                             resource_group: Optional[IsPublicAddressRangeResourceGroupArgs] = None,
                             tags: Optional[Sequence[str]] = None,
                             target: Optional[IsPublicAddressRangeTargetArgs] = None)
    func NewIsPublicAddressRange(ctx *Context, name string, args IsPublicAddressRangeArgs, opts ...ResourceOption) (*IsPublicAddressRange, error)
    public IsPublicAddressRange(string name, IsPublicAddressRangeArgs args, CustomResourceOptions? opts = null)
    public IsPublicAddressRange(String name, IsPublicAddressRangeArgs args)
    public IsPublicAddressRange(String name, IsPublicAddressRangeArgs args, CustomResourceOptions options)
    
    type: ibm:IsPublicAddressRange
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args IsPublicAddressRangeArgs
    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 IsPublicAddressRangeArgs
    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 IsPublicAddressRangeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args IsPublicAddressRangeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args IsPublicAddressRangeArgs
    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 isPublicAddressRangeResource = new Ibm.IsPublicAddressRange("isPublicAddressRangeResource", new()
    {
        Ipv4AddressCount = 0,
        AccessTags = new[]
        {
            "string",
        },
        IsPublicAddressRangeId = "string",
        Name = "string",
        ResourceGroup = new Ibm.Inputs.IsPublicAddressRangeResourceGroupArgs
        {
            Href = "string",
            Id = "string",
            Name = "string",
        },
        Tags = new[]
        {
            "string",
        },
        Target = new Ibm.Inputs.IsPublicAddressRangeTargetArgs
        {
            Vpc = new Ibm.Inputs.IsPublicAddressRangeTargetVpcArgs
            {
                Crn = "string",
                Deleteds = new[]
                {
                    new Ibm.Inputs.IsPublicAddressRangeTargetVpcDeletedArgs
                    {
                        MoreInfo = "string",
                    },
                },
                Href = "string",
                Id = "string",
                Name = "string",
                ResourceType = "string",
            },
            Zone = new Ibm.Inputs.IsPublicAddressRangeTargetZoneArgs
            {
                Href = "string",
                Name = "string",
            },
        },
    });
    
    example, err := ibm.NewIsPublicAddressRange(ctx, "isPublicAddressRangeResource", &ibm.IsPublicAddressRangeArgs{
    	Ipv4AddressCount: pulumi.Float64(0),
    	AccessTags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	IsPublicAddressRangeId: pulumi.String("string"),
    	Name:                   pulumi.String("string"),
    	ResourceGroup: &ibm.IsPublicAddressRangeResourceGroupArgs{
    		Href: pulumi.String("string"),
    		Id:   pulumi.String("string"),
    		Name: pulumi.String("string"),
    	},
    	Tags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Target: &ibm.IsPublicAddressRangeTargetArgs{
    		Vpc: &ibm.IsPublicAddressRangeTargetVpcArgs{
    			Crn: pulumi.String("string"),
    			Deleteds: ibm.IsPublicAddressRangeTargetVpcDeletedArray{
    				&ibm.IsPublicAddressRangeTargetVpcDeletedArgs{
    					MoreInfo: pulumi.String("string"),
    				},
    			},
    			Href:         pulumi.String("string"),
    			Id:           pulumi.String("string"),
    			Name:         pulumi.String("string"),
    			ResourceType: pulumi.String("string"),
    		},
    		Zone: &ibm.IsPublicAddressRangeTargetZoneArgs{
    			Href: pulumi.String("string"),
    			Name: pulumi.String("string"),
    		},
    	},
    })
    
    var isPublicAddressRangeResource = new IsPublicAddressRange("isPublicAddressRangeResource", IsPublicAddressRangeArgs.builder()
        .ipv4AddressCount(0.0)
        .accessTags("string")
        .isPublicAddressRangeId("string")
        .name("string")
        .resourceGroup(IsPublicAddressRangeResourceGroupArgs.builder()
            .href("string")
            .id("string")
            .name("string")
            .build())
        .tags("string")
        .target(IsPublicAddressRangeTargetArgs.builder()
            .vpc(IsPublicAddressRangeTargetVpcArgs.builder()
                .crn("string")
                .deleteds(IsPublicAddressRangeTargetVpcDeletedArgs.builder()
                    .moreInfo("string")
                    .build())
                .href("string")
                .id("string")
                .name("string")
                .resourceType("string")
                .build())
            .zone(IsPublicAddressRangeTargetZoneArgs.builder()
                .href("string")
                .name("string")
                .build())
            .build())
        .build());
    
    is_public_address_range_resource = ibm.IsPublicAddressRange("isPublicAddressRangeResource",
        ipv4_address_count=0,
        access_tags=["string"],
        is_public_address_range_id="string",
        name="string",
        resource_group={
            "href": "string",
            "id": "string",
            "name": "string",
        },
        tags=["string"],
        target={
            "vpc": {
                "crn": "string",
                "deleteds": [{
                    "more_info": "string",
                }],
                "href": "string",
                "id": "string",
                "name": "string",
                "resource_type": "string",
            },
            "zone": {
                "href": "string",
                "name": "string",
            },
        })
    
    const isPublicAddressRangeResource = new ibm.IsPublicAddressRange("isPublicAddressRangeResource", {
        ipv4AddressCount: 0,
        accessTags: ["string"],
        isPublicAddressRangeId: "string",
        name: "string",
        resourceGroup: {
            href: "string",
            id: "string",
            name: "string",
        },
        tags: ["string"],
        target: {
            vpc: {
                crn: "string",
                deleteds: [{
                    moreInfo: "string",
                }],
                href: "string",
                id: "string",
                name: "string",
                resourceType: "string",
            },
            zone: {
                href: "string",
                name: "string",
            },
        },
    });
    
    type: ibm:IsPublicAddressRange
    properties:
        accessTags:
            - string
        ipv4AddressCount: 0
        isPublicAddressRangeId: string
        name: string
        resourceGroup:
            href: string
            id: string
            name: string
        tags:
            - string
        target:
            vpc:
                crn: string
                deleteds:
                    - moreInfo: string
                href: string
                id: string
                name: string
                resourceType: string
            zone:
                href: string
                name: string
    

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

    Ipv4AddressCount double
    The number of IPv4 addresses in this public address range.
    AccessTags List<string>
    List of access management tags
    IsPublicAddressRangeId string
    (String) The unique identifier for this VPC.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    ResourceGroup IsPublicAddressRangeResourceGroup

    The resource group for this public address range.

    Nested schema for resource_group:

    Tags List<string>
    User Tags for the PublicAddressRange
    Target IsPublicAddressRangeTarget

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    Ipv4AddressCount float64
    The number of IPv4 addresses in this public address range.
    AccessTags []string
    List of access management tags
    IsPublicAddressRangeId string
    (String) The unique identifier for this VPC.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    ResourceGroup IsPublicAddressRangeResourceGroupArgs

    The resource group for this public address range.

    Nested schema for resource_group:

    Tags []string
    User Tags for the PublicAddressRange
    Target IsPublicAddressRangeTargetArgs

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    ipv4AddressCount Double
    The number of IPv4 addresses in this public address range.
    accessTags List<String>
    List of access management tags
    isPublicAddressRangeId String
    (String) The unique identifier for this VPC.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceGroup IsPublicAddressRangeResourceGroup

    The resource group for this public address range.

    Nested schema for resource_group:

    tags List<String>
    User Tags for the PublicAddressRange
    target IsPublicAddressRangeTarget

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    ipv4AddressCount number
    The number of IPv4 addresses in this public address range.
    accessTags string[]
    List of access management tags
    isPublicAddressRangeId string
    (String) The unique identifier for this VPC.
    name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceGroup IsPublicAddressRangeResourceGroup

    The resource group for this public address range.

    Nested schema for resource_group:

    tags string[]
    User Tags for the PublicAddressRange
    target IsPublicAddressRangeTarget

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    ipv4_address_count float
    The number of IPv4 addresses in this public address range.
    access_tags Sequence[str]
    List of access management tags
    is_public_address_range_id str
    (String) The unique identifier for this VPC.
    name str
    The name for this public address range. The name is unique across all public address ranges in the region.
    resource_group IsPublicAddressRangeResourceGroupArgs

    The resource group for this public address range.

    Nested schema for resource_group:

    tags Sequence[str]
    User Tags for the PublicAddressRange
    target IsPublicAddressRangeTargetArgs

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    ipv4AddressCount Number
    The number of IPv4 addresses in this public address range.
    accessTags List<String>
    List of access management tags
    isPublicAddressRangeId String
    (String) The unique identifier for this VPC.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceGroup Property Map

    The resource group for this public address range.

    Nested schema for resource_group:

    tags List<String>
    User Tags for the PublicAddressRange
    target Property Map

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    Outputs

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

    Cidr string
    (String) The public IPv4 range, expressed in CIDR format.
    CreatedAt string
    (String) The date and time that the public address range was created.
    Crn string
    (String) The CRN for this VPC.
    Href string
    (String) The URL for this zone.
    Id string
    The provider-assigned unique ID for this managed resource.
    LifecycleState string
    (String) The lifecycle state of the public address range.
    ResourceType string
    (Computed, String) The resource type.
    Cidr string
    (String) The public IPv4 range, expressed in CIDR format.
    CreatedAt string
    (String) The date and time that the public address range was created.
    Crn string
    (String) The CRN for this VPC.
    Href string
    (String) The URL for this zone.
    Id string
    The provider-assigned unique ID for this managed resource.
    LifecycleState string
    (String) The lifecycle state of the public address range.
    ResourceType string
    (Computed, String) The resource type.
    cidr String
    (String) The public IPv4 range, expressed in CIDR format.
    createdAt String
    (String) The date and time that the public address range was created.
    crn String
    (String) The CRN for this VPC.
    href String
    (String) The URL for this zone.
    id String
    The provider-assigned unique ID for this managed resource.
    lifecycleState String
    (String) The lifecycle state of the public address range.
    resourceType String
    (Computed, String) The resource type.
    cidr string
    (String) The public IPv4 range, expressed in CIDR format.
    createdAt string
    (String) The date and time that the public address range was created.
    crn string
    (String) The CRN for this VPC.
    href string
    (String) The URL for this zone.
    id string
    The provider-assigned unique ID for this managed resource.
    lifecycleState string
    (String) The lifecycle state of the public address range.
    resourceType string
    (Computed, String) The resource type.
    cidr str
    (String) The public IPv4 range, expressed in CIDR format.
    created_at str
    (String) The date and time that the public address range was created.
    crn str
    (String) The CRN for this VPC.
    href str
    (String) The URL for this zone.
    id str
    The provider-assigned unique ID for this managed resource.
    lifecycle_state str
    (String) The lifecycle state of the public address range.
    resource_type str
    (Computed, String) The resource type.
    cidr String
    (String) The public IPv4 range, expressed in CIDR format.
    createdAt String
    (String) The date and time that the public address range was created.
    crn String
    (String) The CRN for this VPC.
    href String
    (String) The URL for this zone.
    id String
    The provider-assigned unique ID for this managed resource.
    lifecycleState String
    (String) The lifecycle state of the public address range.
    resourceType String
    (Computed, String) The resource type.

    Look up Existing IsPublicAddressRange Resource

    Get an existing IsPublicAddressRange 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?: IsPublicAddressRangeState, opts?: CustomResourceOptions): IsPublicAddressRange
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            access_tags: Optional[Sequence[str]] = None,
            cidr: Optional[str] = None,
            created_at: Optional[str] = None,
            crn: Optional[str] = None,
            href: Optional[str] = None,
            ipv4_address_count: Optional[float] = None,
            is_public_address_range_id: Optional[str] = None,
            lifecycle_state: Optional[str] = None,
            name: Optional[str] = None,
            resource_group: Optional[IsPublicAddressRangeResourceGroupArgs] = None,
            resource_type: Optional[str] = None,
            tags: Optional[Sequence[str]] = None,
            target: Optional[IsPublicAddressRangeTargetArgs] = None) -> IsPublicAddressRange
    func GetIsPublicAddressRange(ctx *Context, name string, id IDInput, state *IsPublicAddressRangeState, opts ...ResourceOption) (*IsPublicAddressRange, error)
    public static IsPublicAddressRange Get(string name, Input<string> id, IsPublicAddressRangeState? state, CustomResourceOptions? opts = null)
    public static IsPublicAddressRange get(String name, Output<String> id, IsPublicAddressRangeState state, CustomResourceOptions options)
    resources:  _:    type: ibm:IsPublicAddressRange    get:      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:
    AccessTags List<string>
    List of access management tags
    Cidr string
    (String) The public IPv4 range, expressed in CIDR format.
    CreatedAt string
    (String) The date and time that the public address range was created.
    Crn string
    (String) The CRN for this VPC.
    Href string
    (String) The URL for this zone.
    Ipv4AddressCount double
    The number of IPv4 addresses in this public address range.
    IsPublicAddressRangeId string
    (String) The unique identifier for this VPC.
    LifecycleState string
    (String) The lifecycle state of the public address range.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    ResourceGroup IsPublicAddressRangeResourceGroup

    The resource group for this public address range.

    Nested schema for resource_group:

    ResourceType string
    (Computed, String) The resource type.
    Tags List<string>
    User Tags for the PublicAddressRange
    Target IsPublicAddressRangeTarget

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    AccessTags []string
    List of access management tags
    Cidr string
    (String) The public IPv4 range, expressed in CIDR format.
    CreatedAt string
    (String) The date and time that the public address range was created.
    Crn string
    (String) The CRN for this VPC.
    Href string
    (String) The URL for this zone.
    Ipv4AddressCount float64
    The number of IPv4 addresses in this public address range.
    IsPublicAddressRangeId string
    (String) The unique identifier for this VPC.
    LifecycleState string
    (String) The lifecycle state of the public address range.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    ResourceGroup IsPublicAddressRangeResourceGroupArgs

    The resource group for this public address range.

    Nested schema for resource_group:

    ResourceType string
    (Computed, String) The resource type.
    Tags []string
    User Tags for the PublicAddressRange
    Target IsPublicAddressRangeTargetArgs

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    accessTags List<String>
    List of access management tags
    cidr String
    (String) The public IPv4 range, expressed in CIDR format.
    createdAt String
    (String) The date and time that the public address range was created.
    crn String
    (String) The CRN for this VPC.
    href String
    (String) The URL for this zone.
    ipv4AddressCount Double
    The number of IPv4 addresses in this public address range.
    isPublicAddressRangeId String
    (String) The unique identifier for this VPC.
    lifecycleState String
    (String) The lifecycle state of the public address range.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceGroup IsPublicAddressRangeResourceGroup

    The resource group for this public address range.

    Nested schema for resource_group:

    resourceType String
    (Computed, String) The resource type.
    tags List<String>
    User Tags for the PublicAddressRange
    target IsPublicAddressRangeTarget

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    accessTags string[]
    List of access management tags
    cidr string
    (String) The public IPv4 range, expressed in CIDR format.
    createdAt string
    (String) The date and time that the public address range was created.
    crn string
    (String) The CRN for this VPC.
    href string
    (String) The URL for this zone.
    ipv4AddressCount number
    The number of IPv4 addresses in this public address range.
    isPublicAddressRangeId string
    (String) The unique identifier for this VPC.
    lifecycleState string
    (String) The lifecycle state of the public address range.
    name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceGroup IsPublicAddressRangeResourceGroup

    The resource group for this public address range.

    Nested schema for resource_group:

    resourceType string
    (Computed, String) The resource type.
    tags string[]
    User Tags for the PublicAddressRange
    target IsPublicAddressRangeTarget

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    access_tags Sequence[str]
    List of access management tags
    cidr str
    (String) The public IPv4 range, expressed in CIDR format.
    created_at str
    (String) The date and time that the public address range was created.
    crn str
    (String) The CRN for this VPC.
    href str
    (String) The URL for this zone.
    ipv4_address_count float
    The number of IPv4 addresses in this public address range.
    is_public_address_range_id str
    (String) The unique identifier for this VPC.
    lifecycle_state str
    (String) The lifecycle state of the public address range.
    name str
    The name for this public address range. The name is unique across all public address ranges in the region.
    resource_group IsPublicAddressRangeResourceGroupArgs

    The resource group for this public address range.

    Nested schema for resource_group:

    resource_type str
    (Computed, String) The resource type.
    tags Sequence[str]
    User Tags for the PublicAddressRange
    target IsPublicAddressRangeTargetArgs

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    accessTags List<String>
    List of access management tags
    cidr String
    (String) The public IPv4 range, expressed in CIDR format.
    createdAt String
    (String) The date and time that the public address range was created.
    crn String
    (String) The CRN for this VPC.
    href String
    (String) The URL for this zone.
    ipv4AddressCount Number
    The number of IPv4 addresses in this public address range.
    isPublicAddressRangeId String
    (String) The unique identifier for this VPC.
    lifecycleState String
    (String) The lifecycle state of the public address range.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceGroup Property Map

    The resource group for this public address range.

    Nested schema for resource_group:

    resourceType String
    (Computed, String) The resource type.
    tags List<String>
    User Tags for the PublicAddressRange
    target Property Map

    The target this public address range is bound to.If absent, this public address range is not bound to a target.

    Nested schema for target:

    Supporting Types

    IsPublicAddressRangeResourceGroup, IsPublicAddressRangeResourceGroupArgs

    Href string
    (String) The URL for this zone.
    Id string
    The unique identifier for this resource group.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    Href string
    (String) The URL for this zone.
    Id string
    The unique identifier for this resource group.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    href String
    (String) The URL for this zone.
    id String
    The unique identifier for this resource group.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    href string
    (String) The URL for this zone.
    id string
    The unique identifier for this resource group.
    name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    href str
    (String) The URL for this zone.
    id str
    The unique identifier for this resource group.
    name str
    The name for this public address range. The name is unique across all public address ranges in the region.
    href String
    (String) The URL for this zone.
    id String
    The unique identifier for this resource group.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.

    IsPublicAddressRangeTarget, IsPublicAddressRangeTargetArgs

    Vpc IsPublicAddressRangeTargetVpc

    The VPC this public address range is bound to. If present, any of the below value must be specified.

    Nested schema for vpc:

    Zone IsPublicAddressRangeTargetZone

    The zone this public address range resides in. If present, any of the below value must be specified.

    Nested schema for zone:

    Vpc IsPublicAddressRangeTargetVpc

    The VPC this public address range is bound to. If present, any of the below value must be specified.

    Nested schema for vpc:

    Zone IsPublicAddressRangeTargetZone

    The zone this public address range resides in. If present, any of the below value must be specified.

    Nested schema for zone:

    vpc IsPublicAddressRangeTargetVpc

    The VPC this public address range is bound to. If present, any of the below value must be specified.

    Nested schema for vpc:

    zone IsPublicAddressRangeTargetZone

    The zone this public address range resides in. If present, any of the below value must be specified.

    Nested schema for zone:

    vpc IsPublicAddressRangeTargetVpc

    The VPC this public address range is bound to. If present, any of the below value must be specified.

    Nested schema for vpc:

    zone IsPublicAddressRangeTargetZone

    The zone this public address range resides in. If present, any of the below value must be specified.

    Nested schema for zone:

    vpc IsPublicAddressRangeTargetVpc

    The VPC this public address range is bound to. If present, any of the below value must be specified.

    Nested schema for vpc:

    zone IsPublicAddressRangeTargetZone

    The zone this public address range resides in. If present, any of the below value must be specified.

    Nested schema for zone:

    vpc Property Map

    The VPC this public address range is bound to. If present, any of the below value must be specified.

    Nested schema for vpc:

    zone Property Map

    The zone this public address range resides in. If present, any of the below value must be specified.

    Nested schema for zone:

    IsPublicAddressRangeTargetVpc, IsPublicAddressRangeTargetVpcArgs

    Crn string
    The CRN for this VPC.
    Deleteds List<IsPublicAddressRangeTargetVpcDeleted>
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    Href string
    The URL for this VPC.
    Id string
    The unique identifier for this VPC.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    ResourceType string
    (Computed, String) The resource type.
    Crn string
    The CRN for this VPC.
    Deleteds []IsPublicAddressRangeTargetVpcDeleted
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    Href string
    The URL for this VPC.
    Id string
    The unique identifier for this VPC.
    Name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    ResourceType string
    (Computed, String) The resource type.
    crn String
    The CRN for this VPC.
    deleteds List<IsPublicAddressRangeTargetVpcDeleted>
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href String
    The URL for this VPC.
    id String
    The unique identifier for this VPC.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceType String
    (Computed, String) The resource type.
    crn string
    The CRN for this VPC.
    deleteds IsPublicAddressRangeTargetVpcDeleted[]
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href string
    The URL for this VPC.
    id string
    The unique identifier for this VPC.
    name string
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceType string
    (Computed, String) The resource type.
    crn str
    The CRN for this VPC.
    deleteds Sequence[IsPublicAddressRangeTargetVpcDeleted]
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href str
    The URL for this VPC.
    id str
    The unique identifier for this VPC.
    name str
    The name for this public address range. The name is unique across all public address ranges in the region.
    resource_type str
    (Computed, String) The resource type.
    crn String
    The CRN for this VPC.
    deleteds List<Property Map>
    (List) If present, this property indicates the referenced resource has been deleted, and providessome supplementary information.
    href String
    The URL for this VPC.
    id String
    The unique identifier for this VPC.
    name String
    The name for this public address range. The name is unique across all public address ranges in the region.
    resourceType String
    (Computed, String) The resource type.

    IsPublicAddressRangeTargetVpcDeleted, IsPublicAddressRangeTargetVpcDeletedArgs

    MoreInfo string
    (Computed, String) Link to documentation about deleted resources.
    MoreInfo string
    (Computed, String) Link to documentation about deleted resources.
    moreInfo String
    (Computed, String) Link to documentation about deleted resources.
    moreInfo string
    (Computed, String) Link to documentation about deleted resources.
    more_info str
    (Computed, String) Link to documentation about deleted resources.
    moreInfo String
    (Computed, String) Link to documentation about deleted resources.

    IsPublicAddressRangeTargetZone, IsPublicAddressRangeTargetZoneArgs

    Href string
    The URL for this zone.
    Name string
    The globally unique name for this zone.
    Href string
    The URL for this zone.
    Name string
    The globally unique name for this zone.
    href String
    The URL for this zone.
    name String
    The globally unique name for this zone.
    href string
    The URL for this zone.
    name string
    The globally unique name for this zone.
    href str
    The URL for this zone.
    name str
    The globally unique name for this zone.
    href String
    The URL for this zone.
    name String
    The globally unique name for this zone.

    Import

    You can import the ibm_is_public_address_range resource by using id. The unique identifier for this public address range.

    Syntax

    $ pulumi import ibm:index/isPublicAddressRange:IsPublicAddressRange is_public_address_range <id>
    

    Example

    $ pulumi import ibm:index/isPublicAddressRange:IsPublicAddressRange is_public_address_range r006-a4841334-b584-4293-938e-3bc63b4a5b6a
    

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

    Package Details

    Repository
    ibm ibm-cloud/terraform-provider-ibm
    License
    Notes
    This Pulumi package is based on the ibm Terraform Provider.
    ibm logo
    ibm 1.81.1 published on Wednesday, Aug 6, 2025 by ibm-cloud