Merge pull request #293363 from spelluru/egridfreshness01214

Event Grid - freshness

Author: JamesJBarnett

articles/event-grid/communication-services-email-events.md

@@ -1,10 +1,11 @@
 ---
 title: Azure Communication Services - Email events
 description: This article describes how to use Azure Communication Services as an Event Grid event source for Email Events.
-ms.topic: conceptual
-ms.date: 09/30/2022
+ms.topic: concept-article
+ms.date: 01/21/2025
 author: anmolbohra97
 ms.author: anmolbohra
+# Customer intent: I want to learn about what email events from Azure Communication Servics are supported through Azure Event Grid. 
 ---
 
 # Azure Communication Services - Email events
@@ -13,7 +14,7 @@ This article provides the properties and schema for communication services email
 
 ## Events types
 
-Azure Communication Services emits the following telephony and SMS event types:
+Azure Communication Services emits the following telephony and Short Message Service (SMS) event types:
 
 | Event type                                                  | Description                                                                                    |
 | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
@@ -54,7 +55,7 @@ This section contains an example of what that data would look like for each even
 > Possible values for `Status` are:
 > - `Delivered`: The message was successfully handed over to the intended destination (recipient Mail Transfer Agent).
 > - `Suppressed`: The recipient email had hard bounced previously, and all subsequent emails to this recipient are being temporarily suppressed as a result.
-> - `Bounced`: The email hard bounced, which may have happened because the email address does not exist or the domain is invalid.
+> - `Bounced`: The email hard bounced, which might happen because the email address doesn't exist or the domain is invalid.
 > - `Quarantined`: The message was quarantined (as spam, bulk mail, or phishing).
 > - `FilteredSpam`: The message was identified as spam, and was rejected or blocked (not quarantined).
 > - `Expanded`: A distribution group recipient was expanded before delivery to the individual members of the group.

articles/event-grid/configure-private-endpoints.md

@@ -1,13 +1,14 @@
 ---
-title: Configure private endpoints for Azure Event Grid topics or domains
+title: Configure private endpoints for topics or domains
 description: This article describes how to configure private endpoints for Azure Event Grid custom topics or domain. 
 ms.topic: how-to
-ms.date: 03/24/2023 
+ms.date: 01/21/2025 
 ms.custom: devx-track-azurecli, devx-track-azurepowershell
+# Customer intent: I want to know how to enable private only access for my Azure Event Grid topics or domains. 
 ---
 
 # Configure private endpoints for Azure Event Grid custom topics or domains
-You can use [private endpoints](../private-link/private-endpoint-overview.md) to allow ingress of events directly from your virtual network to your custom topics and domains securely over a [private link](../private-link/private-link-overview.md) without going through the public internet. The private endpoint uses an IP address from the VNet address space for your custom topic or domain. For more conceptual information, see [Network security](network-security.md).
+You can use [private endpoints](../private-link/private-endpoint-overview.md) to allow ingress of events directly from your virtual network to your custom topics and domains securely over a [private link](../private-link/private-link-overview.md) without going through the public internet. The private endpoint uses an IP address from the virtual network address space for your custom topic or domain. For more conceptual information, see [Network security](network-security.md).
 
 This article describes how to configure private endpoints for custom topics or domains.
 
@@ -30,7 +31,19 @@ This section shows you how to enable private network access for an Event Grid to
 1. To allow access to the Event Grid topic via a private endpoint, select the **Private access** option. 
 
     :::image type="content" source="./media/configure-firewall/networking-page-private-access.png" alt-text="Image showing the selection of Private access option on the Networking page of the Create topic wizard. ":::    
-1. See the next section for steps to add a private endpoint. 
+1. In the **Private endpoint connections** section, select **+ Private endpoint** button. 
+
+    :::image type="content" source="./media/configure-private-endpoints/create-topic-add-private-endpoint-button.png" alt-text="Screenshot showing the Private endpoint button on the Create topic page.":::
+1. On the **Create private endpoint** page, follow these steps: 
+    1. For **Name**, enter a name for the private endpoint. 
+    1. Select a **virtual network**. Only virtual networks in the currently selected subscription and location are listed in the drop-down list.
+    1. Select a **subnet** in the virtual network you selected. 
+    1. Select whether you want the private endpoint to be integrated with a **private DNS zone**. 
+    1. Select **OK**. 
+
+    :::image type="content" source="./media/configure-private-endpoints/create-topic-create-private-endpoint-page.png" alt-text="Screenshot showing Create private endpoint page.":::        
+1. Now, on the **Create topic** page, select **Review + create** at the bottom of the page. 
+1. On the **Review + create** page, select **Create**. 
 
 ### For an existing topic
 1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your topic or domain.
@@ -440,6 +453,6 @@ Get-AzPrivateEndpointConnection -ResourceId $pseEndpoint.Id
 
 You can approve the connection even after it's rejected via API. If you use Azure portal, you can't approve an endpoint that has been rejected. 
 
-## Next steps
+## Related content
 * To learn about how to configure IP firewall settings, see [Configure IP firewall for Azure Event Grid topics or domains](configure-firewall.md).
 * To troubleshoot network connectivity issues, see [Troubleshoot network connectivity issues](troubleshoot-network-connectivity.md)

articles/event-grid/create-view-manage-system-topics.md

@@ -1,8 +1,9 @@
 ---
-title: Create, view, and manage system topics in Azure Event Grid (portal)
+title: Manage system topics in Azure Event Grid (portal)
 description: This article shows how view existing system topic, create Azure Event Grid system topics using the Azure portal. 
-ms.topic: conceptual
-ms.date: 11/30/2023
+ms.topic: how-to
+ms.date: 01/21/2025
+# Customer intent: I want to know how to create, manage, and delete Azure Event Grid system topics in the Azure portal. 
 ---
 
 # Create, view, and manage Event Grid system topics in the Azure portal
@@ -20,7 +21,7 @@ You can create a system topic for an Azure resource (Storage account, Event Hubs
     2. In the search box at the top, type **Event Grid System Topics**, and then press **ENTER**. 
 
         :::image type="content" source="./media/create-view-manage-system-topics/search-system-topics.png" alt-text="Screenshot that shows the Azure portal with Event Grid System Topics in the search box.":::
-    3. On the **Event Grid System Topics** page, select **+ Create** on the toolbar.
+    3. Select **System Topics** on the left navigation bar. Then, on the **Event Grid System Topics** page, select **+ Create** on the toolbar.
 
         :::image type="content" source="./media/create-view-manage-system-topics/add-system-topic-menu.png" alt-text="Screenshot that shows in the Event Grid System Topics page with the Create button selected." lightbox="./media/create-view-manage-system-topics/add-system-topic-menu.png":::
     4. On the **Create Event Grid System Topic** page, do the following steps:
@@ -56,14 +57,6 @@ Follow these steps to view all existing Event Grid system topics.
     :::image type="content" source="./media/create-view-manage-system-topics/system-topic-delete-button.png" alt-text="Screenshot that shows the System Topic page with the Delete button selected.":::
 3. On the confirmation page, select **OK** to confirm the deletion. It deletes the system topic and also all the event subscriptions for the system topic.  
 
-## Create an event subscription
-1. Follow instructions from the [View system topics](#view-all-system-topics) section to view all system topics, and select the system topic that you want to delete from the list. 
-2. On the **Event Grid System Topic** page, select **+ Event Subscription** from the toolbar. 
-
-    :::image type="content" source="./media/create-view-manage-system-topics/add-event-subscription-button.png" alt-text="Screenshot that shows the System Topic page with Add Event Subscription button selected.":::
-3. Confirm that the **Topic Type**, **Source Resource**, and **Topic Name** are automatically populated. Enter a name, select an **Endpoint Type**, and specify the **endpoint**. Then, select **Create** to create the event subscription. 
-
-    ![System topic - create event subscription](./media/create-view-manage-system-topics/create-event-subscription.png)
 
-## Next steps
+## Related content
 See the [System topics in Azure Event Grid](system-topics.md) section to learn more about system topics and topic types supported by Azure Event Grid. 

articles/event-grid/handler-functions.md

@@ -1,8 +1,9 @@
 ---
-title: Use a function in Azure as an event handler for Azure Event Grid events
+title: Function as event handler for Azure Event Grid events
 description: Describes how you can use functions created in and hosted by Azure Functions as event handlers for Event Grid events. 
-ms.topic: conceptual
-ms.date: 08/31/2023
+ms.topic: concept-article
+ms.date: 01/21/2025
+# Customer intent: I want to know details about using an Azure function as an event handler for Azure Event Grid events. 
 ---
 
 # Use a function as an event handler for Event Grid events
@@ -12,8 +13,8 @@ An event handler is the place where the event is sent. The handler takes an acti
 
 To use a function in Azure as a handler for events, follow one of these approaches: 
 
--	Use [Event Grid trigger](../azure-functions/functions-bindings-event-grid-trigger.md).  Specify **Azure Function** as the **endpoint type**. Then, specify the function app and the function that will handle events. 
--	Use [HTTP trigger](../azure-functions/functions-bindings-http-webhook.md).  Specify **Web Hook** as the **endpoint type**. Then, specify the URL for the function that will handle events. 
+-	Use [Event Grid trigger](../azure-functions/functions-bindings-event-grid-trigger.md). Specify **Azure Function** as the **endpoint type**. Then, specify the function app and the function that will handle events. 
+-	Use [HTTP trigger](../azure-functions/functions-bindings-http-webhook.md). Specify **Web Hook** as the **endpoint type**. Then, specify the URL for the function that will handle events. 
 
 We recommend that you use the first approach (Event Grid trigger) as it has the following advantages over the second approach:
 -	Event Grid automatically validates Event Grid triggers. With generic HTTP triggers, you must implement the [validation response](end-point-validation-event-grid-events-schema.md) yourself.
@@ -28,7 +29,7 @@ We recommend that you use the first approach (Event Grid trigger) as it has the
 |Title  |Description  |
 |---------|---------|
 | [Quickstart: Handle events with function](custom-event-to-function.md) | Sends a custom event to a function for processing. |
-| [Tutorial: stream big data into a data warehouse](event-hubs-integration.md) | When Event Hubs creates a Capture file, Event Grid sends an event to a function app. The app retrieves the Capture file and migrates data to a data warehouse. |
+| [Tutorial: stream big data into a data warehouse](event-hubs-integration.md) | When an event hub creates a Capture file, Event Grid sends an event to a function app. The app retrieves the Capture file and migrates data to a data warehouse. |
 | [Tutorial: Azure Service Bus to Azure Event Grid integration examples](../service-bus-messaging/service-bus-to-event-grid-integration-example.md?toc=%2fazure%2fevent-grid%2ftoc.json) | Event Grid sends messages from Service Bus topic to a function app and a logic app. |
 
 ## REST example (for PUT)
@@ -78,5 +79,5 @@ You can use the [New-AzEventGridSubscription](/powershell/module/az.eventgrid/ne
 > [!NOTE]
 > When you use Event Grid Trigger, the Event Grid service fetches the client secret for the target Azure function, and uses it to deliver events to the Azure function. If you protect your Azure function with a Microsoft Entra application, you have to take the generic web hook approach and use the HTTP Trigger.
 
-## Next steps
+## Related content
 See the [Event handlers](event-handlers.md) article for a list of supported event handlers.

articles/event-grid/includes/media/system-topics/system-topic-details.png

@@ -1,10 +1,11 @@
 ---
- title: include file
- description: include file
+ title: View all Azure Event Grid system topics
+ description: Provides instructions to view all Azure Event Grid system topics. 
+ services: event-grid
  author: spelluru
- ms.service: azure-event-grid
+ ms.service: event-grid
  ms.topic: include
- ms.date: 11/30/2023
+ ms.date: 01/21/2025
  ms.author: spelluru
  ms.custom: include file
 ---
@@ -18,11 +19,11 @@
     :::image type="content" source="./media/system-topics/list-system-topics.png" alt-text="Screenshot that shows the list of system topics." lightbox="./media/system-topics/list-system-topics.png":::
 4. Select a **system topic** from the list to see details about it. 
 
-    :::image type="content" source="./media/system-topics/system-topic-details.png" alt-text="Screenshot that shows the topic page in the Azure portal.":::
+    :::image type="content" source="../media/create-view-manage-system-topics/system-topic-page.png" alt-text="Screenshot that shows the System Topic home page." lightbox="../media/create-view-manage-system-topics/system-topic-page.png":::    
 
     This page shows you details about the system topic such as the following information: 
     - Source. Name of the resource on which the system topic was created.
-    - Source type. Type of the resource. For example: `Microsoft.Storage.StorageAccounts`, `Microsoft.EventHub.Namespaces`, `Microsoft.Resources.ResourceGroups` and so on.
+    - Source type. Type of the resource. For example: `Microsoft.Storage.StorageAccounts`, `Microsoft.EventHub.Namespaces`, `Microsoft.Resources.ResourceGroups`, and so on.
     - Any subscriptions created for the system topic.
 
     This page allows operations such as the following ones: