deployment_getAll.rst

deployment_getAll

.. function:: GET /users/{uid}/deployments

Summary

• Method: GET
• Response Code: 200 / 304
• Response Formats: application/xml application/json
• Since: UForge 3.7.fp6

Returns a list of the deployments for a specific user.

A deployment is the instantiation of a :ref:`deployment-object`.

Currently a deployment is a single instance of a software stack. To deploy a published machine image, refer to :ref:`machineImagePublished-deploy`.

A list of :ref:`deployment-object` objects are returned.

Security Summary

• Requires Authentication: true
• Entitlements Required: deployments_access

URI Parameters

• uid (required): the user name (login name) of the :ref:`user-object`

HTTP Request Body Parameters

None

Example Request

curl "https://uforge.example.com/api/users/{uid}/deployments" -X GET \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml"

.. seealso::

         * :ref:`deployment-object`
         * :ref:`deployment-get`
         * :ref:`deployment-getDeployStatus`
         * :ref:`deployment-terminate`
         * :ref:`machineImagePublished-deploy`
         * :ref:`user-object`