Azure CLI を使用したカスタム トピックのイベントのサブスクライブSubscribe to events for a custom topic with Azure CLI

このスクリプトは、カスタム トピックのイベントに対する Event Grid サブスクリプションを作成します。This script creates an Event Grid subscription to the events for a custom topic.

このサンプルを実行するには、最新バージョンの Azure CLI をインストールします。To run this sample, install the latest version of the Azure CLI. 開始するには、az login を実行して、Azure との接続を作成します。To start, run az login to create a connection with Azure.

Azure CLI のサンプルは、bash シェル用に記述されています。Samples for the Azure CLI are written for the bash shell. このサンプルを Windows PowerShell またはコマンド プロンプトで実行するには、スクリプトの要素を変更する必要があります。To run this sample in Windows PowerShell or Command Prompt, you may need to change elements of the script.

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。If you don't have an Azure subscription, create a free account before you begin.

プレビュー版サンプル スクリプトには、Event Grid 拡張機能が必要です。The preview sample script requires the Event Grid extension. インストールするには、az extension add --name eventgrid を実行します。To install, run az extension add --name eventgrid.

サンプル スクリプト - 安定版Sample script - stable

#!/bin/bash

# Provide the name of the topic you are subscribing to
myTopic=demoContosoTopic

# Provide the name of the resource group containing the custom topic
resourceGroup=demoResourceGroup

# Provide an endpoint for handling the events.
myEndpoint="<endpoint URL>"

# Select the Azure subscription that contains the custom topic.
az account set --subscription "<name or ID of the subscription>"

# Subscribe to the custom event. Include the resource group that contains the custom topic.
az eventgrid event-subscription create \
  --resource-group $resourceGroup \
  --topic-name $myTopic  \
  --name demoSubscription \
  --endpoint $myEndpoint

サンプル スクリプト - プレビュー版拡張機能Sample script - preview extension

#!/bin/bash

# You must have the latest version of the Event Grid preview extension.
# If you have not installed previously:
# az extension add -n eventgrid
# If you have installed previously:
# az extension update -n eventgrid

# Provide the name of the topic you are subscribing to
myTopic=demoContosoTopic

# Provide the name of the resource group containing the custom topic
resourceGroup=demoResourceGroup

# Provide an endpoint for handling the events.
myEndpoint="<endpoint URL>"

# Select the Azure subscription that contains the custom topic.
az account set --subscription "<name or ID of the subscription>"

# Get the resource ID of the custom topic
topicID=$(az eventgrid topic show --name $myTopic -g $resourceGroup --query id --output tsv)

# Subscribe to the custom event. Include the resource group that contains the custom topic.
az eventgrid event-subscription create \
  --source-resource-id $topicID \
  --name demoSubscription \
  --endpoint $myEndpoint

スクリプトの説明Script explanation

このスクリプトは、次のコマンドを使用してイベント サブスクリプションを作成します。This script uses the following command to create the event subscription. 表内の各コマンドは、それぞれのドキュメントにリンクされています。Each command in the table links to command-specific documentation.

コマンドCommand メモNotes
az eventgrid event-subscription createaz eventgrid event-subscription create Event Grid のサブスクリプションを作成する。Create an Event Grid subscription.
az eventgrid event-subscription create - 拡張機能のバージョンaz eventgrid event-subscription create - extension version Event Grid のサブスクリプションを作成する。Create an Event Grid subscription.

次の手順Next steps