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

使用 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. 使用 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.TopicsMicrosoft.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 事件网格支持的系统主题和主题类型。