SALES: 1-800-867-1380

Delete Message from Subscription

Updated: May 8, 2012

This operation is used to complete processing on a locked message and delete it from the subscription. This operation should only be called after processing a previously locked message is successful to maintain At-Least-Once delivery assurances.

 

Method Request URI HTTP Version

DELETE

http{s}://{serviceNamespace}.servicebus.Windows.net/{topic path}/Subscriptions/{subscription Name}/messages/{message-id}/{lock-id}

HTTP/1.1

URI Parameters

The URI is provided in the Location header of the peeked message, or you can construct it from the parts described in the following table.

 

Parameter Description

sequence-number

The sequence number of the message to be unlocked as returned in BrokerProperties{SequenceNumber} by the Peek Message operation.

Lock-id

The ID of the lock as returned by the Peek Message operation in BrokerProperties{LockToken}.

Request Headers

The following table describes required and optional request headers.

 

Request Header Description

Authorization

Specifies a WRAPv0.9.7.2 token containing a SimpleWebToken acquired from ACS. Set to WRAP access_token=”{swt}”.

Request Body

None.

Response Codes

 

Code Description

200

Message successfully deleted.

401

Authorization failure.

404

No message was found with the specified lock ID.

410

Specified subscription does not exist.

500

Internal error.

For information about status codes, see Status and Error Codes.

Response Headers

None.

Response Body

None.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft