你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 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
使用 az extension add -n eventgrid 安装 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 事件网格支持的系统主题和主题类型。

通过