Merge pull request #218570 from b-branco/west-europe-support

Add support for West Europe region

Author: ttorble

articles/private-5g-core/collect-required-information-for-a-site.md

@@ -29,7 +29,8 @@ Collect all the values in the following table for the mobile network site resour
    |The Azure subscription to use to create the mobile network site resource. You must use the same subscription for all resources in your private mobile network deployment.                  |**Project details: Subscription**|
    |The Azure resource group in which to create the mobile network site resource. We recommend that you use the same resource group that already contains your private mobile network.                |**Project details: Resource group**|
    |The name for the site.           |**Instance details: Name**|
-   |The region in which you’re creating the mobile network site resource. We recommend that you use the East US region.                         |**Instance details: Region**|
+   |The region in which you deployed the private mobile network.                         |**Instance details: Region**|
+   |The [region code name](region-code-names.md) of the region in which you deployed the private mobile network. For the East US region, this is *eastus*; for West Europe, this is *westeurope*. </br></br>You only need to collect this value if you're going to create your site using an ARM template.                         |Not applicable.|
    |The mobile network resource representing the private mobile network to which you’re adding the site. |**Instance details: Mobile network**|
    |The billing plan for the site that you are creating. The available plans have the following allowances:</br></br> G1 - 1 Gbps per site and 100 devices per network. </br> G2 - 2 Gbps per site and 200 devices per network. </br> G3 - 3 Gbps per site and 300 devices per network. </br> G4 - 4 Gbps per site and 400 devices per network. </br> G5 - 5 Gbps per site and 500 devices per network.|**Instance details: Site plan**|
 

articles/private-5g-core/collect-required-information-for-private-mobile-network.md

@@ -30,7 +30,7 @@ Collect all of the following values for the mobile network resource that will re
    |The Azure subscription to use to deploy the mobile network resource. You must use the same subscription for all resources in your private mobile network deployment. You identified this subscription in [Complete the prerequisite tasks for deploying a private mobile network](complete-private-mobile-network-prerequisites.md).                 |**Project details: Subscription**
    |The Azure resource group to use to deploy the mobile network resource. You should use a new resource group for this resource. It's useful to include the purpose of this resource group in its name for future identification (for example, *contoso-pmn-rg*).                |**Project details: Resource group**|
    |The name for the private mobile network.           |**Instance details: Mobile network name**|
-   |The region in which you're deploying the private mobile network. We recommend you use the East US region.                         |**Instance details: Region**|
+   |The region in which you're deploying the private mobile network. This can be the East US or the West Europe region.                           |**Instance details: Region**|
    |The mobile country code for the private mobile network.     |**Network configuration: Mobile country code (MCC)**|
    |The mobile network code for the private mobile network.     |**Network configuration: Mobile network code (MNC)**|
 

articles/private-5g-core/configure-service-sim-policy-arm-template.md

@@ -24,6 +24,7 @@ If your environment meets the prerequisites and you're familiar with using ARM t
 
 - Ensure you can sign in to the Azure portal using an account with access to the active subscription you used to create your private mobile network. This account must have the built-in Contributor or Owner role at the subscription scope.
 - Identify the name of the Mobile Network resource corresponding to your private mobile network and the resource group containing it.
+- Identify the Azure region in which you deployed your private mobile network.
 - Identify the name of the data network to which you want to assign the new policy.
 - The ARM template is populated with values to configure a default service and SIM policy that allows all traffic in both directions.
 
@@ -50,8 +51,8 @@ Two Azure resources are defined in the template.
 
     - **Subscription:** select the Azure subscription you used to create your private mobile network.
     - **Resource group:** select the resource group containing the Mobile Network resource representing your private mobile network.
-    - **Region:** select **East US**.
-    - **Location:** enter *eastus*.
+    - **Region:** select the region in which you deployed the private mobile network.
+    - **Location:** enter the [code name](region-code-names.md) of the region in which you deployed the private mobile network. For the East US region, this is *eastus*; for West Europe, this is *westeurope*.
     - **Existing Mobile Network Name:** enter the name of the Mobile Network resource representing your private mobile network.
     - **Existing Slice Name:** enter **slice-1**.
     - **Existing Data Network Name:** enter the name of the data network. This value must match the name you used when creating the data network.

articles/private-5g-core/create-overview-dashboard.md

@@ -28,6 +28,7 @@ If your environment meets the prerequisites and you're familiar with using ARM t
 
   - The name of the **Kubernetes - Azure Arc** resource that represents the Kubernetes cluster on which your packet core instance is running.
   - The name of the resource group containing the **Kubernetes - Azure Arc** resource.
+  - The Azure region in which you deployed your private mobile network.
 
 ## Review the template
 
@@ -45,7 +46,7 @@ The template defines one [**Microsoft.Portal/dashboards**](/azure/templates/micr
 
     - **Subscription:** set this to the Azure subscription you used to create your private mobile network.
     - **Resource group:** set this to the resource group in which you want to create the dashboard. You can use an existing resource group or create a new one.
-    - **Region:** select **East US**.
+    - **Region:** select the region in which you deployed the private mobile network.
     - **Connected Cluster Name:** enter the name of the **Kubernetes - Azure Arc** resource that represents the Kubernetes cluster on which your packet core instance is running.
     - **Connected Cluster Resource Group:** enter the name of the resource group containing the **Kubernetes - Azure Arc** resource.
     - **Dashboard Display Name:** enter the name you want to use for the dashboard.

articles/private-5g-core/create-site-arm-template.md

@@ -52,8 +52,8 @@ Four Azure resources are defined in the template.
     |--|--|
     | **Subscription** | Select the Azure subscription you used to create your private mobile network. |
     | **Resource group** | Select the resource group containing the mobile network resource representing your private mobile network. |
-    | **Region** | Select **East US**. |
-    | **Location** | Enter *eastus*. |
+    | **Region** | Select the region in which you deployed the private mobile network. |
+    | **Location** | Enter the [code name](region-code-names.md) of the region in which you deployed the private mobile network. For the East US region, this is *eastus*; for West Europe, this is *westeurope*. |
     | **Existing Mobile Network Name** | Enter the name of the mobile network resource representing your private mobile network. |
     | **Existing Data Network Name** | Enter the name of the data network. This value must match the name you used when creating the data network. |
     | **Site Name** | Enter a name for your site.|

articles/private-5g-core/deploy-private-mobile-network-with-site-arm-template.md

@@ -67,7 +67,7 @@ The following Azure resources are defined in the template.
     |---------|---------|
     |**Subscription**     | Select the Azure subscription you want to use to create your private mobile network.        |
     |**Resource group**     | Create a new resource group.        |
-    |**Region**     | Select **East US**.        |
+    |**Region**     | Select the region in which you're deploying the private mobile network.        |
     |**Location**     | Leave this field unchanged.        |
     |**Mobile Network Name**     | Enter a name for the private mobile network.        |
     |**Mobile Country Code**     | Enter the mobile country code for the private mobile network.        |

articles/private-5g-core/manage-sim-groups.md

@@ -43,7 +43,7 @@ To create a new SIM group:
 1. Do the following on the **Basics** configuration tab.
 
    - Enter a name for the new SIM group into the **SIM group name** field.
-   - Set **Region** to **East US**.
+   - In the **Region** field, select the region in which you deployed the private mobile network.
    - Select your private mobile network from the **Mobile network** drop-down menu.
 
         :::image type="content" source="media/manage-sim-groups/create-sim-group-basics-tab.png" alt-text="Screenshot of the Azure portal showing the Basics configuration tab.":::

articles/private-5g-core/provision-sims-arm-template.md

@@ -24,6 +24,7 @@ If your environment meets the prerequisites and you're familiar with using ARM t
 
 - Ensure you can sign in to the Azure portal using an account with access to the active subscription you identified in [Complete the prerequisite tasks for deploying a private mobile network](complete-private-mobile-network-prerequisites.md). This account must have the built-in Contributor role at the subscription scope.
 - Identify the name of the Mobile Network resource corresponding to your private mobile network and the resource group containing it.
+- Identify the Azure region in which you deployed your private mobile network.
 - Choose a name for the new SIM group to which your SIMs will be added. 
 - Identify the SIM policy you want to assign to the SIMs you're provisioning. You must have already created this SIM policy using the instructions in [Configure a SIM policy - Azure portal](configure-sim-policy-azure-portal.md). 
 
@@ -86,21 +87,21 @@ The following Azure resources are defined in the template.
 
     - **Subscription:** select the Azure subscription you used to create your private mobile network.
     - **Resource group:** select the resource group containing the Mobile Network resource representing your private mobile network.
-    - **Region:** select **East US**.
-    - **Location:** enter *eastus*.
+    - **Region:** select the region in which you deployed the private mobile network.
+    - **Location:** enter the [code name](region-code-names.md) of the region in which you deployed the private mobile network. For the East US region, this is *eastus*; for West Europe, this is *westeurope*.
     - **Existing Mobile Network Name:** enter the name of the Mobile Network resource representing your private mobile network.
     - **Existing Sim Policy Name:** enter the name of the SIM policy you want to assign to the SIMs.
     - **Sim Group Name:** enter the name for the new SIM group.
     - **Sim Resources:** paste in the array you prepared in [Prepare an array for your SIMs](#prepare-an-array-for-your-sims).
 
     :::image type="content" source="media/provision-sims-arm-template/sims-arm-template-configuration-fields.png" alt-text="Screenshot of the Azure portal showing the configuration fields for the SIMs ARM template.":::
 
-1. Select **Review + create**.
-1. Azure will now validate the configuration values you've entered. You should see a message indicating that your values have passed validation.
+2. Select **Review + create**.
+3. Azure will now validate the configuration values you've entered. You should see a message indicating that your values have passed validation.
 
      If the validation fails, you'll see an error message and the **Configuration** tab(s) containing the invalid configuration will be flagged. Select the flagged tab(s) and use the error messages to correct invalid configuration before returning to the **Review + create** tab.
 
-1. Once your configuration has been validated, you can select **Create** to provision your SIMs. The Azure portal will display a confirmation screen when the SIMs have been provisioned.
+4. Once your configuration has been validated, you can select **Create** to provision your SIMs. The Azure portal will display a confirmation screen when the SIMs have been provisioned.
 
 ## Review deployed resources
 

articles/private-5g-core/region-code-names.md

@@ -0,0 +1,29 @@
+---
+title: Region code names for Azure Private 5G Core 
+description: Learn about the region code names used for the location parameter in Azure Private 5G Core ARM templates
+author: b-branco
+ms.author: biancabranco
+ms.service: private-5g-core
+ms.topic: reference
+ms.custom: references_regions
+ms.date: 11/17/2022
+---
+
+# Region code names
+
+When the **location** parameter is used in a command or request, you need to provide the region code name as the **location** value. To get the code name of the region that your private mobile network is in, run the following command in the Azure CLI.
+
+```cloudshell-bash
+az account list-locations -o table
+```
+
+The output of this command is a table of the names and locations for all the Azure regions that your subscription supports. Navigate to the Azure region that has the *DisplayName* you are looking for and use its *Name* value for the **location** parameter.
+
+For example, if you're deploying in the East US region, use *eastus* for the **location** parameter.
+
+```json
+DisplayName               Name                 RegionalDisplayName
+------------------------  -------------------  -------------------------------------
+East US                   eastus               (US) East US
+West Europe               westeurope           (Europe) West Europe
+```

articles/private-5g-core/toc.yml

@@ -120,6 +120,8 @@ items:
   items:
    - name: REST API
      href: /rest/api/mobilenetwork
+   - name: Region code names
+     href: region-code-names.md
 - name: Resources
   items:
   - name: Azure Private 5G Core product page