Skip to content

Commit 41da96c

Browse files
authored
Merge pull request #288178 from MicrosoftDocs/release-byoipv4parentchild
Release byoipv4parentchild -> main
2 parents 0b2b426 + d9cc706 commit 41da96c

10 files changed

+583
-140
lines changed

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

Lines changed: 14 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,22 @@
11
---
2-
title: Create a custom IPv6 address prefix
2+
title: Create a custom IPv6 address prefix in Azure
33
titleSuffix: Azure Virtual Network
4-
description: Learn how to onboard a custom IPv6 address prefix using the Azure portal, Azure CLI, or PowerShell.
4+
description: Learn how to onboard a custom IPv6 address prefix using the Azure portal, Azure CLI, or Azure PowerShell.
55
author: mbender-ms
66
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

13-
# Create a custom IPv6 address prefix
13+
# Create a custom IPv6 address prefix in Azure
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:
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.
1818

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
24-
25-
For this article, choose between the Azure portal, Azure CLI, or PowerShell to create a custom IPv6 address prefix.
19+
For this article, choose between the Azure portal, Azure CLI, or Azure PowerShell to create a custom IPv6 address prefix.
2620

2721
## Differences between using BYOIPv4 and BYOIPv6
2822

@@ -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 =@{

0 commit comments

Comments
 (0)