Software Repository Objects#

Software Repository objects (repos) are used to collect information about an upstream or local repository for software packages.

When issuing requests, the UID field in the URL can be either the actual UID of the object or the name of the object as given in the "name" field.

Data Fields#

Admin objects have several fields:

name
     Required: The name of the user on the underlying system

description
     Optional: A text string with descriptive information

full_name
     Optional: A text string for identifying the repos

urls
     Optional: A list of URLs for the repos

mirrors
     Optional: A list of mirror URLs for the repos

disable
     Optional: A list of True/False flags for the URLs

keys
     Optional: A list of keys for the URLs

check
     Optional

rhel_entitlement
     Optional: RedHat license entitlement key

Additional Endpoints#

For locally hosted repos, several endpoints can be used to investigate the ISO:

GET /repo/<UID>/iso
     Downloads the ISO image for this repo.  Note that the output format is different
     from other ClusterWare commands – there are no “success” or “data” keys, just the
     binary data of the ISO file being requested

PUT /repo/<UID>/iso
     Uploads an ISO for this repo

DELETE /repo/<UID>/iso
     Deletes the ISO for this repo; note that the repo's object itself will remain,
     just the ISO will be deleted

GET /repo/<UID>/iso/stat
     Returns basic statistics about the ISO file