You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/event-grid/custom-topics.md
+17-3Lines changed: 17 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Custom topics in Azure Event Grid
3
3
description: Describes custom topics in Azure Event Grid.
4
4
ms.topic: conceptual
5
-
ms.date: 07/27/2021
5
+
ms.date: 02/23/2022
6
6
---
7
7
8
8
# Custom topics in Azure Event Grid
@@ -13,7 +13,11 @@ An event grid topic provides an endpoint where the source sends events. The publ
13
13
When designing your application, you have flexibility when deciding how many topics to create. For large solutions, create a **custom topic** for **each category of related events**. For example, consider an application that sends events related to modifying user accounts and processing orders. It's unlikely any event handler wants both categories of events. Create two custom topics and let event handlers subscribe to the one that interests them. For small solutions, you might prefer to send all events to a single topic. Event subscribers can filter for the event types they want.
14
14
15
15
## Event schema
16
-
For a detailed overview of event schema, see [Azure Event Grid event schema](event-schema.md). For custom topics, the event publisher determines the **data** object. The top-level data should have the same fields as standard resource-defined events.
16
+
Azure Event Grid supports two types of event schemas: Event Grid event schema and Cloud event schema.
17
+
18
+
### Event Grid event schema
19
+
20
+
When you use Event Grid event schema, you can specify your application-specific properties in the **data** object.
17
21
18
22
```json
19
23
[
@@ -32,8 +36,18 @@ For a detailed overview of event schema, see [Azure Event Grid event schema](eve
32
36
]
33
37
```
34
38
35
-
The following sections provide links to tutorials to create custom topics using Azure portal, CLI, PowerShell, and Azure Resource Manager (ARM) templates.
39
+
> [!NOTE]
40
+
> For more information, see [Event Grid event schema](event-schema.md).
41
+
42
+
### Cloud event schema
43
+
In addition to its [default event schema](event-schema.md), Azure Event Grid natively supports events in the [JSON implementation of CloudEvents v1.0](https://github.com/cloudevents/spec/blob/v1.0/json-format.md) and [HTTP protocol binding](https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md). [CloudEvents](https://cloudevents.io/) is an [open specification](https://github.com/cloudevents/spec/blob/v1.0/spec.md) for describing event data.
36
44
45
+
CloudEvents simplifies interoperability by providing a common event schema for publishing, and consuming cloud based events. This schema allows for uniform tooling, standard ways of routing & handling events, and universal ways of deserializing the outer event schema. With a common schema, you can more easily integrate work across platforms.
46
+
47
+
> [!NOTE]
48
+
> For more information, see [Cloud event schema](cloud-event-schema.md).
49
+
50
+
The following sections provide links to tutorials to create custom topics using Azure portal, CLI, PowerShell, and Azure Resource Manager (ARM) templates.
0 commit comments