This article shows how to create a custom topic or a domain in Azure Event Grid.

Prerequisites

If you're new to Azure Event Grid, read throughEvent Grid overview before starting this tutorial.

Register the Event Grid resource provider

Unless you've used Event Grid before, you'll need to register the Event Grid resource provider. If you’ve used Event Grid before, skip to the next section.

In the Azure portal, do the following steps:

1. On the left menu, selectSubscriptions.

2. Select thesubscription you want to use for Event Grid from the subscription list.

3. On theSubscription page, selectResource providers underSettings on the left menu.

4. Search forMicrosoft.EventGrid, and confirm that theStatus isNot Registered.

5. SelectMicrosoft.EventGrid in the provider list.

6. SelectRegister on the command bar.

   

7. Refresh to make sure the status ofMicrosoft.EventGrid is changed toRegistered.

   

Create a custom topic or domain

An Event Grid topic provides a user-defined endpoint that you post your events to.

1. Sign in toAzure portal.

2. In the search bar at the top, typeEvent Grid Topics, and then selectEvent Grid Topics from the drop-down list. To create a domain, search forEvent Grid Domains.

   

3. On theEvent Grid Topics orEvent Grid Domains page, select+ Create on the toolbar.

   

Basics page

On theBasics page ofCreate Topic orCreate Event Grid Domain wizard, follow these steps:

1. Select your Azuresubscription.

2. Select an existing resource group or selectCreate new, and enter aname for theresource group.

3. Provide a uniquename 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 "-".

4. Select alocation for the Event Grid topic or domain.

5. SelectNext: Networking at the bottom of the page to switch to theNetworking page.

   

Networking page

On theNetworking page of theCreate Topic orCreate Event Grid Domain wizard, follow these steps:

1. If you want to allow clients to connect to the topic or domain endpoint via a public IP address, keep thePublic access option selected. You can restrict the access to specific IP addresses or IP address range.

   

2. To allow access to the topic or domain via a private endpoint, select thePrivate access option.

   

3. Follow instructions in theAdd a private endpoint using Azure portal section to create a private endpoint.

4. SelectNext: Security at the bottom of the page to switch to theSecurity page.

Security page

On theSecurity page of theCreate Topic orCreate Event Grid Domain wizard, follow these steps:

1. To assign a system-assigned managed identity to your topic or domain, selectEnable system assigned identity.

   

2. To assign a user-assigned identity, selectAdd user assigned identity in theUser assigned identity section of the page.

3. In theSelect user assigned identity window, select the subscription that has the user-assigned identity, select theuser-assigned identity, and then clickSelect.

   

4. To disable local authentication, selectDisabled. When you do it, the topic or domain can't be accessed using accesskey and SAS authentication, but only via Microsoft Entra authentication.

   

5. Configure the minimum required Transport Layer Security (TLS) version. For more information, seeConfigure minimum TLS version.

   

6. SelectAdvanced at the bottom of the page to switch to theAdvanced page.

Advanced page

1. On theAdvanced page of theCreate Topic orCreate Event Grid Domain wizard, select the schema for events that will be published to this topic.

   

2. ForData residency, select whether you don't want any data to be replicated to another region (Regional) or you want the metadata to be replicated to a predefined secondary region (Cross-Geo).

   

   TheCross-Geo option allows Microsoft-initiated failover to the paired region when there's a region failure. For more information, seeServer-side geo disaster recovery in Azure Event Grid. 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, seeHow do I recover from a failover?.

   If you select theRegional option, you can define your own disaster recovery plan.

3. SelectNext: Tags to move to theTags page.

Tags page

TheTags 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. SelectNext: Review + create to switch to theReview + create page.

Review + create page

On theReview + create page, review all your settings, confirm the validation succeeded, and then selectCreate to create the topic or the domain.

Next steps

Now that you know how to create custom topics or domains, learn more about what Event Grid can help you do:

• Route custom events to web endpoint with the Azure portal and Event Grid
• About Event Grid
• Event handlers

See the following samples to learn about publishing events to and consuming events from Event Grid using different programming languages.

• Azure Event Grid samples for .NET
• Azure Event Grid samples for Java
• Azure Event Grid samples for Python
• Azure Event Grid samples for JavaScript
• Azure Event Grid samples for TypeScript