Udostępnij za pośrednictwem


Tworzenie, wyświetlanie tematów systemowych usługi Event Grid i zarządzanie nimi przy użyciu interfejsu wiersza polecenia platformy Azure

W tym artykule przedstawiono sposób tworzenia tematów systemowych i zarządzania nimi przy użyciu interfejsu wiersza polecenia platformy Azure. Aby zapoznać się z omówieniem tematów systemowych, zobacz Tematy systemowe.

Instalowanie rozszerzenia dla interfejsu wiersza polecenia platformy Azure

W przypadku interfejsu wiersza polecenia platformy Azure potrzebne jest rozszerzenie usługi Event Grid.

W Cloud Shell:

  • Jeśli rozszerzenie zostało zainstalowane wcześniej, zaktualizuj je: az extension update -n eventgrid
  • Jeśli rozszerzenie nie zostało zainstalowane wcześniej, zainstaluj je: az extension add -n eventgrid

W przypadku instalacji lokalnej:

  1. Zainstaluj interfejs wiersza polecenia platformy Azure. Upewnij się, że masz najnowszą wersję, sprawdzając element az --version.
  2. Odinstaluj poprzednie wersje rozszerzenia: az extension remove -n eventgrid
  3. Instalowanie rozszerzenia eventgrid za pomocą polecenia az extension add -n eventgrid

Tworzenie tematu systemowego

  • Aby najpierw utworzyć temat systemowy w źródle platformy Azure, a następnie utworzyć subskrypcję zdarzeń dla tego tematu, zobacz następujące tematy referencyjne:

    • az eventgrid system-topic create

      # Get the ID of the Azure source (for example: Azure Storage account)
      storageid=$(az storage account show \
              --name <AZURE STORAGE ACCOUNT NAME> \
              --resource-group <AZURE RESOURCE GROUP NAME> \
                  --query id --output tsv)
      
      # Create the system topic on the Azure source (example: Azure Storage account)
      az eventgrid system-topic create \
          -g <AZURE RESOURCE GROUP NAME> \
          --name <SPECIFY SYSTEM TOPIC NAME> \
          --location <LOCATION> \
          --topic-type microsoft.storage.storageaccounts \
          --source $storageid
      

      Aby uzyskać listę topic-type wartości, których można użyć do utworzenia tematu systemowego, uruchom następujące polecenie. Te wartości typów tematów reprezentują źródła zdarzeń, które obsługują tworzenie tematów systemowych. Ignoruj Microsoft.EventGrid.Topics i Microsoft.EventGrid.Domains z listy.

      az eventgrid topic-type  list --output json | grep -w id
      
    • az eventgrid system-topic event-subscription create

      az eventgrid system-topic event-subscription create --name <SPECIFY EVENT SUBSCRIPTION NAME> \
          -g rg1 --system-topic-name <SYSTEM TOPIC NAME> \
          --endpoint <ENDPOINT URL>		  
      
  • Aby utworzyć temat systemowy (niejawnie) podczas tworzenia subskrypcji zdarzeń dla źródła platformy Azure, użyj metody az eventgrid event-subscription create . Oto przykład:

    storageid=$(az storage account show --name <AZURE STORAGE ACCOUNT NAME> --resource-group <AZURE RESOURCE GROUP NAME> --query id --output tsv)
    endpoint=<ENDPOINT URL>
    
    az eventgrid event-subscription create \
      --source-resource-id $storageid \
      --name <EVENT SUBSCRIPTION NAME> \
      --endpoint $endpoint
    

    Aby zapoznać się z samouczkiem z instrukcjami krok po kroku, zobacz Subskrybowanie konta magazynu.

Wyświetl wszystkie tematy systemowe

Aby wyświetlić wszystkie tematy systemowe i szczegóły wybranego tematu systemowego, użyj następujących poleceń:

Usuwanie tematu systemowego

Aby usunąć temat systemowy, użyj następującego polecenia:

Następne kroki

Zobacz sekcję Tematy systemowe w Azure Event Grid, aby dowiedzieć się więcej o tematach systemowych i typach tematów obsługiwanych przez Azure Event Grid.