API públicas para versiones de Java de Oracle

JMS proporciona API para acceder a información sobre todas las versiones públicas de Oracle Java, a partir de la CPU de julio de 2019. Estas API de RESTful ofrecen acceso a datos esenciales de la versión de Java, lo que permite a los administradores del sistema integrar la información de la versión de Java sin problemas en sus flujos de trabajo operativos.

Se puede acceder a las API a través del dominio java.oraclecloud.com y se pueden utilizar sin autenticación ni autorización. También proporcionan comandos de descarga compatible con script para descargar la versión de Java necesaria mediante la descarga de Java de JMS.

API de REST de Java

Hay disponibles las siguientes API que proporcionan información completa sobre las versiones públicas de Oracle Java. Para cada API, hay parámetros de entrada que puede utilizar para filtrar información específica.

Versiones de Java

API de versiones de Java: https://java.oraclecloud.com/javaVersions: recupera una lista de versiones de Oracle Java. Para cada versión de Java, esta API presenta la siguiente información:

  • docUrl: proporciona la URL de la documentación.
  • endOfSupportLifeDate: proporciona la fecha de finalización del soporte de la versión de Java.
  • jdkVersion: proporciona el número de versión de JDK.
  • isSupportedVersion: indica si la versión de JDK está soportada o no. Los valores son Verdadero o Falso.
  • latestReleaseVersion: proporciona el número de versión más reciente de la versión de JDK.
  • isLts: indica si la versión es de soporte a largo plazo (LTS) o no. Los valores son Verdadero o Falso.

Parámetros de Entrada

  • jdkVersion (cadena): filtra el resultado por la versión principal de Java, como 8, 11, 17 o 21
  • isSupportedVersion (booleano): filtra el resultado por estado de soporte de Oracle. Valor aceptado: <true>
  • isLts (booleano): filtra el resultado por estado de soporte a largo plazo. Valores aceptados: <true or false>
  • sortBy (cadena): ordena el resultado por jdkVersion (valor por defecto) o endOfSupportLifeDate
  • sortOrder (cadena): ordene el resultado por DESC (valor por defecto) o ASC

Versiones de Java

API de versiones de Java - https://java.oraclecloud.com/javaReleases: recupera una lista de versiones de Oracle Java disponibles públicamente, como CPU, funciones y versiones de parches. Para cada versión de Java, esta API presenta la siguiente información:
  • artifactContentTypes: proporciona detalles como el número mínimo de días que una versión de Java está en la línea base de seguridad y si los comandos de descarga de script están disponibles en la página Descarga de Java de JMS.
  • jdkDetails: proporciona detalles sobre las versiones de Java.
  • licenseDetails: proporcione detalles como el nombre mostrado, el tipo de licencia y la URL de licencia.
  • releaseDate: proporciona la fecha de versión de una versión de JDK concreta.
  • releaseNotesUrl: muestra la URL de la versión de JDK.
  • releaseType: indica el tipo de versión, como CPU, FEATURE o PATCH_RELEASE.
  • releaseVersion: proporciona el número de versión de la versión de Java concreta.
  • releaseFullVersion: proporciona la versión completa, incluido el número de compilación de la versión de Java concreta, por ejemplo, jdk-22.0.1+8.
  • securityStatus: indica el estado de seguridad de la versión, como UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED o UNKNOWN.

Parámetros de Entrada

  • jdkVersion (cadena): filtra el resultado por la versión principal de Java, como 8, 11, 17 o 21
  • isSupportedVersion (booleano): filtra el resultado por estado de soporte de Oracle. Valor aceptado: <true>
  • isLts (booleano): filtra el resultado por estado de soporte a largo plazo. Valores aceptados: <true or false>
  • licenseType (cadena): filtra el resultado por tipo de licencia, como OTN o NFTC
  • releaseType (cadena): filtra el resultado por el tipo de versión, como CPU, FEATURE o PATCH_RELEASE
  • releaseVersion (cadena): filtra el resultado por la versión de Java
  • securityStatus (cadena): filtra el resultado por el estado de seguridad, como UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED o UNKNOWN
  • daysUnderSecurityBaseline (entero): filtra el resultado por el número de días que está bajo la base de seguridad. 0 días indica que está actualizado.
  • sortBy (cadena): ordena el resultado por releaseDate (valor por defecto), releaseVersion, jdkVersion o licenseType
  • sortOrder (cadena): ordene el resultado por DESC (valor por defecto) o ASC

Versión de Java de Versión Específica

Versión de Java de API de versión específica: https://java.oraclecloud.com/javaReleases/<$releaseVersion> (utilice el valor releaseVersion de la API https://java.oraclecloud.com/javaReleases para ver los detalles de esa versión. Por ejemplo: https://java.oraclecloud.com/javaReleases/11.0.17 o https://java.oraclecloud.com/javaReleases/1.8.0_421.

Esta API recupera información completa sobre esa versión específica, incluidos todos los artefactos disponibles para esa versión. Para cada versión de Java, la API presenta las propiedades de los artefactos, como:

  • downloadFileSizeInBytes: proporciona el tamaño de archivo del paquete.
  • artifactType: indica el tipo de artefacto, como JDK, JRE o SERVER_JRE.
  • osFamily: indica el sistema operativo correspondiente del artefacto, como Linux, Windows o macOS.
  • architecture: indica la arquitectura del sistema operativo, como aarch64, x64, sparcv9, i586 o arm32.
  • packageType: indica los tipos de paquete soportados, como zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z.
  • downloadCommand: proporciona el comando de descarga fácil de recordar de script que le permitirá descargar el paquete desde la página de descarga de Java de JMS. Asegúrese de proporcionar el ID de token correcto para una descarga perfecta.
  • downloadUrl: proporciona la URL de descarga fácil de recordar de script que puede utilizar para descargar el paquete desde la página Descarga de Java de JMS.
  • checksumCommand: proporciona el comando de descarga fácil de recordar del script para obtener el total de control del artefacto.
  • checksumUrl: proporciona la URL de descarga con el total de control correspondiente.

Parámetros de Entrada

  • artifactType (cadena): filtra los artefactos por el tipo de contenido de artefacto soportado, como JDK, JRE o SERVER_JRE
  • osFamily (cadena): filtra los artefactos por el sistema operativo soportado, como macOS, Windows, Linux o Solaris
  • architecture (cadena): filtra los artefactos por la arquitectura del sistema operativo soportada, como aarch64, x64, sparcv9, i586 o arm32
  • packageType (cadena): filtra los artefactos por el tipo de paquete de artefactos soportado, como zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z
  • sortBy (cadena): ordena el resultado por osFamily (valor por defecto), architecture, artifactType o packageType
  • sortOrder (cadena): ordena el resultado por DESC o ASC (valor por defecto)

Versiones actuales de Java

API de versiones de Java actuales: https://java.oraclecloud.com/currentJavaReleases: recupera una lista de las versiones de Oracle Java soportadas actualmente (versiones de CPU, funciones y parches). La API muestra todas las versiones que cumplen con la línea base de seguridad, es decir, el campo securityStatus definido en UP_TO_DATE. Para cada versión de Java, esta API presenta la siguiente información:

  • artifactContentTypes: proporciona detalles como el número mínimo de días que una versión de Java está en la línea base de seguridad y si los comandos de descarga de script están disponibles en la página Descarga de Java de JMS.
  • jdkDetails: proporciona detalles sobre las versiones de Java.
  • licenseDetails: proporcione detalles como el nombre mostrado, el tipo de licencia y la URL de licencia.
  • releaseDate: proporciona la fecha de versión de una versión de JDK concreta.
  • releaseNotesUrl: muestra la URL de la versión de JDK.
  • releaseType: indica el tipo de versión, como CPU, FEATURE o PATCH_RELEASE.
  • releaseVersion: proporciona el número de versión de la versión de Java concreta.
  • releaseFullVersion: proporciona la versión completa, incluido el número de compilación de la versión de Java concreta, por ejemplo, jdk-22.0.1+8.
  • securityStatus: indica el estado de seguridad de la versión, como UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED o UNKNOWN.

Parámetros de Entrada

  • jdkVersion (cadena): filtra el resultado por la versión principal de Java, como 8, 11, 17 o 21
  • isSupportedVersion (booleano): filtra el resultado por estado de soporte de Oracle. Valor aceptado: <true>
  • isLts (booleano): filtra el resultado por estado de soporte a largo plazo. Valores aceptados: <true or false>
  • licenseType (cadena): filtra el resultado por tipo de licencia, como OTN o NFTC
  • releaseType (cadena): filtra el resultado por el tipo de versión, como CPU, FEATURE o PATCH_RELEASE
  • sortBy (cadena): ordena el resultado por releaseDate (valor por defecto), releaseVersion, jdkVersion o licenseType
  • sortOrder (cadena): ordene el resultado por DESC (valor por defecto) o ASC

Versión actual de Java de la versión de Java específica

Versión de Java actual de API de versión de Java específica: https://java.oraclecloud.com/currentJavaReleases/<$jdkVersion>: utilice el valor jdkVersion de la API https://java.oraclecloud.com/javaVersions para ver los detalles de esa versión. Por ejemplo: https://java.oraclecloud.com/currentJavaReleases/23.

Esta API recupera información completa sobre una versión específica de una versión de Java actual. Para cada versión de Java, esta API presenta la siguiente información:

  • downloadFileSizeInBytes: proporciona el tamaño de archivo del paquete.
  • artifactType: indica el tipo de artefacto, como JDK, JRE o SERVER_JRE.
  • osFamily: indica el sistema operativo correspondiente del artefacto, como Linux, Windows o macOS.
  • architecture: indica la arquitectura del sistema operativo, como aarch64, x64, sparcv9, i586 o arm32.
  • packageType: indica los tipos de paquete soportados, como zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z.
  • downloadCommand: proporciona el comando de descarga fácil de recordar de script que le permitirá descargar el paquete desde la página de descarga de Java de JMS. Asegúrese de proporcionar el ID de token correcto para una descarga perfecta.
  • downloadUrl: proporciona la URL de descarga fácil de recordar de script que puede utilizar para descargar el paquete desde la página Descarga de Java de JMS.
  • checksumCommand: proporciona el comando de descarga fácil de recordar del script para obtener el total de control del artefacto.
  • checksumUrl: proporciona la URL de descarga con el total de control correspondiente.

Parámetros de Entrada

  • artifactType (cadena): filtra los artefactos por el tipo de contenido de artefacto soportado, como JDK, JRE o SERVER_JRE
  • osFamily (cadena): filtra los artefactos por el sistema operativo soportado, como macOS, Windows, Linux o Solaris
  • architecture (cadena): filtra los artefactos por la arquitectura del sistema operativo soportada, como aarch64, x64, sparcv9, i586 o arm32
  • packageType (cadena): filtra los artefactos por el tipo de paquete de artefactos soportado, como zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z
  • sortBy (cadena): ordena el resultado por osFamily (valor por defecto), architecture, artifactType o packageType
  • sortOrder (cadena): ordena el resultado por DESC o ASC (valor por defecto)

Uso de las API REST Java

Puede utilizar los parámetros de entrada de la API de Java para filtrar y recuperar solo la información necesaria. Por ejemplo, para filtrar solo artefactos macOS aarch64 en la versión JDK 11.0.17, utilice:
https://java.oraclecloud.com/javaReleases/11.0.17?osFamily=macos&architecture=aarch64
Para descargar la última plataforma JDK 11 for Linux aarch64 desde la página JMS - Descarga de Java, utilice:
curl -H "token:<$token>" -L -O https://java.oraclecloud.com/java/11/latest/jdk-11_linux-aarch64_bin.tar.gz
En el comando de descarga, asegúrese de proporcionar un ID de Token válido en el campo <$token>.
Nota

El token es opcional para descargar versiones de Java bajo licencia NFTC. Las descargas sin un token válido no aparecerán en Reporting.

También puede utilizar el comando checksum para verificar la integridad del paquete.