API pubbliche per le release Oracle Java

JMS fornisce API per accedere alle informazioni su tutte le release pubbliche di Oracle Java, a partire dalla CPU di luglio 2019. Queste API RESTful offrono l'accesso ai dati essenziali delle release Java, consentendo agli amministratori di sistema di integrare senza problemi le informazioni sulle release Java nei flussi di lavoro operativi.

Le API sono accessibili tramite il dominio java.oraclecloud.com e possono essere utilizzate senza autenticazione o autorizzazione. Forniscono inoltre i comandi Download descrittivo per script per scaricare la versione Java richiesta tramite il download Java JMS.

API REST Java

Sono disponibili le seguenti API che forniscono informazioni complete sulle release pubbliche di Oracle Java. Per ogni API sono disponibili parametri di input che è possibile utilizzare per filtrare informazioni specifiche.

Versioni Java

API Versioni Java - https://java.oraclecloud.com/javaVersions: recupera una lista di versioni Oracle Java. Per ogni versione Java, questa API presenta le seguenti informazioni:

  • docUrl: fornisce l'URL della documentazione.
  • endOfSupportLifeDate: fornisce la data di fine del supporto della release Java.
  • jdkVersion: fornisce il numero di versione del kit JDK.
  • isSupportedVersion: indica se la versione del JDK è supportata o meno. I valori sono True o False.
  • latestReleaseVersion: fornisce il numero di versione più recente della release JDK.
  • isLts: indica se il rilascio è LTS (Long-Term-Support). I valori sono True o False.

Parametri di input

  • jdkVersion (string): filtra il risultato in base alla versione Java principale, ad esempio 8, 11, 17 o 21
  • isSupportedVersion (booleano): filtra il risultato in base allo stato del supporto Oracle. Valore accettato: <true>
  • isLts (booleano): filtra il risultato in base allo stato di supporto a lungo termine. Valori accettati: <true or false>
  • sortBy (stringa): ordina il risultato in base a jdkVersion (valore predefinito) o endOfSupportLifeDate
  • sortOrder (stringa): ordinare il risultato mediante DESC (valore predefinito) o ASC

Release di Java

API per le release Java - https://java.oraclecloud.com/javaReleases: recupera un elenco di release Oracle Java pubblicamente disponibili, ad esempio release di CPU, funzioni e patch. Per ogni release Java, questa API presenta le informazioni riportate di seguito.
  • artifactContentTypes: fornisce dettagli quali il numero minimo di giorni di permanenza di una release Java nella baseline di sicurezza e se i comandi di download degli script sono disponibili nella pagina di download di Java JMS.
  • jdkDetails: fornisce dettagli sulle versioni Java.
  • licenseDetails: fornisce dettagli quali nome visualizzato, tipo di licenza e URL della licenza.
  • releaseDate: fornisce la data di rilascio di una determinata versione del JDK.
  • releaseNotesUrl: visualizza l'URL della release del JDK.
  • releaseType: indica il tipo di release, ad esempio CPU, FEATURE o PATCH_RELEASE.
  • releaseVersion: fornisce il numero di versione della release Java specifica.
  • releaseFullVersion: fornisce la versione completa, incluso il numero di build della release Java specifica, ad esempio jdk-22.0.1+8.
  • securityStatus: indica lo stato di sicurezza della release, ad esempio UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED o UNKNOWN.

Parametri di input

  • jdkVersion (string): filtra il risultato in base alla versione Java principale, ad esempio 8, 11, 17 o 21
  • isSupportedVersion (booleano): filtra il risultato in base allo stato del supporto Oracle. Valore accettato: <true>
  • isLts (booleano): filtra il risultato in base allo stato di supporto a lungo termine. Valori accettati: <true or false>
  • licenseType (stringa): filtra il risultato in base al tipo di licenza, ad esempio OTN o NFTC
  • releaseType (stringa): filtra il risultato in base al tipo di release, ad esempio CPU, FEATURE o PATCH_RELEASE
  • releaseVersion (string): i filtri sono il risultato della versione della release Java
  • securityStatus (stringa): filtra il risultato in base allo stato di sicurezza, ad esempio UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED o UNKNOWN
  • daysUnderSecurityBaseline (integer): filtra il risultato in base al numero di giorni in cui si trova al di sotto della baseline di sicurezza. 0 giorni indica che è aggiornato.
  • sortBy (stringa): ordina il risultato in base al valore releaseDate (valore predefinito), releaseVersion, jdkVersion o licenseType
  • sortOrder (stringa): ordinare il risultato mediante DESC (valore predefinito) o ASC

Release Java di una versione specifica

Release Java dell'interfaccia API versione specifica - https://java.oraclecloud.com/javaReleases/<$releaseVersion> (utilizzare il valore releaseVersion dell'interfaccia API https://java.oraclecloud.com/javaReleases per visualizzare i dettagli di tale release. Ad esempio, https://java.oraclecloud.com/javaReleases/11.0.17 o https://java.oraclecloud.com/javaReleases/1.8.0_421.

Questa interfaccia API recupera informazioni complete sulla release specifica, inclusi tutti gli artifact disponibili per la versione specifica. Per ogni release Java, l'interfaccia API presenta le proprietà degli artifact, ad esempio:

  • downloadFileSizeInBytes: indica la dimensione del file del pacchetto.
  • artifactType: indica il tipo di artifact, ad esempio JDK, JRE o SERVER_JRE.
  • osFamily: indica il sistema operativo corrispondente dell'artifact, ad esempio Linux, Windows o macOS.
  • architecture: indica l'architettura del sistema operativo, ad esempio aarch64, x64, sparcv9, i586 o arm32.
  • packageType: indica i tipi di package supportati, ad esempio zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z.
  • downloadCommand: fornisce il comando di download descrittivo dello script che consente di scaricare il package dalla pagina di download di Java JMS. Assicurarsi di fornire l'ID token corretto per il download senza problemi.
  • downloadUrl: fornisce l'URL di download intuitivo per gli script che è possibile utilizzare per scaricare il package dalla pagina di download Java JMS.
  • checksumCommand: fornisce il comando script friendly download per ottenere il checksum dell'artifact.
  • checksumUrl: fornisce all'URL di download il checksum corrispondente.

Parametri di input

  • artifactType (stringa): filtra gli artifact in base al tipo di contenuto dell'artifact supportato, ad esempio JDK, JRE o SERVER_JRE
  • osFamily (string): filtra gli artifact in base al sistema operativo supportato, ad esempio macOS, Windows, Linux o Solaris
  • architecture (string): filtra gli artifact in base all'architettura del sistema operativo supportata, ad esempio aarch64, x64, sparcv9, i586 o arm32
  • packageType (stringa): filtra gli artifact in base al tipo di package di artifact supportato, ad esempio zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z
  • sortBy (stringa): ordina il risultato in base al valore osFamily (valore predefinito), architecture, artifactType o packageType
  • sortOrder (stringa): ordina il risultato mediante DESC o ASC (valore predefinito)

Release correnti di Java

API delle release Java correnti: https://java.oraclecloud.com/currentJavaReleases: recupera un elenco delle release Oracle Java attualmente supportate (release CPU, funzioni e patch). L'API elenca tutte le release conformi alla baseline di sicurezza, ovvero il campo securityStatus impostato su UP_TO_DATE. Per ogni release Java, questa API presenta le informazioni riportate di seguito.

  • artifactContentTypes: fornisce dettagli quali il numero minimo di giorni di permanenza di una release Java nella baseline di sicurezza e se i comandi di download degli script sono disponibili nella pagina di download di Java JMS.
  • jdkDetails: fornisce dettagli sulle versioni Java.
  • licenseDetails: fornisce dettagli quali nome visualizzato, tipo di licenza e URL della licenza.
  • releaseDate: fornisce la data di rilascio di una determinata versione del JDK.
  • releaseNotesUrl: visualizza l'URL della release del JDK.
  • releaseType: indica il tipo di release, ad esempio CPU, FEATURE o PATCH_RELEASE.
  • releaseVersion: fornisce il numero di versione della release Java specifica.
  • releaseFullVersion: fornisce la versione completa, incluso il numero di build della release Java specifica, ad esempio jdk-22.0.1+8.
  • securityStatus: indica lo stato di sicurezza della release, ad esempio UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED o UNKNOWN.

Parametri di input

  • jdkVersion (string): filtra il risultato in base alla versione Java principale, ad esempio 8, 11, 17 o 21
  • isSupportedVersion (booleano): filtra il risultato in base allo stato del supporto Oracle. Valore accettato: <true>
  • isLts (booleano): filtra il risultato in base allo stato di supporto a lungo termine. Valori accettati: <true or false>
  • licenseType (stringa): filtra il risultato in base al tipo di licenza, ad esempio OTN o NFTC
  • releaseType (stringa): filtra il risultato in base al tipo di release, ad esempio CPU, FEATURE o PATCH_RELEASE
  • sortBy (stringa): ordina il risultato in base al valore releaseDate (valore predefinito), releaseVersion, jdkVersion o licenseType
  • sortOrder (stringa): ordinare il risultato mediante DESC (valore predefinito) o ASC

Release Java corrente di una versione Java specifica

Release Java corrente dell'API versione Java specifica - https://java.oraclecloud.com/currentJavaReleases/<$jdkVersion>: utilizzare il valore jdkVersion dell'API https://java.oraclecloud.com/javaVersions per visualizzare i dettagli di tale versione. Ad esempio, https://java.oraclecloud.com/currentJavaReleases/23.

Questa API recupera informazioni complete su una versione specifica di una release corrente di Java. Per ogni release Java, questa API presenta le informazioni riportate di seguito.

  • downloadFileSizeInBytes: indica la dimensione del file del pacchetto.
  • artifactType: indica il tipo di artifact, ad esempio JDK, JRE o SERVER_JRE.
  • osFamily: indica il sistema operativo corrispondente dell'artifact, ad esempio Linux, Windows o macOS.
  • architecture: indica l'architettura del sistema operativo, ad esempio aarch64, x64, sparcv9, i586 o arm32.
  • packageType: indica i tipi di package supportati, ad esempio zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z.
  • downloadCommand: fornisce il comando di download descrittivo dello script che consente di scaricare il package dalla pagina di download Java JMS. Assicurarsi di fornire l'ID token corretto per il download senza problemi.
  • downloadUrl: fornisce l'URL di download intuitivo per gli script che è possibile utilizzare per scaricare il package dalla pagina di download Java JMS.
  • checksumCommand: fornisce il comando script friendly download per ottenere il checksum dell'artifact.
  • checksumUrl: fornisce all'URL di download il checksum corrispondente.

Parametri di input

  • artifactType (stringa): filtra gli artifact in base al tipo di contenuto dell'artifact supportato, ad esempio JDK, JRE o SERVER_JRE
  • osFamily (string): filtra gli artifact in base al sistema operativo supportato, ad esempio macOS, Windows, Linux o Solaris
  • architecture (string): filtra gli artifact in base all'architettura del sistema operativo supportata, ad esempio aarch64, x64, sparcv9, i586 o arm32
  • packageType (stringa): filtra gli artifact in base al tipo di package di artifact supportato, ad esempio zip, exe, dmg, deb, rpm, tar.gz, msi o tar.Z
  • sortBy (stringa): ordina il risultato in base al valore osFamily (valore predefinito), architecture, artifactType o packageType
  • sortOrder (stringa): ordina il risultato mediante DESC o ASC (valore predefinito)

Uso delle API REST Java

È possibile utilizzare i parametri di input dell'API Java per filtrare e recuperare solo le informazioni richieste. Ad esempio, per filtrare solo gli artifact macOS aarch64 nella release JDK 11.0.17, utilizzare:
https://java.oraclecloud.com/javaReleases/11.0.17?osFamily=macos&architecture=aarch64
Per scaricare la piattaforma aarch64 JDK 11 per Linux più recente dalla pagina di download di JMS Java, utilizzare:
curl -H "token:<$token>" -L -O https://java.oraclecloud.com/java/11/latest/jdk-11_linux-aarch64_bin.tar.gz
Nel comando di download, assicurarsi di fornire un ID Token valido nel campo <$token>.
Nota

Il token è facoltativo per scaricare le release Java con licenza NFTC. I download senza un token valido non verranno visualizzati in Reporting.

È anche possibile utilizzare il comando di checksum per verificare l'integrità dei pacchetti.