.. _DELETE Service ostor-users:

DELETE Service ostor-users
--------------------------

Description
~~~~~~~~~~~

Deletes the user specified by email or ID.

Requests
~~~~~~~~

Syntax
^^^^^^

::

    DELETE /?ostor-users&emailAddress=<value> HTTP/1.1
    Host: s3.amazonaws.com
    Date: <date>
    Authorization: <authorization_string>

Parameters
^^^^^^^^^^

+------------------+-------------------------------------------------------+----------+
| Parameter        | Description                                           | Required |
+==================+=======================================================+==========+
| ``emailAddress`` | User email address.                                   | Yes*     |
|                  |                                                       |          |
|                  | Type: string.                                         |          |
|                  |                                                       |          |
|                  | Default value: none.                                  |          |
+------------------+-------------------------------------------------------+----------+
| ``id``           | User ID.                                              | Yes*     |
|                  |                                                       |          |
|                  | Type: string.                                         |          |
|                  |                                                       |          |
|                  | Default value: none.                                  |          |
+------------------+-------------------------------------------------------+----------+

\* Only one of the required parameters can be set in a single request.

Headers
^^^^^^^

This implementation uses only common request headers.

Responses
~~~~~~~~~

Headers
^^^^^^^

This implementation uses only common response headers.

Body
^^^^

Empty.

Errors
^^^^^^

Returns ``Error Code 400`` if more than one required parameter is set.

.. note:: If a user is successfully deleted, ``Status204NoContent`` is returned.

Examples
~~~~~~~~

Sample Request
^^^^^^^^^^^^^^

Deletes the user with the email ``test@test.test``.

::

    DELETE /?ostor-users&emailAddress=test@test.test HTTP/1.1
    Host: s3.amazonaws.com
    Date: Wed, 30 Apr 2016 22:32:00 GMT 
    Authorization: <authorization_string>
 
Sample Response
^^^^^^^^^^^^^^^

::

    HTTP/1.1 203 No Content
    x-amz-req-time-micros : 172807
    Server : nginx/1.8.1
    Connection : closed
    x-amz-request-id : 80000000000000030005c8ca5862476a
    Date : Wed, 30 Apr 2016 22:32:03 GMT
    Content-type : application/xml