Public APIs for Oracle Java Releases
JMS provides APIs to access information about all Oracle Java public releases, starting from July 2019 CPU. These RESTful APIs offer access to essential Java release data, empowering system administrators to integrate Java release information seamlessly into their operational workflows.
The APIs are accessible over the java.oraclecloud.com
domain and can be used without authentication or authorization. They also provide Script Friendly Download commands to download the required Java version through JMS Java Download.
Java REST APIs
The following APIs are available that provide comprehensive information about Oracle Java public releases. For each API, there are input parameters that you can use to filter specific information.
Java Versions
Java Versions API - https://java.oraclecloud.com/javaVersions: retrieves a list of Oracle Java versions. For each Java version, this API presents the following information:
docUrl
: provides the documentation URL.endOfSupportLifeDate
: provides end of support date of the Java release.jdkVersion
: provides JDK version number.isSupportedVersion
: indicates whether the JDK version is supported or not. Values are True or False.latestReleaseVersion
: provides the latest version number of the JDK release.isLts
: indicates whether the release is Long-Term-Support (LTS) or not. Values are True or False.
Input Parameters
jdkVersion
(string): filters the result by major Java version such as 8, 11, 17, or 21isSupportedVersion
(boolean): filters the result by Oracle support status. Accepted value:<true>
isLts
(boolean): filters the result by long term support status. Accepted values:<true or false>
sortBy
(string): sorts the result either byjdkVersion
(default value) orendOfSupportLifeDate
sortOrder
(string): order the result either byDESC
(default value) orASC
Java Releases
artifactContentTypes
: provides details such as, minimum number of days a Java release is under the security baseline and whether script download commands are available from the JMS Java Download page.jdkDetails
: provides details about the Java versions.licenseDetails
: provide details such as display name, license type, and license URL.releaseDate
: provides the release date of a particular JDK version.releaseNotesUrl
: displays the URL of the JDK release.releaseType
: indicates the type of release such as CPU, FEATURE, or PATCH_RELEASE.releaseVersion
: provides version number of the particular Java release.releaseFullVersion
: provides complete version, including the build number of the particular Java release, for example,jdk-22.0.1+8
.securityStatus
: indicates security status of the release, such asUP_TO_DATE
,UPDATE_REQUIRED
,UPGRADE_REQUIRED
, orUNKNOWN
.
Input Parameters
jdkVersion
(string): filters the result by major Java version such as 8, 11, 17, or 21isSupportedVersion
(boolean): filters the result by Oracle support status. Accepted value:<true>
isLts
(boolean): filters the result by long term support status. Accepted values:<true or false>
licenseType
(string): filters the result by the license type such asOTN
orNFTC
releaseType
(string): filters the result by the release type such asCPU
,FEATURE
, orPATCH_RELEASE
releaseVersion
(string): filters result by the Java release versionsecurityStatus
(string): filters the result by the security status such asUP_TO_DATE
,UPDATE_REQUIRED
,UPGRADE_REQUIRED
, orUNKNOWN
daysUnderSecurityBaseline
(integer): filters the result by the number of days it is under the security baseline. 0 days indicates it is up to date.sortBy
(string): sorts the result byreleaseDate
(default value),releaseVersion
,jdkVersion
, orlicenseType
sortOrder
(string): order the result either byDESC
(default value) orASC
Java Release of Specific Version
Java Release of Specific Version API - https://java.oraclecloud.com/javaReleases/<$releaseVersion> (use releaseVersion
value from https://java.oraclecloud.com/javaReleases API to see details of that release. For instance - https://java.oraclecloud.com/javaReleases/11.0.17 or https://java.oraclecloud.com/javaReleases/1.8.0_421.
This API retrieves complete information about that specific release, including all the artifacts available for that release version. For each Java release, the API presents the artifacts properties, such as:
downloadFileSizeInBytes
: provides the file size of the package.artifactType
: indicates the artifact type, such as JDK, JRE, or SERVER_JRE.osFamily
: indicates the corresponding Operating System of the artifact, such as Linux, Windows, or macOS.architecture
: indicates the architecture of the operating system, such asaarch64
,x64
,sparcv9
,i586
, orarm32
.packageType
: indicates the supported package types, such aszip
,exe
,dmg
,deb
,rpm
,tar.gz
,msi
, ortar.Z
.downloadCommand
: provides the script friendly download command that will enable you to download the package from JMS Java download page. Ensure to provide correct Token ID and Region for seamless download.downloadUrl
: provides the script friendly download URL that you can use to download the package from JMS Java Download page. Ensure to provide correct Region.checksumCommand
: provides the script friendly download command to get checksum of the artifact. Ensure to provide correct Region in the command.checksumUrl
: provides the download URL with corresponding checksum. Ensure to provide correct Region.
Input Parameters
artifactType
(string): filters the artifacts by the supported artifact content type such asJDK
,JRE
, orSERVER_JRE
osFamily
(string): filters the artifacts by the supported operating system such asmacOS
,Windows
,Linux
, orSolaris
architecture
(string): filters the artifacts by the supported operating system architecture such asaarch64
,x64
,sparcv9
,i586
, orarm32
packageType
(string): filters the artifacts by the supported artifact package type such aszip
,exe
,dmg
,deb
,rpm
,tar.gz
,msi
ortar.Z
sortBy
(string): sorts the result byosFamily
(default value),architecture
,artifactType
, orpackageType
sortOrder
(string): orders the result either byDESC
orASC
(default value)
Current Java Releases
Current Java Releases API - https://java.oraclecloud.com/currentJavaReleases: retrieves a list of currently supported Oracle Java releases (CPU, Feature, and Patch releases). The API lists all releases that conform to the security baseline that is, securityStatus
field set to UP_TO_DATE
. For each Java release, this API presents the following information:
artifactContentTypes
: provides details such as, minimum number of days a Java release is under the security baseline and whether script download commands are available from the JMS Java Download page.jdkDetails
: provides details about the Java versions.licenseDetails
: provide details such as display name, license type, and license URL.releaseDate
: provides the release date of a particular JDK version.releaseNotesUrl
: displays the URL of the JDK release.releaseType
: indicates the type of release such as CPU, FEATURE, or PATCH_RELEASE.releaseVersion
: provides version number of the particular Java release.releaseFullVersion
: provides complete version, including the build number of the particular Java release, for example,jdk-22.0.1+8
.securityStatus
: indicates security status of the release, such asUP_TO_DATE
,UPDATE_REQUIRED
,UPGRADE_REQUIRED
, orUNKNOWN
.
Input Parameters
jdkVersion
(string): filters the result by major Java version such as 8, 11, 17, or 21isSupportedVersion
(boolean): filters the result by Oracle support status. Accepted value:<true>
isLts
(boolean): filters the result by long term support status. Accepted values:<true or false>
licenseType
(string): filters the result by the license type such asOTN
orNFTC
releaseType
(string): filters the result by the release type such asCPU
,FEATURE
, orPATCH_RELEASE
sortBy
(string): sorts the result byreleaseDate
(default value),releaseVersion
,jdkVersion
, orlicenseType
sortOrder
(string): order the result either byDESC
(default value) orASC
Current Java Release of Specific Java Version
Current Java Release of Specific Java Version API - https://java.oraclecloud.com/currentJavaReleases/<$jdkVersion>
: use the jdkVersion
value from https://java.oraclecloud.com/javaVersions API to see the details of that version. For instance - https://java.oraclecloud.com/currentJavaReleases/22.
This API retrieves complete information about a specific version of a current Java release. For each Java release, this API presents the following information:
downloadFileSizeInBytes
: provides the file size of the package.artifactType
: indicates the artifact type, such asJDK
,JRE
, orSERVER_JRE
.osFamily
: indicates the corresponding Operating System of the artifact, such asLinux
,Windows
, ormacOS
.architecture
: indicates the architecture of the operating system, such asaarch64
,x64
,sparcv9
,i586
, orarm32
.packageType
: indicates the supported package types, such aszip
,exe
,dmg
,deb
,rpm
,tar.gz
,msi
, ortar.Z
.downloadCommand
: provides the script friendly download command that will enable you to download the package from JMS Java Download page. Ensure to provide correct Token ID and Region for seamless download.downloadUrl
: provides the script friendly download URL that you can use to download the package from JMS Java Download page. Ensure to provide correct Region.checksumCommand
: provides the script friendly download command to get checksum of the artifact. Ensure to provide correct Region in the command.checksumUrl
: provides the download URL with corresponding checksum. Ensure to provide correct Region.
Input Parameters
artifactType
(string): filters the artifacts by the supported artifact content type such asJDK
,JRE
, orSERVER_JRE
osFamily
(string): filters the artifacts by the supported operating system such asmacOS
,Windows
,Linux
, orSolaris
architecture
(string): filters the artifacts by the supported operating system architecture such asaarch64
,x64
,sparcv9
,i586
, orarm32
packageType
(string): filters the artifacts by the supported artifact package type such aszip
,exe
,dmg
,deb
,rpm
,tar.gz
,msi
ortar.Z
sortBy
(string): sorts the result byosFamily
(default value),architecture
,artifactType
, orpackageType
sortOrder
(string): orders the result either byDESC
orASC
(default value)
Using Java REST APIs
https://java.oraclecloud.com/javaReleases/11.0.17?osFamily=macos&architecture=aarch64
curl -H "token:<$token>" -L -O https://javamanagementservice-download.<$region>.oci.oraclecloud.com/java/11/latest/jdk-11_linux-aarch64_bin.tar.gz
In the download command, ensure that you provide a valid Token ID in the <$token> field and correct Region in the <$region> field. See the table in Regions and Availability Domains to find the <$region> values. Use the “Region Identifier” associated with the “Region Name” in which the token was created.
You can also use the checksum command to verify the package integrity.