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

Статья
06/01/2023

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

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

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

В Cloud Shell:

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

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

Установка Azure CLI. С помощью az --version проверьте, что установлена последняя версия.
Удалите предыдущие версии расширения: az extension remove -n eventgrid.
Установите расширение 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
```
Пошаговые инструкции см. в разделе Подписка на учетную запись хранения.

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

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

az eventgrid system-topic list
```
az eventgrid system-topic list	 
```

az eventgrid system-topic show

az eventgrid system-topic show -g <AZURE RESOURCE GROUP NAME> -n <SYSTEM TOPIC NAME>

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

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

az eventgrid system-topic delete

az eventgrid system-topic delete -g <AZURE RESOURCE GROUP NAME> --name <SYSTEM TOPIC NAME>

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

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