Skip to content

Commit 713f177

Browse files
Merge pull request #301319 from TimShererWithAquent/us439212-06
Freshness Edit: Azure Messaging Service (6 of 10)
2 parents 34c6674 + 8a54d9c commit 713f177

File tree

2 files changed

+17
-18
lines changed

2 files changed

+17
-18
lines changed
Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,51 @@
11
---
2-
title: 'Quickstart: Send and receive large messages with Azure Event Hubs (preview)'
3-
description: In this quickstart, you learn how to send and receive large messages with Azure Event Hubs.
2+
title: 'Quickstart: Send and Receive Large Messages with Azure Event Hubs (Preview)'
3+
description: In this quickstart, you learn how to send and receive large messages with Azure Event Hubs after you configure an Event Hubs dedicated cluster.
44
ms.topic: quickstart
55
ms.author: Saglodha
6-
ms.date: 5/6/2024
6+
ms.date: 06/16/2025
7+
#customer intent: As a developer, I want to understand how to send and receive large messages with Azure Event Hubs to support apps that need this ability.
78
---
89

910
# Quickstart: Send and receive large messages with Azure Event Hubs (preview)
1011

11-
In this quickstart, you learn how to send and receive large messages (up to 20 MB) by using Azure Event Hubs. If you're new to Event Hubs, see [Event Hubs overview](event-hubs-about.md) before you go through this quickstart.
12+
In this quickstart, you learn how to send and receive large messages (up to 20 MB) by using Azure Event Hubs. If you're new to Event Hubs, see [Event Hubs overview](event-hubs-about.md) before you begin.
1213

13-
### Prerequisites
14+
## Prerequisites
1415

15-
To complete this quickstart, you need the following prerequisites:
16-
17-
- An Azure subscription. To use Azure services, including Event Hubs, you need a subscription. If you don't have an existing Azure account, you can sign up for a [free trial](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) or use your MSDN subscriber benefits when you [create an account](https://azure.microsoft.com/).
18-
- A [self-serve scalable dedicated cluster](event-hubs-dedicated-cluster-create-portal.md), an event hubs namespace, and an event hub. The first step to meet this prerequisite is to use the Azure portal to create a dedicated cluster and namespace inside a cluster. To create an event hub, see [Quickstart: Create an event hub by using the Azure portal](event-hubs-create.md). You can skip this step if you already have a self-serve scalable dedicated cluster.
16+
- An Azure subscription. To use Azure services, including Event Hubs, you need a subscription. If you don't have an Azure account, you can sign up for a [free trial](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) or activate your [Monthly Azure credits for Visual Studio subscribers](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/?WT.mc_id=A85619ABF).
17+
- A [self-serve scalable dedicated cluster](event-hubs-dedicated-cluster-create-portal.md), an Event Hubs namespace, and an event hub. Use the Azure portal to create a dedicated cluster and namespace inside a cluster. To create an event hub, see [Quickstart: Create an event hub by using the Azure portal](event-hubs-create.md). You can skip this step if you already have a self-serve scalable dedicated cluster.
1918

2019
> [!NOTE]
21-
> Large message support, currently in public preview, is exclusively available with certain Event Hubs self-serve dedicated clusters. Streaming large messages with these clusters incurs no extra charges.
20+
> Large message support is currently in public preview. It's exclusively available with certain Event Hubs self-serve dedicated clusters. Streaming large messages with these clusters incurs no extra charges.
2221
2322
## Configure an Event Hubs dedicated cluster
2423

2524
To stream large messages, you must configure your self-serve scalable dedicated cluster.
2625

2726
In the Azure portal, go to the **Settings** section for the dedicated cluster. Under **Settings**, select the **Quota** tab.
2827

29-
:::image type="content" source="./media/event-hubs-quickstart-stream-large-messages/large-message-configuration-for-dedicated-cluster.png" alt-text="Screenshot that shows the Quota pane for a dedicated cluster.":::
28+
:::image type="content" source="./media/event-hubs-quickstart-stream-large-messages/large-message-configuration-for-dedicated-cluster.png" alt-text="Screenshot that shows the Quota pane for a dedicated cluster." lightbox="./media/event-hubs-quickstart-stream-large-messages/large-message-configuration-for-dedicated-cluster.png":::
3029

31-
- Validate that the value for the read-only key `supportslargemessages` is set to `True`.
3230
- You can update the key `eventhubmaxmessagesizeinbytes` to a suitable value in bytes. An acceptable range for this value is between 1,048,576 and 20,971,520 bytes.
31+
- Validate that the value for the read-only key `supportslargemessages` is set to `True`.
3332

34-
After the configuration is saved, you're ready to stream large messages with Event Hubs.
33+
After you save the configuration, you're ready to stream large messages with Event Hubs.
3534

3635
> [!IMPORTANT]
37-
> Large message streaming is only supported with self-serve scalable dedicated clusters built out of the latest infrastructure. This capability is reflected by the `Supportslargemessages` key.
36+
> Large message streaming is only supported with self-serve scalable dedicated clusters built out of the latest infrastructure. The `Supportslargemessages` key reflects this capability.
3837
>
39-
> If a cluster value is false, it won't support large message streaming. To enable this feature, you must re-create the cluster.
38+
> If a cluster value is false, it doesn't support large message streaming. To enable this feature, you must re-create the cluster.
4039
4140
## Stream large messages with Event Hubs
4241

43-
Event Hubs allows streaming of large messages up to 20 MB, both in batches and as individual publications. The ability to stream large messages or events requires no client code changes apart from the change in the message or event itself. You can continue sending or receiving messages by using any existing Event Hubs SDK or Kafka API to stream large messages to Event Hubs. This way you can stream large messages to Event Hubs in the same manner as you would for messages of sizes less than 1 MB.
42+
Event Hubs allows streaming of large messages up to 20 MB, both in batches and as individual publications. The ability to stream large messages or events requires no client code changes apart from the change in the message or event itself. You can continue to send or receive messages by using any existing Event Hubs SDK or Kafka API to stream large messages to Event Hubs. This way you can stream large messages to Event Hubs in the same manner as you would for messages of sizes less than 1 MB.
4443

4544
For more information, see [Send events to and receive events from Event Hubs by using .NET](event-hubs-dotnet-standard-getstarted-send.md).
4645

4746
> [!TIP]
4847
> Make sure to review any Event Hubs Advanced Message Queuing Protocol (AMQP) client or Kafka client configuration that might limit the maximum message size that you stream into Event Hubs. You must update client timeout to a higher value to stream large messages.
4948
>
50-
>By default, the AMQP client prefetch count is 300. Lower this value to avoid client-side memory issues when you deal with large messages.
49+
> By default, the AMQP client prefetch count is 300. Lower this value to avoid client-side memory issues when you deal with large messages.
5150
52-
For the complete .NET library reference, see the [SDK documentation](/dotnet/api/overview/azure/event-hubs).
51+
For the complete SDK reference, see [Azure Event Hubs libraries for .NET](/dotnet/api/overview/azure/event-hubs).
Loading

0 commit comments

Comments
 (0)