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

  • Artigo

Este artigo fornece as propriedades e o esquema para eventos de Configurações de Manutenção do Azure. Para obter uma introdução aos esquemas de eventos, consulte Esquema de eventos da Grade de Eventos do Azure. Ele também fornece links para artigos para usar a Configuração de Manutenção como uma fonte de eventos.

Tipos de eventos 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 executar operações de pré-manutenção.
Microsoft.Maintenance.PostMaintenanceEvent Criado após a conclusão do trabalho de manutenção e dá a oportunidade de realizar operações de pós-manutenção.

Exemplo de evento

Segue-se 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" 
}]

Segue-se um exemplo de um evento 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 completo do recurso para a origem do evento. Este campo não pode ser gravado. O Event Grid fornece este valor.
requerente string Caminho definido pelo publicador para o assunto do evento.
tipo string Um dos tipos de eventos registados para esta origem de evento.
hora string A hora em que o evento é gerado com base na hora UTC do provedor.
ID string Identificador exclusivo do evento.
dados objeto Dados de eventos de Configuração do Aplicativo.
specversion string Versão da especificação do esquema CloudEvents.

O objeto de dados tem as seguintes propriedades:

Propriedade Tipo Descrição
correlationId string O ID do recurso da instância específica do cronograma de manutenção.
maintenanceConfigurationId string O ID do recurso da configuração de manutenção.
startDateTime string A hora de início do cronograma de manutenção.
endDateTime string A hora de término do cronograma de manutenção.
cancelamentoCutOffDateTime string O tempo limite de cancelamento da instância de agendamento de manutenção.
resourceSubscriptionIds string As IDs de assinatura das quais as VMs são incluídas nesta instância de agendamento.
status string O status de conclusão da instância do cronograma de manutenção.

Próximos passos

  • Para obter uma introdução à Grade de Eventos do Azure, consulte O que é a Grade de Eventos?
  • Para obter mais informações sobre como criar uma assinatura da Grade de Eventos do Azure, consulte Esquema de assinatura da Grade de Eventos.