Поделиться через


Создание, просмотр системных разделов Сетки событий, а также управление ими с помощью Azure CLI

В этой статье показано, как создавать системные разделы и управлять ими с помощью Azure CLI. Обзор системных разделов см. в статье Системные разделы.

Установка расширения для Azure CLI

Для Azure CLI вам потребуется расширение Сетки событий.

В Cloud Shell:

  • Если вы установили расширение ранее, обновите его: az extension update -n eventgrid.
  • Если расширение еще не установлено, установите его: az extension add -n eventgrid.

При локальной установке:

  1. Установка Azure CLI. С помощью az --version проверьте, что установлена последняя версия.
  2. Удалите предыдущие версии расширения: az extension remove -n eventgrid.
  3. Установите расширение eventgrid с помощью az extension add -n eventgrid.

Создание системного раздела

  • Чтобы сначала создать системный раздел в источнике Azure, а затем создать подписку на события для этого раздела, ознакомьтесь со следующими примерами разделов:

    • 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
      

      Чтобы получить список значений topic-type, которые можно использовать для создания системного раздела, выполните команду, приведенную ниже. Эти значения типа раздела представляют источники событий, которые поддерживают создание системных разделов. Пропустите Microsoft.EventGrid.Topics и Microsoft.EventGrid.Domains из списка.

      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>		  
      
  • Чтобы создать системный раздел (неявно) при создании подписки на события для источника Azure, используйте метод az eventgrid event-subscription create. Ниже приведен пример:

    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
    

    Пошаговые инструкции см. в разделе Подписка на учетную запись хранения.

Просмотр всех системных разделов

Чтобы просмотреть список всех разделов и сведения о выбранном системном разделе, используйте следующие команды:

Удаление системного раздела

Чтобы удалить системный раздел, используйте следующую команду:

Дальнейшие действия

Дополнительные сведения о системных разделах и типах разделов, поддерживаемых службой "Сетка событий Azure", см. в разделе Системные разделы в службе "Сетка событий Azure".