Membuat peristiwa pra dan posting

Berlaku untuk: ✔️ VM Windows VM ✔️ ✔️ Linux Lingkungan ✔️ lokal Azure Arc-enabled server ✔️ Azure VM.

Peristiwa pra dan posting memungkinkan Anda menjalankan tindakan yang ditentukan pengguna sebelum dan sesudah konfigurasi pemeliharaan terjadwal. Untuk informasi selengkapnya, buka pekerjaan acara pra dan posting di Azure Update Manager.

Artikel ini menjelaskan cara membuat peristiwa sebelum dan diposting di Azure Update Manager.

Event Grid dalam konfigurasi pemeliharaan jadwal

Azure Update Manager memanfaatkan Event Grid untuk membuat dan mengelola peristiwa pra dan posting. Untuk informasi selengkapnya, buka gambaran umum Event Grid. Untuk memicu peristiwa baik sebelum atau sesudah jendela pemeliharaan jadwal, Anda memerlukan hal berikut:

1. Menjadwalkan konfigurasi pemeliharaan - Anda dapat membuat peristiwa pra dan posting untuk konfigurasi pemeliharaan jadwal di Azure Update Manager. Untuk informasi selengkapnya, lihat menjadwalkan pembaruan menggunakan konfigurasi pemeliharaan.
2. Tindakan yang akan dilakukan dalam peristiwa sebelum atau pasca - Anda dapat menggunakan Penanganan aktivitas (Titik Akhir) yang didukung oleh Event Grid untuk menentukan tindakan atau tugas. Berikut adalah contoh tentang cara membuat Runbook Azure Automation melalui Webhook dan Azure Functions. Dalam penanganan/Titik Akhir Peristiwa ini, Anda harus menentukan tindakan yang harus dilakukan sebagai bagian dari peristiwa pra dan posting.
   1. Webhook - Buat Runbook PowerShell 7.2 dan tautkan Runbook ke webhook.
   2. Azure Function - Membuat Azure Function.
3. Sebelum dan posting peristiwa - Anda dapat mengikuti langkah-langkah yang dibagikan di bagian berikut untuk membuat peristiwa pra dan posting untuk menjadwalkan konfigurasi pemeliharaan. Untuk mempelajari selengkapnya tentang istilah yang digunakan di tab Dasar di Event Grid, lihat Istilah Event Grid .

Membuat peristiwa pra dan pasca

Membuat peristiwa pra dan pasca saat membuat konfigurasi pemeliharaan jadwal baru

Menggunakan portal Azure

1. Masuk ke portal Azure dan buka Azure Update Manager.

2. Di bawah Kelola, pilih Komputer.

3. Pilih Jadwalkan pembaruan dari pita di bagian atas.

4. Di halaman Buat konfigurasi pemeliharaan, pilih tab Peristiwa .

5. Pilih +Langganan Peristiwa untuk membuat peristiwa pra/posting.

6. Pada halaman Tambahkan Langganan Peristiwa, masukkan detail berikut ini: Di bagian Detail Langganan Peristiwa, berikan nama yang sesuai.

   • Pertahankan skema sebagai Skema Event Grid.
   • Masukkan Nama Topik Sistem untuk peristiwa pertama yang Anda buat dalam konfigurasi pemeliharaan ini. Nama Topik Sistem yang sama akan diisi secara otomatis untuk peristiwa yang konsekuen.
   • Di bagian Jenis Peristiwa, Filter ke Jenis Peristiwa, pilih jenis peristiwa yang ingin Anda dorong ke titik akhir atau tujuan. Anda dapat memilih Peristiwa Pra Pemeliharaan atau Peristiwa Pemeliharaan Pasca Pemeliharaan atau keduanya. Untuk mempelajari selengkapnya tentang jenis peristiwa yang khusus untuk menjadwalkan konfigurasi pemeliharaan, lihat Jenis Peristiwa Azure.
   • Di bagian Detail titik akhir, pilih titik akhir tempat Anda ingin menerima respons.

7. Pilih Tambahkan untuk membuat peristiwa pra dan posting untuk jadwal setelah pembuatannya.

   

Catatan

Dalam alur di atas, Webhook dan Azure Functions adalah dua Penanganan aktivitas/titik akhir yang dapat Anda pilih. Saat Anda memilih Tambahkan, langganan peristiwa tidak dibuat tetapi ditambahkan ke konfigurasi pemeliharaan. Langganan peristiwa dibuat bersama dengan konfigurasi pemeliharaan jadwal.

Menggunakan PowerShell

1. Buat konfigurasi pemeliharaan dengan mengikuti langkah-langkah yang tercantum di sini.

2.  # Obtain the Maintenance Configuration ID from Step 1 and assign it to MaintenanceConfigurationResourceId variable  
   
    $MaintenanceConfigurationResourceId = "/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"
   
    # Use the same Resource Group that you used to create maintenance configuration in Step 1
   
    $ResourceGroupForSystemTopic = "<Resource Group for System Topic>"
   
    $SystemTopicName = "<System topic name>"
   
    $TopicType = "Microsoft.Maintenance.MaintenanceConfigurations"
   
    $SystemTopicLocation = "<System topic location>"
   
    # System topic creation
   
    New-AzEventGridSystemTopic -ResourceGroupName $ResourceGroupForSystemTopic -Name $SystemTopicName -Source $MaintenanceConfigurationResourceId -TopicType $TopicType -Location $SystemTopicLocation
   
    # Event subscription creation
   
    $IncludedEventTypes = @("Microsoft.Maintenance.PreMaintenanceEvent")
   
    # Webhook
   
    $EventSubscriptionName = "PreEventWebhook"
   
    $PreEventWebhookEndpoint = "<Webhook URL>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes
   
    # Azure Function
   
    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"
   
    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes
   
   

Menggunakan CLI

1. Buat konfigurasi pemeliharaan dengan mengikuti langkah-langkah yang tercantum di sini.

2. 
    SystemTopicName="<System topic name> 
   
    # Use the same Resource Group that you used to create maintenance configuration in Step 1
   
    ResourceGroupName="<Resource Group mentioned in Step 1>"
   
    # Obtain the Maintenance Configuration ID from Step 1 and assign it to Source variable
   
    Source="/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"
   
    TopicType="Microsoft.Maintenance.MaintenanceConfigurations"
   
    Location="<System topic location> "
   
    # System topic creation
   
    az eventgrid system-topic create --name $SystemTopicName --resource-group $ResourceGroupName --source $Source --topic-type $TopicType --location $Location
   
    # Event subscription creation
   
    IncludedEventTypes='("Microsoft.Maintenance.PreMaintenanceEvent")'
   
    # Webhook
   
    az eventgrid system-topic event-subscription create --name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type webhook --endpoint "<webhook URL>" --included-event-types IncludedEventTypes
   
    # Azure Function
   
    az eventgrid system-topic event-subscription create –name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type azurefunction --endpoint "<Azure Function ResourceId>" --included-event-types IncludedEventTypes
   
   

Menggunakan API

1. Buat konfigurasi pemeliharaan dengan mengikuti langkah-langkah yang tercantum di sini.

2. # Pembuatan topik sistem Pelajari selengkapnya

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>?api-version=2022-06-15
   

   Isi Permintaan:

   {
     "properties": {
       "source": "/subscriptions/<subscription Id>/resourceGroups/<resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenance configuration name> ",
       "topicType": "Microsoft.Maintenance.MaintenanceConfigurations"
     },
     "location": "<location>"
   }
   

   # Pembuatan langganan peristiwa Pelajari selengkapnya

   Jenis Peristiwa yang Diizinkan - Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

   Webhook

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15
   

   Isi Permintaan:

   {
     "properties": {
       "destination": {
         "endpointType": "WebHook",
         "properties": {
           "endpointUrl": "<Webhook URL>"
         }
       },
       "filter": {
         "includedEventTypes": [
           "Microsoft.Maintenance.PreMaintenanceEvent"
         ]
       }
     }
   }
   

   Fungsi Azure

   PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15
   

   Isi Permintaan

   {
       "properties": {
           "destination": {
               "endpointType": "AzureFunction",
               "properties": {
                   "resourceId": "<Azure Function Resource Id>"
               }
           }
       },
       "filter": {
           "includedEventTypes": [
               "Microsoft.Maintenance.PostMaintenanceEvent"
           ]
       }
   }
   

   ---

Membuat peristiwa pra dan posting pada konfigurasi pemeliharaan jadwal yang ada

Menggunakan portal Azure

1. Masuk ke portal Azure dan buka Azure Update Manager.

2. Di bawah Kelola, pilih Komputer, Konfigurasi Pemeliharaan.

3. Di halaman Konfigurasi Pemeliharaan, pilih konfigurasi pemeliharaan yang ingin Anda tambahkan peristiwa pra dan posting.

4. Di halaman Konfigurasi pemeliharaan yang dipilih, di bawah Pengaturan, pilih Peristiwa. Atau, di bawah Gambaran Umum, pilih kartu Buat peristiwa pemeliharaan.

   

5. Pilih +Langganan Peristiwa untuk membuat Peristiwa Pra/Pasca Pemeliharaan.

   

6. Pada halaman Buat Langganan Peristiwa, masukkan detail berikut ini:

   • Di bagian Detail Langganan Peristiwa, berikan nama yang sesuai.

   • Pertahankan skema sebagai Skema Event Grid.

   • Di bagian Detail Topik, berikan nama yang sesuai ke Nama Topik Sistem.

   • Di bagian Jenis Peristiwa, Filter ke Jenis Peristiwa, pilih jenis peristiwa yang ingin Anda dorong ke titik akhir atau tujuan. Anda dapat memilih antara Peristiwa Pra Pemeliharaan dan Peristiwa Pemeliharaan Pasca Pemeliharaan. Untuk mempelajari selengkapnya tentang jenis peristiwa yang khusus untuk menjadwalkan konfigurasi pemeliharaan, lihat Jenis Peristiwa Azure.

   • Di bagian Detail titik akhir, pilih titik akhir dari tempat Anda ingin menerima respons.

     

7. Pilih Buat untuk mengonfigurasi peristiwa pra dan posting pada jadwal yang ada.

Menggunakan PowerShell

    $MaintenanceConfigurationResourceId = "/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"

    $ResourceGroupForSystemTopic = "<Resource Group for System Topic>"

    $SystemTopicName = "<System topic name>"

    $TopicType = "Microsoft.Maintenance.MaintenanceConfigurations"

    $SystemTopicLocation = "<System topic location>"

    # System topic creation

    New-AzEventGridSystemTopic -ResourceGroupName $ResourceGroupForSystemTopic -Name $SystemTopicName -Source $MaintenanceConfigurationResourceId -TopicType $TopicType -Location $SystemTopicLocation

    # Event subscription creation

    $IncludedEventTypes = @("Microsoft.Maintenance.PreMaintenanceEvent")

    # Webhook

    $EventSubscriptionName = "PreEventWebhook"

    $PreEventWebhookEndpoint = "<Webhook URL>"

    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Endpoint $PreEventWebhookEndpoint -IncludedEventType $IncludedEventTypes

    # Azure Function

    $dest = New-AzEventGridAzureFunctionEventSubscriptionDestinationObject -ResourceId "<Azure Function Resource Id>"

    New-AzEventGridSystemTopicEventSubscription -ResourceGroupName $ResourceGroupForSystemTopic -SystemTopicName $SystemTopicName -EventSubscriptionName $EventSubscriptionName -Destination $dest -IncludedEventType $IncludedEventTypes

Menggunakan CLI

   SystemTopicName="<System topic name> 

   ResourceGroupName="<Resource Group for System Topic>"

   Source="/subscriptions/<subId>/resourceGroups/<Resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<Maintenance configuration Name>"

    TopicType="Microsoft.Maintenance.MaintenanceConfigurations"

    Location="<System topic location> "

   # System topic creation

    az eventgrid system-topic create --name $SystemTopicName --resource-group $ResourceGroupName --source $Source --topic-type $TopicType --location $Location

   # Event subscription creation

    IncludedEventTypes='("Microsoft.Maintenance.PreMaintenanceEvent")'

   # Webhook

    az eventgrid system-topic event-subscription create --name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type webhook --endpoint "<webhook URL>" --included-event-types IncludedEventTypes

   # Azure Function

    az eventgrid system-topic event-subscription create –name "<Event subscription name>" --resource-group $ResourceGroupName --system-topic-name $SystemTopicName --endpoint-type azurefunction --endpoint "<Azure Function ResourceId>" --included-event-types IncludedEventTypes

Menggunakan API

# Pembuatan topik sistem Pelajari selengkapnya

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>?api-version=2022-06-15

Isi Permintaan:

{
  "properties": {
    "source": "/subscriptions/<subscription Id>/resourceGroups/<resource group>/providers/Microsoft.Maintenance/maintenanceConfigurations/<maintenance configuration name> ",
    "topicType": "Microsoft.Maintenance.MaintenanceConfigurations"
  },
  "location": "<location>"
}

# Pembuatan langganan peristiwa Pelajari selengkapnya

Jenis Peristiwa yang Diizinkan - Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

Webhook

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Isi Permintaan:

{
  "properties": {
    "destination": {
      "endpointType": "WebHook",
      "properties": {
        "endpointUrl": "<Webhook URL>"
      }
    },
    "filter": {
      "includedEventTypes": [
        "Microsoft.Maintenance.PreMaintenanceEvent"
      ]
    }
  }
}

Fungsi Azure

PUT /subscriptions/<subscription Id>/resourceGroups/<resource group name>/providers/Microsoft.EventGrid/systemTopics/<system topic name>/eventSubscriptions/<Event Subscription name>?api-version=2022-06-15

Isi Permintaan

{
    "properties": {
        "destination": {
            "endpointType": "AzureFunction",
            "properties": {
                "resourceId": "<Azure Function Resource Id>"
            }
        }
    },
    "filter": {
        "includedEventTypes": [
            "Microsoft.Maintenance.PostMaintenanceEvent"
        ]
    }
}

Langkah berikutnya

• Untuk gambaran umum peristiwa pra dan posting di Azure Update Manager, lihat di sini.
• Untuk mempelajari cara mengelola peristiwa pra dan posting atau membatalkan eksekusi jadwal, lihat peristiwa konfigurasi pra dan pasca pemeliharaan.
• Untuk mempelajari cara menggunakan peristiwa pra dan posting untuk mengaktifkan dan menonaktifkan VM Anda menggunakan Webhook, lihat di sini.
• Untuk mempelajari cara menggunakan peristiwa pra dan posting untuk mengaktifkan dan menonaktifkan VM Anda menggunakan Azure Functions, lihat di sini.