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
After you enable identity for your event grid custom topic or domain, Azure automatically creates an identity in Microsoft Entra ID. Add this identity to appropriate Azure roles so that the custom topic or domain can forward events to supported destinations. For example, add the identity to the **Azure Event Hubs Data Sender** role for an Azure Event Hubs namespace so that the event grid custom topic can forward events to event hubs in that namespace.
19
+
After you enable identity for your Event Grid custom topic or domain, Azure automatically creates an identity in Microsoft Entra ID. Add this identity to appropriate Azure roles so that the custom topic or domain can forward events to supported destinations. For example, add the identity to the **Azure Event Hubs Data Sender** role for an Azure Event Hubs namespace so that the Event Grid custom topic can forward events to event hubs in that namespace.
20
20
21
-
Currently, Azure event grid supports custom topics or domains configured with a system-assigned managed identity to forward events to the following destinations. This table also gives you the roles that the identity should be in so that the custom topic can forward the events.
21
+
Currently, Azure Event Grid supports custom topics or domains configured with a system-assigned managed identity to forward events to the following destinations. This table also gives you the roles that the identity should be in so that the custom topic can forward the events.
22
22
23
23
| Destination | Azure role |
24
24
| ----------- | --------- |
@@ -30,7 +30,7 @@ Currently, Azure event grid supports custom topics or domains configured with a
30
30
## Use the Azure portal
31
31
You can use the Azure portal to assign the custom topic or domain identity to an appropriate role so that the custom topic or domain can forward events to the destination.
32
32
33
-
The following example adds a managed identity for an event grid custom topic named **msitesttopic** to the **Azure Service Bus Data Sender** role for a Service Bus namespace that contains a queue or topic resource. When you add to the role at the namespace level, the event grid custom topic can forward events to all entities within the namespace.
33
+
The following example adds a managed identity for an Event Grid custom topic named **msitesttopic** to the **Azure Service Bus Data Sender** role for a Service Bus namespace that contains a queue or topic resource. When you add to the role at the namespace level, the Event Grid custom topic can forward events to all entities within the namespace.
34
34
35
35
1. Go to your **Service Bus namespace** in the [Azure portal](https://portal.azure.com).
36
36
1. Select **Access Control** in the left pane.
@@ -56,7 +56,7 @@ The following example adds a managed identity for an event grid custom topic nam
56
56
The steps are similar for adding an identity to other roles mentioned in the table.
57
57
58
58
## Use the Azure CLI
59
-
The example in this section shows you how to use the Azure CLI to add an identity to an Azure role. The sample commands are for event grid custom topics. The commands for event grid domains are similar.
59
+
The example in this section shows you how to use the Azure CLI to add an identity to an Azure role. The sample commands are for Event Grid custom topics. The commands for Event Grid domains are similar.
60
60
61
61
### Get the principal ID for the custom topic's system identity
62
62
First, get the principal ID of the custom topic's system-managed identity and assign the identity to appropriate roles.
@@ -82,7 +82,7 @@ az role assignment create --role "$role" --assignee "$topic_pid" --scope "$event
82
82
```
83
83
84
84
### Create a role assignment for a Service Bus topic at various scopes
85
-
The following CLI example shows how to add an event grid custom topic's identity to the **Azure Service Bus Data Sender** role at the namespace level or at the Service Bus topic level. If you create the role assignment at the namespace level, the event grid topic can forward events to all entities (Service Bus queues or topics) within that namespace. If you create a role assignment at the Service Bus queue or topic level, the event grid custom topic can forward events only to that specific Service Bus queue or topic.
85
+
The following CLI example shows how to add an Event Grid custom topic's identity to the **Azure Service Bus Data Sender** role at the namespace level or at the Service Bus topic level. If you create the role assignment at the namespace level, the Event Grid topic can forward events to all entities (Service Bus queues or topics) within that namespace. If you create a role assignment at the Service Bus queue or topic level, the Event Grid custom topic can forward events only to that specific Service Bus queue or topic.
Copy file name to clipboardExpand all lines: articles/event-grid/create-custom-topic.md
+11-8Lines changed: 11 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Create an Azure Event Grid topic or a domain
3
3
description: This article shows how to create an Event Grid topic or domain.
4
-
ms.date: 07/21/2022
4
+
ms.date: 01/31/2024
5
5
ms.topic: how-to
6
6
ms.custom: mode-ui
7
7
---
@@ -18,9 +18,9 @@ If you're new to Azure Event Grid, read through [Event Grid overview](overview.m
18
18
An Event Grid topic provides a user-defined endpoint that you post your events to.
19
19
20
20
1. Sign in to [Azure portal](https://portal.azure.com/).
21
-
2. In the search bar at the top, type **Event Grid Topics**, and then select **Event Grid Topics** from the drop-down list. If you are create a domain, search for **Event Grid Domains**.
21
+
2. In the search bar at the top, type **Event Grid Topics**, and then select **Event Grid Topics** from the drop-down list. To create a domain, search for **Event Grid Domains**.
22
22
23
-
:::image type="content" source="./media/custom-event-quickstart-portal/select-topics.png" alt-text="Screenshot showing the Azure port search bar to search for Event Grid topics.":::
23
+
:::image type="content" source="./media/custom-event-quickstart-portal/select-topics.png" lightbox="./media/custom-event-quickstart-portal/select-topics.png" alt-text="Screenshot showing the Azure port search bar to search for Event Grid topics.":::
24
24
3. On the **Event Grid Topics** or **Event Grid Domains** page, select **+ Create** on the toolbar.
25
25
26
26
:::image type="content" source="./media/custom-event-quickstart-portal/create-topic-button.png" alt-text="Screenshot showing the Create Topic button on Event Grid topics page.":::
@@ -30,7 +30,7 @@ On the **Basics** page of **Create Topic** or **Create Event Grid Domain** wizar
30
30
31
31
1. Select your Azure **subscription**.
32
32
2. Select an existing resource group or select **Create new**, and enter a **name** for the **resource group**.
33
-
3. Provide a unique **name** for the custom topic or domain. The name must be unique because it's represented by a DNS entry. Don't use the name shown in the image. Instead, create your own name - it must be between 3-50 characters and contain only values a-z, A-Z, 0-9, and "-".
33
+
3. Provide a unique **name** for the custom topic or domain. The name must be unique because it's represented by a Domain Name System (DNS) entry. Don't use the name shown in the image. Instead, create your own name - it must be between 3-50 characters and contain only values a-z, A-Z, 0-9, and "-".
34
34
4. Select a **location** for the Event Grid topic or domain.
35
35
1. Select **Next: Networking** at the bottom of the page to switch to the **Networking** page.
36
36
@@ -39,7 +39,7 @@ On the **Basics** page of **Create Topic** or **Create Event Grid Domain** wizar
39
39
## Networking page
40
40
On the **Networking** page of the **Create Topic** or **Create Event Grid Domain** wizard, follow these steps:
41
41
42
-
1. If you want to allow clients to connect to the topic or domain endpoint via a public IP address, keep the **Public access** option selected.
42
+
1. If you want to allow clients to connect to the topic or domain endpoint via a public IP address, keep the **Public access** option selected. You can restrict the access to specific IP addresses or IP address range.
43
43
44
44
:::image type="content" source="./media/configure-firewall/networking-page-public-access.png" alt-text="Screenshot showing the selection of Public access option on the Networking page of the Create topic wizard.":::
45
45
1. To allow access to the topic or domain via a private endpoint, select the **Private access** option.
@@ -62,6 +62,9 @@ On the **Security** page of the **Create Topic** or **Create Event Grid Domain*
62
62
1. To disable local authentication, select **Disabled**. When you do it, the topic or domain can't be accessed using accesskey and SAS authentication, but only via Microsoft Entra authentication.
63
63
64
64
:::image type="content" source="./media/authenticate-with-microsoft-entra-id/create-topic-disable-local-auth.png" alt-text="Screenshot showing the Advanced tab of Create Topic page when you can disable local authentication.":::
65
+
1. Configure the minimum required Transport Layer Security (TLS) version. For more information, see [Configure minimum TLS version](transport-layer-security-configure-minimum-version.md).
66
+
67
+
:::image type="content" source="./media/create-custom-topic/configure-transport-layer-security-version.png" alt-text="Screenshot showing the Advanced tab of Create Topic page when you can select the minimum TLS version.":::
65
68
1. Select **Advanced** at the bottom of the page to switch to the **Advanced** page.
66
69
67
70
## Advanced page
@@ -72,13 +75,13 @@ On the **Security** page of the **Create Topic** or **Create Event Grid Domain*
72
75
73
76
:::image type="content" source="./media/create-custom-topic/data-residency.png" alt-text="Screenshot showing the Data residency section of the Advanced page in the Create Topic wizard.":::
74
77
75
-
The **Cross-Geo** option allows Microsoft-initiated failover to the paired region in case of a region failure. For more information, see [Server-side geo disaster recovery in Azure Event Grid](geo-disaster-recovery.md). Microsoft-initiated failover is exercised by Microsoft in rare situations to fail over Event Grid resources from an affected region to the corresponding geo-paired region. This process doesn't require an intervention from user. Microsoft reserves right to make a determination of when this path will be taken. The mechanism doesn't involve a user consent before the user's topic or domain is failed over. For more information, see [How do I recover from a failover?](./faq.yml).
78
+
The **Cross-Geo** option allows Microsoft-initiated failover to the paired region when there's a region failure. For more information, see [Server-side geo disaster recovery in Azure Event Grid](geo-disaster-recovery.md). Microsoft-initiated failover is exercised by Microsoft in rare situations to fail over Event Grid resources from an affected region to the corresponding geo-paired region. This process doesn't require an intervention from user. Microsoft reserves right to make a determination of when this path will be taken. The mechanism doesn't involve a user consent before the user's topic or domain is failed over. For more information, see [How do I recover from a failover?](./faq.yml).
76
79
77
-
If you select the **Regional** option, you may define your own disaster recovery plan.
80
+
If you select the **Regional** option, you can define your own disaster recovery plan.
78
81
3. Select **Next: Tags** to move to the **Tags** page.
79
82
80
83
## Tags page
81
-
The **Tags** page has no fields that are specific to Event Grid. You can assign a tag (name-value pair) as you do for any other Azure resource. Select **Next: Review + create** to switch to the **Review + create** page.
84
+
The **Tags** page has no fields that are specific to Event Grid. You can assign a tag (name-value pair) as you do for any other Azure resource. Select **Next: Review + create** to switch to the **Review + create** page.
82
85
83
86
## Review + create page
84
87
On the **Review + create** page, review all your settings, confirm the validation succeeded, and then select **Create** to create the topic or the domain.
description: 'Quickstart: Use Azure Event Grid and Azure CLI to publish a topic, and subscribe to that event. An event hub is used for the endpoint.'
4
-
ms.date: 11/18/2022
4
+
ms.date: 01/31/2024
5
5
ms.topic: quickstart
6
6
ms.custom: devx-track-azurecli, mode-api
7
7
---
8
8
9
9
# Quickstart: Route custom events to Azure Event Hubs with Azure CLI and Event Grid
10
10
11
-
[Azure Event Grid](overview.md) is a highly scalable and serverless event broker that you can use to integrate applications using events. Events are delivered by Event Grid to [supported event handlers](event-handlers.md) and Azure Event Hubs is one of them. In this article, you use Azure CLI for the following steps:
11
+
[Azure Event Grid](overview.md) is a highly scalable and serverless event broker that you can use to integrate applications using events. Event Grid delivers events to [supported event handlers](event-handlers.md) and Azure Event Hubs is one of them. In this article, you use Azure CLI for the following steps:
12
12
13
13
1. Create an Event Grid custom topic.
14
14
1. Create an Azure Event Hubs subscription for the custom topic.
@@ -34,7 +34,7 @@ az group create --name gridResourceGroup --location westus2
34
34
35
35
## Create a custom topic
36
36
37
-
An Event Grid topic provides a user-defined endpoint that you post your events to. The following example creates the custom topic in your resource group. Replace `<topic_name>` with a unique name for your custom topic. The Event Grid topic name must be unique because it's represented by a DNS entry.
37
+
An Event Grid topic provides a user-defined endpoint that you post your events to. The following example creates the custom topic in your resource group. Replace `<topic_name>` with a unique name for your custom topic. The Event Grid topic name must be unique because it's represented by a Domain Name System (DNS) entry.
To simplify this article, you use sample event data to send to the custom topic. Typically, an application or Azure service would send the event data. CURL is a utility that sends HTTP requests. In this article, use CURL to send the event to the custom topic. The following example sends three events to the Event Grid topic:
99
+
To simplify this article, you use sample event data to send to the custom topic. Typically, an application or Azure service would send the event data. CURL is a utility that sends HTTP requests. In this article, use CURL to send the event to the custom topic. The following example sends three events to the Event Grid topic:
100
100
101
101
```azurecli-interactive
102
102
for i in 1 2 3
@@ -106,7 +106,7 @@ do
106
106
done
107
107
```
108
108
109
-
On the **Overview** page for your Event Hubs namespace in the Azure portal, notice that Event Grid sent those three events to the event hub. You'll see the same chart on the **Overview** page for the `demohub` Event Hubs instance page.
109
+
On the **Overview** page for your Event Hubs namespace in the Azure portal, notice that Event Grid sent those three events to the event hub. You see the same chart on the **Overview** page for the `demohub` Event Hubs instance page.
110
110
111
111
:::image type="content" source="./media/custom-event-to-eventhub/show-result.png" lightbox="./media/custom-event-to-eventhub/show-result.png" alt-text="Image showing the portal page with incoming message count as 3.":::
description: 'Quickstart: Use Azure Event Grid and Azure CLI to publish a topic, and subscribe to that event. A storage queue is used for the endpoint.'
4
-
ms.date: 12/20/2022
4
+
ms.date: 01/31/2024
5
5
ms.topic: quickstart
6
6
ms.custom: devx-track-azurecli, mode-api
7
7
---
8
8
9
9
# Quickstart: Route custom events to Azure Queue storage via Event Grid using Azure CLI
10
10
11
-
[Azure Event Grid](overview.md) is a highly scalable and serverless event broker that you can use to integrate applications using events. Events are delivered by Event Grid to [supported event handlers](event-handlers.md) and Azure Queue storage is one of them. In this article, you use Azure CLI for the following steps:
11
+
[Azure Event Grid](overview.md) is a highly scalable and serverless event broker that you can use to integrate applications using events. Event Grid delivers events to [supported event handlers](event-handlers.md) and Azure Queue storage is one of them. In this article, you use Azure CLI for the following steps:
12
12
13
13
1. Create an Event Grid custom topic.
14
14
1. Create an Azure Queue subscription for the custom topic.
@@ -34,7 +34,7 @@ az group create --name gridResourceGroup --location westus2
34
34
35
35
## Create a custom topic
36
36
37
-
An Event Grid topic provides a user-defined endpoint that you post your events to. The following example creates the custom topic in your resource group. Replace `<topic_name>` with a unique name for your custom topic. The Event Grid topic name must be unique because it's represented by a DNS entry.
37
+
An Event Grid topic provides a user-defined endpoint that you post your events to. The following example creates the custom topic in your resource group. Replace `<topic_name>` with a unique name for your custom topic. The Event Grid topic name must be unique because it's represented by a Domain Name System (DNS) entry.
To simplify this article, you use sample event data to send to the custom topic. Typically, an application or Azure service would send the event data. CURL is a utility that sends HTTP requests. In this article, you use CURL to send the event to the custom topic. The following example sends three events to the Event Grid topic:
117
+
To simplify this article, you use sample event data to send to the custom topic. Typically, an application or Azure service would send the event data. CURL is a utility that sends HTTP requests. In this article, you use CURL to send the event to the custom topic. The following example sends three events to the Event Grid topic:
0 commit comments