Skip to content

Commit 5907e83

Browse files
authored
Merge pull request #179053 from ecfan/chunking
Azure Logic Apps: Add note about chunking protocol
2 parents 11b6f10 + 6cfb6b8 commit 5907e83

File tree

1 file changed

+17
-17
lines changed

1 file changed

+17
-17
lines changed

articles/logic-apps/logic-apps-handle-large-messages.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,28 @@
11
---
2-
title: Handle large messages by using chunking
3-
description: Learn how to handle large message sizes by using chunking in automated tasks and workflows that you create with Azure Logic Apps
2+
title: Handle large messages in workflows using chunking
3+
description: Handle large messages using chunking in Azure Logic Apps.
44
services: logic-apps
55
ms.suite: integration
6-
ms.topic: article
6+
ms.topic: how-to
77
ms.date: 12/18/2020
88
---
99

10-
# Handle large messages with chunking in Azure Logic Apps
10+
# Handle large messages in workflows using chunking in Azure Logic Apps
1111

12-
When handling messages, Logic Apps limits message content to a maximum size.
13-
This limit helps reduce overhead created by storing and processing large messages.
14-
To handle messages larger than this limit, Logic Apps can *chunk* a large
15-
message into smaller messages. That way, you can still transfer large
16-
files using Logic Apps under specific conditions.
17-
When communicating with other services through connectors or HTTP,
18-
Logic Apps can consume large messages but *only* in chunks.
19-
This condition means connectors must also support chunking, or the underlying
20-
HTTP message exchange between Logic Apps and these services must use chunking.
12+
Azure Logic Apps has different maximum limits on the message content size that triggers and actions can handle in logic app workflows, based on the logic app resource type and the environment where that logic app workflow runs. These limits help reduce any overhead that results from storing and processing [large messages](#what-is-large-message). For more information about message size limits, review [Message limits in Azure Logic Apps](logic-apps-limits-and-config.md#messages).
2113

22-
This article shows how you can set up chunking for actions handling messages that are
23-
larger than the limit. Logic App triggers don't
24-
support chunking because of the increased overhead of exchanging multiple messages.
14+
If you're using built-in HTTP actions or specific managed connector actions, and you need Azure Logic Apps to work with messages larger than the default limits, you can enable *chunking*, which splits a large message into smaller messages. That way, you can still transfer large files under specific conditions. In fact, when you use these built-in HTTP actions or specific managed connector actions, chunking is the only way that Azure Logic Apps can consume large messages. This requirement means that either the underlying HTTP message exchange between Azure Logic Apps and other services must use chunking, or that the connections created by the managed connectors that you want to use must also support chunking.
15+
16+
> [!NOTE]
17+
> Azure Logic Apps doesn't support chunking on triggers due to the increased overhead from exchanging multiple messages.
18+
> Also, Azure Logic Apps implements chunking for HTTP actions using its own protocol as described in this article.
19+
> So, even if your web site or web service supports chunking, they won't work with HTTP action chunking.
20+
> To use HTTP action chunking with your web site or web service, you have to implement the same protocol
21+
> that's used by Azure Logic Apps. Otherwise, don't enable chunking on the HTTP action.
22+
23+
This article provides an overview about how chunking works in Azure Logic Apps and how to set up chunking on supported actions.
24+
25+
<a name="what-is-large-message"></a>
2526

2627
## What makes messages "large"?
2728

@@ -58,7 +59,6 @@ For connectors that support chunking, the underlying chunking protocol is invisi
5859
However, not all connectors support chunking, so these connectors generate runtime
5960
errors when incoming messages exceed the connectors' size limits.
6061

61-
6262
For actions that support and are enabled for chunking, you can't use trigger bodies, variables, and expressions such as `@triggerBody()?['Content']` because using any of these inputs prevents the chunking operation from happening. Instead, use the [**Compose** action](../logic-apps/logic-apps-perform-data-operations.md#compose-action). Specifically, you must create a `body` field by using the **Compose** action to store the data output from the trigger body, variable, expression, and so on, for example:
6363

6464
```json

0 commit comments

Comments
 (0)