Channel Software Methods

Channel software methods are available in the channel.software namespace. The following methods can by used to query the packages that are available to a session from a channel on ULN.

channel.software.getDetails

The getDetails method returns the details of the given channel.

  • Input Parameters
    string sessionKey

    The session key for the session. For example: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc

    string channelLabel

    The channel label for the channel that you wish to query. For example: ol7_x86_64_latest

  • Return Parameters
    string channel_arch_name

    The channel architecture name. For example: x86_64

    string channel_description

    The channel description. For example: All packages released for Oracle Linux 7 (x86_64) including the latest errata packages. (x86_64)

    string channel_summary

    The channel summary, usually the same as the channel name. For example: Oracle Linux 7 Latest (x86_64)

    struct metadata_urls

    A dictionary or associative array of metadata locations and checksum information, including the URLs to download channel metadata.

    struct filelists
    string checksum_type

    The hashing algorithm used to generate the checksum. For example: sha

    string checksum

    The checksum for the filelists metadata file. For example: abc4ef3d6e6b2bc3246e56ee4756ed5c245b60b0

    string file_name

    The file name for the filelists metadata at the channel location. For example: repodata/filelists.xml.gz

    string url

    The URL where the filelists metadata can be accessed.

    To access the URL, include the X-ULN-Api-User-Key header with the value of the session key that was returned when you authenticated. For example: 
    curl -H "X-ULN-Api-User-Key: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc" \
https://uln.oracle.com/XMLRPC/GET-REQ/ol7_x86_64_latest/repodata/filelists.xml.gz
    struct group

    This structure is returned optionally if this information is available.

    string checksum_type

    The hashing algorithm used to generate the checksum. For example: sha

    string checksum

    The checksum for the group metadata file. For example: 90acbe6860bbcd4e40ee71cec9d2397dceccbca6

    string file_name

    The file name for the group metadata at the channel location. For example: repodata/comps.xml

    string url

    The URL where the group metadata can be accessed.

    To access the URL, include the X-ULN-Api-User-Key header with the value of the session key that was returned when you authenticated. For example: 
    curl -H "X-ULN-Api-User-Key: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc" \
https://uln.oracle.com/XMLRPC/GET-REQ/ol7_x86_64_latest/repodata/comps.xml
    struct other
    string checksum_type

    The hashing algorithm used to generate the checksum. For example: sha

    string checksum

    The checksum for the other metadata file. For example: 20f6b193cd9376d650cf96c8c01995cf7f02163a

    string file_name

    The file name for the other metadata at the channel location. For example: repodata/other.xml.gz

    string url

    The URL where the other metadata can be accessed.

    To access the URL, include the X-ULN-Api-User-Key header with the value of the session key that was returned when you authenticated. For example:
    curl -H "X-ULN-Api-User-Key: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc" \
https://uln.oracle.com/XMLRPC/GET-REQ/ol7_x86_64_latest/repodata/other.xml.gz
    struct primary
    string checksum_type

    The hashing algorithm used to generate the checksum. For example: sha

    string checksum

    The checksum for the primary metadata file. For example: 3992e1e77d476d09eb1dcb16fd106263aaa84bb4

    string file_name

    The file name for the primary metadata at the channel location. For example: repodata/primary.xml.gz

    string url

    The URL where the primary metadata can be accessed.

    To access the URL, include the X-ULN-Api-User-Key header with the value of the session key that was returned when you authenticated. For example:
    curl -H "X-ULN-Api-User-Key: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc" \
https://uln.oracle.com/XMLRPC/GET-REQ/ol7_x86_64_latest/repodata/primary.xml.gz
    struct repomd
    string file_name

    The file name for the repomd metadata at the channel location. For example: repodata/repomd.xml

    string url

    The URL where the repomd metadata can be accessed.

    To access the URL, include the X-ULN-Api-User-Key header with the value of the session key that was returned when you authenticated. For example:
    curl -H "X-ULN-Api-User-Key: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc" \
https://uln.oracle.com/XMLRPC/GET-REQ/ol7_x86_64_latest/repodata/repomd.xml
    struct updateinfo

    This structure is returned optionally if this information is available.

    string checksum_type

    The hashing algorithm used to generate the checksum. For example: sha

    string checksum

    The checksum for the updateinfo metadata file. For example: 6d11ecbceb58515be79a2adff9ff911f8a839069

    string file_name

    The file name for the updateinfo metadata at the channel location. For example: repodata/updateinfo.xml.gz

    string url

    The URL where the updateinfo metadata can be accessed.

    To access the URL, include the X-ULN-Api-User-Key header with the value of the session key that was returned when you authenticated. For example:
    curl -H "X-ULN-Api-User-Key: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc" \
https://uln.oracle.com/XMLRPC/GET-REQ/ol7_x86_64_latest/repodata/updateinfo.xml.gz

channel.software.listAllPackages

The listAllPackages method returns a list of all packages that are available from a channel, including packages that are not the latest.

  • Input Parameters
    string sessionKey

    The session key for the session. For example: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc.

    string channelLabel

    The channel label for the channel that you wish to query.

  • Return Parameters
    array

    An array of all packages:

    struct (package)

    A structure containing the following strings:

    string package_arch_label

    The package architecture label. For example: noarch

    string package_epoch

    The package epoch value, if specified. The epoch value can help RPM determine package version ordering if the versioning does not make sense or does not follow sequentially. For example: 1

    string package_id

    The package ID within the ULN infrastructure. For example: 11776733

    string package_last_modified

    The date and timestamp for when a package was last modified. For example: 2018-09-27 19:31:13

    string package_name

    The name of the package. For example: selinux-policy-mls

    string package_release

    The package release information. For example: 192.0.6.el7_5.6

    string package_version

    The package version number. For example: 3.13.1

channel.software.listErrata

The listErrata method returns a list of all errata that are associated with a channel.

  • Input Parameters
    string sessionKey

    The session key for the session. For example: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc.

    string channelLabel

    The channel label for the channel that you wish to query. For example: ol7_x86_64_latest

  • Return Parameters
    array

    An array of all errata associated with the channel label:

    struct (errata)

    A structure containing the following strings:

    string errata_advisory_type

    The errata advisory type. For example: Bug Fix Advisory

    string errata_advisory

    The errata advisory label. For example: ELBA-2018-4255

    string errata_issue_date

    The date the errata was issued. For example: 2018-10-17 00:00:00

    string errata_last_modified_date

    The date the errata was last modified. For example: 2018-10-17 00:00:00

    string errata_synopsis

    A brief synopsis of the errata. For example: glibc bug fix update

    string errata_update_date

    The errata update date. For example: 2018-10-17 00:00:00

channel.software.listLatestPackages

The listLatestPackages method returns a list of the latest packages that are available from a channel.

  • Input Parameters
    string sessionKey

    The session key for the session. For example: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc.

    string channelLabel

    The channel label for the channel that you wish to query. For example: ol7_x86_64_latest

  • Return Parameters
    array

    An array of latest packages:

    struct (package)

    A structure containing the following strings:

    string package_arch_label

    The package architecture label. For example: noarch

    string package_epoch

    The package epoch value, if specified. The epoch value can help RPM determine package version ordering if the versioning does not make sense or does not follow sequentially. For example: 1

    string package_id

    The package ID within the ULN infrastructure. For example: 11776733

    string package_name

    The name of the package. For example: selinux-policy-mls

    string package_release

    The package release information. For example: 192.0.6.el7_5.6

    string package_version

    The package version number. For example: 3.13.1