1. Packages
  2. Azure Classic
  3. API Docs
  4. network
  5. getPublicIPs

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-azure

azure.network.getPublicIPs

azure logo

We recommend using Azure Native.

Viewing docs for Azure v4.42.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
Go to latest version
Schema (JSON)
pulumi/pulumi-azure

    Use this data source to access information about a set of existing Public IP Addresses.

    Example Usage

    using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var example = Output.Create(Azure.Network.GetPublicIPs.InvokeAsync(new Azure.Network.GetPublicIPsArgs
        {
            AttachmentStatus = "Attached",
            ResourceGroupName = "pip-test",
        }));
    }

}

    package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v4/go/azure/network"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.GetPublicIPs(ctx, &network.GetPublicIPsArgs{
			AttachmentStatus:  pulumi.StringRef("Attached"),
			ResourceGroupName: "pip-test",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    Example coming soon!

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

const example = pulumi.output(azure.network.getPublicIPs({
    attachmentStatus: "Attached",
    resourceGroupName: "pip-test",
}));

    import pulumi
import pulumi_azure as azure

example = azure.network.get_public_i_ps(attachment_status="Attached",
    resource_group_name="pip-test")

    Example coming soon!

    Using getPublicIPs

    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 getPublicIPs(args: GetPublicIPsArgs, opts?: InvokeOptions): Promise<GetPublicIPsResult>
function getPublicIPsOutput(args: GetPublicIPsOutputArgs, opts?: InvokeOptions): Output<GetPublicIPsResult>
    def get_public_i_ps(allocation_type: Optional[str] = None,
                    attached: Optional[bool] = None,
                    attachment_status: Optional[str] = None,
                    name_prefix: Optional[str] = None,
                    resource_group_name: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetPublicIPsResult
def get_public_i_ps_output(allocation_type: Optional[pulumi.Input[str]] = None,
                    attached: Optional[pulumi.Input[bool]] = None,
                    attachment_status: Optional[pulumi.Input[str]] = None,
                    name_prefix: Optional[pulumi.Input[str]] = None,
                    resource_group_name: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetPublicIPsResult]
    func GetPublicIPs(ctx *Context, args *GetPublicIPsArgs, opts ...InvokeOption) (*GetPublicIPsResult, error)
func GetPublicIPsOutput(ctx *Context, args *GetPublicIPsOutputArgs, opts ...InvokeOption) GetPublicIPsResultOutput

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

    public static class GetPublicIPs 
{
    public static Task<GetPublicIPsResult> InvokeAsync(GetPublicIPsArgs args, InvokeOptions? opts = null)
    public static Output<GetPublicIPsResult> Invoke(GetPublicIPsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetPublicIPsResult> getPublicIPs(GetPublicIPsArgs args, InvokeOptions options)
public static Output<GetPublicIPsResult> getPublicIPs(GetPublicIPsArgs args, InvokeOptions options)

    fn::invoke:
  function: azure:network/getPublicIPs:getPublicIPs
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ResourceGroupName string
    Specifies the name of the resource group.
    AllocationType string
    The Allocation Type for the Public IP Address. Possible values include Static or Dynamic.
    Attached bool

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    AttachmentStatus string
    Filter to include IP Addresses which are attached to a device, such as a VM/LB (Attached) or unattached (Unattached). To allow for both, use All.
    NamePrefix string
    A prefix match used for the IP Addresses name field, case sensitive.
    ResourceGroupName string
    Specifies the name of the resource group.
    AllocationType string
    The Allocation Type for the Public IP Address. Possible values include Static or Dynamic.
    Attached bool

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    AttachmentStatus string
    Filter to include IP Addresses which are attached to a device, such as a VM/LB (Attached) or unattached (Unattached). To allow for both, use All.
    NamePrefix string
    A prefix match used for the IP Addresses name field, case sensitive.
    resourceGroupName String
    Specifies the name of the resource group.
    allocationType String
    The Allocation Type for the Public IP Address. Possible values include Static or Dynamic.
    attached Boolean

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachmentStatus String
    Filter to include IP Addresses which are attached to a device, such as a VM/LB (Attached) or unattached (Unattached). To allow for both, use All.
    namePrefix String
    A prefix match used for the IP Addresses name field, case sensitive.
    resourceGroupName string
    Specifies the name of the resource group.
    allocationType string
    The Allocation Type for the Public IP Address. Possible values include Static or Dynamic.
    attached boolean

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachmentStatus string
    Filter to include IP Addresses which are attached to a device, such as a VM/LB (Attached) or unattached (Unattached). To allow for both, use All.
    namePrefix string
    A prefix match used for the IP Addresses name field, case sensitive.
    resource_group_name str
    Specifies the name of the resource group.
    allocation_type str
    The Allocation Type for the Public IP Address. Possible values include Static or Dynamic.
    attached bool

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachment_status str
    Filter to include IP Addresses which are attached to a device, such as a VM/LB (Attached) or unattached (Unattached). To allow for both, use All.
    name_prefix str
    A prefix match used for the IP Addresses name field, case sensitive.
    resourceGroupName String
    Specifies the name of the resource group.
    allocationType String
    The Allocation Type for the Public IP Address. Possible values include Static or Dynamic.
    attached Boolean

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachmentStatus String
    Filter to include IP Addresses which are attached to a device, such as a VM/LB (Attached) or unattached (Unattached). To allow for both, use All.
    namePrefix String
    A prefix match used for the IP Addresses name field, case sensitive.

    getPublicIPs Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    PublicIps List<GetPublicIPsPublicIp>
    A List of public_ips blocks as defined below filtered by the criteria above.
    ResourceGroupName string
    AllocationType string
    Attached bool

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    AttachmentStatus string
    NamePrefix string
    Id string
    The provider-assigned unique ID for this managed resource.
    PublicIps []GetPublicIPsPublicIp
    A List of public_ips blocks as defined below filtered by the criteria above.
    ResourceGroupName string
    AllocationType string
    Attached bool

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    AttachmentStatus string
    NamePrefix string
    id String
    The provider-assigned unique ID for this managed resource.
    publicIps List<GetPublicIPsPublicIp>
    A List of public_ips blocks as defined below filtered by the criteria above.
    resourceGroupName String
    allocationType String
    attached Boolean

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachmentStatus String
    namePrefix String
    id string
    The provider-assigned unique ID for this managed resource.
    publicIps GetPublicIPsPublicIp[]
    A List of public_ips blocks as defined below filtered by the criteria above.
    resourceGroupName string
    allocationType string
    attached boolean

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachmentStatus string
    namePrefix string
    id str
    The provider-assigned unique ID for this managed resource.
    public_ips Sequence[GetPublicIPsPublicIp]
    A List of public_ips blocks as defined below filtered by the criteria above.
    resource_group_name str
    allocation_type str
    attached bool

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachment_status str
    name_prefix str
    id String
    The provider-assigned unique ID for this managed resource.
    publicIps List<Property Map>
    A List of public_ips blocks as defined below filtered by the criteria above.
    resourceGroupName String
    allocationType String
    attached Boolean

    Deprecated: This property has been deprecated in favour of attachment_status to improve filtering

    attachmentStatus String
    namePrefix String

    Supporting Types

    GetPublicIPsPublicIp

    DomainNameLabel string
    The Domain Name Label of the Public IP Address
    Fqdn string
    The FQDN of the Public IP Address
    Id string
    The ID of the Public IP Address
    IpAddress string
    The IP address of the Public IP Address
    Name string
    The Name of the Public IP Address
    DomainNameLabel string
    The Domain Name Label of the Public IP Address
    Fqdn string
    The FQDN of the Public IP Address
    Id string
    The ID of the Public IP Address
    IpAddress string
    The IP address of the Public IP Address
    Name string
    The Name of the Public IP Address
    domainNameLabel String
    The Domain Name Label of the Public IP Address
    fqdn String
    The FQDN of the Public IP Address
    id String
    The ID of the Public IP Address
    ipAddress String
    The IP address of the Public IP Address
    name String
    The Name of the Public IP Address
    domainNameLabel string
    The Domain Name Label of the Public IP Address
    fqdn string
    The FQDN of the Public IP Address
    id string
    The ID of the Public IP Address
    ipAddress string
    The IP address of the Public IP Address
    name string
    The Name of the Public IP Address
    domain_name_label str
    The Domain Name Label of the Public IP Address
    fqdn str
    The FQDN of the Public IP Address
    id str
    The ID of the Public IP Address
    ip_address str
    The IP address of the Public IP Address
    name str
    The Name of the Public IP Address
    domainNameLabel String
    The Domain Name Label of the Public IP Address
    fqdn String
    The FQDN of the Public IP Address
    id String
    The ID of the Public IP Address
    ipAddress String
    The IP address of the Public IP Address
    name String
    The Name of the Public IP Address

    Package Details

    Repository
    Azure Classic pulumi/pulumi-azure
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the azurerm Terraform Provider.
    azure logo

    We recommend using Azure Native.

    Viewing docs for Azure v4.42.0 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
    Go to latest version
    Schema (JSON)
    pulumi/pulumi-azure
      Try Pulumi Cloud free. Your team will thank you.