pulumi-azure-native-kotlin/com.pulumi.azurenative.network.kotlin/PublicIPAddress

PublicIPAddress

class PublicIPAddress : KotlinCustomResource

Public IP address resource. Azure REST API version: 2023-02-01. Prior API version in Azure Native 1.x: 2020-11-01. Other available API versions: 2016-03-30, 2019-06-01, 2019-08-01, 2023-04-01, 2023-05-01.

Example Usage

Create public IP address DNS

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var publicIPAddress = new AzureNative.Network.PublicIPAddress("publicIPAddress", new()
    {
        DnsSettings = new AzureNative.Network.Inputs.PublicIPAddressDnsSettingsArgs
        {
            DomainNameLabel = "dnslbl",
        },
        Location = "eastus",
        PublicIpAddressName = "test-ip",
        ResourceGroupName = "rg1",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure-native-sdk/network/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewPublicIPAddress(ctx, "publicIPAddress", &network.PublicIPAddressArgs{
			DnsSettings: &network.PublicIPAddressDnsSettingsArgs{
				DomainNameLabel: pulumi.String("dnslbl"),
			},
			Location:            pulumi.String("eastus"),
			PublicIpAddressName: pulumi.String("test-ip"),
			ResourceGroupName:   pulumi.String("rg1"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.PublicIPAddress;
import com.pulumi.azurenative.network.PublicIPAddressArgs;
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 publicIPAddress = new PublicIPAddress("publicIPAddress", PublicIPAddressArgs.builder()
            .dnsSettings(Map.of("domainNameLabel", "dnslbl"))
            .location("eastus")
            .publicIpAddressName("test-ip")
            .resourceGroupName("rg1")
            .build());
    }
}
Content copied to clipboard

Create public IP address DNS with Domain Name Label Scope

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var publicIPAddress = new AzureNative.Network.PublicIPAddress("publicIPAddress", new()
    {
        DnsSettings = new AzureNative.Network.Inputs.PublicIPAddressDnsSettingsArgs
        {
            DomainNameLabel = "dnslbl",
            DomainNameLabelScope = AzureNative.Network.PublicIpAddressDnsSettingsDomainNameLabelScope.TenantReuse,
        },
        Location = "eastus",
        PublicIpAddressName = "test-ip",
        ResourceGroupName = "rg1",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure-native-sdk/network/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewPublicIPAddress(ctx, "publicIPAddress", &network.PublicIPAddressArgs{
			DnsSettings: &network.PublicIPAddressDnsSettingsArgs{
				DomainNameLabel:      pulumi.String("dnslbl"),
				DomainNameLabelScope: network.PublicIpAddressDnsSettingsDomainNameLabelScopeTenantReuse,
			},
			Location:            pulumi.String("eastus"),
			PublicIpAddressName: pulumi.String("test-ip"),
			ResourceGroupName:   pulumi.String("rg1"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.PublicIPAddress;
import com.pulumi.azurenative.network.PublicIPAddressArgs;
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 publicIPAddress = new PublicIPAddress("publicIPAddress", PublicIPAddressArgs.builder()
            .dnsSettings(Map.ofEntries(
                Map.entry("domainNameLabel", "dnslbl"),
                Map.entry("domainNameLabelScope", "TenantReuse")
            ))
            .location("eastus")
            .publicIpAddressName("test-ip")
            .resourceGroupName("rg1")
            .build());
    }
}
Content copied to clipboard

Create public IP address allocation method

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var publicIPAddress = new AzureNative.Network.PublicIPAddress("publicIPAddress", new()
    {
        IdleTimeoutInMinutes = 10,
        Location = "eastus",
        PublicIPAddressVersion = "IPv4",
        PublicIPAllocationMethod = "Static",
        PublicIpAddressName = "test-ip",
        ResourceGroupName = "rg1",
        Sku = new AzureNative.Network.Inputs.PublicIPAddressSkuArgs
        {
            Name = "Standard",
            Tier = "Global",
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure-native-sdk/network/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewPublicIPAddress(ctx, "publicIPAddress", &network.PublicIPAddressArgs{
			IdleTimeoutInMinutes:     pulumi.Int(10),
			Location:                 pulumi.String("eastus"),
			PublicIPAddressVersion:   pulumi.String("IPv4"),
			PublicIPAllocationMethod: pulumi.String("Static"),
			PublicIpAddressName:      pulumi.String("test-ip"),
			ResourceGroupName:        pulumi.String("rg1"),
			Sku: &network.PublicIPAddressSkuArgs{
				Name: pulumi.String("Standard"),
				Tier: pulumi.String("Global"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.PublicIPAddress;
import com.pulumi.azurenative.network.PublicIPAddressArgs;
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 publicIPAddress = new PublicIPAddress("publicIPAddress", PublicIPAddressArgs.builder()
            .idleTimeoutInMinutes(10)
            .location("eastus")
            .publicIPAddressVersion("IPv4")
            .publicIPAllocationMethod("Static")
            .publicIpAddressName("test-ip")
            .resourceGroupName("rg1")
            .sku(Map.ofEntries(
                Map.entry("name", "Standard"),
                Map.entry("tier", "Global")
            ))
            .build());
    }
}
Content copied to clipboard

Create public IP address defaults

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var publicIPAddress = new AzureNative.Network.PublicIPAddress("publicIPAddress", new()
    {
        Location = "eastus",
        PublicIpAddressName = "test-ip",
        ResourceGroupName = "rg1",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure-native-sdk/network/v2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewPublicIPAddress(ctx, "publicIPAddress", &network.PublicIPAddressArgs{
			Location:            pulumi.String("eastus"),
			PublicIpAddressName: pulumi.String("test-ip"),
			ResourceGroupName:   pulumi.String("rg1"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.PublicIPAddress;
import com.pulumi.azurenative.network.PublicIPAddressArgs;
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 publicIPAddress = new PublicIPAddress("publicIPAddress", PublicIPAddressArgs.builder()
            .location("eastus")
            .publicIpAddressName("test-ip")
            .resourceGroupName("rg1")
            .build());
    }
}
Content copied to clipboard

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:network:PublicIPAddress testDNS-ip /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPAddresses/{publicIpAddressName}
Content copied to clipboard

Properties

Link copied to clipboard
val ddosSettings: Output<DdosSettingsResponse>?

The DDoS protection custom policy associated with the public IP address.

Link copied to clipboard
val deleteOption: Output<String>?

Specify what happens to the public IP address when the VM using it is deleted

Link copied to clipboard
val dnsSettings: Output<PublicIPAddressDnsSettingsResponse>?

The FQDN of the DNS record associated with the public IP address.

Link copied to clipboard
val etag: Output<String>

A unique read-only string that changes whenever the resource is updated.

Link copied to clipboard
val extendedLocation: Output<ExtendedLocationResponse>?

The extended location of the public ip address.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val idleTimeoutInMinutes: Output<Int>?

The idle timeout of the public IP address.

Link copied to clipboard
val ipAddress: Output<String>?

The IP address associated with the public IP address resource.

Link copied to clipboard
val ipConfiguration: Output<IPConfigurationResponse>

The IP configuration associated with the public IP address.

Link copied to clipboard
val ipTags: Output<List<IpTagResponse>>?

The list of tags associated with the public IP address.

Link copied to clipboard
val linkedPublicIPAddress: Output<PublicIPAddressResponse>?

The linked public IP address of the public IP address resource.

Link copied to clipboard
val location: Output<String>?

Resource location.

Link copied to clipboard
val migrationPhase: Output<String>?

Migration phase of Public IP Address.

Link copied to clipboard
val name: Output<String>

Resource name.

Link copied to clipboard
val natGateway: Output<NatGatewayResponse>?

The NatGateway for the Public IP address.

Link copied to clipboard
val provisioningState: Output<String>

The provisioning state of the public IP address resource.

Link copied to clipboard
val publicIPAddressVersion: Output<String>?

The public IP address version.

Link copied to clipboard
val publicIPAllocationMethod: Output<String>?

The public IP address allocation method.

Link copied to clipboard
val publicIPPrefix: Output<SubResourceResponse>?

The Public IP Prefix this Public IP Address should be allocated from.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val resourceGuid: Output<String>

The resource GUID property of the public IP address resource.

Link copied to clipboard
val servicePublicIPAddress: Output<PublicIPAddressResponse>?

The service public IP address of the public IP address resource.

Link copied to clipboard
val sku: Output<PublicIPAddressSkuResponse>?

The public IP address SKU.

Link copied to clipboard
val tags: Output<Map<String, String>>?

Resource tags.

Link copied to clipboard
val type: Output<String>

Resource type.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val zones: Output<List<String>>?

A list of availability zones denoting the IP allocated for the resource needs to come from.