Tworzenie zdarzeń wstępnych i ogłaszanych (wersja zapoznawcza)

Dotyczy: ✔️ Maszyny wirtualne z systemem Windows Maszyny ✔️ wirtualne z systemem Linux ✔️ w środowisku ✔️ lokalnym serwery z obsługą usługi Azure Arc na maszynach ✔️ wirtualnych platformy Azure.

Zdarzenia wstępne i ogłaszane umożliwiają wykonywanie akcji zdefiniowanych przez użytkownika przed i po konfiguracji zaplanowanej konserwacji. Aby uzyskać więcej informacji, zapoznaj się z działaniem zdarzenia wstępnego i ogłaszanego w usłudze Azure Update Manager.

W tym artykule opisano sposób tworzenia zdarzeń wstępnych i ogłaszanych w usłudze Azure Update Manager.

Usługa Event Grid w konfiguracjach konserwacji harmonogramu

Usługa Azure Update Manager wykorzystuje usługę Event Grid do tworzenia zdarzeń wstępnych i ogłaszania oraz zarządzania nimi. Aby uzyskać więcej informacji, zapoznaj się z omówieniem usługi Event Grid. Aby wyzwolić zdarzenie przed lub po oknie konserwacji harmonogramu, wymagane są następujące elementy:

1. Konfiguracja konserwacji harmonogramu — możesz utworzyć zdarzenia wstępne i końcowe dla konfiguracji konserwacji harmonogramu w usłudze Azure Update Manager. Aby uzyskać więcej informacji, zobacz Planowanie aktualizacji przy użyciu konfiguracji konserwacji.
2. Akcja do wykonania w zdarzeniu wstępnym lub po zdarzeniu — możesz użyć procedur obsługi zdarzeń (punktów końcowych) obsługiwanych przez usługę Event Grid w celu zdefiniowania akcji lub zadań. Poniżej przedstawiono przykłady tworzenia elementów Runbook usługi Azure Automation za pośrednictwem elementów webhook i usługi Azure Functions. W ramach tych programów obsługi zdarzeń/punktów końcowych należy zdefiniować akcje, które powinny być wykonywane w ramach zdarzeń wstępnych i po nich.
   1. Element webhook Utwórz element Runbook programu PowerShell 7.2 i połącz element Runbook z elementem webhook. -
   2. Funkcja - platformy Azure — tworzenie funkcji platformy Azure.
3. Zdarzenie wstępne i końcowe — możesz wykonać kroki udostępnione w poniższej sekcji, aby utworzyć zdarzenie wstępne i końcowe dla konfiguracji konserwacji harmonogramu. Aby dowiedzieć się więcej na temat terminów używanych na karcie Podstawy usługi Event Grid, zobacz Terminy usługi Event Grid .

Tworzenie zdarzenia przed zdarzeniem i po jego utworzeniu

Tworzenie zdarzeń wstępnych i ogłaszanych podczas tworzenia nowej konfiguracji konserwacji harmonogramu

Przy użyciu witryny Azure Portal

1. Zaloguj się do witryny Azure Portal i przejdź do usługi Azure Update Manager.

2. W obszarze Zarządzanie wybierz pozycję Maszyny.

3. Wybierz pozycję Zaplanuj aktualizacje na wstążce u góry.

4. Na stronie Tworzenie konfiguracji konserwacji wybierz kartę Zdarzenia.

5. Wybierz pozycję +Subskrypcja zdarzeń, aby utworzyć zdarzenie wstępne/ogłaszane.

6. Na stronie Dodawanie subskrypcji zdarzeń wprowadź następujące szczegóły: W sekcji Szczegóły subskrypcji zdarzeń podaj odpowiednią nazwę.

   • Zachowaj schemat jako schemat usługi Event Grid.
   • Wprowadź nazwę tematu systemowego dla pierwszego zdarzenia utworzonego w tej konfiguracji konserwacji. Ta sama nazwa tematu systemowego zostanie automatycznie wypełniona dla zdarzeń konsekwencji.
   • W sekcji Typy zdarzeń filtruj do typów zdarzeń wybierz typy zdarzeń, które chcesz wypchnąć do punktu końcowego lub miejsca docelowego. Możesz wybrać zdarzenie przed konserwacją lub zdarzenie po konserwacji albo oba te zdarzenia . Aby dowiedzieć się więcej o typach zdarzeń specyficznych dla planowania konfiguracji konserwacji, zobacz Typy zdarzeń platformy Azure.
   • W sekcji Szczegóły punktu końcowego wybierz punkt końcowy, z którego chcesz otrzymywać odpowiedź.

7. Wybierz pozycję Dodaj , aby utworzyć zdarzenia wstępne i ogłaszane dla harmonogramu podczas jego tworzenia.

   

Uwaga

W powyższym przepływie elementy webhook i usługa Azure Functions to dwa programy obsługi zdarzeń/punkty końcowe, które można wybrać. Po wybraniu pozycji Dodaj subskrypcja zdarzeń nie zostanie utworzona, ale dodana do konfiguracji konserwacji. Subskrypcja zdarzeń jest tworzona wraz z konfiguracją konserwacji harmonogramu.

Przy użyciu programu PowerShell

1. Utwórz konfigurację konserwacji, wykonując kroki wymienione tutaj.

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
   
   

Korzystanie z interfejsu wiersza polecenia (CLI)

1. Utwórz konfigurację konserwacji, wykonując kroki wymienione tutaj.

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
   
   

Korzystanie z interfejsu API

1. Utwórz konfigurację konserwacji, wykonując kroki wymienione tutaj.

2. # Tworzenie tematu systemowego Dowiedz się więcej

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

   Treść żądania:

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

   # Tworzenie subskrypcji zdarzeń Dowiedz się więcej

   Dozwolone typy zdarzeń — Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

   Element 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
   

   Treść żądania:

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

   Funkcja platformy 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
   

   Treść żądania

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

   ---

Tworzenie zdarzeń wstępnych i ogłaszanych w istniejącej konfiguracji konserwacji harmonogramu

Przy użyciu witryny Azure Portal

1. Zaloguj się do witryny Azure Portal i przejdź do usługi Azure Update Manager.

2. W obszarze Zarządzanie wybierz pozycję Maszyny, Konfiguracje konserwacji.

3. Na stronie Konfiguracja konserwacji wybierz konfigurację konserwacji, do której chcesz dodać zdarzenie wstępne i końcowe.

4. Na wybranej stronie Konfiguracja konserwacji w obszarze Ustawienia wybierz pozycję Zdarzenia. Alternatywnie w obszarze Przegląd wybierz kartę Utwórz zdarzenie konserwacji.

   

5. Wybierz pozycję +Subskrypcja zdarzeń, aby utworzyć zdarzenie przed/po konserwacji.

   

6. Na stronie Tworzenie subskrypcji zdarzeń wprowadź następujące szczegóły:

   • W sekcji Szczegóły subskrypcji zdarzeń podaj odpowiednią nazwę.

   • Zachowaj schemat jako schemat usługi Event Grid.

   • W sekcji Szczegóły tematu podaj odpowiednią nazwę dla nazwy tematu systemowego.

   • W sekcji Typy zdarzeń filtruj do typów zdarzeń wybierz typy zdarzeń, które chcesz wypchnąć do punktu końcowego lub miejsca docelowego. Możesz wybrać między zdarzeniem przed konserwacją a zdarzeniem po konserwacji. Aby dowiedzieć się więcej o typach zdarzeń specyficznych dla planowania konfiguracji konserwacji, zobacz Typy zdarzeń platformy Azure.

   • W sekcji Szczegóły punktu końcowego wybierz punkt końcowy, z którego chcesz otrzymywać odpowiedź.

     

7. Wybierz pozycję Utwórz , aby skonfigurować zdarzenia wstępne i ogłaszane według istniejącego harmonogramu.

Przy użyciu programu 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

Korzystanie z interfejsu wiersza polecenia (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

Korzystanie z interfejsu API

# Tworzenie tematu systemowego Dowiedz się więcej

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

Treść żądania:

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

# Tworzenie subskrypcji zdarzeń Dowiedz się więcej

Dozwolone typy zdarzeń — Microsoft.Maintenance.PreMaintenanceEvent, Microsoft.Maintenance.PostMaintenanceEvent

Element 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

Treść żądania:

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

Funkcja platformy 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

Treść żądania

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

Następne kroki

• Aby zapoznać się z omówieniem zdarzeń wstępnych i po ich opublikowaniu w usłudze Azure Update Manager, zobacz tutaj.
• Aby dowiedzieć się, jak zarządzać zdarzeniami wstępnymi i publikować je lub anulować przebieg harmonogramu, zobacz zdarzenia konfiguracji przed konserwacją i po nim.
• Aby dowiedzieć się, jak używać zdarzeń wstępnych i ogłaszanych do włączania i wyłączania maszyn wirtualnych przy użyciu elementów webhook, zobacz tutaj.
• Aby dowiedzieć się, jak używać zdarzeń wstępnych i ogłaszanych do włączania i wyłączania maszyn wirtualnych przy użyciu usługi Azure Functions, zobacz tutaj.