訂閱 Azure 資源通知 - 資源管理事件 - Azure Event Grid

發行項
03/11/2024

本文說明訂閱 Azure 資源通知 - 資源所發佈事件所需的步驟。如需關於這些事件的詳細資訊，請參閱 Azure 資源通知 - 資源事件。

建立資源系統主題

本節說明如何建立 microsoft.resourcenotifications.resources 類型的系統主題。

將帳戶設定為您要在其中建立系統主題的 Azure 訂用帳戶。
```
az account set –s AZURESUBSCRIPTIONID
```

使用 az eventgrid system-topic create 命令建立 microsoft.resourcenotifications.resources 類型的系統主題。

az eventgrid system-topic create \
            --name SYSTEMTOPICNAME \
            --resource-group RESOURCEGROUPNAME \
            --source /subscriptions/AZURESUBSCRIPTIONID \
            --topic-type microsoft.resourcenotifications.resources \
            --location Global

將帳戶設定為您要在其中建立系統主題的 Azure 訂用帳戶。
```
Set-AzContext -Subscription AZURESUBSCRIPTIONID
```

使用 New-AzEventGridSystemTopic 命令建立 microsoft.resourcenotifications.resources 類型的系統主題。

New-AzEventGridSystemTopic -name SYSTEMTOPICNAME `
                -resourcegroup RESOURCEGROUPNAME `
                -source /subscriptions/AZURESUBSCRIPTIONID `
                -topictype microsoft.resourcenotifications.resources `
                -location global

使用 az eventgrid system-topic event-subscription create 命令來建立上述主題的事件訂閱。

下列範例命令會為 CreatedOrUpdated 和 Deleted 事件建立事件訂閱。如果您未指定 included-event-types，則預設會包含所有事件類型。

az eventgrid system-topic event-subscription create \
                --name EVENTSUBSCRIPTIONNAME \
                --resource-group RESOURCEGROUPNAME \
                --system-topic-name SYSTEMTOPICNAME \
                –-included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
                --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB \
                --endpoint-type eventhub

使用 New-AzEventGridSystemTopicEventSubscription 命令，為上述主題建立事件訂閱。

下列範例命令會為 CreatedOrUpdated 和 Deleted 事件建立事件訂閱。如果您未指定 IncludedEventType，則預設會包含所有事件類型。

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName EVENTSUBSCRIPTIONNAME `
                -ResourceGroupName RESOURCEGROUPNAME `
                -SystemtopicName SYSTEMTOPICNAME `
                -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
                -Endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBSNAMESPACE/eventhubs/EVENTHUB `
                -EndpointType eventhub

在 [事件方格系統主題] 頁面上，選取工具列上的 [事件訂閱]。
確認 [主題類型]、[來源資源] 和 [主題名稱] 都已自動填入。
輸入事件訂閱的名稱。
針對 [篩選至事件類型]，請選取事件，例如 CreatedOrUpdated 或 Deleted。
選取端點類型。
根據您選取的端點類型，設定事件處理常式。在下列範例中，會選取 Azure 事件中樞。
選取 [篩選] 索引標籤，以提供主旨篩選和進階篩選。例如，若要從特定資源群組中的資源篩選事件，請遵循下列步驟：
1. 選取 [啟用主旨篩選]。
2. 在 [主題篩選] 區段中，針對 [主旨開頭為]，請以下列格式提供資源群組的值：/subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}。
然後，選取 [建立] 以建立事件訂用帳戶。

刪除事件訂閱與系統主題

若要刪除事件訂閱，請使用 az eventgrid system-topic event-subscription delete 命令。以下是範例：

az eventgrid system-topic event-subscription delete --name firstEventSubscription --resourcegroup sampletestrg --system-topic-name arnSystemTopicResources

若要刪除系統主題，請使用 az eventgrid system-topic delete 命令。以下是範例：

az eventgrid system-topic delete --name arnSystemTopicResources --resource-group sampletestrg

若要刪除事件訂閱，請使用 Remove-AzEventGridSystemTopicEventSubscription 命令。以下是範例：

Remove-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription -ResourceGroupName sampletestrg -SystemTopicName arnSystemTopicResources

若要刪除系統主題，請使用 Remove-AzEventGridSystemTopic 命令。以下是範例：

Remove-AzEventGridSystemTopic -ResourceGroupName sampletestrg -Name arnSystemTopicResources

篩選範例

本節顯示在 Azure 訂用帳戶中建立、更新、刪除虛擬機器的通知篩選範例。

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources 
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
	--endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub `
            -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

選擇 CreatedOrUpdated 和 Deleted 事件類型。

在事件訂閱的 [篩選] 索引標籤中，選擇下列進階篩選。

Key = "data.resourceInfo.type"
Operator = "StringEndsWith" 
Value = "virtualMachines"

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources \
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --subject-begins-with /subscription/{Azure subscription ID}/resourceGroups/<Resource group name>/
	--advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub -AdvancedFilter @(@{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

在事件訂閱的 [篩選] 索引標籤中，啟用主體篩選，然後使用下列主體篩選：

Subject begins with = /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

然後，選擇下列進階篩選。

Key = "data.resourceInfo.type"
Operator = "String ends with"
Value = "virtualMachines"

az eventgrid system-topic event-subscription create \
	--name firstEventSubscription \
	--resource-group sampletestrg \
	--system-topic-name arnSystemTopicResources \
	--included-event-types Microsoft.ResourceNotifications.Resources.CreatedOrUpdated \
	--endpoint/subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources \
	--endpoint-type evenhub \
    --subject-begins-with /subscription/{Azure subscription ID}/resourceGroups/<Resource group name>/
    --advanced-filter data.resourceInfo.location StringIn eastus 
    –-advanced-filter data.resourceInfo.type StringEndsWith virtualMachines

New-AzEventGridSystemTopicEventSubscription -EventSubscriptionName firstEventSubscription `
            -ResourceGroupName sampletestrg `
            -SystemtopicName arnSystemTopicResources `
            -IncludedEventType Microsoft.ResourceNotifications.Resources.CreatedOrUpdated, Microsoft.ResourceNotifications.Resources.Deleted `
            -Endpoint /subscriptions/000000000-0000-0000-0000-000000000000/resourceGroups/sampletestrg/providers/Microsoft.EventHub/namespaces/testEventHub/eventhubs/ehforsystemtopicresources `
            -EndpointType eventhub `
            -AdvancedFilter @(@{operator = "StringIn"; key = "data.resourceInfo.location"; value ="eastus"}, @{operator = "StringEndsWith"; key = "data.resourceInfo.type" ; value ="virtualMachines"})

在事件訂閱的 [篩選] 索引標籤中，啟用主體篩選，然後使用下列主體篩選：

Subject begins with = /subscriptions/{subscription-id}/resourceGroups/{resourceGroup-id}

然後，選擇下列進階篩選。

Key = "data.resourceInfo.location",
Operator = "String is in"
Value = "eastus"

且

Key = "data.resourceInfo.type", Operator = "String ends with" Value = "virtualMachines"

與我們連絡

如果您對這項功能有任何疑問或意見反應，請立即與我們連絡：arnsupport@microsoft.com。

為了更妥善地協助您處理特定事件的特定意見反應，請提供下列資訊：

針對遺失的事件：

系統主題類型名稱
執行作業時，UTC 的近似時間戳記
產生通知的基底資源識別碼
在 Azure 入口網站中瀏覽至您的資源，然後選取最右側的 JSON 檢視。資源識別碼是 JSON 檢視頁面上的第一個欄位。
預期的事件類型
執行的作業 (例如 VM 已啟動或停止、已建立記憶體帳戶等)
發生問題的描述 (例如，VM 已啟動，且未產生 Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged 事件)
可能的話，請提供所執行作業的相互關聯識別碼

針對延遲或有非預期內容的事件

系統主題類型名稱
通知的整個內容 (排除 data.resourceInfo.properties)
所遇到問題的描述和受影響欄位的值

請確定您在共用此資料時，未提供任何終端使用者可識別的資訊。

下一步

如需關於這些事件的詳細資訊，請參閱 Azure 資源通知 - 資源事件。

Share via

建立資源系統主題

刪除事件訂閱與系統主題

篩選範例

與我們連絡

針對遺失的事件：

針對延遲或有非預期內容的事件

下一步

其他資源

Share via

訂閱事件方格中的 Azure 資源管理事件 (預覽)

建立資源系統主題

訂閱事件

刪除事件訂閱與系統主題

篩選範例

訂閱在 Azure 訂用帳戶中建立、更新、刪除虛擬機器的通知

訂閱特定資源群組的 VM 建立、更新和刪除通知

訂閱訂用帳戶內特定位置的 VM 建立和更新通知

與我們連絡

針對遺失的事件：

針對延遲或有非預期內容的事件

下一步

其他資源