チャネル・ソフトウェア・メソッド

チャネル・ソフトウェア・メソッドは、channel.softwareネームスペースで使用できます。次のメソッドを使用すると、ULNのチャネルからセッションで使用可能なパッケージを問合せできます。

• channel.software.getDetails

• channel.software.listAllPackages

• channel.software.listErrata

• channel.software.listLatestPackages

channel.software.getDetails

getDetailsメソッドは、指定のチャネルの詳細を返します。

入力パラメータ

パラメータ	説明
sessionKey	セッションのセッション・キー。
channelLabel	問い合せるチャネルのチャネル・ラベル。

戻り値のパラメータ

フィールド	説明
channel_arch_name	チャネル・アーキテクチャ名。
channel_description	チャネルの説明。
channel_summary	チャネル・サマリー(通常はチャネル名と同じです)。
metadata_urls	メタデータの場所とチェックサム情報のディクショナリまたは連想配列。チャネル・メタデータをダウンロードするためのURLも含まれます。 filelists checksum_type チェックサムの生成に使用されたハッシュ・アルゴリズム。 checksum filelistsメタデータ・ファイルのチェックサム。 file_name チャネルの場所でのfilelistsメタデータのファイル名。 url filelistsメタデータにアクセスできるURL。URLにアクセスするには、認証時に返されたセッション・キーの値とともにX-ULN-Api-User-Keyヘッダーを含めます。 group checksum_type チェックサムの生成に使用されたハッシュ・アルゴリズム。 checksum groupメタデータ・ファイルのチェックサム。 file_name チャネルの場所でのgroupメタデータのファイル名。 url groupメタデータにアクセスできるURL。URLにアクセスするには、認証時に返されたセッション・キーの値とともにX-ULN-Api-User-Keyヘッダーを含めます。 other checksum_type チェックサムの生成に使用されたハッシュ・アルゴリズム。 checksum otherメタデータ・ファイルのチェックサム。 file_name チャネルの場所でのotherメタデータのファイル名。 url otherメタデータにアクセスできるURL。URLにアクセスするには、認証時に返されたセッション・キーの値とともにX-ULN-Api-User-Keyヘッダーを含めます。 primary checksum_type チェックサムの生成に使用されたハッシュ・アルゴリズム。 checksum primaryメタデータ・ファイルのチェックサム。 file_name チャネルの場所でのprimaryメタデータのファイル名。 url primaryメタデータにアクセスできるURL。URLにアクセスするには、認証時に返されたセッション・キーの値とともにX-ULN-Api-User-Keyヘッダーを含めます。 repomd file_name チャネルの場所でのrepomdメタデータのファイル名。 url repomdメタデータにアクセスできるURL。URLにアクセスするには、認証時に返されたセッション・キーの値とともにX-ULN-Api-User-Keyヘッダーを含めます。 updateinfo checksum_type チェックサムの生成に使用されたハッシュ・アルゴリズム。 checksum updateinfoメタデータ・ファイルのチェックサム。 file_name チャネルの場所でのupdateinfoメタデータのファイル名。 url updateinfoメタデータにアクセスできるURL。URLにアクセスするには、認証時に返されたセッション・キーの値とともにX-ULN-Api-User-Keyヘッダーを含めます。

入力パラメータの例

sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest
            

出力パラメータの例

{
    "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

listAllPackagesメソッドは、チャネルから使用可能なすべてのパッケージのリストを返します。リストには最新でないパッケージも含まれます。

入力パラメータ

パラメータ	説明
sessionKey	セッションのセッション・キー。例: JyUVNoT74BFaRJ6fRjDIQ5idPmCaj5UJLb76E2f45Gc
channelLabel	問い合せるチャネルのチャネル・ラベル。

戻り値のパラメータ

フィールド

説明

array

すべてのパッケージの配列: struct (package) package_arch_label パッケージ・アーキテクチャ・ラベル。例: noarch package_epoch パッケージのエポック値(指定されている場合)。エポック値は、バージョニングが意味を成さない場合や連続していない場合に、RPMがパッケージ・バージョンの順序を決定する際に役立ちます。例: 1 package_id ULNインフラストラクチャ内のパッケージID。例: 11776733 package_last_modified パッケージが最後に変更された日付とタイムスタンプ。例: 2018-09-27 19:31:13 package_name パッケージの名前。例: selinux-policy-mls package_release パッケージ・リリース情報。例: 192.0.6.el7_5.6 package_version パッケージ・バージョン番号。例: 3.13.1

入力パラメータの例

sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest
            

出力パラメータの例

[
    {
        "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

listErrataメソッドは、チャネルに関連付けられたすべてのエラッタのリストを返します。

入力パラメータ

パラメータ	説明
sessionKey	セッションのセッション・キー。
channelLabel	問い合せるチャネルのチャネル・ラベル。

戻り値のパラメータ

フィールド	説明
array	チャネル・ラベルに関連付けられたすべてのエラッタの配列: struct (errata) errata_advisory_type エラッタ・アドバイザ・タイプ。 errata_advisory エラッタ・アドバイザ・ラベル。 errata_issue_date エラッタが発行された日付。 errata_last_modified_date エラッタが最後に変更された日付。 errata_synopsis エラッタの簡単な概要。 errata_update_date エラッタ更新日。

入力パラメータの例

sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest
            

出力パラメータの例

[
    {
        "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

listLatestPackagesメソッドは、チャネルから使用可能な最新パッケージのリストを返します。

入力パラメータ

パラメータ	説明
sessionKey	セッションのセッション・キー。
channelLabel	問い合せるチャネルのチャネル・ラベル。

戻り値のパラメータ

フィールド	説明
array	最新パッケージの配列: struct (package) package_arch_label パッケージ・アーキテクチャ・ラベル。 package_epoch パッケージのエポック値(指定されている場合)。エポック値は、バージョニングが意味を成さない場合や連続していない場合に、RPMがパッケージ・バージョンの順序を決定する際に役立ちます。 package_id ULNインフラストラクチャ内のパッケージID。 package_name パッケージの名前。 package_release パッケージ・リリース情報。 package_version パッケージ・バージョン番号。

入力パラメータの例

sessionKey: ebQ3nS8QOmXoDIsXbrZTcD4xDMzsmJUo7yhoSi6VwPT
channelLabel: ol9_x86_64_baseos_latest
            

出力パラメータの例

[
    {
        "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
    }
]