Skip to content

Commit 9b047b3

Browse files
authored
Merge pull request #232918 from asudbring/vnet-old-review-2
Review of manage a public IP prefix article.
2 parents d995dc6 + 506b6ee commit 9b047b3

File tree

1 file changed

+30
-31
lines changed

1 file changed

+30
-31
lines changed

articles/virtual-network/ip-services/manage-public-ip-address-prefix.md

Lines changed: 30 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -2,40 +2,39 @@
22
title: Create, change, or delete an Azure public IP address prefix
33
titlesuffix: Azure Virtual Network
44
description: Learn about public IP address prefixes and how to create, change, or delete them.
5-
services: virtual-network
65
author: asudbring
76
ms.service: virtual-network
87
ms.subservice: ip-services
98
ms.topic: conceptual
10-
ms.date: 05/13/2019
9+
ms.date: 03/30/2023
1110
ms.author: allensu
1211
---
1312

1413
# Manage a public IP address prefix
1514

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.
1716

1817
## Create a public IP address prefix
1918

2019
The following section details the parameters when creating a public IP prefix.
2120

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. |
3029

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.
3231

3332
**Commands**
3433

35-
|Tool|Command|
36-
|---|---|
37-
|CLI|[az network public-ip prefix create](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-create)|
38-
|PowerShell|[New-AzPublicIpPrefix](/powershell/module/az.network/new-azpublicipprefix)|
34+
| Tool | Command |
35+
| --- | --- |
36+
| CLI | [az network public-ip prefix create](/cli/azure/network/public-ip/prefix#az-network-public-ip-prefix-create) |
37+
| PowerShell |[New-AzPublicIpPrefix](/powershell/module/az.network/new-azpublicipprefix) |
3938

4039
>[!NOTE]
4140
>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
4443

4544
The following section details the parameters required when creating a static public IP address from a prefix.
4645

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). |
5251

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.
5453

55-
|Tool|Command|
56-
|---|---|
57-
|CLI|[az network public-ip create](/cli/azure/network/public-ip#az-network-public-ip-create)|
58-
|PowerShell|[New-AzPublicIpAddress](/powershell/module/az.network/new-azpublicipaddress)|
54+
| Tool | Command |
55+
| --- | --- |
56+
| CLI | [az network public-ip create](/cli/azure/network/public-ip#az-network-public-ip-create) |
57+
| PowerShell | [New-AzPublicIpAddress](/powershell/module/az.network/new-azpublicipaddress) |
5958

6059
>[!NOTE]
6160
>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
6968

7069
**Commands**
7170

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. |
7675

7776
## Permissions
7877

@@ -83,7 +82,7 @@ For permissions to manage public IP address prefixes, your account must be assig
8382
| Microsoft.Network/publicIPPrefixes/read | Read a public IP address prefix |
8483
| Microsoft.Network/publicIPPrefixes/write | Create or update a public IP address prefix |
8584
| 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 |
8786

8887
## Next steps
8988

0 commit comments

Comments
 (0)