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/system-topics.md
+13-10Lines changed: 13 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,14 +2,14 @@
2
2
title: System topics in Azure Event Grid
3
3
description: Describes system topics in Azure Event Grid.
4
4
ms.topic: conceptual
5
-
ms.date: 01/05/2022
5
+
ms.date: 02/27/2023
6
6
---
7
7
8
8
# System topics in Azure Event Grid
9
-
A system topic in Event Grid represents one or more events published by Azure services such as Azure Storage and Azure Event Hubs. For example, a system topic may represent **all blob events** or only **blob created** and **blob deleted** events published for a **specific storage account**. In this example, when a blob is uploaded to the storage account, the Azure Storage service publishes a **blob created** event to the system topic in Event Grid, which then forwards the event to topic's [subscribers](event-handlers.md) that receive and process the event.
9
+
A system topic in Event Grid represents one or more **events published by Azure services** such as Azure Storage and Azure Event Hubs. For example, a system topic may represent **all blob events** or only **blob created** and **blob deleted** events published for a **specific storage account**. In this example, when a blob is uploaded to the storage account, the Azure Storage service publishes a **blob created** event to the system topic in Event Grid, which then forwards the event to topic's [subscribers](event-handlers.md) that receive and process the event.
10
10
11
11
> [!NOTE]
12
-
> -Only Azure services can publish events to system topics. Therefore, you don't get an endpoint or access keys that you can use to publish events like you do for [custom topics](custom-topics.md) or [event domains](event-domains.md).
12
+
> Only Azure services can publish events to system topics. Therefore, you don't get an endpoint or access keys that you can use to publish events like you do for [custom topics](custom-topics.md) or [event domains](event-domains.md).
13
13
14
14
## Azure services that support system topics
15
15
Here's the current list of Azure services that support creation of system topics on them.
@@ -18,17 +18,17 @@ Here's the current list of Azure services that support creation of system topics
18
18
19
19
20
20
## System topics as Azure resources
21
-
In the past, a system topic was implicit and wasn't exposed for simplicity. System topics are now visible as Azure resources and provide the following capabilities:
21
+
System topics are visible as Azure resources and provide the following capabilities:
22
22
23
23
-[View system topics in the Azure portal](create-view-manage-system-topics.md#view-all-system-topics)
24
24
- Export Resource Manager templates for system topics and event subscriptions in the Azure portal
25
25
-[Set up diagnostic logs for system topics](enable-diagnostic-logs-topic.md#enable-diagnostic-logs-for-event-grid-system-topics)
26
-
- Set up alerts on publish and delivery failures
26
+
-[Set up alerts](set-alerts.md) on publish and delivery failures
27
27
28
28
> [!NOTE]
29
-
> - Only one Azure Event Grid system topic is allowed per source (like Subscription, Resource Group, etc.).
30
-
> -Resource Group is required for Subscription level Event Grid system topic and cannot be changed until deleted/moved to another subscription.
31
-
> -Azure Event Grid creates a system topic resource in the same Azure subscription that has the event source. For example, if you create a system topic for a storage account *ContosoStorage* in an Azure subscription *ContosoSubscription*, Event Grid creates the system topic in the *ContosoSubscription*. It's not possible to create a system topic in an Azure subscription that's different from the event source's Azure subscription.
29
+
> - Only one Azure Event Grid system topic is allowed per source (like subscription, resource group, etc.).
30
+
> -A resource group is required for subscription-level system topic and can't be changed until deleted or moved to another subscription.
31
+
> - Event Grid creates a system topic resource in the same Azure subscription that has the event source. For example, if you create a system topic for a storage account `ContosoStorage` in an Azure subscription `ContosoSubscription`, Event Grid creates the system topic in the `ContosoSubscription`. It's not possible to create a system topic in an Azure subscription that's different from the event source's Azure subscription.
32
32
33
33
## Lifecycle of system topics
34
34
You can create a system topic in two ways:
@@ -38,12 +38,15 @@ You can create a system topic in two ways:
38
38
39
39
When you use the Azure portal, you're always using this method. When you create an event subscription using the [**Events** page of an Azure resource](blob-event-quickstart-portal.md#subscribe-to-the-blob-storage), the system topic is created first and then the subscription for the topic is created. You can explicitly create a system topic first by using the [**Event Grid System Topics** page](create-view-manage-system-topics.md#create-a-system-topic) and then create a subscription for that topic.
40
40
41
-
When you use [CLI](create-view-manage-system-topics-cli.md), [REST](/rest/api/eventgrid/controlplane-version2022-06-15/event-subscriptions/create-or-update), or [Azure Resource Manager template](create-view-manage-system-topics-arm.md), you can choose either of the above methods. We recommend that you create a system topic first and then create a subscription on the topic, as it's the latest way of creating system topics.
41
+
When you use [CLI](create-view-manage-system-topics-cli.md), [REST](/rest/api/eventgrid/controlplane-version2022-06-15/event-subscriptions/create-or-update), or [Azure Resource Manager template](create-view-manage-system-topics-arm.md), you can choose either of the above methods.
42
+
43
+
> [!IMPORTANT]
44
+
> We recommend that you create a system topic first and then create a subscription on the topic, as it's the latest way of creating system topics.
42
45
43
46
### Failure to create system topics
44
47
The system topic creation fails if you have set up Azure policies in such a way that the Event Grid service can't create it. For example, you may have a policy that allows creation of only certain types of resources (for example: Azure Storage, Azure Event Hubs, and so on.) in the subscription.
45
48
46
-
In such cases, event flow functionality is preserved. However, metrics and diagnostic functionalities of system topics will be unavailable.
49
+
In such cases, event flow functionality is preserved. However, metrics and diagnostic functionalities of system topics are unavailable.
47
50
48
51
If you require this functionality, allow creation of resources of the system topic type, and create the missing system topic as described in the [Lifecycle of system topics](#lifecycle-of-system-topics) section.
0 commit comments