import * as pulumi from "@pulumi/pulumi"; /** * Manages a Public IP Prefix. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "example-resources", * location: "West Europe", * }); * const examplePublicIpPrefix = new azure.network.PublicIpPrefix("example", { * name: "acceptanceTestPublicIpPrefix1", * location: example.location, * resourceGroupName: example.name, * prefixLength: 31, * tags: { * environment: "Production", * }, * }); * ``` * * ## API Providers * * * This resource uses the following Azure API Providers: * * * `Microsoft.Network` - 2025-01-01 * * ## Import * * Public IP Prefixes can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:network/publicIpPrefix:PublicIpPrefix myPublicIpPrefix /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/publicIPPrefixes/myPublicIpPrefix1 * ``` */ export declare class PublicIpPrefix extends pulumi.CustomResource { /** * Get an existing PublicIpPrefix resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: PublicIpPrefixState, opts?: pulumi.CustomResourceOptions): PublicIpPrefix; /** * Returns true if the given object is an instance of PublicIpPrefix. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is PublicIpPrefix; /** * The Custom IP Prefix ID associated with the Public IP Prefix. Changing this forces a new resource to be created. * * > **Note:** When `ipVersion` is set to `IPv6`, `customIpPrefixId` must reference a regional (child) range rather than a global (parent) range. For more details on creating a Public IP Prefix from a custom IP prefix, see [here](https://learn.microsoft.com/en-us/azure/virtual-network/ip-services/manage-custom-ip-address-prefix#create-a-public-ip-prefix-from-a-custom-ip-prefix). */ readonly customIpPrefixId: pulumi.Output; /** * The IP address prefix value that was allocated. */ readonly ipPrefix: pulumi.Output; /** * The IP Version to use, `IPv6` or `IPv4`. Changing this forces a new resource to be created. Default is `IPv4`. */ readonly ipVersion: pulumi.Output; /** * Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. */ readonly location: pulumi.Output; /** * Specifies the name of the Public IP Prefix resource . Changing this forces a new resource to be created. */ readonly name: pulumi.Output; /** * Specifies the number of bits of the prefix. The value can be set between 0 (4,294,967,296 addresses) and 31 (2 addresses). Defaults to `28`(16 addresses). Changing this forces a new resource to be created. * * > **Note:** There may be Public IP address limits on the subscription . [More information available here](https://docs.microsoft.com/azure/azure-subscription-service-limits?toc=%2fazure%2fvirtual-network%2ftoc.json#publicip-address) */ readonly prefixLength: pulumi.Output; /** * The name of the resource group in which to create the Public IP Prefix. Changing this forces a new resource to be created. */ readonly resourceGroupName: pulumi.Output; /** * The SKU of the Public IP Prefix. Possible values are `Standard` and `StandardV2`. Defaults to `Standard`. Changing this forces a new resource to be created. */ readonly sku: pulumi.Output; /** * The SKU Tier that should be used for the Public IP Prefix. Possible values are `Regional` and `Global`. Defaults to `Regional`. Changing this forces a new resource to be created. * * > **Note:** When `skuTier` is set to `Global`, `sku` must be set to `Standard`. */ readonly skuTier: pulumi.Output; /** * A mapping of tags to assign to the resource. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Specifies a list of Availability Zones in which this Public IP Prefix should be located. Changing this forces a new Public IP Prefix to be created. * * > **Note:** Availability Zones are [only supported in several regions at this time](https://docs.microsoft.com/azure/availability-zones/az-overview). */ readonly zones: pulumi.Output; /** * Create a PublicIpPrefix resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: PublicIpPrefixArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering PublicIpPrefix resources. */ export interface PublicIpPrefixState { /** * The Custom IP Prefix ID associated with the Public IP Prefix. Changing this forces a new resource to be created. * * > **Note:** When `ipVersion` is set to `IPv6`, `customIpPrefixId` must reference a regional (child) range rather than a global (parent) range. For more details on creating a Public IP Prefix from a custom IP prefix, see [here](https://learn.microsoft.com/en-us/azure/virtual-network/ip-services/manage-custom-ip-address-prefix#create-a-public-ip-prefix-from-a-custom-ip-prefix). */ customIpPrefixId?: pulumi.Input; /** * The IP address prefix value that was allocated. */ ipPrefix?: pulumi.Input; /** * The IP Version to use, `IPv6` or `IPv4`. Changing this forces a new resource to be created. Default is `IPv4`. */ ipVersion?: pulumi.Input; /** * Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. */ location?: pulumi.Input; /** * Specifies the name of the Public IP Prefix resource . Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * Specifies the number of bits of the prefix. The value can be set between 0 (4,294,967,296 addresses) and 31 (2 addresses). Defaults to `28`(16 addresses). Changing this forces a new resource to be created. * * > **Note:** There may be Public IP address limits on the subscription . [More information available here](https://docs.microsoft.com/azure/azure-subscription-service-limits?toc=%2fazure%2fvirtual-network%2ftoc.json#publicip-address) */ prefixLength?: pulumi.Input; /** * The name of the resource group in which to create the Public IP Prefix. Changing this forces a new resource to be created. */ resourceGroupName?: pulumi.Input; /** * The SKU of the Public IP Prefix. Possible values are `Standard` and `StandardV2`. Defaults to `Standard`. Changing this forces a new resource to be created. */ sku?: pulumi.Input; /** * The SKU Tier that should be used for the Public IP Prefix. Possible values are `Regional` and `Global`. Defaults to `Regional`. Changing this forces a new resource to be created. * * > **Note:** When `skuTier` is set to `Global`, `sku` must be set to `Standard`. */ skuTier?: pulumi.Input; /** * A mapping of tags to assign to the resource. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Specifies a list of Availability Zones in which this Public IP Prefix should be located. Changing this forces a new Public IP Prefix to be created. * * > **Note:** Availability Zones are [only supported in several regions at this time](https://docs.microsoft.com/azure/availability-zones/az-overview). */ zones?: pulumi.Input[]>; } /** * The set of arguments for constructing a PublicIpPrefix resource. */ export interface PublicIpPrefixArgs { /** * The Custom IP Prefix ID associated with the Public IP Prefix. Changing this forces a new resource to be created. * * > **Note:** When `ipVersion` is set to `IPv6`, `customIpPrefixId` must reference a regional (child) range rather than a global (parent) range. For more details on creating a Public IP Prefix from a custom IP prefix, see [here](https://learn.microsoft.com/en-us/azure/virtual-network/ip-services/manage-custom-ip-address-prefix#create-a-public-ip-prefix-from-a-custom-ip-prefix). */ customIpPrefixId?: pulumi.Input; /** * The IP Version to use, `IPv6` or `IPv4`. Changing this forces a new resource to be created. Default is `IPv4`. */ ipVersion?: pulumi.Input; /** * Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. */ location?: pulumi.Input; /** * Specifies the name of the Public IP Prefix resource . Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * Specifies the number of bits of the prefix. The value can be set between 0 (4,294,967,296 addresses) and 31 (2 addresses). Defaults to `28`(16 addresses). Changing this forces a new resource to be created. * * > **Note:** There may be Public IP address limits on the subscription . [More information available here](https://docs.microsoft.com/azure/azure-subscription-service-limits?toc=%2fazure%2fvirtual-network%2ftoc.json#publicip-address) */ prefixLength?: pulumi.Input; /** * The name of the resource group in which to create the Public IP Prefix. Changing this forces a new resource to be created. */ resourceGroupName: pulumi.Input; /** * The SKU of the Public IP Prefix. Possible values are `Standard` and `StandardV2`. Defaults to `Standard`. Changing this forces a new resource to be created. */ sku?: pulumi.Input; /** * The SKU Tier that should be used for the Public IP Prefix. Possible values are `Regional` and `Global`. Defaults to `Regional`. Changing this forces a new resource to be created. * * > **Note:** When `skuTier` is set to `Global`, `sku` must be set to `Standard`. */ skuTier?: pulumi.Input; /** * A mapping of tags to assign to the resource. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Specifies a list of Availability Zones in which this Public IP Prefix should be located. Changing this forces a new Public IP Prefix to be created. * * > **Note:** Availability Zones are [only supported in several regions at this time](https://docs.microsoft.com/azure/availability-zones/az-overview). */ zones?: pulumi.Input[]>; }