Merge pull request #115325 from RonyMSFT/20200514rpregistration

20200514rpregistration

Author: ttorble

articles/synapse-analytics/overview-faq.md

@@ -30,8 +30,7 @@ A: Azure Synapse is an integrated data platform for BI, AI, and continuous intel
 
 ### Q: How do I get started with Azure Synapse Analytics
 
-A: To start using Azure Synapse Analytics, create a [Synapse workspace](https://portal.azure.com) (it's free!) and create the resources that you want under that workspace. You can follow one of our quickstart tutorials, such as [Create a Synapse SQL pool](quickstart-create-sql-pool-portal.md) or [Create a workspace](quickstart-create-workspace.md), that will walk you through simple use case. 
-
+A: To start using Azure Synapse Analytics, [register Azure Synapse resource provider](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types) by selecting *Microsoft.Synapse* from the list of resource providers. Then create a [Synapse workspace](https://portal.azure.com) (it's free!) and create the resources that you want under that workspace. You can follow one of our quickstart tutorials, such as [Create a Synapse SQL pool](quickstart-create-sql-pool.md) or [Create a workspace](quickstart-create-workspace.md), that will walk you through simple use case. 
 You can also find sample notebooks and SQL scripts in our [repository](https://github.com/Azure/azure-synapse-analytics/tree/master/samples). If you need to connect to a public dataset, create a new linked service with the following attributes:
 
 - azure_storage_account_name = "azureopendatastorage"

articles/synapse-analytics/quickstart-create-workspace.md

@@ -21,6 +21,9 @@ If you don't have an Azure subscription, [create a free account before you begin
 
 - [Azure Data Lake Storage Gen2 storage account](../storage/common/storage-account-create.md?toc=/azure/synapse-analytics/toc.json&bc=/azure/synapse-analytics/breadcrumb/toc.json)
 
+## Register Azure Synapse resource provider
+If you have not already done so, register Azure Synapse resource provider. Registering a resource provider configures your subscription to work with the resource provider. For registering Azure Synapse resource provider, see [Azure resource providers and types](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types). Choose *Microsoft.Synapse* from the list of resource providers when you register.
+
 ## Sign in to the Azure portal
 
 Sign in to the [Azure portal](https://portal.azure.com/)

articles/synapse-analytics/security/how-to-connect-to-workspace-with-private-links.md

@@ -13,19 +13,24 @@ ms.reviewer: jrasnick
 
 This article will teach you how to create private endpoint to your Azure Synapse workspace. See [private links and private endpoints](https://docs.microsoft.com/azure/private-link/) to learn more.
 
-## Step 1: Open your Azure Synapse workspace in Azure portal
+## Step 1: Register Network resource provider
+
+If you have not already done so, register the Network resource provider. Registering a resource provider configures your subscription to work with the resource provider. Choose *Microsoft.Network* from the list of resource providers when you [register](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types). If the Network resource provider is already registered, then proceed to Step 2.
+
+
+## Step 2: Open your Azure Synapse workspace in Azure portal
 
 Select **Private endpoint connection** under **Security** and then select **+ Private endpoint**.
 ![Open Azure Synapse workspace in Azure portal](./media/how-to-connect-to-workspace-with-private-links/private-endpoint-1.png)
 
-## Step 2: Select your subscription and region details
+## Step 3: Select your subscription and region details
 
 Under the **Basics** tab in the **Create a private endpoint** window, choose your **Subscription** and **Resource Group**. Give a **Name** to the private endpoint that you want to create. Select the **Region** where you want the private endpoint created.
 
 Private endpoints are created in a subnet. The subscription, resource group, and region selected filter the private endpoint subnets. Select **Next: Resource >** when done.
 ![Select subscription and region details](./media/how-to-connect-to-workspace-with-private-links/private-endpoint-2.png)
 
-## Step 3: Select your Azure Synapse workspace details
+## Step 4: Select your Azure Synapse workspace details
 
 Select **Connect to an Azure resource in my directory** in the **Resource** tab. Select the **Subscription** that contains your Azure Synapse workspace. The **Resource type** for creating private endpoints to an Azure Synapse workspace is *Microsoft.Synapse/workspaces*.
 

articles/synapse-analytics/security/synapse-workspace-managed-private-endpoints.md

@@ -27,8 +27,9 @@ Private endpoint uses a private IP address from your VNet to effectively bring t
 
 >[!IMPORTANT]
 >Managed private endpoints are only supported in Azure Synapse workspaces with a Managed workspace VNet.
+
 >[!NOTE]
->It's recommended that you create Managed private endpoints to connect to all your Azure data sources. All outbound traffic from the >Managed workspace VNet will be blocked in the future.
+>All outbound traffic from the Managed workspace VNet except through Managed private endpoints will be blocked in the future. It's recommended that you create Managed private endpoints to connect to all your Azure data sources external to the workspace. 
 
 A private endpoint connection is created in a "Pending" state when you create a Managed private endpoint in Azure Synapse. An approval workflow is initiated. The private link resource owner is responsible to approve or reject the connection.
 

articles/synapse-analytics/security/synapse-workspace-managed-vnet.md

@@ -37,6 +37,8 @@ SQL pool and SQL on-demand are multi-tenant capabilities and therefore reside ou
 
 ## Create an Azure Synapse workspace with a Managed workspace VNet
 
+If you have not already done so, register the Network resource provider. Registering a resource provider configures your subscription to work with the resource provider. Choose *Microsoft.Network* from the list of resource providers when you [register](https://docs.microsoft.com/azure/azure-resource-manager/management/resource-providers-and-types).
+
 To create an Azure Synapse workspace that has a Managed workspace VNet associated with it, select the **Security + networking** tab in Azure portal and check the **Enable managed virtual network** checkbox.
 
 If you leave the checkbox unchecked, then your workspace won't have a VNet associated with it.
@@ -47,7 +49,7 @@ If you leave the checkbox unchecked, then your workspace won't have a VNet assoc
 ![Enable Managed workspace VNet](./media/synapse-workspace-managed-vnet/enable-managed-vnet-1.png)
 
 >[!NOTE]
->All outbound traffic from the Managed workspace VNet will be blocked in the future. It's recommended that you connect to all your data sources using Managed private endpoints.
+>All outbound traffic from the Managed workspace VNet except through Managed private endpoints will be blocked in the future. It's recommended that you create Managed private endpoints to connect to all your Azure data sources external to the workspace. 
 
 You can check whether your Azure Synapse workspace is associated to a Managed workspace VNet by selecting **Overview** from Azure portal.