この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

受信して、メッセージ (破壊読み取り) を削除します。

 

この操作はキューまたはサブスクリプションからメッセージを受信し、1 つのアトミック操作内でそのキューまたはサブスクリプションからメッセージを削除します。

メソッド

要求 URI

HTTP バージョン

Delete

http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head

or

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head

HTTP/1.1

次の表は、必須の要求ヘッダーおよび省略可能な要求ヘッダーを示します。 ヘッダーには、記載されているプロパティに加えて、カスタム プロパティが含まれる場合があります。 例を参照してください。

要求ヘッダー

description

認証

次のいずれかを指定します。

  • ACS から取得した SimpleWebToken を含む WRAPv0.9.7.2 トークンです。 設定 WRAP access_token ="{swt}"です。

  • SAS トークンです。

ありません。

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

Code

description

200

メッセージが正常に受信および削除されました。

204

指定されたタイムアウト期間内に使用可能なメッセージはありません。

400

正しくない要求です。

401

認証エラー。

410

指定されたキューまたはサブスクリプションが存在しません。

500

内部エラー。

状態コードについては、次を参照してください。 ステータス コードとエラー コードです。

この操作の応答には、次のヘッダーが含まれています。 追加の標準 HTTP ヘッダーが応答に含まれていることもあります。 すべての標準ヘッダーに準拠している、 http/1.1 プロトコル仕様です。

応答本文は、取得されたメッセージのメッセージ本文です。

次の HTTP 要求は、キューからメッセージを受信して削除します。

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1 Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey Host: your-namespace.servicebus.windows.net Content-Length: 0

Service Bus 次の応答を返します。 このメッセージにはカスタム プロパティ "Priority" および "Customer" が含まれます。

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/atom+xml;type=entry;charset=utf-8 Server: Microsoft-HTTPAPI/2.0 BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10} Priority: "High" Customer: "12345,ABC" Date: Tue, 01 Jul 2014 23:00:23 GMT 12 This is a message. 0
表示: