Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.