名前空間トピックのサブスクリプションの配信プロパティ

イベント サブスクリプションを使用すると、配信されたイベントに含める HTTP ヘッダーを設定できます。 この機能を使用すると、宛先に必要なカスタム ヘッダーを設定できます。 イベント サブスクリプションを作成するときに、最大 10 個のヘッダーを設定できます。 各ヘッダー値は、4,096 (4K) バイトを超えてはなりません。

次の宛先に配信されるイベントにカスタム ヘッダーを設定できます: Azure Event Hubs。

Azure portal でイベント サブスクリプションを作成する場合は、[ 配信プロパティ ] タブを使用してカスタム HTTP ヘッダーを設定できます。 このページでは、固定ヘッダー値と動的ヘッダー値を設定できます。

静的ヘッダー値の設定

固定値でヘッダーを設定するには、対応するフィールドにヘッダーの名前とその値を指定します。

機密データを提供する場合には、シークレットかどうかをご確認いただくことをお勧めします。 Azure portal での機密データの可視性は、ユーザーのロールベースのアクセス制御 (RBAC) アクセス許可によって異なります。

動的ヘッダー値の設定

受信イベントのプロパティに基づいてヘッダーの値を設定できます。 JsonPath 構文を使用して、送信要求のヘッダーの値として使用される受信イベントのプロパティ値を参照します。 文字列、数値、およびブール値の JSON 値のみがサポートされています。 たとえば、イベント データの受信イベント プロパティ システムの値を使用してチャネルという名前のヘッダーの値を設定するには、次のようにイベント サブスクリプションを構成します。

例示

このセクションでは、配信プロパティを使用する例をいくつか示します。

Event Hubs の例

イベント ハブ内の特定のパーティションにイベントを発行する必要がある場合は、イベント サブスクリプションの PartitionKey プロパティを設定して、ターゲット イベント ハブパーティションを識別するパーティション キーを指定します。

イベント ハブにメッセージを送信するときにカスタム プロパティを指定することもできます。 メッセージ ヘッダーのシステム プロパティで使用されるため、プロパティ名には aeg- プレフィックスを使用しないでください。 メッセージ ヘッダーのプロパティの一覧については、 イベント ハンドラーとしての Event Hubs に関するページを参照してください。

次のステップ

イベント配信の詳細については、次の記事を参照してください。

• イベントのフィルター処理