Skip to content

Commit e3cc9a9

Browse files
author
Michael Bender
committed
Added IPv6 article
1 parent 81341ed commit e3cc9a9

File tree

2 files changed

+14
-22
lines changed

2 files changed

+14
-22
lines changed

articles/virtual-network/ip-services/create-custom-ip-address-prefix-ipv6-portal.md

Lines changed: 10 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -7,20 +7,14 @@ ms.author: mbender
77
ms.service: azure-virtual-network
88
ms.subservice: ip-services
99
ms.topic: how-to
10-
ms.date: 08/24/2023
10+
ms.date: 08/06/2024
1111
---
1212

1313
# Create a custom IPv6 address prefix
1414

15-
A custom IPv6 address prefix enables you to bring your own IPv6 ranges to Microsoft and associate it to your Azure subscription. The range would continue to be owned by you, though Microsoft would be permitted to advertise it to the Internet. A custom IP address prefix functions as a regional resource that represents a contiguous block of customer owned IP addresses.
15+
In this article, you learn how to create a custom IPv6 address prefix. You prepare a range to provision, provision the range for IP allocation, and enable the range to be advertised by Microsoft.
1616

17-
The steps in this article detail the process to:
18-
19-
* Prepare a range to provision
20-
21-
* Provision the range for IP allocation
22-
23-
* Enable the IPv6 range to be advertised by Microsoft
17+
A custom IPv6 address prefix enables you to bring your own IPv6 ranges to Microsoft and associate it to your Azure subscription. The range would continue to be owned by you, though Microsoft would be permitted to advertise it to the Internet. A custom IP address prefix functions as a regional resource that represents a contiguous block of customer owned IP addresses.
2418

2519
For this article, choose between the Azure portal, Azure CLI, or PowerShell to create a custom IPv6 address prefix.
2620

@@ -51,7 +45,7 @@ For this article, choose between the Azure portal, Azure CLI, or PowerShell to c
5145
- Ensure your Az.Network module is 5.1.1 or later. To verify the installed module, use the command `Get-InstalledModule -Name "Az.Network"`. If the module requires an update, use the command `Update-Module -Name "Az.Network"` if necessary.
5246
- A customer owned IPv6 range to provision in Azure. A sample customer range (2a05:f500:2::/48) is used for this example, but wouldn't be validated by Azure; you need to replace the example range with yours.
5347

54-
If you choose to install and use PowerShell locally, this article requires the Azure PowerShell module version 5.4.1 or later. Run `Get-Module -ListAvailable Az` to find the installed version. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-azure-powershell). If you're running PowerShell locally, you also need to run `Connect-AzAccount` to create a connection with Azure
48+
If you choose to install and use PowerShell locally, this article requires the Azure PowerShell module version 5.4.1 or later. Run `Get-Module -ListAvailable Az` to find the installed version. If you need to upgrade, see [Install Azure PowerShell module](/powershell/azure/install-azure-powershell). If you're running PowerShell locally, you also need to run `Connect-AzAccount` to create a connection with Azure.
5549

5650
---
5751

@@ -79,7 +73,7 @@ The following flow creates a custom IP prefix in the specified region and resour
7973

8074
Sign in to the [Azure portal](https://portal.azure.com).
8175

82-
### Create and provision a custom IP address prefix
76+
### Create and provision a custom IPv6 address prefix
8377

8478
1. In the search box at the top of the portal, enter **Custom IP**.
8579

@@ -102,7 +96,6 @@ Sign in to the [Azure portal](https://portal.azure.com).
10296
| Global IPv6 Prefix (CIDR) | Enter **2a05:f500:2::/48**. |
10397
| ROA expiration date | Enter your ROA expiration date in the **yyyymmdd** format. |
10498
| Signed message | Paste in the output of **$byoipauthsigned** from the pre-provisioning section. |
105-
| Availability Zones | Select **Zone-redundant**. |
10699

107100
:::image type="content" source="./media/create-custom-ip-address-prefix-ipv6/create-custom-ipv6-prefix.png" alt-text="Screenshot of create custom IP prefix page in Azure portal.":::
108101

@@ -114,23 +107,23 @@ The range is pushed to the Azure IP Deployment Pipeline. The deployment process
114107

115108
### Provision a regional custom IPv6 address prefix
116109

117-
After the global custom IP prefix is in a **Provisioned** state, regional custom IP prefixes can be created. These ranges must always be of size /64 to be considered valid. The ranges can be created in any region (it doesn't need to be the same as the global custom IP prefix), keeping in mind any geolocation restrictions associated with the original global range. The "children" custom IP prefixes will be advertised locally from the region they're created in. Because the validation is only done for global custom IP prefix provision, no Authorization or Signed message is required. (Because these ranges will be advertised from a specific region, zones can be utilized.)
110+
After the global custom IP prefix is in a **Provisioned** state, regional custom IP prefixes can be created. These ranges must always be of size /64 to be considered valid. The ranges can be created in any region (it doesn't need to be the same as the global custom IP prefix), keeping in mind any geolocation restrictions associated with the original global range. The "children" custom IP prefixes advertise from the region they're created in. Because the validation is only done for global custom IP prefix provision, no Authorization or Signed message is required (but availability zones can be utilized).
118111

119112
In the same **Create a custom IP prefix** page as before, enter or select the following information:
120113

121114
| Setting | Value |
122115
| ------- | ----- |
123116
| **Project details** | |
124117
| Subscription | Select your subscription |
125-
| Resource group | Select **Create new**. </br> Enter **myResourceGroup**. </br> Select **OK**. |
118+
| Resource group | Select **Create new**.</br> Enter **myResourceGroup**.</br> Select **OK**. |
126119
| **Instance details** | |
127120
| Name | Enter **myCustomIPv6RegionalPrefix**. |
128121
| Region | Select **West US 2**. |
129122
| IP Version | Select IPv6. |
130123
| IP prefix range | Select Regional. |
131124
| Custom IP prefix parent | Select myCustomIPv6GlobalPrefix (2a05:f500:2::/48) from the drop-down menu. |
132125
| Regional IPv6 Prefix (CIDR) | Enter **2a05:f500:2:1::/64**. |
133-
| ROA expiration date | Enter your ROA expiration date in the **yyyymmdd** format. |
126+
| ROA expiration date | Enter your ROA (Route Origin Expiration) expiration date in the **yyyymmdd** format. |
134127
| Signed message | Paste in the output of **$byoipauthsigned** from the pre-provisioning section. |
135128
| Availability Zones | Select **Zone-redundant**. |
136129

@@ -203,7 +196,7 @@ The following command creates a custom IP prefix in the specified region and res
203196

204197
### Provision a regional custom IPv6 address prefix
205198

206-
After the global custom IP prefix is in a **Provisioned** state, regional custom IP prefixes can be created. These ranges must always be of size /64 to be considered valid. The ranges can be created in any region (it doesn't need to be the same as the global custom IP prefix), keeping in mind any geolocation restrictions associated with the original global range. The *children* custom IP prefixes are advertised locally from the region they're created in. Because the validation is only done for global custom IP prefix provision, no Authorization or Signed message is required. (Because these ranges are advertised from a specific region, zones can be utilized.)
199+
After the global custom IP prefix is in a **Provisioned** state, regional custom IP prefixes can be created. These ranges must always be of size /64 to be considered valid. The ranges can be created in any region (it doesn't need to be the same as the global custom IP prefix), keeping in mind any geolocation restrictions associated with the original global range. The "children" custom IP prefixes advertise from the region they're created in. Because the validation is only done for global custom IP prefix provision, no Authorization or Signed message is required (but availability zones can be utilized).
207200

208201
```azurecli-interactive
209202
az network custom-ip prefix create \
@@ -256,7 +249,6 @@ It's possible to commission the global custom IPv6 prefix prior to the regional
256249
> [!IMPORTANT]
257250
> As the global custom IPv6 prefix transitions to a **Commissioned** state, the range is being advertised with Microsoft from the local Azure region and globally to the Internet by Microsoft's wide area network under Autonomous System Number (ASN) 8075. Advertising this same range to the Internet from a location other than Microsoft at the same time could potentially create BGP routing instability or traffic loss. For example, a customer on-premises building. Plan any migration of an active range during a maintenance period to avoid impact.
258251
259-
260252
# [Azure PowerShell](#tab/azurepowershell/)
261253

262254
### Create a resource group and specify the prefix and authorization messages
@@ -292,7 +284,7 @@ $myCustomIPv6GlobalPrefix = New-AzCustomIPPrefix @prefix
292284

293285
### Provision a regional custom IPv6 address prefix
294286

295-
After the global custom IP prefix is in a **Provisioned** state, regional custom IP prefixes can be created. These ranges must always be of size /64 to be considered valid. The ranges can be created in any region (it doesn't need to be the same as the global custom IP prefix), keeping in mind any geolocation restrictions associated with the original global range. The "children" custom IP prefixes will be advertised locally from the region they're created in. Because the validation is only done for global custom IP prefix provision, no Authorization or Signed message is required. (Because these ranges will be advertised from a specific region, zones can be utilized.)
287+
After the global custom IP prefix is in a **Provisioned** state, regional custom IP prefixes can be created. These ranges must always be of size /64 to be considered valid. The ranges can be created in any region (it doesn't need to be the same as the global custom IP prefix), keeping in mind any geolocation restrictions associated with the original global range. The "children" custom IP prefixes advertise from the region they're created in. Because the validation is only done for global custom IP prefix provision, no Authorization or Signed message is required (but availability zones can be utilized).
296288

297289
```azurepowershell-interactive
298290
$prefix =@{

includes/ip-services-ipv4-ipv6-differences.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@
44
services: virtual-network
55
sub-services: ip-services
66
author: mbender-ms
7-
ms.service: virtual-network
7+
ms.service: azure-virtual-network
88
ms.topic: include
9-
ms.date: 07/29/2024
9+
ms.date: 08/06/2024
1010
ms.author: mbender
1111
ms.custom: include file
1212
---
@@ -16,6 +16,6 @@
1616
1717
* Custom IPv6 prefixes use a *parent*/*child* model. In this model, the Microsoft Wide Area Network (WAN) advertises the global (parent) range, and the respective Azure regions advertise the regional (child) ranges. Global ranges must be /48 in size, while regional ranges must always be /64 size. You can have multiple /64 ranges per region.
1818

19-
* Only the global range needs to be validated using the steps detailed in the [Create Custom IP Address Prefix](../articles/virtual-network/ip-services/create-custom-ip-address-prefix-portal.md) articles. The regional ranges are derived from the global range in a similar manner to the way public IP prefixes are derived from custom IP prefixes.
19+
* Only the global range needs to be validated using the steps detailed in [Create Custom IP Address Prefix](create-custom-ip-address-prefix-portal.md). The regional ranges are derived from the global range in a similar manner to the way public IP prefixes are derived from custom IP prefixes.
2020

21-
* Public IPv6 prefixes must be derived from the regional ranges. Only the first 2048 IPv6 addresses of each regional /64 custom IP prefix can be utilized as valid IPv6 space. Attempting to create public IPv6 prefixes that span beyond this result in an error.
21+
* Public IPv6 prefixes must be derived from the regional ranges. Only the first 2048 IPv6 addresses of each regional /64 custom IP prefix can be utilized as valid IPv6 space. Attempting to create public IPv6 prefixes that span beyond this range results in an error.

0 commit comments

Comments
 (0)