Delete Queue
Important
This API is obsolete and retired as of 11/1/2021 and should no longer be used.
Deletes an existing queue. This operation removes all associated state, including messages in the queue.
Request
Method | Request URI | HTTP version |
---|---|---|
DELETE | https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path} | HTTP/1.1 |
Request Headers
The following table describes required and optional request headers.
Request Header | Description |
---|---|
Namespace | Management Endpoint url |
x-ms-version | 2012-03-01 |
Note that the request also requires a client certificate. This certificate must match the certificate you uploaded for that particular subscription.
Request Body
None.
Response
The response includes an HTTP status code and a set of response headers.
Response Codes
Note
If you create a queue with a name that contains special or encoded characters (for example, test?Name=value&
, which gets encoded to test%3FName%3Dvalue%26
), a (401) Unauthorized exception is generated.
Code | Description |
---|---|
200 | Queue deleted successfully. It doesn't mean that the queue is completely deleted upon the return of the API call. This code means that it's marked for deletion. |
401 | Authorization failure. |
404 | The specified queue doesn't exist. |
500 | Internal error. |
For information about status codes, see Status and Error Codes.
Response Headers
None.
Response Body
None.