クイックスタート: Azure CLI を使用したイベントハブの作成

[アーティクル]
03/17/2023

このクイックスタートでは、Azure CLI を使用してイベントハブを作成します。

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。

前提条件

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
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 Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。

リソースグループを作成する

次のコマンドを実行して、リソースグループを作成します。リソースグループは、Azure リソースの論理的なコレクションです。すべてのリソースのデプロイと管理はリソースグループで行われます。

[コピー] を選択してコマンドをコピーし、Cloud Shell または CLI ウィンドウに貼り付けて実行します。必要にじて、リソースグループ名とリージョンを更新します。

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

次のような出力が表示されます。 name フィールドにリソースグループ名が表示され、$RANDOM が乱数で置き換えられています。

{
  "id": "/subscriptions/0000000000-0000-0000-0000-000000000000000/resourceGroups/contosorg32744",
  "location": "eastus",
  "managedBy": null,
  "name": "contosorg32744",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Event Hubs 名前空間を作成します

次のコマンドを実行して、Event Hubs 名前空間を作成します。 Event Hubs 名前空間は一意のスコープコンテナーを提供します。このコンテナーは、1 つ以上のイベントハブを作成する完全修飾ドメイン名によって参照されます。必要にじて、名前空間の名前を更新します。

# 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/0000000000-0000-0000-0000-0000000000000000/resourceGroups/contosorg32744/providers/Microsoft.EventHub/namespaces/contosoehubns17861",
  "isAutoInflateEnabled": false,
  "kafkaEnabled": true,
  "location": "East US",
  "maximumThroughputUnits": 0,
  "metricId": "0000000000-0000-0000-0000-0000000000000000:contosoehubns17861",
  "minimumTlsVersion": "1.2",
  "name": "contosoehubns17861",
  "provisioningState": "Succeeded",
  "publicNetworkAccess": "Enabled",
  "resourceGroup": "contosorg32744",
  "serviceBusEndpoint": "https://contosoehubns17861.servicebus.windows.net: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": "eastus",
  "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 を使用して Event Hubs 名前空間を作成し、その名前空間内にイベントハブを作成しました。

リソースをクリーンアップする

イベントの送受信をテストできるようにこのイベントハブを保持する場合は、このセクションを無視してください。そうでない場合は、次のコマンドを実行して、リソースグループを削除します。このコマンドは、リソースグループ内のすべてのリソースと、リソースグループ自体を削除します。

az group delete --name $rgName

次のステップ

この記事では、リソースグループ、Event Hubs 名前空間、イベントハブを作成しました。イベントハブとの間でイベントを送信または受信するためのステップバイステップの手順については、以下のイベントの送受信のチュートリアルを参照してください。

クイック スタート: Azure CLI を使用したイベント ハブの作成