分享方式：

Azure 維修設定作為事件方格來源

  • 文章

本文提供 Azure 維修設定事件的屬性和結構描述。 如需事件結構描述的簡介，請參閱 Azure Event Grid 事件結構描述。 其也提供您文章的連結，以使用維修設定作為事件來源。

可用的事件類型

維修設定會發出下列事件類型：

事件類型 說明
Microsoft.Maintenance.PreMaintenanceEvent 在維修作業開始之前引發，並讓使用者有機會執行維修前作業。
Microsoft.Maintenance.PostMaintenanceEvent 在維修作業完成之後引發，並提供機會執行維修後作業。

事件範例

以下是預維修事件架構的範例：

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration", 
  "subject": "contosomaintenanceconfiguration", 
"data": 
{ 
   "correlationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000",  
   "maintenanceConfigurationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration",  
   "startDateTime": "2023-05-09T15:00:00Z",  
   "endDateTime": "2023-05-09T18:55:00Z",  
   "cancellationCutOffDateTime": "2023-05-09T14:59:00Z",  
   "resourceSubscriptionIds": ["subscription guid 1", "subscription guid 2"] 
} 
"eventType": "Microsoft.Maintenance.PreMaintenanceEvent", 
"eventTime": "2023-05-09T14:25:00.3717473Z", 
  "dataVersion": "1.0", 
  "metadataVersion": "1" 
}]

以下是維修事件後結構描述的範例：

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration", 
  "subject": "contosomaintenanceconfiguration", 
"data": 
{ 
   "correlationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000",  
   "maintenanceConfigurationId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration",  
   "status": "Succeeded", 
   "startDateTime": "2023-05-09T15:00:00Z",  
   "endDateTime": "2023-05-09T18:55:00Z",  
   "resourceSubscriptionIds": ["subscription guid 1", "subscription guid 2"] 
} 
"eventType": "Microsoft.Maintenance.PostMaintenanceEvent", 
"eventTime": "2023-05-09T15:55:00.3717473Z", 
  "dataVersion": "1.0", 
  "metadataVersion": "1" 
}]

事件屬性

事件具有下列的最高層級資料：

屬性 型別 說明
主題 string 事件來源的完整資源路徑。 此欄位無法寫入。 事件方格提供此值。
主旨 string 發行者定義事件主旨的路徑。
eventType string 此事件來源已註冊的事件類型之一。
eventTime string 事件產生的時間，以提供者的 UTC 時間為準。
識別碼 string 事件唯一識別碼
資料 object 應用程式組態事件資料。
dataVersion string 資料物件的結構描述版本。 發行者會定義結構描述版本。
metadataVersion string 事件中繼資料的結構描述版本。 「事件方格」會定義最上層屬性的結構描述。 事件方格提供此值。

資料物件具有下列屬性：

屬性 型別 說明
correlationId string 特定維修排程執行個體的資源標識碼。
maintenanceConfigurationId string 維修設定的資源識別碼。
startDateTime string 維修排程開始時間。
endDateTime string 維修排程結束時間。
cancellationCutOffDateTime string 維修排程執行個體取消截止時間。
resourceSubscriptionIds string 此排程執行個體中包含 VM 的訂用帳戶識別碼。
status 字串 維修排程執行個體的完成狀態。

下一步