メッセージを受信して削除する (破壊読み取り)
この操作はキューまたはサブスクリプションからメッセージを受信し、1 つのアトミック操作内でそのキューまたはサブスクリプションからメッセージを削除します。
Request
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| DELETE | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/headまたは http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。 ヘッダーには、記載されているプロパティに加えて、カスタム プロパティが含まれる場合があります。 例を参照してください。
| 要求ヘッダー | 説明 |
|---|---|
| 承認 | 次のいずれかのトークン値を指定します。
|
要求本文
なし。
[応答]
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
応答コード
| コード | 説明 |
|---|---|
| 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