快速入门:使用 Azure CLI 创建事件中心

在本快速入门中,请使用 Azure CLI 创建事件中心。

如果没有 Azure 订阅,可在开始前创建一个试用帐户

先决条件

可以使用本地 Azure CLI。

  • 如果需要,请安装 Azure CLI 来运行 CLI 参考命令。

  • 本地 Azure CLI,请了解如何安装 Azure CLI。 如果在 Windows 或 macOS 上运行,请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息,请参阅如何在 Docker 容器中运行 Azure CLI

    • 通过使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程,请遵循终端中显示的步骤。 有关其他登录选项,请参阅使用 Azure CLI 登录

    • 出现提示时,请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息,请参阅使用 Azure CLI 的扩展

    • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本,请运行 az upgrade

  • 本文需要 Azure CLI 版本 2.0.4 或更高版本。

创建资源组

运行以下命令来创建资源组。 资源组是 Azure 资源的逻辑集合。 所有资源在资源组中进行部署和管理。

选择“复制”,复制命令并将其粘贴到本地 Shell 或 CLI 窗口中,然后运行。 如果需要,请更新资源组名称和区域。

rgName="contosorg$RANDOM"
region="chinaeast"
az group create --name $rgName --location $region

系统将显示类似于下面的输出。 name 字段中会显示资源组名称,并使用一个随机数字替换 $RANDOM

{
  "id": "/subscriptions/{subscription_id}/resourceGroups/contosorg32744",
  "location": "chinaeast",
  "managedBy": null,
  "name": "contosorg32744",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

创建事件中心命名空间

请运行以下命令,创建事件中心命名空间: 事件中心命名空间提供唯一的范围容器,可以通过其完全限定的域名进行引用,而在该容器中,可以创建一个或多个事件中心。 如果需要,请更新命名空间的名称。

# Create an Event Hubs namespace. Specify a name for the Event Hubs namespace.
namespaceName="contosoehubns$RANDOM"
az eventhubs namespace create --name $namespaceName --resource-group $rgName -l $region

系统将显示类似于下面的输出。 name 字段中会显示命名空间的名称。

{
  "createdAt": "2023-03-13T20:28:53.037Z",
  "disableLocalAuth": false,
  "id": "/subscriptions/{subscription_id}0/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861",
  "isAutoInflateEnabled": false,
  "kafkaEnabled": true,
  "location": "China East",
  "maximumThroughputUnits": 0,
  "metricId": "{subscription_id}0:contosoehubns17861",
  "minimumTlsVersion": "1.2",
  "name": "contosoehubns17861",
  "provisioningState": "Succeeded",
  "publicNetworkAccess": "Enabled",
  "resourceGroup": "contosorg32744",
  "serviceBusEndpoint": "https://contosoehubns17861.servicebus.chinacloudapi.cn:443/",
  "sku": {
    "capacity": 1,
    "name": "Standard",
    "tier": "Standard"
  },
  "status": "Active",
  "tags": {},
  "type": "Microsoft.EventHub/Namespaces",
  "updatedAt": "2023-03-13T20:29:45.637Z",
  "zoneRedundant": false
}

创建事件中心

请运行以下命令,创建事件中心。 如果需要,请更新事件中心的名称。

# Create an event hub. Specify a name for the event hub. 
eventhubName="contosoehub$RANDOM"
az eventhubs eventhub create --name $eventhubName --resource-group $rgName --namespace-name $namespaceName

系统将显示类似于下面的输出。 name 字段中会显示事件中心的名称。

{
  "captureDescription": null,
  "createdAt": "2023-03-13T20:32:04.457000+00:00",
  "id": "/subscriptions/000000000-0000-0000-0000-00000000000000/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861/eventhubs/contosoehub23255",
  "location": "chinaeast",
  "messageRetentionInDays": 7,
  "name": "contosoehub23255",
  "partitionCount": 4,
  "partitionIds": [
    "0",
    "1",
    "2",
    "3"
  ],
  "resourceGroup": "contosorg32744",
  "status": "Active",
  "systemData": null,
  "type": "Microsoft.EventHub/namespaces/eventhubs",
  "updatedAt": "2023-03-13T20:32:04.727000+00:00"
}

祝贺你! 现已使用 Azure CLI 创建了一个事件中心命名空间,并在该命名空间中创建了一个事件中心。

清理资源

如果要保留此事件中心以便测试发送和接收事件,请忽略此部分。 否则,请运行以下命令,删除资源组。 此命令可删除资源组中的所有资源以及资源组本身。

az group delete --name $rgName

后续步骤

在本文中,你已创建一个资源组、一个事件中心命名空间和一个事件中心。 有关如何将事件发送到事件中心(或)从事件中心接收事件的分步说明,请参阅“发送和接收事件”教程: