orgOS_getAll.rst

orgOS_getAll

.. function:: GET /orgs/{oid}/distributions

Summary

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

Retrieves all the operating systems for an organization.

A list of :ref:`distribution-object` objects are returned. You can use a set of query parameters to retrieve a subset of these operating systems:

• name: filter by operating system name, for example CentOS
• version: filter by operating system version, for example 7.0
• arch: filter by operating system architecture, for example x86

Security Summary

• Requires Authentication: true
• Entitlements Required: appliance_create

URI Parameters

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

HTTP Request Body Parameters

None

Example Request

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

.. seealso::

         * :ref:`distribution-object`
         * :ref:`license-object`
         * :ref:`org-object`
         * :ref:`orgCompany-getAll`
         * :ref:`orgMember-getAll`
         * :ref:`orgMember-remove`
         * :ref:`orgMember-update`
         * :ref:`orgOSWindows-add`
         * :ref:`orgOSWindows-delete`
         * :ref:`orgOSWindows-getAll`
         * :ref:`orgOS-add`
         * :ref:`orgOS-update`
         * :ref:`org-create`
         * :ref:`org-get`
         * :ref:`org-getAll`
         * :ref:`user-object`