通过

使用 Azure CLI 创建、查看和管理事件网格系统主题

  • 项目

本文说明如何使用 Azure CLI 创建和管理系统主题。 有关系统主题的概述，请参阅系统主题。

安装适用于 Azure CLI 的扩展

对于 Azure CLI，需要事件网格扩展。

对于本地安装：

  1. 安装 Azure CLI。 请通过使用 az --version 进行检查来确保安装了最新版本。
  2. 卸载旧版扩展：az extension remove -n eventgrid
  3. 使用 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

    有关分步说明的教程，请参阅订阅存储帐户。

查看所有系统主题

若要查看所有系统主题以及所选系统主题的详细信息，请使用以下命令：

删除系统主题

若要删除系统主题，请使用以下命令：

后续步骤

请参阅 Azure 事件网格中的系统主题部分，详细了解 Azure 事件网格支持的系统主题和主题类型。