Öffentliche APIs für Oracle Java-Releases

JMS bietet APIs für den Zugriff auf Informationen zu allen öffentlichen Oracle Java-Releases ab Juli 2019. Diese RESTful-APIs bieten Zugriff auf wichtige Java-Releasedaten, mit denen Systemadministratoren Java-Releaseinformationen nahtlos in ihre betrieblichen Workflows integrieren können.

Die APIs sind über die Domain java.oraclecloud.com zugänglich und können ohne Authentifizierung oder Autorisierung verwendet werden. Außerdem stellen sie skriptfreundliche Downloadbefehle bereit, mit denen Sie die erforderliche Java-Version über JMS-Java-Download herunterladen können.

Java-REST-APIs

Die folgenden APIs sind verfügbar, die umfassende Informationen zu öffentlichen Releases von Oracle Java enthalten. Für jede API gibt es Eingabeparameter, mit denen Sie bestimmte Informationen filtern können.

Java-Versionen

Java Versions-API - https://java.oraclecloud.com/javaVersions: Ruft eine Liste der Oracle Java-Versionen ab. Für jede Java-Version enthält diese API die folgenden Informationen:

  • docUrl: Gibt die Dokumentations-URL an.
  • endOfSupportLifeDate: Gibt das Supportenddatum des Java-Release an.
  • jdkVersion: Gibt die JDK-Versionsnummer an.
  • isSupportedVersion: Gibt an, ob die JDK-Version unterstützt wird. Werte sind True oder False.
  • latestReleaseVersion: Gibt die neueste Versionsnummer des JDK-Release an.
  • isLts: Gibt an, ob das Release Long-Term-Support (LTS) ist oder nicht. Werte sind True oder False.

Eingabeparameter

  • jdkVersion (Zeichenfolge): filtert das Ergebnis nach Java-Hauptversion, wie 8, 11, 17 oder 21
  • isSupportedVersion (boolean): filtert das Ergebnis nach dem Oracle-Supportstatus. Akzeptierter Wert: <true>
  • isLts (boolean): filtert das Ergebnis nach Langzeitunterstützungsstatus. Akzeptierte Werte: <true or false>
  • sortBy (Zeichenfolge): Sortiert das Ergebnis entweder nach jdkVersion (Standardwert) oder endOfSupportLifeDate
  • sortOrder (Zeichenfolge): Sortieren Sie das Ergebnis entweder nach DESC (Standardwert) oder ASC

Java-Releases

Java Releases API - https://java.oraclecloud.com/javaReleases: Ruft eine Liste der öffentlich verfügbaren Oracle Java-Releases ab, wie CPU-, Feature- und Patchreleases. Für jedes Java-Release enthält diese API die folgenden Informationen:
  • artifactContentTypes: Gibt Details an, wie die Mindestanzahl von Tagen, die ein Java-Release unter der Sicherheits-Baseline steht, und ob Skriptdownloadbefehle auf der Seite "JMS-Java-Download" verfügbar sind.
  • jdkDetails: Enthält Details zu den Java-Versionen.
  • licenseDetails: Geben Sie Details an, wie Anzeigename, Lizenztyp und Lizenz-URL.
  • releaseDate: Gibt das Releasedatum einer bestimmten JDK-Version an.
  • releaseNotesUrl: Zeigt die URL des JDK-Release an.
  • releaseType: Gibt den Releasetyp an, wie CPU, FEATURE oder PATCH_RELEASE.
  • releaseVersion: Gibt die Versionsnummer des jeweiligen Java-Release an.
  • releaseFullVersion: Stellt eine vollständige Version bereit, einschließlich der Build-Nummer des jeweiligen Java-Release, z.B. jdk-22.0.1+8.
  • securityStatus: Gibt den Sicherheitsstatus des Releases an, wie UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED oder UNKNOWN.

Eingabeparameter

  • jdkVersion (Zeichenfolge): filtert das Ergebnis nach Java-Hauptversion, wie 8, 11, 17 oder 21
  • isSupportedVersion (boolean): filtert das Ergebnis nach dem Oracle-Supportstatus. Akzeptierter Wert: <true>
  • isLts (boolean): filtert das Ergebnis nach Langzeitunterstützungsstatus. Akzeptierte Werte: <true or false>
  • licenseType (Zeichenfolge): filtert das Ergebnis nach dem Lizenztyp, z.B. OTN oder NFTC
  • releaseType (Zeichenfolge): filtert das Ergebnis nach dem Releasetyp, wie CPU, FEATURE oder PATCH_RELEASE
  • releaseVersion (Zeichenfolge): Filtert das Ergebnis nach der Java-Releaseversion
  • securityStatus (Zeichenfolge): filtert das Ergebnis nach dem Sicherheitsstatus, wie UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED oder UNKNOWN
  • daysUnderSecurityBaseline (Ganzzahl): filtert das Ergebnis nach der Anzahl der Tage, die es sich unter der Sicherheits-Baseline befindet. 0 Tage gibt an, dass es aktuell ist.
  • sortBy (Zeichenfolge): Sortiert das Ergebnis nach releaseDate (Standardwert), releaseVersion, jdkVersion oder licenseType
  • sortOrder (Zeichenfolge): Sortieren Sie das Ergebnis entweder nach DESC (Standardwert) oder ASC

Java-Release einer bestimmten Version

Java-Release der spezifischen Versions-API - https://java.oraclecloud.com/javaReleases/<$releaseVersion> (verwenden Sie den Wert releaseVersion aus der https://java.oraclecloud.com/javaReleases-API, um Details zu diesem Release anzuzeigen). Beispiel: https://java.oraclecloud.com/javaReleases/11.0.17 oder https://java.oraclecloud.com/javaReleases/1.8.0_421.

Diese API ruft vollständige Informationen zu diesem spezifischen Release ab, einschließlich aller Artefakte, die für diese Releaseversion verfügbar sind. Für jedes Java-Release zeigt die API die Artefakteigenschaften an. Beispiele:

  • downloadFileSizeInBytes: Gibt die Dateigröße des Packages an.
  • artifactType: Gibt den Artefakttyp an, wie JDK, JRE oder SERVER_JRE.
  • osFamily: Gibt das entsprechende Betriebssystem des Artefakts an, wie Linux, Windows oder macOS.
  • architecture: Gibt die Architektur des Betriebssystems an, wie aarch64, x64, sparcv9, i586 oder arm32.
  • packageType: Gibt die unterstützten Packagetypen an, wie zip, exe, dmg, deb, rpm, tar.gz, msi oder tar.Z.
  • downloadCommand: Gibt den skriptfreundlichen Downloadbefehl an, mit dem Sie das Package von der JMS-Java-Downloadseite herunterladen können. Stellen Sie sicher, dass Sie die korrekte Token-ID für den nahtlosen Download angeben.
  • downloadUrl: Gibt die skriptfreundliche Download-URL an, mit der Sie das Package von der JMS-Java-Downloadseite herunterladen können.
  • checksumCommand: Gibt den skriptfreundlichen Downloadbefehl zum Abrufen der Prüfsumme des Artefakts an.
  • checksumUrl: Stellt die Download-URL mit der entsprechenden Prüfsumme bereit.

Eingabeparameter

  • artifactType (Zeichenfolge): filtert die Artefakte nach dem unterstützten Artefaktinhaltstyp, wie JDK, JRE oder SERVER_JRE
  • osFamily (Zeichenfolge): filtert die Artefakte nach dem unterstützten Betriebssystem, wie macOS, Windows, Linux oder Solaris
  • architecture (Zeichenfolge): filtert die Artefakte nach der unterstützten Betriebssystemarchitektur, wie aarch64, x64, sparcv9, i586 oder arm32
  • packageType (Zeichenfolge): filtert die Artefakte nach dem unterstützten Artefaktpackagetyp, wie zip, exe, dmg, deb, rpm, tar.gz, msi oder tar.Z
  • sortBy (Zeichenfolge): Sortiert das Ergebnis nach osFamily (Standardwert), architecture, artifactType oder packageType
  • sortOrder (Zeichenfolge): Sortiert das Ergebnis entweder nach DESC oder ASC (Standardwert)

Aktuelle Java-Versionen

Aktuelle Java-Releases-API - https://java.oraclecloud.com/currentJavaReleases: Ruft eine Liste der aktuell unterstützten Oracle Java-Releases ab (CPU-, Feature- und Patchreleases). Die API listet alle Releases auf, die der Sicherheits-Baseline entsprechen, d.h. das Feld securityStatus, das auf UP_TO_DATE gesetzt ist. Für jedes Java-Release enthält diese API die folgenden Informationen:

  • artifactContentTypes: Gibt Details an, wie die Mindestanzahl von Tagen, die ein Java-Release unter der Sicherheits-Baseline steht, und ob Skriptdownloadbefehle auf der Seite "JMS-Java-Download" verfügbar sind.
  • jdkDetails: Enthält Details zu den Java-Versionen.
  • licenseDetails: Geben Sie Details an, wie Anzeigename, Lizenztyp und Lizenz-URL.
  • releaseDate: Gibt das Releasedatum einer bestimmten JDK-Version an.
  • releaseNotesUrl: Zeigt die URL des JDK-Release an.
  • releaseType: Gibt den Releasetyp an, wie CPU, FEATURE oder PATCH_RELEASE.
  • releaseVersion: Gibt die Versionsnummer des jeweiligen Java-Release an.
  • releaseFullVersion: Stellt eine vollständige Version bereit, einschließlich der Build-Nummer des jeweiligen Java-Release, z.B. jdk-22.0.1+8.
  • securityStatus: Gibt den Sicherheitsstatus des Releases an, wie UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED oder UNKNOWN.

Eingabeparameter

  • jdkVersion (Zeichenfolge): filtert das Ergebnis nach Java-Hauptversion, wie 8, 11, 17 oder 21
  • isSupportedVersion (boolean): filtert das Ergebnis nach dem Oracle-Supportstatus. Akzeptierter Wert: <true>
  • isLts (boolean): filtert das Ergebnis nach Langzeitunterstützungsstatus. Akzeptierte Werte: <true or false>
  • licenseType (Zeichenfolge): filtert das Ergebnis nach dem Lizenztyp, z.B. OTN oder NFTC
  • releaseType (Zeichenfolge): filtert das Ergebnis nach dem Releasetyp, wie CPU, FEATURE oder PATCH_RELEASE
  • sortBy (Zeichenfolge): Sortiert das Ergebnis nach releaseDate (Standardwert), releaseVersion, jdkVersion oder licenseType
  • sortOrder (Zeichenfolge): Sortieren Sie das Ergebnis entweder nach DESC (Standardwert) oder ASC

Aktuelles Java-Release der bestimmten Java-Version

Aktuelles Java-Release der spezifischen Java-Versions-API - https://java.oraclecloud.com/currentJavaReleases/<$jdkVersion>: Verwenden Sie den Wert jdkVersion aus der https://java.oraclecloud.com/javaVersions-API, um die Details dieser Version anzuzeigen. Beispiel: https://java.oraclecloud.com/currentJavaReleases/23.

Diese API ruft vollständige Informationen zu einer bestimmten Version eines aktuellen Java-Release ab. Für jedes Java-Release enthält diese API die folgenden Informationen:

  • downloadFileSizeInBytes: Gibt die Dateigröße des Packages an.
  • artifactType: Gibt den Artefakttyp an, wie JDK, JRE oder SERVER_JRE.
  • osFamily: Gibt das entsprechende Betriebssystem des Artefakts an, wie Linux, Windows oder macOS.
  • architecture: Gibt die Architektur des Betriebssystems an, wie aarch64, x64, sparcv9, i586 oder arm32.
  • packageType: Gibt die unterstützten Packagetypen an, wie zip, exe, dmg, deb, rpm, tar.gz, msi oder tar.Z.
  • downloadCommand: Gibt den skriptfreundlichen Downloadbefehl an, mit dem Sie das Package von der JMS-Java-Downloadseite herunterladen können. Stellen Sie sicher, dass Sie die korrekte Token-ID für den nahtlosen Download angeben.
  • downloadUrl: Gibt die skriptfreundliche Download-URL an, mit der Sie das Package von der JMS-Java-Downloadseite herunterladen können.
  • checksumCommand: Gibt den skriptfreundlichen Downloadbefehl zum Abrufen der Prüfsumme des Artefakts an.
  • checksumUrl: Stellt die Download-URL mit der entsprechenden Prüfsumme bereit.

Eingabeparameter

  • artifactType (Zeichenfolge): filtert die Artefakte nach dem unterstützten Artefaktinhaltstyp, wie JDK, JRE oder SERVER_JRE
  • osFamily (Zeichenfolge): filtert die Artefakte nach dem unterstützten Betriebssystem, wie macOS, Windows, Linux oder Solaris
  • architecture (Zeichenfolge): filtert die Artefakte nach der unterstützten Betriebssystemarchitektur, wie aarch64, x64, sparcv9, i586 oder arm32
  • packageType (Zeichenfolge): filtert die Artefakte nach dem unterstützten Artefaktpackagetyp, wie zip, exe, dmg, deb, rpm, tar.gz, msi oder tar.Z
  • sortBy (Zeichenfolge): Sortiert das Ergebnis nach osFamily (Standardwert), architecture, artifactType oder packageType
  • sortOrder (Zeichenfolge): Sortiert das Ergebnis entweder nach DESC oder ASC (Standardwert)

Java-REST-APIs verwenden

Mit den Eingabeparametern der Java-API können Sie nur die erforderlichen Informationen filtern und abrufen. Beispiel: Um nur macOS-aarch64-Artefakte im JDK 11.0.17-Release zu filtern, verwenden Sie:
https://java.oraclecloud.com/javaReleases/11.0.17?osFamily=macos&architecture=aarch64
Um die neueste JDK 11 for Linux-Plattform aarch64 von der Seite "JMS Java-Download" herunterzuladen, verwenden Sie:
curl -H "token:<$token>" -L -O https://java.oraclecloud.com/java/11/latest/jdk-11_linux-aarch64_bin.tar.gz
Stellen Sie im Downloadbefehl sicher, dass Sie im Feld <$token> eine gültige Token-ID angeben.
Hinweis

Token ist für das Herunterladen von Java-Releases unter der NFTC-Lizenz optional. Downloads ohne gültiges Token werden unter Reporting nicht angezeigt.

Sie können die Paketintegrität auch mit dem Prüfsummenbefehl überprüfen.