メッセージバッチの送信

メッセージのバッチを Service Bus キューまたはトピックに送信します。

依頼

方式	要求 URI	HTTP バージョン
投稿	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

要求ヘッダー

次の表では、必須の要求ヘッダーと省略可能な要求ヘッダーについて説明します。一覧表示されているプロパティに加えて、ヘッダーにはカスタムプロパティを含めることができます。例を参照してください。

要求ヘッダー	形容
認可	次のいずれかのトークン値を指定します。 Microsoft Entra JSON Web トークン (JWT) トークン。例: `Authorization: Bearer <Azure AD JWT token>`. Microsoft Entra トークンの生成の詳細については、「アプリケーションからの認証」を参照してください。 SAS トークン。例: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. SAS トークンの生成の詳細については、「Shared Access Signature トークンの生成」および「SAS トークンの生成」を参照してください。
Content-Type	アプリケーション/vnd.microsoft.servicebus.jsonに設定します。
x-ms-retrypolicy	(省略可能)一時的なエラーが発生した場合に送信操作の自動再試行を無効にするには、`NoRetry` に設定します。

要求本文

要求本文には、JSON でエンコードされたメッセージバッチが含まれています。

応答

応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。

応答コード

コード	形容
201	メッセージがキューまたはトピックに正常に送信されました。
400	要求が正しくありません。
401	承認エラー。
403	クォータを超えたか、メッセージが大きすぎます。
410	指定されたキューまたはトピックが存在しません。
500	内部エラー。

状態コードの詳細については、「状態コードとエラーコードの」を参照してください。

応答ヘッダー

Content-type 渡されます。

応答本文

何一つ。

例

次の HTTP 要求は、3 つのメッセージのバッチをキューまたはトピックに送信します。最初のメッセージの TimeToLiveTimeSpan 値は 40 秒で、2 番目のメッセージにはカスタムメッセージプロパティ "Priority" があり、3 番目のメッセージにはカスタムメッセージプロパティ "Priority" と "Customer" があります。

POST https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Content-Type: application/vnd.microsoft.servicebus.json  
Host: your-namespace.servicebus.windows.net  
Content-Length: 18  
Expect: 100-continue  
  
[  
  {  
    "Body":”This is the first message",  
    "BrokerProperties":{"Label":"M1","TimeToLiveTimeSpan":"0.00:00:40"}  
  },  
  {  
    "Body":”This is the second message",  
    "BrokerProperties":{"Label":"M2"},  
    "UserProperties":{"Priority":"Low"}  
  },  
  {  
    "Body":”This is the third message",  
    "BrokerProperties":{"Label":"M3"},  
    "UserProperties":{"Priority":"Medium","Customer":"ABC"}  
  }  
]

Service Bus は、次の応答を返します。

HTTP/1.1 201 Created  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:22 GMT  
  
0

次の方法で共有

メッセージ バッチの送信

依頼