os_get.rst

os_get

.. function:: GET /distributions/{id}

Summary

• Method: GET
• Response Code: 200 / 304
• Response Formats: application/xml application/json
• Since: UForge 1.0

Retrieves the meta-data of an operating system.

Security Summary

• Requires Authentication: true
• Entitlements Required: appliance_create

URI Parameters

• id (required): the id of the :ref:`distribution-object`

HTTP Request Body Parameters

None

Example Request

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

.. seealso::

         * :ref:`distribution-object`
         * :ref:`osAccess-update`
         * :ref:`osLicense-download`
         * :ref:`osLogo-download`
         * :ref:`osLogo-downloadFile`
         * :ref:`osPkgUpdates-getAll`
         * :ref:`osPkg-get`
         * :ref:`osPkg-getAll`
         * :ref:`os-create`
         * :ref:`os-getAll`
         * :ref:`os-update`