次の方法で共有

バッチ イベントを送信する

新しいバッチ処理されたメッセージ イベントをイベント ハブに送信します。 バッチ処理では、複数のメッセージからの情報を 1 つのメッセージのバッチにマージすることで、送信されるメッセージの数を減らします。 これにより、確立された接続の数が減り、ネットワーク経由で送信されるパケット ヘッダーの数が減ることでネットワーク帯域幅が減少します。

メッセージのバッチの送信は、単一のイベントをイベント ハブに送信するのとそれほど変わるわけではありません。 REST API を使用してイベント ハブへのバッチ イベントの送信を有効にするには、次の要件を満たす必要があります。

  1. バッチ処理されたメッセージを作成するロジックを実装します。

  2. メッセージ本文は有効な JSON ペイロードであり、規則に従って各メッセージを記述する必要があります。

  3. Content-Type ヘッダーを application/vnd.microsoft.servicebus.json に設定します。

Request

Method 要求 URI
POST https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/messages

要求ヘッダー

Event Hubs に関連するすべての要求で使用されるヘッダーとパラメーターについては、「 共通 のパラメーターとヘッダー」を参照してください。

追加の要求ヘッダー

要求ヘッダー 必須または省略可能 Description
Content-Type 必須 application/vnd.microsoft.servicebus.json を設定します。

要求本文

複数のメッセージの内容を含む JSON ペイロード。 次に例を示します。

[{"Body":"Message1"},{"Body":"Message2"},{"Body":"Message3"}]

UserProperties バッチ イベントを送信するときにヘッダーに設定することはできません (これらは無視されます)。 代わりに、要求本文の一部として送信します。 たとえば、バッチ 処理されたイベントでの の設定 UserProperties は次のとおりです。

[{"Body":"Message1", "UserProperties":{"Alert":"Strong Wind"}}, {"Body":"Message2"}, {"Body":"Message3"}]

[応答]

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

応答コード

コード 説明
201 正常終了しました。
401 認証エラー。
500 内部エラーです。

応答本文

要求が成功した場合、応答本文は空です。 要求が成功しない場合、本文にはエラー コードとエラー メッセージが含まれます。

使用例

Request

注意

また、「共通パラメーターとヘッダー」で説明されているように、Authorization ヘッダーに Azure Active Directory トークンを使用することもできます。 たとえば、Authorization: Bearer <Azure AD token> のように指定します。

POST https://your-namespace.servicebus.windows.net/your-event-hub/messages?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=your-sas-key&se=1456197782&skn=RootManageSharedAccessKey  
Content-Type: application/vnd.microsoft.servicebus.json  
Host: your-namespace.servicebus.windows.net  
  
[{"Body":"Message1", "UserProperties":{"Alert":"Strong Wind"}},{"Body":"Message2"},{"Body":"Message3"}]

Response

HTTP/1.1 201 Created  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 23 Feb 2016 03:22:27 GMT  
Content-Length: 0
  • Last updated on