Channel Software Methods

`channel.software.getDetails`

The getDetails method returns the details of the given channel.

Input Parameters

Parameter	Description
`sessionKey`	The session key for the session.
`channelLabel`	The channel label for the channel that you want to query.

Return Parameters

Field	Description
`channel_arch_name`	The channel architecture name.
`channel_description`	The channel description.
`channel_summary`	The channel summary, usually the same as the channel name.
`metadata_urls`	A dictionary or associative array of metadata locations and checksum information, including the URLs to download channel metadata. `filelists` `checksum_type` The hashing algorithm used to generate the checksum. `checksum` The checksum for the filelists metadata file. `file_name` The file name for the filelists metadata at the channel location. `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. `group` `checksum_type` The hashing algorithm used to generate the checksum. `checksum` The checksum for the group metadata file. `file_name` The file name for the group metadata at the channel location. `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. `other` `checksum_type` The hashing algorithm used to generate the checksum. `checksum` The checksum for the other metadata file. `file_name` The file name for the other metadata at the channel location. `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. `primary` `checksum_type` The hashing algorithm used to generate the checksum. `checksum` The checksum for the primary metadata file. `file_name` The file name for the primary metadata at the channel location. `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. `repomd` `file_name` The file name for the repomd metadata at the channel location. `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. `updateinfo` `checksum_type` The hashing algorithm used to generate the checksum. `checksum` The checksum for the updateinfo metadata file. `file_name` The file name for the updateinfo metadata at the channel location. `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.

Example Input Parameters


sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest

Example Output Parameters


{
    "channel_description": "Base operating system packages released for Oracle Linux 9 (x86_64) including the latest errata packages. (x86_64)",
    "channel_summary": "Oracle Linux 9 BaseOS  Latest(x86_64)",
    "metadata_urls": {
        "group": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/ffd5c9f2031a5f21c846c98879751501c9a58f1a0143c6f3c6cddd097a31a4ec-comps.xml",
                "checksum": "ffd5c9f2031a5f21c846c98879751501c9a58f1a0143c6f3c6cddd097a31a4ec",
                "file_name": "repodata/ffd5c9f2031a5f21c846c98879751501c9a58f1a0143c6f3c6cddd097a31a4ec-comps.xml",
                "checksum_type": "sha256"
            }
        ],
        "filelists": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/82041c9af2eb2e5aa5c0ce2bbf61a1bc66cd5620bfa40df6f6c4b1af0979e4e8-filelists.xml.gz",
                "checksum": "82041c9af2eb2e5aa5c0ce2bbf61a1bc66cd5620bfa40df6f6c4b1af0979e4e8",
                "file_name": "repodata/82041c9af2eb2e5aa5c0ce2bbf61a1bc66cd5620bfa40df6f6c4b1af0979e4e8-filelists.xml.gz",
                "checksum_type": "sha256"
            }
        ],
        "updateinfo": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/8ad18b669d06050ce2ae33716a01f42b92aa93c97520b0323858c128848f151a-updateinfo.xml.gz",
                "checksum": "8ad18b669d06050ce2ae33716a01f42b92aa93c97520b0323858c128848f151a",
                "file_name": "repodata/8ad18b669d06050ce2ae33716a01f42b92aa93c97520b0323858c128848f151a-updateinfo.xml.gz",
                "checksum_type": "sha256"
            }
        ],
        "group_gz": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/0313b3e188b286e75d90c5146d6e168a039c38d64b0e5ee46fb5233769dfb173-comps.xml.gz",
                "checksum": "0313b3e188b286e75d90c5146d6e168a039c38d64b0e5ee46fb5233769dfb173",
                "file_name": "repodata/0313b3e188b286e75d90c5146d6e168a039c38d64b0e5ee46fb5233769dfb173-comps.xml.gz",
                "checksum_type": "sha256"
            }
        ],
        "primary": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/524c868192afe18efa772e0d6cada2c3b6db2d3e62046e6e99c4e4309a9da3ed-primary.xml.gz",
                "checksum": "524c868192afe18efa772e0d6cada2c3b6db2d3e62046e6e99c4e4309a9da3ed",
                "file_name": "repodata/524c868192afe18efa772e0d6cada2c3b6db2d3e62046e6e99c4e4309a9da3ed-primary.xml.gz",
                "checksum_type": "sha256"
            }
        ],
        "repomd": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/repomd.xml",
                "file_name": "repodata/repomd.xml"
            }
        ],
        "other": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/261714d8945401ce571cc4ecb5ad9083fefe642f5dc73634eddd4deea05b61dc-other.xml.gz",
                "checksum": "261714d8945401ce571cc4ecb5ad9083fefe642f5dc73634eddd4deea05b61dc",
                "file_name": "repodata/261714d8945401ce571cc4ecb5ad9083fefe642f5dc73634eddd4deea05b61dc-other.xml.gz",
                "checksum_type": "sha256"
            }
        ],
        "other_db": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/5866a956b11159666f8d695c7376d5f38123a6539ddb98be3510b85a92563f76-other.sqlite.bz2",
                "checksum": "5866a956b11159666f8d695c7376d5f38123a6539ddb98be3510b85a92563f76",
                "file_name": "repodata/5866a956b11159666f8d695c7376d5f38123a6539ddb98be3510b85a92563f76-other.sqlite.bz2",
                "checksum_type": "sha256"
            }
        ],
        "primary_db": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/9a2bf82b1cc00fd953fd0d17469607a7cc14c7c7c6de4a79ad1cdd67283f5e05-primary.sqlite.bz2",
                "checksum": "9a2bf82b1cc00fd953fd0d17469607a7cc14c7c7c6de4a79ad1cdd67283f5e05",
                "file_name": "repodata/9a2bf82b1cc00fd953fd0d17469607a7cc14c7c7c6de4a79ad1cdd67283f5e05-primary.sqlite.bz2",
                "checksum_type": "sha256"
            }
        ],
        "filelists_db": [
            {
                "url": "https://linux-update.oracle.com/XMLRPC/GET-REQ/ol9_x86_64_baseos_latest/repodata/5c54dce2baa12fa91cd92a9f1ff313d1822e54b14fd82f23482e805ca5f1a1eb-filelists.sqlite.bz2",
                "checksum": "5c54dce2baa12fa91cd92a9f1ff313d1822e54b14fd82f23482e805ca5f1a1eb",
                "file_name": "repodata/5c54dce2baa12fa91cd92a9f1ff313d1822e54b14fd82f23482e805ca5f1a1eb-filelists.sqlite.bz2",
                "checksum_type": "sha256"
            }
        ]
    },
    "channel_arch_name": "x86_64"
}

`channel.software.listAllPackages`

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

Input Parameters

Parameter	Description
`sessionKey`	The session key for the session. For example: `JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc`
`channelLabel`	The channel label for the channel that you want to query.

Return Parameters

Field Description

Field	Description
`array`	An array of all packages: `struct (package)` `package_arch_label` The package architecture label. For example: `noarch` `package_epoch` The package epoch value, if specified. The epoch value can help RPM decide package version ordering if the versioning doesn't make sense or doesn't follow sequentially. For example: `1` `package_id` The package ID within the ULN infrastructure. For example: `11776733` `package_last_modified` The date and timestamp for when a package was last modified. For example: `2018-09-27 19:31:13` `package_name` The name of the package. For example: `selinux-policy-mls` `package_release` The package release information. For example: `192.0.6.el7_5.6` `package_version` The package version number. For example: `3.13.1`

array

An array of all packages:

struct (package)

package_arch_label: The package architecture label. For example: noarch
package_epoch: The package epoch value, if specified. The epoch value can help RPM decide package version ordering if the versioning doesn't make sense or doesn't follow sequentially. For example: 1
package_id: The package ID within the ULN infrastructure. For example: 11776733
package_last_modified: The date and timestamp for when a package was last modified. For example: 2018-09-27 19:31:13
package_name: The name of the package. For example: selinux-policy-mls
package_release: The package release information. For example: 192.0.6.el7_5.6
package_version: The package version number. For example: 3.13.1

Example Input Parameters


sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest

Example Output Parameters


[
    {
        "package_arch_label": "x86_64",
        "package_name": "openssl",
        "package_epoch": "1",
        "package_version": "3.0.1",
        "package_release": "43.0.1.el9_0",
        "package_id": 22428399,
        "package_last_modified": "2022-11-01 19:52:21"
    },
    {
        "package_arch_label": "x86_64",
        "package_name": "openssl",
        "package_epoch": "1",
        "package_version": "3.0.1",
        "package_release": "43.0.1.el9_0",
        "package_id": 22428400,
        "package_last_modified": "2022-11-01 19:53:02"
    }
]

`channel.software.listErrata`

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

Input Parameters

Parameter	Description
`sessionKey`	The session key for the session.
`channelLabel`	The channel label for the channel that you want to query.

Return Parameters

Field	Description
`array`	An array of all errata associated with the channel label: `struct (errata)` `errata_advisory_type` The errata advisory type. `errata_advisory` The errata advisory label. `errata_issue_date` The date the errata was issued. `errata_last_modified_date` The date the errata was last modified. `errata_synopsis` A brief synopsis of the errata. `errata_update_date` The errata update date.

Example Input Parameters


sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest

Example Output Parameters


[
    {
        "errata_update_date": "2025-04-30 00:00:00",
        "errata_advisory_type": "Bug Fix Advisory",
        "errata_synopsis": "OpenIPMI  bug fix update",
        "errata_advisory": "ELBA-2025-20301",
        "errata_last_modified_date": "2025-04-30 00:00:00",
        "errata_issue_date": "2025-04-30 00:00:00"
    },
    {
        "errata_update_date": "2025-04-30 00:00:00",
        "errata_advisory_type": "Security Advisory",
        "errata_synopsis": "kernel security update",
        "errata_advisory": "ELSA-2025-4341",
        "errata_last_modified_date": "2025-04-30 00:00:00",
        "errata_issue_date": "2025-04-30 00:00:00"
    }
]

`channel.software.listLatestPackages`

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

Input Parameters

Parameter	Description
`sessionKey`	The session key for the session.
`channelLabel`	The channel label for the channel that you want to query.

Return Parameters

Field Description

Field	Description
`array`	An array of latest packages: `struct (package)` `package_arch_label` The package architecture label. `package_epoch` The package epoch value, if specified. The epoch value can help RPM decide package version ordering if the versioning doesn't make sense or doesn't follow sequentially. `package_id` The package ID within the ULN infrastructure. `package_name` The name of the package. `package_release` The package release information. `package_version` The package version number.

array

An array of latest packages:

struct (package)

package_arch_label: The package architecture label.
package_epoch: The package epoch value, if specified. The epoch value can help RPM decide package version ordering if the versioning doesn't make sense or doesn't follow sequentially.
package_id: The package ID within the ULN infrastructure.
package_name: The name of the package.
package_release: The package release information.
package_version: The package version number.

Example Input Parameters


sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest

Example Output Parameters


[
    {
        "package_arch_label": "x86_64",
        "package_name": "NetworkManager-adsl",
        "package_epoch": "1",
        "package_version": "1.48.10",
        "package_release": "8.0.1.el9_5",
        "package_id": 31941131
    },
    {
        "package_arch_label": "noarch",
        "package_name": "NetworkManager-initscripts-updown",
        "package_epoch": "1",
        "package_version": "1.48.10",
        "package_release": "8.0.1.el9_5",
        "package_id": 31941125
    }
]