Skip to content

Commit fa14e3e

Browse files
Merge pull request #202644 from ecfan/patch-2
Clarity edits
2 parents d242921 + 3c89e32 commit fa14e3e

File tree

4 files changed

+69
-53
lines changed

4 files changed

+69
-53
lines changed

articles/connectors/built-in.md

Lines changed: 58 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Overview about built-in connectors in Azure Logic Apps
3-
description: Learn about built-in connectors that run natively to create automated integration workflows in Azure Logic Apps.
2+
title: Built-in connector overview
3+
description: Learn about built-in connectors that run natively in Azure Logic Apps.
44
services: logic-apps
55
ms.suite: integration
66
ms.reviewer: estfan, azla
@@ -24,22 +24,46 @@ This article provides a general overview about built-in connectors in Consumptio
2424

2525
## Built-in connectors in Consumption versus Standard
2626

27-
The following table lists the current and expanding galleries of built-in connectors available for Consumption versus Standard logic app workflows. An asterisk (**\***) marks [service provider-based built-in connectors](../logic-apps/custom-connector-overview.md#service-provider-interface-implementation).
27+
The following table lists the current and expanding galleries of built-in connectors available for Consumption versus Standard logic app workflows. For Standard workflows, an asterisk (**\***) marks [built-in connectors based on the *service provider* model](#service-provider-interface-implementation), which is described in more detail later.
2828

2929
| Consumption | Standard |
3030
|-------------|----------|
3131
| Azure API Management<br>Azure App Services <br>Azure Functions <br>Azure Logic Apps <br>Batch <br>Control <br>Data Operations <br>Date Time <br>Flat File <br>HTTP <br>Inline Code <br>Integration Account <br>Liquid <br>Request <br>Schedule <br>Variables <br>XML | Azure Blob* <br>Azure Cosmos DB* <br>Azure Functions <br>Azure Queue* <br>Azure Table Storage* <br>Control <br>Data Operations <br>Date Time <br>DB2* <br>Event Hubs* <br>Flat File <br>FTP* <br>HTTP <br>IBM Host File* <br>Inline Code <br>Liquid operations <br>MQ* <br>Request <br>Schedule <br>Service Bus* <br>SFTP* <br>SQL Server* <br>Variables <br>Workflow operations <br>XML operations |
3232
|||
3333

34+
<a name="service-provider-interface-implementation"></a>
35+
36+
## Service provider-based built-in connectors
37+
38+
In Standard logic app workflows, a built-in connector that has the following attributes is informally known as a *service provider*:
39+
40+
* Is based on the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md).
41+
42+
* Provides access from a Standard logic app workflow to a service, such as Azure Blob Storage, Azure Service Bus, Azure Event Hubs, SFTP, and SQL Server.
43+
44+
Some built-in connectors support only a single way to authenticate a connection to the underlying service. Other built-in connectors can offer a choice, such as using a connection string, Azure Active Directory (Azure AD), or a managed identity.
45+
46+
* Runs in the same process as the redesigned Azure Logic Apps runtime.
47+
48+
These service provider-based built-in connectors are available alongside their [managed connector versions](managed.md).
49+
50+
In contrast, a built-in connector that's *not a service provider* has the following attributes:
51+
52+
* Isn't based on the Azure Functions extensibility model.
53+
54+
* Is directly implemented as a job within the Azure Logic Apps runtime, such as Schedule, HTTP, Request, and XML operations.
55+
3456
<a name="custom-built-in"></a>
3557

3658
## Custom built-in connectors
3759

38-
For Standard logic apps, if a built-connector isn't available for your scenario, you can create your own built-in connector. You can use the same [*service provider interface implementation*](../logic-apps/custom-connector-overview.md#service-provider-interface-implementation) that's used by service provider-based built-in connectors, such as SQL Server, Service Bus, Blob Storage, Event Hubs, and Blob Storage. This interface implementation is based on the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md) and provides the capability for you to create custom built-in connectors that anyone can use in Standard logic apps.
60+
For Standard logic apps, you can create your own built-in connector with the same [built-in connector extensibility model](../logic-apps/custom-connector-overview.md#built-in-connector-extensibility-model) that's used by service provider-based built-in connectors, such as Azure Blob, Azure Event Hubs, Azure Service Bus, SQL Server, and more. This interface implementation is based on the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md) and provides the capability for you to create custom built-in connectors that anyone can use in Standard logic apps.
61+
62+
For Consumption logic apps, you can't create your own built-in connectors, but you create your own managed connectors.
3963

4064
For more information, review the following documentation:
4165

42-
* [Custom connectors for Standard logic apps](../logic-apps/custom-connector-overview.md#custom-connector-standard)
66+
* [Custom connectors in Azure Logic Apps](../logic-apps/custom-connector-overview.md#custom-connector-standard)
4367
* [Create custom built-in connectors for Standard logic apps](../logic-apps/create-custom-built-in-connector-standard.md)
4468

4569
<a name="general-built-in"></a>
@@ -120,19 +144,19 @@ You can use the following built-in connectors to perform general tasks, for exam
120144
:::row-end:::
121145
:::row:::
122146
:::column:::
123-
[![FTP icon][ftp-icon]][ftp-doc]
147+
![FTP icon][ftp-icon]
124148
\
125149
\
126-
[**FTP**][ftp-doc]<br>(*Standard logic app only*)
150+
**FTP**<br>(*Standard logic app only*)
127151
\
128152
\
129153
Connect to FTP or FTPS servers you can access from the internet so that you can work with your files and folders.
130154
:::column-end:::
131155
:::column:::
132-
[![SFTP-SSH icon][sftp-ssh-icon]][sftp-ssh-doc]
156+
![SFTP-SSH icon][sftp-ssh-icon]
133157
\
134158
\
135-
[**SFTP-SSH**][sftp-ssh-doc]<br>(*Standard logic app only*)
159+
**SFTP-SSH**<br>(*Standard logic app only*)
136160
\
137161
\
138162
Connect to SFTP servers that you can access from the internet by using SSH so that you can work with your files and folders.
@@ -145,9 +169,9 @@ You can use the following built-in connectors to perform general tasks, for exam
145169

146170
<a name="service-built-in"></a>
147171

148-
## Service-based built-in connectors
172+
## Built-in connectors for specific services and systems
149173

150-
Connectors for some services provide both built-in connectors and managed connectors, which might differ across these versions.
174+
You can use the following built-in connectors to access specific services and systems. In Standard logic app workflows, some of these built-in connectors are also informally known as *service providers*, which can differ from their managed connector counterparts in some ways.
151175

152176
:::row:::
153177
:::column:::
@@ -172,75 +196,75 @@ Connectors for some services provide both built-in connectors and managed connec
172196
When Swagger is included, the triggers and actions defined by these apps appear like any other first-class triggers and actions in Azure Logic Apps.
173197
:::column-end:::
174198
:::column:::
175-
[![Azure Blob icon icon][azure-blob-storage-icon]][azure-app-services-doc]
199+
![Azure Blob icon][azure-blob-storage-icon]
176200
\
177201
\
178-
[**Azure Blob**][azure-blob-storage-doc]<br>(*Standard logic app only*)
202+
**Azure Blob**<br>(*Standard logic app only*)
179203
\
180204
\
181205
Connect to your Azure Blob Storage account so you can create and manage blob content.
182206
:::column-end:::
183207
:::column:::
184-
[![Azure Cosmos DB icon][azure-cosmos-db-icon]][azure-cosmos-db-doc]
208+
![Azure Cosmos DB icon][azure-cosmos-db-icon]
185209
\
186210
\
187-
[**Azure Cosmos DB**][azure-cosmos-db-doc]<br>(*Standard logic app only*)
211+
**Azure Cosmos DB**<br>(*Standard logic app only*)
188212
\
189213
\
190214
Connect to Azure Cosmos DB so that you can access and manage Azure Cosmos DB documents.
191215
:::column-end:::
192216
:::column:::
193-
[![Azure Functions icon][azure-functions-icon]][azure-functions-doc]
217+
![Azure Event Hubs icon][azure-event-hubs-icon]
194218
\
195219
\
196-
[**Azure Functions**][azure-functions-doc]
220+
**Azure Event Hubs**<br>(*Standard logic app only*)
197221
\
198222
\
199-
Call [Azure-hosted functions](../azure-functions/functions-overview.md) to run your own *code snippets* (C# or Node.js) within your workflow.
223+
Consume and publish events through an event hub. For example, get output from your logic app with Event Hubs, and then send that output to a real-time analytics provider.
200224
:::column-end:::
201225
:::row-end:::
202226
:::row:::
203227
:::column:::
204-
[![Azure Logic Apps icon][azure-logic-apps-icon]][nested-logic-app-doc]
228+
[![Azure Functions icon][azure-functions-icon]][azure-functions-doc]
205229
\
206230
\
207-
[**Azure Logic Apps**][nested-logic-app-doc]<br>(*Consumption logic app*) <br><br>-or-<br><br>[**Workflow operations**][nested-logic-app-doc]<br>(*Standard logic app*)
231+
[**Azure Functions**][azure-functions-doc]
208232
\
209233
\
210-
Call other workflows that start with the Request trigger named **When a HTTP request is received**.
234+
Call [Azure-hosted functions](../azure-functions/functions-overview.md) to run your own *code snippets* (C# or Node.js) within your workflow.
211235
:::column-end:::
212236
:::column:::
213-
[![Azure Service Bus icon][azure-service-bus-icon]][azure-service-bus-doc]
237+
[![Azure Logic Apps icon][azure-logic-apps-icon]][nested-logic-app-doc]
214238
\
215239
\
216-
[**Azure Service Bus**][azure-service-bus-doc]<br>(*Standard logic app only*)
240+
[**Azure Logic Apps**][nested-logic-app-doc]<br>(*Consumption logic app*) <br><br>-or-<br><br>**Workflow operations**<br>(*Standard logic app*)
217241
\
218242
\
219-
Manage asynchronous messages, queues, sessions, topics, and topic subscriptions.
243+
Call other workflows that start with the Request trigger named **When a HTTP request is received**.
220244
:::column-end:::
221245
:::column:::
222-
[![Azure Table Storage icon][azure-table-storage-icon]][azure-table-storage-doc]
246+
![Azure Service Bus icon][azure-service-bus-icon]
223247
\
224248
\
225-
[**Azure Table Storage**][azure-table-storage-doc]<br>(*Standard logic app only*)
249+
**Azure Service Bus**<br>(*Standard logic app only*)
226250
\
227251
\
228-
Connect to your Azure Storage account so that you can create, update, query, and manage tables.
252+
Manage asynchronous messages, queues, sessions, topics, and topic subscriptions.
229253
:::column-end:::
230254
:::column:::
231-
[![Azure Event Hubs icon][azure-event-hubs-icon]][azure-event-hubs-doc]
255+
![Azure Table Storage icon][azure-table-storage-icon]
232256
\
233257
\
234-
[**Event Hubs**][azure-event-hubs-doc]<br>(*Standard logic app only*)
258+
**Azure Table Storage**<br>(*Standard logic app only*)
235259
\
236260
\
237-
Consume and publish events through an event hub. For example, get output from your logic app with Event Hubs, and then send that output to a real-time analytics provider.
261+
Connect to your Azure Storage account so that you can create, update, query, and manage tables.
238262
:::column-end:::
239263
:::column:::
240-
[![IBM DB2 icon][ibm-db2-icon]][ibm-db2-doc]
264+
![IBM DB2 icon][ibm-db2-icon]
241265
\
242266
\
243-
[**DB2**][ibm-db2-doc]<br>(*Standard logic app only*)
267+
**DB2**<br>(*Standard logic app only*)
244268
\
245269
\
246270
Connect to IBM DB2 in the cloud or on-premises. Update a row, get a table, and more.
@@ -257,10 +281,10 @@ Connectors for some services provide both built-in connectors and managed connec
257281
Connect to IBM Host File and generate or parse contents.
258282
:::column-end:::
259283
:::column:::
260-
[![IBM MQ icon][ibm-mq-icon]][ibm-mq-doc]
284+
![IBM MQ icon][ibm-mq-icon]
261285
\
262286
\
263-
[**MQ**][ibm-mq-doc]<br>(*Standard logic app only*)
287+
**IBM MQ**<br>(*Standard logic app only*)
264288
\
265289
\
266290
Connect to IBM MQ on-premises or in Azure to send and receive messages.

articles/logic-apps/custom-connector-overview.md

Lines changed: 6 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: logic-apps
55
ms.suite: integration
66
ms.reviewer: estfan, daviburg, apseth, psrivas, azla
77
ms.topic: conceptual
8-
ms.date: 05/17/2022
8+
ms.date: 06/10/2022
99
# As a developer, I want learn about the capability to create custom connectors with operations that I can use in my Azure Logic Apps workflows.
1010
---
1111

@@ -47,23 +47,15 @@ In [multi-tenant Azure Logic Apps](logic-apps-overview.md), you can create [cust
4747

4848
In [single-tenant Azure Logic Apps](logic-apps-overview.md), the redesigned Azure Logic Apps runtime powers Standard logic app workflows. This runtime differs from the multi-tenant Azure Logic Apps runtime that powers Consumption logic app workflows. The single-tenant runtime uses the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md), which provides a key capability for you to create your own [built-in connectors](../connectors/built-in.md) for anyone to use in Standard workflows. In most cases, the built-in version provides better performance, capabilities, pricing, and so on.
4949

50-
When single-tenant Azure Logic Apps officially released, new built-in connectors included Azure Blob Storage, Azure Event Hubs, Azure Service Bus, and SQL Server. Over time, this list of built-in connectors continues to grow. However, if you need connectors that aren't available in Standard logic app workflows, you can [create your own built-in connectors](create-custom-built-in-connector-standard.md) using the same extensibility model that's used by built-in connectors in Standard workflows.
50+
When single-tenant Azure Logic Apps officially released, new built-in connectors included Azure Blob Storage, Azure Event Hubs, Azure Service Bus, and SQL Server. Over time, this list of built-in connectors continues to grow. However, if you need connectors that aren't available in Standard logic app workflows, you can [create your own built-in connectors](create-custom-built-in-connector-standard.md) using the same extensibility model that's used by *service provider-based* built-in connectors in Standard workflows.
5151

5252
<a name="service-provider-interface-implementation"></a>
5353

54-
### Built-in connectors as service providers
54+
### Service provider-based built-in connectors
5555

56-
In single-tenant Azure Logic Apps, a built-in connector that has the following attributes is called a *service provider*:
56+
In single-tenant Azure Logic Apps, a [built-in connector with specific attributes is informally known as a *service provider*](../connectors/built-in.md#service-provider-interface-implementation). For example, these connectors are based on the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md), which provide the capability for you to create your own custom built-in connectors to use in Standard logic app workflows.
5757

58-
* Is based on the [Azure Functions extensibility model](../azure-functions/functions-bindings-register.md).
59-
60-
* Provides access from a Standard logic app workflow to a service, such as Azure Blob Storage, Azure Service Bus, Azure Event Hubs, SFTP, and SQL Server.
61-
62-
Some built-in connectors support only a single way to authenticate a connection to the underlying service. Other built-in connectors can offer a choice, such as using a connection string, Azure Active Directory (Azure AD), or a managed identity.
63-
64-
* Runs in the same process as the redesigned Azure Logic Apps runtime.
65-
66-
A built-in connector that's *not a service provider* has the following attributes:
58+
In contrast, non-service provider built-in connectors have the following attributes:
6759

6860
* Isn't based on the Azure Functions extensibility model.
6961

@@ -206,4 +198,4 @@ This method has a default implementation, so you don't need to explicitly implem
206198

207199
When you're ready to start the implementation steps, continue to the following article:
208200

209-
* [Create custom built-in connectors for Standard logic apps in single-tenant Azure Logic Apps](create-custom-built-in-connector-standard.md)
201+
* [Create custom built-in connectors for Standard logic apps in single-tenant Azure Logic Apps](create-custom-built-in-connector-standard.md)

articles/logic-apps/single-tenant-overview-compare.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,7 @@ The single-tenant model and **Logic App (Standard)** resource type include many
193193

194194
* Create logic apps and their workflows from [hundreds of managed connectors](/connectors/connector-reference/connector-reference-logicapps-connectors) for Software-as-a-Service (SaaS) and Platform-as-a-Service (PaaS) apps and services plus connectors for on-premises systems.
195195

196-
* More managed connectors are now available as built-in connectors in Standard logic app workflows. The built-in versions run natively on the single-tenant Azure Logic Apps runtime. Some built-in connectors are also [*service provider-based* connectors](custom-connector-overview.md#service-provider-interface-implementation). For a list, review the [Built-in connectors for Standard logic apps](#built-connectors-standard) section later in this article.
196+
* More managed connectors are now available as built-in connectors in Standard logic app workflows. The built-in versions run natively on the single-tenant Azure Logic Apps runtime. Some built-in connectors are also informally known as [*service provider* connectors](../connectors/built-in.md#service-provider-interface-implementation). For a list, review [Built-in connectors in Consumption and Standard](../connectors/built-in.md#built-in-connectors).
197197

198198
* You can create your own custom built-in connectors for any service that you need by using the single-tenant Azure Logic Apps extensibility framework. Similar to built-in connectors such as Azure Service Bus and SQL Server, custom built-in connectors provide higher throughput, low latency, and local connectivity because they run in the same process as the single-tenant runtime. However, custom built-in connectors aren't similar to [custom managed connectors](../connectors/apis-list.md#custom-connectors-and-apis), which aren't currently supported. For more information, review [Custom connector overview](custom-connector-overview.md#custom-connector-standard) and [Create custom built-in connectors for Standard logic apps in single-tenant Azure Logic Apps](create-custom-built-in-connector-standard.md).
199199

@@ -244,7 +244,7 @@ A Standard logic app workflow has many of the same built-in connectors as a Cons
244244

245245
For example, a Standard logic app workflow has both managed connectors and built-in connectors for Azure Blob, Azure Cosmos DB, Azure Event Hubs, Azure Service Bus, DB2, FTP, MQ, SFTP, SQL Server, and others. Although a Consumption logic app workflow doesn't have these same built-in connector versions, other built-in connectors such as Azure API Management, Azure App Services, and Batch, are available.
246246

247-
In single-tenant Azure Logic Apps, [built-in connectors with specific attributes are informally known as *service providers*](custom-connector-overview.md#service-provider-interface-implementation). Some built-in connectors support only a single way to authenticate a connection to the underlying service. Other built-in connectors can offer a choice, such as using a connection string, Azure Active Directory (Azure AD), or a managed identity. All built-in connectors run in the same process as the redesigned Azure Logic Apps runtime. For more information, review the [built-in connector list for Standard logic app workflows](../connectors/built-in.md).
247+
In single-tenant Azure Logic Apps, [built-in connectors with specific attributes are informally known as *service providers*](../connectors/built-in.md#service-provider-interface-implementation). Some built-in connectors support only a single way to authenticate a connection to the underlying service. Other built-in connectors can offer a choice, such as using a connection string, Azure Active Directory (Azure AD), or a managed identity. All built-in connectors run in the same process as the redesigned Azure Logic Apps runtime. For more information, review the [built-in connector list for Standard logic app workflows](../connectors/built-in.md#built-in-connectors).
248248

249249
<a name="limited-unavailable-unsupported"></a>
250250

0 commit comments

Comments
 (0)