Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into nw-grafana

Author: halkazwini

.openpublishing.redirection.json

@@ -1,6 +1,16 @@
 {
     "redirections": [
     {
+      "source_path": "articles/traffic-manager/powershell-samples.md",
+      "redirect_url": "/previous-versions/azure/traffic-manager/powershell-samples",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "articles/traffic-manager/scripts/traffic-manager-cli-websites-high-availability.md",
+      "redirect_url": "/previous-versions/azure/traffic-manager/scripts/traffic-manager-cli-websites-high-availability",
+      "redirect_document_id": false
+     },
+     {
       "source_path": "articles/network-watcher/network-watcher-security-group-view-powershell.md",
       "redirect_url": "/previous-versions/azure/network-watcher/network-watcher-security-group-view-powershell",
       "redirect_document_id": false
@@ -34,7 +44,7 @@
       "source_path": "articles/germany/index.yml",
       "redirect_url": "/previous-versions/azure/germany/index",
       "redirect_document_id": false
-    },
+     },
         {
             "source_path_from_root": "/articles/internet-analyzer/internet-analyzer-cli.md",
             "redirect_url": "/previous-versions/azure/internet-analyzer/internet-analyzer-cli",

articles/azure-resource-manager/management/frequently-asked-questions.yml

@@ -3,7 +3,7 @@ metadata:
   title: Azure Resource Manager frequently asked questions
   description: Answers to common questions about using Azure Resource Manager to manage resources.
   ms.topic: faq
-  ms.date: 02/22/2024
+  ms.date: 05/31/2024
   content_well_notification: 
     - AI-contribution
   ai-usage: ai-assisted
@@ -35,12 +35,6 @@ sections:
           resource group location, we recommend that you select a location close to where your control operations originate. Typically, this location is the one closest to 
           your current location.
 
-      - question: Can I move a resource group to a different subscription?
-        answer: |
-          No, you can't move a resource group to a new subscription. But, you can move all of the resources in the resource group to a resource group in another 
-          subscription. Settings such as tags, role assignments, and policies aren't automatically transferred from the original resource group to the destination resource group. 
-          You need to reapply these settings to the new resource group. For more information, see [Move resources to new resource group or subscription](./move-support-resources.md).
-
   - name: Resources
     questions:
       - question: What happens if two operations update the same resource at the same time?

articles/azure-resource-manager/management/move-resource-group-and-subscription.md

@@ -1,8 +1,8 @@
 ---
 title: Move resources to a new subscription or resource group
-description: Use Azure Resource Manager to move resources to a new resource group or subscription.
+description: Describes how to move resources to a new resource group or subscription, and the steps to take to ensure a successful move operation.
 ms.topic: conceptual
-ms.date: 04/24/2023
+ms.date: 05/31/2024
 ms.custom: devx-track-azurecli, devx-track-azurepowershell, devx-track-arm-template, devx-track-python
 content_well_notification: 
   - AI-contribution
@@ -472,6 +472,10 @@ If the source or target resource group contains a virtual network, the states of
 
 When you receive this error, you have two options. Either move your resources to a resource group that doesn't have a virtual network, or [contact support](../../azure-portal/supportability/how-to-create-azure-support-request.md).
 
+**Question: Can I move a resource group to a different subscription?**
+
+No, you can't move a resource group to a new subscription. But, you can move all of the resources in the resource group to a resource group in another subscription. Settings such as tags, role assignments, and policies aren't automatically transferred from the original resource group to the destination resource group. You need to reapply these settings to the new resource group. For more information, see [Move resources to new resource group or subscription](./move-support-resources.md).
+
 ## Next steps
 
 For a list of which resources support move, see [Move operation support for resources](move-support-resources.md).

articles/azure-resource-manager/management/overview.md

@@ -2,7 +2,7 @@
 title: Azure Resource Manager overview
 description: Describes how to use Azure Resource Manager for deployment, management, and access control of resources on Azure.
 ms.topic: overview
-ms.date: 02/16/2024
+ms.date: 05/31/2024
 ms.custom: devx-track-arm-template
 ---
 
@@ -87,19 +87,7 @@ There are some important factors to consider when defining your resource group:
 
 * You can move a resource from one resource group to another group. For more information, see [Move resources to new resource group or subscription](move-resource-group-and-subscription.md).
 
-* The resources in a resource group can be located in different regions than the resource group.
-
-* When you create a resource group, you need to provide a location for that resource group. 
-
-  You may be wondering, "Why does a resource group need a location? And, if the resources can have different locations than the resource group, why does the resource group location matter at all?"
-
-  The resource group stores metadata about the resources. When you specify a location for the resource group, you're specifying where that metadata is stored. For compliance reasons, you may need to ensure that your data is stored in a particular region.
-
-  To ensure state consistency for the resource group, all [control plane operations](./control-plane-and-data-plane.md) are routed through the resource group's location. When selecting a resource group location, we recommend that you select a location close to where your control operations originate. Typically, this location is the one closest to your current location. This routing requirement only applies to control plane operations for the resource group. It doesn't affect requests that are sent to your applications.
-  
-  If a resource group's region is temporarily unavailable, you may not be able to update resources in the resource group because the metadata is unavailable. The resources in other regions still function as expected, but you may not be able to update them. This condition may also apply to global resources like Azure DNS, Azure DNS Private Zones, Azure Traffic Manager, and Azure Front Door. You can view which types have their metadata managed by Azure Resource Manager via the [list of types for the Azure Resource Graph resources table](../../governance/resource-graph/reference/supported-tables-resources.md#resources).
-   
-  For more information about building reliable applications, see [Designing reliable Azure applications](/azure/architecture/checklist/resiliency-per-service).
+* The resources in a resource group can be located in different regions than the resource group, but we recommend that you use the same location. See [What location should I use for my resource group?](#what-location-should-i-use-for-my-resource-group)
 
 * A resource group can be used to scope access control for administrative actions. To manage a resource group, you can assign [Azure Policies](../../governance/policy/overview.md), [Azure roles](../../role-based-access-control/role-assignments-portal.yml), or [resource locks](lock-resources.md).
 
@@ -115,6 +103,22 @@ There are some important factors to consider when defining your resource group:
 
 * To create a resource group, you can use the [portal](manage-resource-groups-portal.md#create-resource-groups), [PowerShell](manage-resource-groups-powershell.md#create-resource-groups), [Azure CLI](manage-resource-groups-cli.md#create-resource-groups), or an [ARM template](../templates/deploy-to-subscription.md#resource-groups).
 
+## What location should I use for my resource group?
+
+When you create a resource group, you need to provide a location for that resource group.
+
+You may be wondering, "Why does a resource group need a location? And, if the resources can have different locations than the resource group, why does the resource group location matter at all?"
+
+The resource group stores metadata about the resources. When you specify a location for the resource group, you're specifying where that metadata is stored. For compliance reasons, you may need to ensure that your data is stored in a particular region.
+
+To ensure state consistency for the resource group, all [control plane operations](./control-plane-and-data-plane.md) are routed through the resource group's location. When selecting a resource group location, we recommend that you select a location close to where your control operations originate. Typically, this location is the one closest to your current location. This routing requirement only applies to control plane operations for the resource group. It doesn't affect requests that are sent to your applications.
+  
+If a resource group's region is temporarily unavailable, you may not be able to update resources in the resource group because the metadata is unavailable. The resources in other regions still function as expected, but you may not be able to update them. This condition may also apply to global resources like Azure DNS, Azure DNS Private Zones, Azure Traffic Manager, and Azure Front Door. You can view which types have their metadata managed by Azure Resource Manager via the [list of types for the Azure Resource Graph resources table](../../governance/resource-graph/reference/supported-tables-resources.md#resources).
+
+To reduce the impact of regional outages, we recommend that you locate resources in the same region as the resource group. When the resource group's region is unavailable, Azure Resource Manager is unable to update your resource's metadata and blocks your write calls. By colocating your resource and resource group region, you reduce the risk of region unavailability because your resources and metadata exist in one region instead of multiple regions.
+
+For more information about building reliable applications, see [Designing reliable Azure applications](/azure/architecture/checklist/resiliency-per-service).
+
 ## Resiliency of Azure Resource Manager
 
 The Azure Resource Manager service is designed for resiliency and continuous availability. Resource Manager and control plane operations (requests sent to `management.azure.com`) in the REST API are:
@@ -129,14 +133,6 @@ The Azure Resource Manager service is designed for resiliency and continuous ava
 
 This resiliency applies to services that receive requests through Resource Manager. For example, Key Vault benefits from this resiliency.
 
-## Resource group location alignment
-
-To reduce the impact of regional outages, we recommend that you locate resources in the same region as the resource group.
-
-The resource group location is where Azure Resource Manager stores metadata for the resources in the resource group. Azure Resource Manager uses this location for routing and caching. For example, when you list your resources at the subscription or resource group scopes, Azure Resource Manager gets the information from the cache.
-
-When the resource group's region is unavailable, Azure Resource Manager is unable to update your resource's metadata and blocks your write calls. By colocating your resource and resource group region, you reduce the risk of region unavailability because your resources and metadata exist in one region instead of multiple regions.
-
 ## Resolve concurrent operations
 
 When two or more operations try to update the same resource at the same time, Azure Resource Manager detects the conflict and permits only one operation to complete successfully. Azure Resource Manager blocks the other operations and returns an error.

articles/machine-learning/how-to-read-write-data-v2.md

@@ -78,16 +78,20 @@ ml_client = MLClient(
 )
 
 # ==============================================================
-# Set the URI path for the data. Supported paths include:
+# Set the URI path for the data.
+# Supported `path` formats for input include:
 # local: `./<path>
 # Blob: wasbs://<container_name>@<account_name>.blob.core.windows.net/<path>
 # ADLS: abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>
 # Datastore: azureml://datastores/<data_store_name>/paths/<path>
 # Data Asset: azureml:<my_data>:<version>
-# We set the path to a file on a public blob container
+# Supported `path` format for output is:
+# Datastore: azureml://datastores/<data_store_name>/paths/<path>
+# We set the input path to a file on a public blob container
 # ==============================================================
 path = "wasbs://[email protected]/titanic.csv"
 
+
 # ==============================================================
 # What type of data does the path point to? Options include:
 # data_type = AssetTypes.URI_FILE # a specific file
@@ -139,12 +143,15 @@ Create a job specification YAML file (`<file-name>.yml`).
 $schema: https://azuremlschemas.azureedge.net/latest/commandJob.schema.json
 
 # ==============================================================
-# Set the URI path for the data. Supported paths include:
+# Set the URI path for the data.
+# Supported `path` formats for input include:
 # local: `./<path>
 # Blob: wasbs://<container_name>@<account_name>.blob.core.windows.net/<path>
 # ADLS: abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>
 # Datastore: azureml://datastores/<data_store_name>/paths/<path>
 # Data Asset: azureml:<my_data>:<version>
+# Supported `path` format for output is:
+# Datastore: azureml://datastores/<data_store_name>/paths/<path>
 # ==============================================================
 
 # ==============================================================
@@ -212,12 +219,15 @@ ml_client = MLClient(
 )
 
 # ==============================================================
-# Set the input and output URI paths for the data. Supported paths include:
+# Set the URI path for the data.
+# Supported `path` formats for input include:
 # local: `./<path>
 # Blob: wasbs://<container_name>@<account_name>.blob.core.windows.net/<path>
 # ADLS: abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>
 # Datastore: azureml://datastores/<data_store_name>/paths/<path>
 # Data Asset: azureml:<my_data>:<version>
+# Supported `path` format for output is:
+# Datastore: azureml://datastores/<data_store_name>/paths/<path>
 # As an example, we set the input path to a file on a public blob container
 # As an example, we set the output path to a folder in the default datastore
 # ==============================================================
@@ -259,8 +269,8 @@ outputs = {
                           path=output_path, 
                           mode=output_mode,
                           # optional: if you want to create a data asset from the output, 
-                          # then uncomment name (name can be set without setting version)
-                          # name = "<name_of_data_asset>",
+                          # then uncomment `name` (`name` can be set without setting `version`, and in this way, we will set `version` automatically for you)
+                          # name = "<name_of_data_asset>", # use `name` and `version` to create a data asset from the output
                           # version = "<version>",
                   )
 }
@@ -319,10 +329,10 @@ outputs:
     path: azureml://datastores/workspaceblobstore/paths/quickstart-output/titanic.csv
     type: uri_file
     # optional: if you want to create a data asset from the output, 
-    # then uncomment name (name can be set without setting version)
-    # name: <name_of_data_asset>
+    # then uncomment `name` (`name` can be set without setting `version`, and in this way, we will set `version` automatically for you)
+    # name: <name_of_data_asset> # use `name` and `version` to create a data asset from the output
     # version: <version>
-    
+
 ```
 
 Next, submit the job using the CLI:
@@ -352,13 +362,13 @@ When you submit a job, the Azure Machine Learning data runtime controls the data
 
 When you provide a data input/output to a job, you must specify a `path` parameter that points to the data location. This table shows the different data locations that Azure Machine Learning supports, and also shows `path` parameter examples:
 
-|Location  | Examples  |
-|---------|---------|
-|A path on your local computer     | `./home/username/data/my_data`         |
-|A path on a public http(s) server    |  `https://raw.githubusercontent.com/pandas-dev/pandas/main/doc/data/titanic.csv`    |
-|A path on Azure Storage     |   `wasbs://<container_name>@<account_name>.blob.core.windows.net/<path>`<br>`abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>`    |
-|A path on an Azure Machine Learning Datastore   |   `azureml://datastores/<data_store_name>/paths/<path>`      |
-|A path to a Data Asset  |  `azureml:<my_data>:<version>`  |
+|Location  | Examples  | Input | Output |
+|---------|---------|---------|---------|
+|A path on your local computer     | `./home/username/data/my_data`         |Y|N|
+|A path on a public http(s) server    |  `https://raw.githubusercontent.com/pandas-dev/pandas/main/doc/data/titanic.csv`    |Y|N|
+|A path on Azure Storage     |   `wasbs://<container_name>@<account_name>.blob.core.windows.net/<path>`<br>`abfss://<file_system>@<account_name>.dfs.core.windows.net/<path>`    |Y, only for identity-based authentication.|N|
+|A path on an Azure Machine Learning Datastore   |   `azureml://datastores/<data_store_name>/paths/<path>`      |Y|Y|
+|A path to a Data Asset  |  `azureml:<my_data>:<version>`  |Y|N, but you can use `name` and `version` to create a data asset from output|
 
 ## Modes
 
@@ -1127,4 +1137,4 @@ az ml job create -f <file-name>.yml
 
 * [Train models](how-to-train-model.md)
 * [Tutorial: Create production ML pipelines with Python SDK v2](tutorial-pipeline-python-sdk.md)
-* Learn more about [Data in Azure Machine Learning](concept-data.md)
+* Learn more about [Data in Azure Machine Learning](concept-data.md)