다음을 통해 공유

Event Grid 원본으로서의 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", 
  "source": "/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"] 
} 
"type": "Microsoft.Maintenance.PreMaintenanceEvent", 
"time": "2023-05-09T14:25:00.3717473Z", 
  "specversion": "1.0" 
}]

다음은 유지 관리 후 이벤트에 대한 예입니다.

[{ 
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Maintenance/maintenanceConfigurations/contosomaintenanceconfiguration/providers/microsoft.maintenance/applyupdates/20230509150000", 
  "source": "/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"] 
} 
"type": "Microsoft.Maintenance.PostMaintenanceEvent", 
"time": "2023-05-09T15:55:00.3717473Z", 
  "specversion": "1.0" 
}]

이벤트 속성

이벤트에는 다음과 같은 최상위 데이터가 있습니다.

속성 Type 설명
원본 string 이벤트 원본에 대한 전체 리소스 경로입니다. 이 필드는 쓸 수 없습니다. Event Grid는 이 값을 제공합니다.
subject string 게시자가 정의한 이벤트 주체의 경로입니다.
type string 이 이벤트 원본에 대해 등록된 이벤트 유형 중 하나입니다.
시간 string 공급자의 UTC 시간을 기준으로 이벤트가 생성되는 시간입니다.
ID string 이벤트에 대한 고유 식별자입니다.
데이터 개체 App Configuration 이벤트 데이터.
specversion string CloudEvents 스키마 사양 버전입니다.

데이터 개체의 속성은 다음과 같습니다.

속성 Type 설명
correlationId string 특정 유지 관리 일정 인스턴스의 리소스 ID입니다.
maintenanceConfigurationId string 유지 관리 구성의 리소스 ID입니다.
startDateTime string 유지 관리 일정 시작 시간입니다.
endDateTime string 유지 관리 일정 종료 시간입니다.
cancellationCutOffDateTime string 유지 관리 일정 인스턴스 취소 마감 시간입니다.
resourceSubscriptionIds string VM이 이 일정 인스턴스에 포함된 구독 ID입니다.
status string 유지 관리 일정 인스턴스의 완료 상태입니다.

다음 단계