catalog.apps¶
Retrieve apps details for label catalog.
options.cache is a boolean which when set will try to get apps details for label catalog from cache if available.
options.cache_only is a boolean which when set will force usage of cache only for retrieving catalog information. If the content for the catalog in question is not cached, no content would be returned. If options.cache is unset, this attribute has no effect.
options.retrieve_all_trains is a boolean value which when set will retrieve information for all the trains present in the catalog ( it is set by default ).
options.trains is a list of train name(s) which will allow selective filtering to retrieve only information of desired trains in a catalog. If options.retrieve_all_trains is set, it has precedence over options.train.
No Additional Items
Tuple Validation
Parameter 1: catalog_apps_options
catalog_apps_options
Type: objectCatalogAppsArgs parameters.
No Additional PropertiesCache
Type: boolean Default: trueWhether to use cached catalog data if available.
Cache Only
Type: boolean Default: falseWhether to only return cached data without fetching updates.
Retrieve All Trains
Type: boolean Default: trueWhether to retrieve apps from all available trains.
Trains
Type: array of stringSpecific train names to retrieve apps from (empty array means all trains).
No Additional ItemsEach item of this array must be:
Must be at least 1
characters long
Result
Type: objectObject mapping train names to their app information.
Each additional property must conform to the following schema
CatalogTrainInfo
Type: objectEach additional property must conform to the following schema
CatalogAppInfo
Type: objectApp Readme
HTML content of the app README.
Categories
Type: array of stringList of categories for the app.
No Additional ItemsEach item of this array must be:
Description
Type: stringShort description of the app.
Healthy
Type: booleanHealth status of the app.
Healthy Error
Default: nullError if app is not healthy.
Home
Type: stringHomepage URL of the app.
Location
Type: stringLocal path to the app's location.
Latest Version
Latest available app version.
Latest App Version
Latest available app version in repository.
Latest Human Version
Human-readable version of the app.
Last Update
Timestamp of the last update in ISO format.
Name
Type: stringName of the app.
Recommended
Type: booleanIndicates if the app is recommended.
Title
Type: stringTitle of the app.
Maintainers
Type: array of objectList of app maintainers.
No Additional ItemsEach item of this array must be:
Maintainer
Type: objectNo Additional Properties
Name
Type: stringName of the app maintainer.
Email address of the app maintainer.
Url
Website URL of the app maintainer or null
.
Tags
Type: array of stringTags associated with the app.
No Additional ItemsEach item of this array must be:
Screenshots
Type: array of stringList of screenshot URLs.
No Additional ItemsEach item of this array must be:
Sources
Type: array of stringList of source URLs.
No Additional ItemsEach item of this array must be:
Icon Url
Default: nullURL of the app icon.
Additional Properties of any type are allowed.
Type: objectRequired roles: CATALOG_READ