Merge pull request #105278 from Blackmist/acr-disclaimer

troubleshooting info

Author: ttorble

articles/machine-learning/how-to-create-workspace-template.md

@@ -59,10 +59,12 @@ The example template has two parameters:
     The names of the other services are generated randomly.
 
 > [!TIP]
-> While the template associated with this document creates a new Azure Container Registry, you can also create a new workspace without creating a container registry. If on container registry is present in the workspace, one will be created when you perform an operation that requires a container registry. For example, training or deploying a model.
+> While the template associated with this document creates a new Azure Container Registry, you can also create a new workspace without creating a container registry. One will be created when you perform an operation that requires a container registry. For example, training or deploying a model.
 >
 > You can also reference an existing container registry or storage account in the Azure Resource Manager template, instead of creating a new one.
 
+[!INCLUDE [machine-learning-delete-acr](../../includes/machine-learning-delete-acr.md)]
+
 For more information on templates, see the following articles:
 
 * [Author Azure Resource Manager templates](../azure-resource-manager/templates/template-syntax.md)

articles/machine-learning/how-to-manage-rest.md

@@ -397,6 +397,23 @@ providers/Microsoft.Storage/storageAccounts/{your-storage-account-name}"
 
 You should receive a `202 Accepted` response and, in the returned headers, a `Location` URI. You can GET this URI for information on the deployment, including helpful debugging information if there is a problem with one of your dependent resources (for instance, if you forgot to enable admin access on your container registry). 
 
+## Troubleshooting
+
+### Resource provider errors
+
+[!INCLUDE [machine-learning-resource-provider](../../includes/machine-learning-resource-provider.md)]
+
+### Moving the workspace
+
+> [!WARNING]
+> Moving your Azure Machine Learning workspace to a different subscription, or moving the owning subscription to a new tenant, is not supported. Doing so may cause errors.
+
+### Deleting the Azure Container Registry
+
+The Azure Machine Learning workspace uses Azure Container Registry (ACR) for some operations. It will automatically create an ACR instance when it first needs one.
+
+[!INCLUDE [machine-learning-delete-acr](../../includes/machine-learning-delete-acr.md)]
+
 ## Next steps
 
 - Explore the complete [AzureML REST API reference](https://docs.microsoft.com/rest/api/azureml/).

articles/machine-learning/how-to-manage-workspace-cli.md

@@ -346,6 +346,17 @@ For more information, see the [az ml workspace delete](https://docs.microsoft.co
 
 [!INCLUDE [machine-learning-resource-provider](../../includes/machine-learning-resource-provider.md)]
 
+### Moving the workspace
+
+> [!WARNING]
+> Moving your Azure Machine Learning workspace to a different subscription, or moving the owning subscription to a new tenant, is not supported. Doing so may cause errors.
+
+### Deleting the Azure Container Registry
+
+The Azure Machine Learning workspace uses Azure Container Registry (ACR) for some operations. It will automatically create an ACR instance when it first needs one.
+
+[!INCLUDE [machine-learning-delete-acr](../../includes/machine-learning-delete-acr.md)]
+
 ## Next steps
 
 For more information on the Azure CLI extension for machine learning, see the [az ml](https://docs.microsoft.com/cli/azure/ext/azure-cli-ml/ml?view=azure-cli-latest) documentation.

articles/machine-learning/how-to-manage-workspace.md

@@ -117,6 +117,12 @@ Use the Delete button at the top of the workspace you wish to delete.
 > [!WARNING]
 > Moving your Azure Machine Learning workspace to a different subscription, or moving the owning subscription to a new tenant, is not supported. Doing so may cause errors.
 
+### Deleting the Azure Container Registry
+
+The Azure Machine Learning workspace uses Azure Container Registry (ACR) for some operations. It will automatically create an ACR instance when it first needs one.
+
+[!INCLUDE [machine-learning-delete-acr](../../includes/machine-learning-delete-acr.md)]
+
 ## Next steps
 
 Follow the full-length tutorial to learn how to use a workspace to build, train, and deploy models with Azure Machine Learning.

includes/machine-learning-delete-acr.md

@@ -0,0 +1,10 @@
+---
+author: Blackmist
+ms.service: machine-learning
+ms.topic: include
+ms.date: 02/24/2020
+ms.author: larryfr
+---
+
+> [!WARNING]
+> Once an Azure Container Registry has been created for a workspace, do not delete it. Doing so will break your Azure Machine Learning workspace.