Configuração da Manutenção do Azure como uma origem da Grade de Eventos

  • Artigo

Este artigo fornece as propriedades e o esquema para os eventos de Configurações de Manutenção do Azure. Para obter uma introdução a esquemas de evento, consulte esquema de grade de eventos do Azure. Ele também fornece links para artigos sobre como usar a Configuração de Manutenção como uma origem do evento.

Tipos de evento disponíveis

A Configuração de Manutenção emite os seguintes tipos de eventos:

Tipo de evento Descrição
Microsoft.Maintenance.PreMaintenanceEvent Criado antes do início do trabalho de manutenção e dá ao usuário a oportunidade de realizar operações de pré-manutenção.
Microsoft.Maintenance.PostMaintenanceEvent Acionado após a conclusão do trabalho de manutenção e dá ao usuário a oportunidade de realizar operações de pós-manutenção.

Exemplo de evento

A seguir, um exemplo de um esquema de um evento de pré-manutenção:

[{ 
  "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" 
}]

A seguir, um exemplo de um evento de pós-manutenção:

[{ 
  "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" 
}]

Propriedades do evento

Um evento tem os seguintes dados de nível superior:

Propriedade Tipo Descrição
origem string Caminho de recurso completo para a origem do evento. Este campo não é gravável. Grade de Eventos fornece esse valor.
subject string Caminho definido pelo publicador para o assunto do evento.
tipo string Um dos tipos de evento registrados para a origem do evento.
time string A hora em que o evento é gerado com base na hora UTC do provedor.
ID string Identificador exclusivo do evento.
data objeto Dados de evento da Configuração de Aplicativos.
specversion string Versão de especificação do esquema CloudEvents.

O objeto de dados tem as seguintes propriedades:

Propriedade Tipo Descrição
correlationId string A ID do recurso da instância específica de agendamento de manutenção.
maintenanceConfigurationId string A ID do recurso da configuração de manutenção.
startDateTime string A hora de início do agendamento da manutenção.
endDateTime string A hora de término do agendamento da manutenção.
cancellationCutOffDateTime string O horário limite para cancelamento de uma instância de agendamento de manutenção.
resourceSubscriptionIds string As IDs de assinatura das quais as VMs estão incluídas nessa instância de programação.
status string O status de conclusão da instância de agendamento de manutenção.

Próximas etapas