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 | 字串 | 維修排程執行個體的完成狀態。 |
下一步
- 如需 Azure Event Grid 的簡介，請參閱什麼是 Event Grid？
- 若要了解 Event Grid 訂用帳戶的建立，請參閱 Event Grid 訂用帳戶結構描述。