Merge pull request #250349 from spelluru/egridfreshness0831

Freshness review & broken links

Author: Stacyrch140

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

@@ -11,16 +11,18 @@ This article shows you how to create and manage system topics using the Azure po
 ## Create a system topic
 You can create a system topic for an Azure resource (Storage account, Event Hubs namespace, etc.) in two ways:
 
-- Using the **Events** page of a resource, for example, Storage Account or Event Hubs Namespace. When you use the **Events** page in the Azure portal to create an event subscription for an event raised by an Azure source (for example: Azure Storage account), the portal creates a system topic for the Azure resource and then creates a subscription for the system topic. You specify the name of the system topic if you're creating an event subscription on the Azure resource for the first time. From the second time onwards, the system topic name is displayed for you in the read-only mode. See [Quickstart: Route Blob storage events to web endpoint with the Azure portal](blob-event-quickstart-portal.md#subscribe-to-the-blob-storage) for detailed steps.
-- Using the **Event Grid System Topics** page. The following steps are for creating a system topic using the **Event Grid System Topics** page. 
+- Using the **Events** page of a resource, for example, Storage Account or Event Hubs Namespace. Event Grid automatically creates a system topic for you in this case.
+
+    When you use the **Events** page in the Azure portal to create an event subscription for an event raised by an Azure source (for example: Azure Storage account), the portal creates a system topic for the Azure resource and then creates a subscription for the system topic. You specify the name of the system topic if you're creating an event subscription on the Azure resource for the first time. From the second time onwards, the system topic name is displayed for you in the read-only mode. See [Quickstart: Route Blob storage events to web endpoint with the Azure portal](blob-event-quickstart-portal.md#subscribe-to-the-blob-storage) for detailed steps.
+- Using the **Event Grid System Topics** page. You create a system topic manually in this case by using the following steps. 
 
 1. Sign in to [Azure portal](https://portal.azure.com).
 2. In the search box at the top, type **Event Grid System Topics**, and then press **ENTER**. 
 
-    ![Search for system topics](./media/create-view-manage-system-topics/search-system-topics.png)
-3. On the **Event Grid System Topics** page, select **+ Add** on the toolbar.
+    :::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.
 
-    ![Add system topic - toolbar button](./media/create-view-manage-system-topics/add-system-topic-menu.png)
+    :::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.":::
 4. On the **Create Event Grid System Topic** page, do the following steps:
     1. Select the **topic type**. In the following example, **Storage Accounts** option is selected. 
     2. Select the **Azure subscription** that has your storage account resource. 

articles/event-grid/media/create-view-manage-system-topics/add-system-topic-menu.png

@@ -15,33 +15,33 @@ For more information on Service Manager and Resource Manager APIs for Azure Serv
 
 - [Azure Service Bus](/rest/api/servicebus/)
 - [Azure Event Hubs](/rest/api/eventhub/)
-- [Azure Relay](/rest/api/relay/controlplane-preview/)
+- [Azure Relay](/rest/api/relay/)
 
 ## Service Manager REST API - Resource Manager REST API
 
 | Service Manager APIs (Deprecated) | Resource Manager - Service Bus API | Resource Manager - Event Hubs API | Resource Manager - Relay API |
 | --------------- | ----------------- | ----------------- | ----------------- | 
 | **Namespaces-GetNamespaceAsync** <br/>[Service Bus Get Namespace](/rest/api/servicebus/get-namespace)<br/>[Event Hubs Get Namespace](/rest/api/eventhub/get-event-hub)<br/>[Relay Get Namespace](/rest/api/servicebus/get-relays)<br/> ```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}``` | [get](/rest/api/servicebus/controlplane-stable/namespaces/get) | [get](/rest/api/eventhub/controlplane-stable/namespaces/get) | [get](/rest/api/relay/controlplane-preview/namespaces/get) |
-| **ConnectionDetails-GetConnectionDetails**<br/>Service Bus/Event Hub/Relay GetConnectionDetals<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/ConnectionDetails``` | [listkeys](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/list-keys) | [listkeys](/rest/api/eventhub/controlplane-stable/authorization-rules-event-hubs/list-keys) | [listkeys](/rest/api/relay/controlplane-preview/namespaces/listkeys) |
-| **Topics-GetTopicsAsync**<br/>Service Bus<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/topics? $skip={skip}&$top={top}``` | [list](/rest/api/servicebus/controlplane-stable/topics/listbynamespace) | &nbsp; | &nbsp; | 
+| **ConnectionDetails-GetConnectionDetails**<br/>Service Bus/Event Hub/Relay GetConnectionDetals<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/ConnectionDetails``` | [listkeys](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/list-keys) | [listkeys](/rest/api/eventhub/controlplane-stable/authorization-rules-event-hubs/list-keys) | [listkeys](/rest/api/relay/controlplane-stable/wcf-relays/list-keys) |
+| **Topics-GetTopicsAsync**<br/>Service Bus<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/topics? $skip={skip}&$top={top}``` | [list](/rest/api/servicebus/controlplane-preview/topics/list-by-namespace) | &nbsp; | &nbsp; | 
 | **Queues-GetQueueAsync** <br/>Service Bus<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/queues/{queueName}``` | [get](/rest/api/servicebus/controlplane-stable/queues/get) | &nbsp; | &nbsp; | 
-| **Relays-GetRelaysAsync**<br/>[Get Relays](/rest/api/servicebus/get-relays)<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/relays? $skip={skip}&$top={top}```| &nbsp; | &nbsp; | [list](/rest/api/relay/controlplane-preview/wcfrelays/listbynamespace) | 
-| **NamespaceAuthorizationRules-GetNamespaceAuthorizationRuleAsync**<br/>Service Bus/Event Hub/Relay GetNamespaceAuthRule<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/authorizationrules?``` | [getauthorizationrule](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/get-authorization-rule) | [getauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-namespaces/get-authorization-rule) | [getauthorizationrule](/rest/api/relay/controlplane-preview/namespaces/getauthorizationrule) |
+| **Relays-GetRelaysAsync**<br/>[Get Relays](/rest/api/servicebus/get-relays)<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/relays? $skip={skip}&$top={top}```| &nbsp; | &nbsp; | [list](/rest/api/relay/controlplane-stable/wcf-relays/list-by-namespace) | 
+| **NamespaceAuthorizationRules-GetNamespaceAuthorizationRuleAsync**<br/>Service Bus/Event Hub/Relay GetNamespaceAuthRule<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/authorizationrules?``` | [getauthorizationrule](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/get-authorization-rule) | [getauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-namespaces/get-authorization-rule) | [getauthorizationrule](/rest/api/relay/controlplane-stable/wcf-relays/get-authorization-rule) |
 | **Namespaces-DeleteNamespaceAsync**<br/>[Service Bus Delete Namespace](/rest/api/servicebus/delete-namespace)<br/>[Event Hubs Delete Namespace](/rest/api/eventhub/delete-event-hub)<br/>[Relays Delete Namespace](/rest/api/servicebus/delete-namespace)<br/> ```DELETE	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}``` | [delete](/rest/api/servicebus/controlplane-stable/namespaces/delete) | [delete](/rest/api/eventhub/controlplane-stable/namespaces/delete) | [delete](/rest/api/relay/controlplane-preview/namespaces/delete) | 
 | **MessagingSKUPlan-GetPlanAsync**<br/>Service Bus/Event Hub/Relay Get Namespace<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/MessagingPlan``` | [get](/rest/api/servicebus/controlplane-stable/namespaces/get) | [get](/rest/api/eventhub/controlplane-stable/namespaces/get) | [get](/rest/api/relay/controlplane-preview/namespaces/get) |
-| **MessagingSKUPlan-UpdatePlanAsync**<br/>Service Bus/Event Hub/Relay Get Namespace<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/MessagingPlan``` | [createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/createorupdate) | [createorupdate](/rest/api/eventhub/controlplane-stable/namespaces/createorupdate) | [createorupdate](/rest/api/relay/controlplane-preview/namespaces/createorupdate) |
-| **NamespaceAuthorizationRules-UpdateNamespaceAuthorizationRuleAsync**<br/>Service Bus/Event Hub/Relay Get Namespace<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules/{rule name}``` | [createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/createorupdate) | [createorupdateauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-event-hubs/create-or-update-authorization-rule) | [createorupdateauthorizationrule](/rest/api/relay/controlplane-preview/namespaces/createorupdateauthorizationrule) | 
+| **MessagingSKUPlan-UpdatePlanAsync**<br/>Service Bus/Event Hub/Relay Get Namespace<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/MessagingPlan``` | [createorupdate](/rest/api/servicebus/controlplane-preview/namespaces/create-or-update) | [createorupdate](/rest/api/eventhub/controlplane-stable/event-hubs/create-or-update) | [createorupdate](/rest/api/relay/controlplane-stable/namespaces/create-or-update) |
+| **NamespaceAuthorizationRules-UpdateNamespaceAuthorizationRuleAsync**<br/>Service Bus/Event Hub/Relay Get Namespace<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules/{rule name}``` | [createorupdate](/rest/api/servicebus/controlplane-preview/namespaces/create-or-update) | [createorupdateauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-event-hubs/create-or-update-authorization-rule) | [createorupdateauthorizationrule](/rest/api/relay/controlplane-stable/namespaces/create-or-update-authorization-rule) | 
 | **NamespaceAuthorizationRules-CreateNamespaceAuthorizationRuleAsync**<br/> 
-Service Bus/Event Hub/Relay<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules/{rule name}``` |[createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/createorupdate) | [createorupdateauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-event-hubs/create-or-update-authorization-rule) | [createorupdateauthorizationrule](/rest/api/relay/controlplane-preview/namespaces/createorupdateauthorizationrule) |
+Service Bus/Event Hub/Relay<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules/{rule name}``` |[createorupdate](/rest/api/servicebus/controlplane-preview/namespaces/create-or-update) | [createorupdateauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-event-hubs/create-or-update-authorization-rule) | [createorupdateauthorizationrule](/rest/api/relay/controlplane-stable/namespaces/create-or-update-authorization-rule) |
 | **NamespaceProperties-GetNamespacePropertiesAsync**<br/>[Service Bus Get Namespace](/rest/api/servicebus/get-namespace)<br/>[Event Hubs Get Namespace](/rest/api/eventhub/get-event-hub)<br/>[Relay Get Namespace](/rest/api/servicebus/get-relays)<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}``` | [get](/rest/api/servicebus/controlplane-stable/namespaces/get) | [get](/rest/api/eventhub/controlplane-stable/namespaces/get) | [get](/rest/api/relay/controlplane-preview/namespaces/get) |
 | **RegionCodes-GetRegionCodesAsync**<br/>Service Bus/EventHub/Relay Get Namespace<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}``` | &nbsp; | &nbsp; | &nbsp; | 
-| **NamespaceProperties-UpdateNamespacePropertyAsync**<br/>Service Bus/EventHub/Relay<br/>```GET	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Regions/``` | [createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/createorupdate) | [createorupdate](/rest/api/eventhub/controlplane-stable/namespaces/createorupdate) | [createorupdate](/rest/api/relay/controlplane-preview/namespaces/createorupdate) |
+| **NamespaceProperties-UpdateNamespacePropertyAsync**<br/>Service Bus/EventHub/Relay<br/>```GET	https://management.core.windows.net/{subscription ID}/services/ServiceBus/Regions/``` | [createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/create-or-update) | [createorupdate](/rest/api/eventhub/controlplane-stable/event-hubs/create-or-update) | [createorupdate](/rest/api/relay/controlplane-stable/namespaces/create-or-update) |
 | **EventHubsCrud-ListEventHubsAsync**<br/>[List Event Hubs](/rest/api/eventhub/list-event-hubs)<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/eventhubs?$skip={skip}&$top={top}``` | &nbsp; | [list](/rest/api/eventhub/controlplane-preview/event-hubs/list-by-namespace) | &nbsp; | 
 | **EventHubsCrud-GetEventHubAsync**<br/>[Get Event Hubs](/rest/api/eventhub/get-event-hub)<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/eventhubs/{eventHubPath}``` | &nbsp; | [get](/rest/api/eventhub/get-event-hub) | &nbsp; | 
-| **NamespaceAuthorizationRules-DeleteNamespaceAuthorizationRuleAsync**<br/>Service Bus/Event Hub/Relay<br/>```DELETE https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules/{rule name}``` | [deleteauthorizationrule](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/delete-authorization-rule) | [deleteauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-namespaces/delete-authorization-rule) | [deleteauthorizationrule](/rest/api/relay/controlplane-preview/namespaces/deleteauthorizationrule) |
-| **NamespaceAuthorizationRules-GetNamespaceAuthorizationRulesAsync**<br/>Service Bus/EventHub/Relay<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules``` | [listauthorizationrules](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/list-authorization-rules) | [listauthorizationrules](/rest/api/eventhub/controlplane-stable/authorization-rules-namespaces/list-authorization-rules) | [listauthorizationrules](/rest/api/relay/controlplane-preview/namespaces/listauthorizationrules) |
-| **NamespaceAvailability-IsNamespaceAvailable**<br/>[Service Bus Namespace Availability](/rest/api/servicebus/check-namespace-availability)<br/>```GET	https://management.core.windows.net/{subscription ID}/services/ServiceBus/CheckNamespaceAvailability/?namespace=<namespaceValue>``` | [checknameavailability](/rest/api/servicebus/controlplane-stable/namespaces-check-name-availability/check-name-availability) | [checknameavailability](/rest/api/eventhub/controlplane-stable/check-name-availability-namespaces/check-name-availability) | [checknameavailability](/rest/api/relay/controlplane-preview/namespaces/checknameavailability) |
-| **Namespaces-CreateOrUpdateNamespaceAsync**<br/>Service Bus/Event Hub/Relay<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}``` | [createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/createorupdate) | [createorupdate](/rest/api/eventhub/controlplane-stable/namespaces/createorupdate) | [createorupdate](/rest/api/relay/controlplane-preview/namespaces/createorupdate) | 
+| **NamespaceAuthorizationRules-DeleteNamespaceAuthorizationRuleAsync**<br/>Service Bus/Event Hub/Relay<br/>```DELETE https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules/{rule name}``` | [deleteauthorizationrule](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/delete-authorization-rule) | [deleteauthorizationrule](/rest/api/eventhub/controlplane-stable/authorization-rules-namespaces/delete-authorization-rule) | [deleteauthorizationrule](/rest/api/relay/controlplane-stable/namespaces/delete-authorization-rule) |
+| **NamespaceAuthorizationRules-GetNamespaceAuthorizationRulesAsync**<br/>Service Bus/EventHub/Relay<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/AuthorizationRules``` | [listauthorizationrules](/rest/api/servicebus/controlplane-stable/namespaces-authorization-rules/list-authorization-rules) | [listauthorizationrules](/rest/api/eventhub/controlplane-stable/authorization-rules-namespaces/list-authorization-rules) | [listauthorizationrules](/rest/api/relay/controlplane-stable/namespaces/list-authorization-rules) |
+| **NamespaceAvailability-IsNamespaceAvailable**<br/>[Service Bus Namespace Availability](/rest/api/servicebus/check-namespace-availability)<br/>```GET	https://management.core.windows.net/{subscription ID}/services/ServiceBus/CheckNamespaceAvailability/?namespace=<namespaceValue>``` | [checknameavailability](/rest/api/servicebus/controlplane-stable/namespaces-check-name-availability/check-name-availability) | [checknameavailability](/rest/api/eventhub/controlplane-stable/check-name-availability-namespaces/check-name-availability) | [checknameavailability](/rest/api/relay/controlplane-stable/namespaces/check-name-availability) |
+| **Namespaces-CreateOrUpdateNamespaceAsync**<br/>Service Bus/Event Hub/Relay<br/>```PUT https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}``` | [createorupdate](/rest/api/servicebus/controlplane-stable/namespaces/create-or-update) | [createorupdate](/rest/api/eventhub/controlplane-stable/namespaces/create-or-update) | [createorupdate](/rest/api/relay/controlplane-stable/namespaces/create-or-update) | 
 | **Topics-GetTopicAsync**<br/>```GET https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{namespace name}/topics/{topicPath}``` | [get](/rest/api/servicebus/controlplane-stable/topics/get) | &nbsp; | &nbsp; |
 
 ## Service Manager PowerShell - Resource Manager PowerShell
@@ -62,7 +62,7 @@ See the following documentation:
 - Latest REST API documentation
     - [Azure Service Bus](/rest/api/servicebus/)
     - [Azure Event Hubs](/rest/api/eventhub/)
-    - [Azure Relay](/rest/api/relay/controlplane-preview/)
+    - [Azure Relay](/rest/api/relay/)
 - Latest PowerShell documentation
     - [Azure Service Bus](/powershell/module/azurerm.servicebus/#service_bus)
     - [Azure Event Hubs](/powershell/module/azurerm.eventhub/#event_hub)