快速入门:使用 Azure CLI 创建事件中心
在本快速入门中,请使用 Azure CLI 创建事件中心。
如果没有 Azure 试用版订阅,请在开始前创建 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
后续步骤
在本文中,你已创建一个资源组、一个事件中心命名空间和一个事件中心。 有关如何将事件发送到事件中心(或)从事件中心接收事件的分步说明,请参阅“发送和接收事件”教程: