Merge pull request #92258 from ecfan/patch-1

Add "read" operations reference and clarify gateway installation, resource, and subscription relationships

Author: v-albemi

articles/logic-apps/logic-apps-gateway-connection.md

@@ -8,14 +8,14 @@ author: ecfan
 ms.author: estfan
 ms.reviewer: arthii, LADocs
 ms.topic: article
-ms.date: 09/01/2019
+ms.date: 10/18/2019
 ---
 
 # Connect to on-premises data sources from Azure Logic Apps
 
-To access data sources on premises from your logic apps, create an on-premises data gateway resource in the Azure portal. Your logic apps can then use the [on-premises connectors](../connectors/apis-list.md#on-premises-connectors). Azure Logic Apps supports write operations, including inserts and updates, through the gateway. However, these operations have [limits on their payload size](https://docs.microsoft.com/data-integration/gateway/service-gateway-onprem#considerations).
+Before you can access data sources on premises from your logic apps, you need to create an Azure resource after you [install the *on-premises data gateway* on a local computer](../logic-apps/logic-apps-gateway-install.md). Your logic apps then use this Azure gateway resource in the triggers and actions provided by the [on-premises connectors](../connectors/apis-list.md#on-premises-connectors) that are available for Azure Logic Apps.
 
-This article shows how to create your Azure gateway resource *after* you [download and install the gateway on a local computer](../logic-apps/logic-apps-gateway-install.md). For more information about the gateway, see [How the gateway works](../logic-apps/logic-apps-gateway-install.md#gateway-cloud-service). 
+This article shows how to create your Azure gateway resource for a previously [installed gateway on your local computer](../logic-apps/logic-apps-gateway-install.md). For more information about the gateway, see [How the gateway works](../logic-apps/logic-apps-gateway-install.md#gateway-cloud-service).
 
 > [!TIP]
 > To connect to Azure virtual networks, consider creating an 
@@ -32,7 +32,7 @@ For information about how to use the gateway with other services, see these arti
 
 ## Supported data sources
 
-For Azure Logic Apps, the on-premises data gateway supports [on-premises connectors](../connectors/apis-list.md#on-premises-connectors) for these data sources:
+In Azure Logic Apps, the on-premises data gateway supports the [on-premises connectors](../connectors/apis-list.md#on-premises-connectors) for these data sources:
 
 * BizTalk Server 2016
 * File System
@@ -47,23 +47,23 @@ For Azure Logic Apps, the on-premises data gateway supports [on-premises connect
 * SQL Server
 * Teradata
 
-Although the gateway itself doesn't incur additional costs, the [Logic Apps pricing model](../logic-apps/logic-apps-pricing.md) applies to these connectors and other operations in Azure Logic Apps.
+Azure Logic Apps supports read and write operations through the data gateway. However, these operations have [limits on their payload size](https://docs.microsoft.com/data-integration/gateway/service-gateway-onprem#considerations). Although the gateway itself doesn't incur additional costs, the [Logic Apps pricing model](../logic-apps/logic-apps-pricing.md) applies to these connectors and other operations in Azure Logic Apps.
 
 ## Prerequisites
 
-* You've already [installed the on-premises data gateway on a local computer](../logic-apps/logic-apps-gateway-install.md).
+* You already [installed the on-premises data gateway on a local computer](../logic-apps/logic-apps-gateway-install.md).
 
-* You have the [same Azure account and Azure subscription](../logic-apps/logic-apps-gateway-install.md#requirements) that you used when you installed the on-premises data gateway.
+* You have the [same Azure account and subscription](../logic-apps/logic-apps-gateway-install.md#requirements) that was used when installing that data gateway.
 
-* You haven't previously linked your gateway installation to another gateway resource in Azure.
+* Your gateway installation isn't already registered and claimed by another Azure gateway resource.
 
-  When you create a gateway resource, you select a gateway installation to associate with your gateway resource. An already linked gateway installation isn't available for you to select when creating gateway resources.
+  When you create a gateway resource in the Azure portal, you select a gateway installation, which links to your gateway resource and only that gateway resource. In Azure Logic Apps, on-premises triggers and actions then use the gateway resource for connecting to on-premises data sources. In these triggers and actions, you select your Azure subscription and the associated gateway resource that you want to use. Each gateway resource links to only one gateway installation, which links to only one Azure account.
 
 <a name="create-gateway-resource"></a>
 
 ## Create Azure gateway resource
 
-After you install the gateway on a local computer, create the Azure resource for your gateway. 
+After you install the gateway on a local computer, create the Azure resource for your gateway.
 
 1. Sign in to the [Azure portal](https://portal.azure.com) with the same Azure account that was used to install the gateway.
 
@@ -79,16 +79,16 @@ After you install the gateway on a local computer, create the Azure resource for
 
    | Property | Description |
    |----------|-------------|
-   | **Resource Name** | Your gateway resource name, which can contain only letters, numbers, hyphens (`-`), underscores (`_`), parentheses (`(`, `)`), and periods (`.`). |
-   | **Subscription** | Your Azure subscription, which must be the same as gateway installation and logic app. The default subscription is based on the Azure account that you used to sign in. |
+   | **Resource Name** | Provide a name for your gateway resource that contains only letters, numbers, hyphens (`-`), underscores (`_`), parentheses (`(`, `)`), or periods (`.`). |
+   | **Subscription** | Select the Azure subscription for the Azure account that was used for the gateway installation. The default subscription is based on the Azure account that you used to sign in. |
    | **Resource group** | The [Azure resource group](../azure-resource-manager/resource-group-overview.md) that you want to use |
-   | **Location** | The same region as the location that was selected for the gateway cloud service during [gateway installation](../logic-apps/logic-apps-gateway-install.md). Otherwise, your gateway installation won't appear in the **Installation Name** list for you to select. Your logic app location can differ from your gateway resource location. |
-   | **Installation Name** | If your gateway installation isn't already selected, select the gateway that you previously installed. Previously linked gateway installations won't appear in this list for you to select. |
+   | **Location** | The same region or location that was selected for the gateway cloud service during [gateway installation](../logic-apps/logic-apps-gateway-install.md). Otherwise, your gateway installation won't appear in the **Installation Name** list. Your logic app location can differ from your gateway resource location. |
+   | **Installation Name** | Select a gateway installation, which appears in the list only when these conditions are met: <p><p>- Exists in the same region as the gateway resource that you want to create <br>- Unlinked to another Azure gateway resource <br>- Linked to the same Azure account that you're using to create the gateway resource <p><p>For more information, see the [Frequently asked questions](#faq) section. |
    |||
 
-   Here is an example:
+   Here is an example that shows a gateway installation that's in the same region as your gateway resource and is linked to the same Azure account:
 
-   ![Provide details to create your on-premises data gateway](./media/logic-apps-gateway-connection/gateway-details.png)
+   ![Provide details to create data gateway resource](./media/logic-apps-gateway-connection/gateway-details.png)
 
 <a name="connect-logic-app-gateway"></a>
 
@@ -100,41 +100,43 @@ After you create your gateway resource and associate your Azure subscription wit
 
 1. Add a connector that supports on-premises connections, for example, **SQL Server**.
 
-1. Select **Connect via on-premises data gateway**. 
+1. Select **Connect via on-premises data gateway**.
+
+1. Under **Gateways**, from the **Subscriptions** list, select your Azure subscription that has the gateway resource you want.
 
-1. For **Gateways**, select the gateway resource that you created.
+1. From the **Connection Gateway** list, which shows the available gateway resources in your selected subscription, select the gateway resource that you want. Each gateway resource is linked to a single gateway installation.
 
    > [!NOTE]
    > The gateways list includes gateway resources in other regions because your 
-   > logic app's location can differ from your gateway resource's location.
+   > logic app's location can differ from your gateway resource's location. 
 
 1. Provide a unique connection name and other required information, which depends on the connection that you want to create.
 
    A unique connection name helps you easily find that connection later, especially if you create multiple connections. If applicable, also include the qualified domain for your username.
-   
+
    Here is an example:
 
    ![Create connection between logic app and data gateway](./media/logic-apps-gateway-connection/logic-app-gateway-connection.png)
 
-1. When you're done, select **Create**. 
+1. When you're done, select **Create**.
 
 Your gateway connection is now ready for your logic app to use.
 
 ## Edit connection
 
 To update the settings for a gateway connection, you can edit your connection.
 
-1. To find all API connections for just your logic app, on your logic app's menu, under **Development Tools**, select **API connections**.
-   
+1. To find all the API connections for just your logic app, on your logic app's menu, under **Development Tools**, select **API connections**.
+
    ![On your logic app menu, select "API Connections"](./media/logic-apps-gateway-connection/logic-app-find-api-connections.png)
 
 1. Select the gateway connection you want, and then select **Edit API connection**.
 
    > [!TIP]
-   > If your updates don't take effect, 
-   > try [stopping and restarting the gateway Windows service account](../logic-apps/logic-apps-gateway-install.md#restart-gateway) for your gateway installation.
+   > If your updates don't take effect, try 
+   > [stopping and restarting the gateway Windows service account](../logic-apps/logic-apps-gateway-install.md#restart-gateway) for your gateway installation.
 
-To find all API connections associated with your Azure subscription: 
+To find all API connections associated with your Azure subscription:
 
 * From the main Azure menu, go to **All services** > **Web** > **API Connections**.
 * Or, from the main Azure menu, go to **All resources**. Set the **Type** filter to **API Connection**.
@@ -143,7 +145,7 @@ To find all API connections associated with your Azure subscription:
 
 ## Delete gateway resource
 
-To create a different gateway resource, link your gateway installation to a different gateway resource, or remove the gateway resource, you can delete the gateway resource without affecting the gateway installation. 
+To create a different gateway resource, link your gateway installation to a different gateway resource, or remove the gateway resource, you can delete the gateway resource without affecting the gateway installation.
 
 1. From the main Azure menu, select **All resources**. Find and select your gateway resource.
 
@@ -157,12 +159,14 @@ To create a different gateway resource, link your gateway installation to a diff
 
 ## Frequently asked questions
 
-**Q**: Why don't I see my gateway installation when I create the gateway resource in Azure? <br/>
+**Q**: Why doesn't my gateway installation appear when I create my gateway resource in Azure? <br/>
 **A**: This issue can happen for these reasons:
 
-* Your gateway installation is already registered and claimed by another gateway resource in Azure. Gateway installations don't appear in the instances list after gateway resources are created for them. To check your gateway registrations in the Azure portal, review all your Azure resources with the **On-premises Data Gateways** type for *all* Azure subscriptions.
+* Your Azure account has to be the same account that's linked to the gateway installation on the local computer. Check that you're signed in to the Azure portal with the same identity that's linked to the gateway installation.
+
+* Your gateway resource and gateway installation have to use the same region. However, your logic app location can differ from your gateway resource location.
 
-* The Azure AD identity for the person who installed the gateway differs from the person who signed in to the Azure portal. Check that you're signed in with the same identity that installed the gateway.
+* Your gateway installation is already registered and claimed by another gateway resource. These installations won't appear in the **Installation Name** list. To review your gateway registrations in the Azure portal, find all your Azure resources that have the **On-premises Data Gateways** type across *all* your Azure subscriptions. To unlink the gateway installation from the other gateway resource, see [Delete gateway resource](#change-delete-gateway-resource).
 
 [!INCLUDE [existing-gateway-location-changed](../../includes/logic-apps-existing-gateway-location-changed.md)]