userFormats_update¶

PUT /users/{uid}/formats

Updates the list of machine image formats that an user has access to.

Please refer to imageFormat for a complete list of all the image format attributes.

Warning

Any image format that the user currently has access to that is not specified in the new target format list will be removed, this effectively de-activates those image formats for the user.

Security Summary¶

Requires Authentication: true
Entitlements Required: org_formats_administrate

URI Parameters¶

uid (required): the user name (login name) of the user

HTTP Request Body Parameters¶

A imageFormats object

Example Request¶

curl "https://uforge.example.com/api/users/{uid}/formats" -X PUT \
-u USER_LOGIN:PASSWORD -H "Accept: application/xml" --data-binary "@representation.xml"

Example of representation.xml content (the request body):

<ns0:imageFormats xmlns:ns0="http://www.usharesoft.com/uforge">
        <imageFormats>
                <imageFormat>
                        <access>true</access>
                        <active>true</active>
                        <uri>format/5</uri>
                </imageFormat>
                <imageFormat>
                        <access>true</access>
                        <active>true</active>
                        <uri>format/7</uri>
                </imageFormat>
        </imageFormats>
</ns0:imageFormats>