You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/virtual-network/ip-services/manage-public-ip-address-prefix.md
+30-31Lines changed: 30 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,40 +2,39 @@
2
2
title: Create, change, or delete an Azure public IP address prefix
3
3
titlesuffix: Azure Virtual Network
4
4
description: Learn about public IP address prefixes and how to create, change, or delete them.
5
-
services: virtual-network
6
5
author: asudbring
7
6
ms.service: virtual-network
8
7
ms.subservice: ip-services
9
8
ms.topic: conceptual
10
-
ms.date: 05/13/2019
9
+
ms.date: 03/30/2023
11
10
ms.author: allensu
12
11
---
13
12
14
13
# Manage a public IP address prefix
15
14
16
-
A public IP address prefix is a contiguous range of standard SKU public IP addresses. When you create a public IP address resource, you can assign a static public IP from the prefix and associate the address to Azure resources. For more information, see [Public IP address prefix overview](public-ip-address-prefix.md). This article explains how to create, modify, or delete public IP address prefixes, as well as creating public IPs from an existing prefix.
15
+
A public IP address prefix is a contiguous range of standard SKU public IP addresses. When you create a public IP address resource, you can assign a static public IP from the prefix and associate the address to Azure resources. For more information, see [Public IP address prefix overview](public-ip-address-prefix.md). This article explains how to create, modify, or delete public IP address prefixes, and create public IPs from an existing prefix.
17
16
18
17
## Create a public IP address prefix
19
18
20
19
The following section details the parameters when creating a public IP prefix.
21
20
22
-
|Setting|Required?|Details|
23
-
|---|---|---|
24
-
|Subscription|Yes|Must exist in the same [subscription](../../azure-glossary-cloud-terminology.md?toc=%2fazure%2fvirtual-network%2ftoc.json#subscription) as the resource you want to associate the public IP address to.|
25
-
|Resource group|Yes|Can exist in the same, or different, [resource group](../../azure-glossary-cloud-terminology.md?toc=%2fazure%2fvirtual-network%2ftoc.json#resource-group) as the resource you want to associate the public IP address to.|
26
-
|Name|Yes|The name must be unique within the resource group you select.|
27
-
|Region|Yes|Must exist in the same [region](https://azure.microsoft.com/regions)as the public IP addresses you'll assign addresses from the range.|
28
-
|IP version|Yes| IP version of the prefix (v4 or v6).
29
-
|Prefix size|Yes| The size of the prefix you need. A range with 16 IP addresses (/28 for v4 or /124 for v6) is the default.
21
+
|Setting|Required?|Details|
22
+
|---|---|---|
23
+
|Subscription|Yes|Must exist in the same [subscription](../../azure-glossary-cloud-terminology.md?toc=%2fazure%2fvirtual-network%2ftoc.json#subscription) as the resource you want to associate the public IP address to.|
24
+
|Resource group|Yes|Can exist in the same, or different, [resource group](../../azure-glossary-cloud-terminology.md?toc=%2fazure%2fvirtual-network%2ftoc.json#resource-group) as the resource you want to associate the public IP address to.|
25
+
|Name|Yes|The name must be unique within the resource group you select.|
26
+
|Region|Yes|Must exist in the same [region](https://azure.microsoft.com/regions)as the public IP addresses assigned from the range.|
27
+
|IP version|Yes| IP version of the prefix (v4 or v6).|
28
+
|Prefix size|Yes| The size of the prefix you need. A range with 16 IP addresses (/28 for v4 or /124 for v6) is the default.|
30
29
31
-
Alternatively, you may use the CLI and PowerShell commands below to create a public IP address prefix.
30
+
Alternatively, you may use the following CLI and PowerShell commands to create a public IP address prefix.
>In regions with availability zones, you can use PowerShell or CLI commands to create a public IP address prefix as either: non-zonal, associated with a specific zone, or to use zone-redundancy. For API version 2020-08-01 or later, if a zone parameter is not provided, a non-zonal public IP address prefix is created. For versions of the API older than 2020-08-01, a zone-redundant public IP address prefix is created.
@@ -44,18 +43,18 @@ Alternatively, you may use the CLI and PowerShell commands below to create a pub
44
43
45
44
The following section details the parameters required when creating a static public IP address from a prefix.
46
45
47
-
|Setting|Required?|Details|
48
-
|---|---|---|
49
-
|Name|Yes|The name of the public IP address must be unique within the resource group you select.|
50
-
|Idle timeout (minutes)|No|How many minutes to keep a TCP or HTTP connection open without relying on clients to send keep-alive messages. |
51
-
|DNS name label|No|Must be unique within the Azure region you create the name in (across all subscriptions and all customers). Azure automatically registers the name and IP address in its DNS so you can connect to a resource with the name. Azure appends a default subnet *location.cloudapp.azure.com* to the name you provide to create the fully qualified DNS name. For more information, see [Use Azure DNS with an Azure public IP address](../../dns/dns-custom-domain.md?toc=%2fazure%2fvirtual-network%2ftoc.json#public-ip-address).|
46
+
|Setting|Required?|Details|
47
+
|---|---|---|
48
+
|Name|Yes|The name of the public IP address must be unique within the resource group you select.|
49
+
|Idle timeout (minutes)|No|How many minutes to keep a TCP or HTTP connection open without relying on clients to send keep-alive messages. |
50
+
|DNS name label| No |Must be unique within the Azure region you create the name in (across all subscriptions and all customers). </br> Azure automatically registers the name and IP address in its DNS so you can connect to a resource with the name. </br> Azure appends a default subnet *location.cloudapp.azure.com* to the name you provide to create the fully qualified DNS name. </br> For more information, see [Use Azure DNS with an Azure public IP address](../../dns/dns-custom-domain.md?toc=%2fazure%2fvirtual-network%2ftoc.json#public-ip-address).|
52
51
53
-
Alternatively, you may use the CLI and PowerShell commands below with the **--public-ip-prefix(CLI)** and **-PublicIpPrefix(PowerShell)** parameters, to create a public IP address resource from a prefix.
52
+
Alternatively, you may use the following CLI and PowerShell commands with the **`--public-ip-prefix`****(CLI)** and **`-PublicIpPrefix`****(PowerShell)** parameters, to create a public IP address resource from a prefix.
>When requesting a Public IP address from a Public IP Prefix, the allocation is not deterministic or sequential. If a specific Public IP address from a Public IP Prefix is required, the PowerShell or CLI commands allow for this. For PowerShell, the `IpAddress` parameter (followed by the desired IP) should be used; for CLI, the `ip-address` parameter (followed by the desired IP) should be used.
@@ -69,10 +68,10 @@ To view or delete a prefix, the following commands can be used in Azure CLI and
69
68
70
69
**Commands**
71
70
72
-
|Tool|Command|
73
-
|---|---|
74
-
|CLI|[az network public-ip prefix list](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-list) to list public IP addresses<br>[az network public-ip prefix show](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-show) to show settings<br> [az network public-ip prefix update](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-update) to update<br>[az network public-ip prefix delete](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-delete) to delete|
75
-
|PowerShell|[Get-AzPublicIpPrefix](/powershell/module/az.network/get-azpublicipprefix) to retrieve a public IP address object and view its settings<br>[Set-AzPublicIpPrefix](/powershell/module/az.network/set-azpublicipprefix) to update settings<br> [Remove-AzPublicIpPrefix](/powershell/module/az.network/remove-azpublicipprefix) to delete|
71
+
|Tool|Command|
72
+
|---|---|
73
+
|CLI|[az network public-ip prefix list](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-list) to list public IP addresses. <br>[az network public-ip prefix show](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-show) to show settings. <br> [az network public-ip prefix update](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-update) to update. <br>[az network public-ip prefix delete](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-delete) to delete. |
74
+
|PowerShell|[Get-AzPublicIpPrefix](/powershell/module/az.network/get-azpublicipprefix) to retrieve a public IP address object and view its settings. <br>[Set-AzPublicIpPrefix](/powershell/module/az.network/set-azpublicipprefix) to update settings. <br> [Remove-AzPublicIpPrefix](/powershell/module/az.network/remove-azpublicipprefix) to delete. |
76
75
77
76
## Permissions
78
77
@@ -83,7 +82,7 @@ For permissions to manage public IP address prefixes, your account must be assig
83
82
| Microsoft.Network/publicIPPrefixes/read | Read a public IP address prefix |
84
83
| Microsoft.Network/publicIPPrefixes/write | Create or update a public IP address prefix |
85
84
| Microsoft.Network/publicIPPrefixes/delete | Delete a public IP address prefix |
86
-
|Microsoft.Network/publicIPPrefixes/join/action | Create a public IP address from a prefix |
85
+
|Microsoft.Network/publicIPPrefixes/join/action | Create a public IP address from a prefix |
0 commit comments