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

PublicIPPrefix

class PublicIPPrefix : KotlinCustomResource

Public IP prefix resource. Uses Azure REST API version 2024-05-01. In version 2.x of the Azure Native provider, it used API version 2023-02-01. Other available API versions: 2018-07-01, 2018-08-01, 2018-10-01, 2018-11-01, 2018-12-01, 2019-02-01, 2019-04-01, 2019-06-01, 2019-07-01, 2019-08-01, 2019-09-01, 2019-11-01, 2019-12-01, 2020-03-01, 2020-04-01, 2020-05-01, 2020-06-01, 2020-07-01, 2020-08-01, 2020-11-01, 2021-02-01, 2021-03-01, 2021-05-01, 2021-08-01, 2022-01-01, 2022-05-01, 2022-07-01, 2022-09-01, 2022-11-01, 2023-02-01, 2023-04-01, 2023-05-01, 2023-06-01, 2023-09-01, 2023-11-01, 2024-01-01, 2024-03-01, 2024-07-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native network [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create public IP prefix allocation method

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var publicIPPrefix = new AzureNative.Network.PublicIPPrefix("publicIPPrefix", new()
    {
        Location = "westus",
        PrefixLength = 30,
        PublicIPAddressVersion = AzureNative.Network.IPVersion.IPv4,
        PublicIpPrefixName = "test-ipprefix",
        ResourceGroupName = "rg1",
        Sku = new AzureNative.Network.Inputs.PublicIPPrefixSkuArgs
        {
            Name = AzureNative.Network.PublicIPPrefixSkuName.Standard,
            Tier = AzureNative.Network.PublicIPPrefixSkuTier.Regional,
        },
    });
});

package main
import (
	network "github.com/pulumi/pulumi-azure-native-sdk/network/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewPublicIPPrefix(ctx, "publicIPPrefix", &network.PublicIPPrefixArgs{
			Location:               pulumi.String("westus"),
			PrefixLength:           pulumi.Int(30),
			PublicIPAddressVersion: pulumi.String(network.IPVersionIPv4),
			PublicIpPrefixName:     pulumi.String("test-ipprefix"),
			ResourceGroupName:      pulumi.String("rg1"),
			Sku: &network.PublicIPPrefixSkuArgs{
				Name: pulumi.String(network.PublicIPPrefixSkuNameStandard),
				Tier: pulumi.String(network.PublicIPPrefixSkuTierRegional),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.PublicIPPrefix;
import com.pulumi.azurenative.network.PublicIPPrefixArgs;
import com.pulumi.azurenative.network.inputs.PublicIPPrefixSkuArgs;
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 publicIPPrefix = new PublicIPPrefix("publicIPPrefix", PublicIPPrefixArgs.builder()
            .location("westus")
            .prefixLength(30)
            .publicIPAddressVersion("IPv4")
            .publicIpPrefixName("test-ipprefix")
            .resourceGroupName("rg1")
            .sku(PublicIPPrefixSkuArgs.builder()
                .name("Standard")
                .tier("Regional")
                .build())
            .build());
    }
}

Create public IP prefix defaults

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
    var publicIPPrefix = new AzureNative.Network.PublicIPPrefix("publicIPPrefix", new()
    {
        Location = "westus",
        PrefixLength = 30,
        PublicIpPrefixName = "test-ipprefix",
        ResourceGroupName = "rg1",
        Sku = new AzureNative.Network.Inputs.PublicIPPrefixSkuArgs
        {
            Name = AzureNative.Network.PublicIPPrefixSkuName.Standard,
        },
    });
});

package main
import (
	network "github.com/pulumi/pulumi-azure-native-sdk/network/v3"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := network.NewPublicIPPrefix(ctx, "publicIPPrefix", &network.PublicIPPrefixArgs{
			Location:           pulumi.String("westus"),
			PrefixLength:       pulumi.Int(30),
			PublicIpPrefixName: pulumi.String("test-ipprefix"),
			ResourceGroupName:  pulumi.String("rg1"),
			Sku: &network.PublicIPPrefixSkuArgs{
				Name: pulumi.String(network.PublicIPPrefixSkuNameStandard),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.network.PublicIPPrefix;
import com.pulumi.azurenative.network.PublicIPPrefixArgs;
import com.pulumi.azurenative.network.inputs.PublicIPPrefixSkuArgs;
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 publicIPPrefix = new PublicIPPrefix("publicIPPrefix", PublicIPPrefixArgs.builder()
            .location("westus")
            .prefixLength(30)
            .publicIpPrefixName("test-ipprefix")
            .resourceGroupName("rg1")
            .sku(PublicIPPrefixSkuArgs.builder()
                .name("Standard")
                .build())
            .build());
    }
}

Import

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

$ pulumi import azure-native:network:PublicIPPrefix test-ipprefix /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIpPrefixName}