API publiques pour les versions Java d'Oracle

JMS fournit des API permettant d'accéder aux informations sur toutes les versions publiques d'Oracle Java, à partir de juillet 2019. Ces API RESTful offrent un accès aux données essentielles des versions de Java, permettant aux administrateurs de système d'intégrer de façon transparente les informations des versions de Java à leurs flux de travail opérationnels.

Les API sont accessibles sur le domaine java.oraclecloud.com et peuvent être utilisées sans authentification ou autorisation. Ils fournissent également des commandes de téléchargement compatible avec les scripts pour télécharger la version Java requise au moyen du téléchargement Java JMS.

API REST Java

Les API suivantes fournissent des informations complètes sur les versions publiques d'Oracle Java. Pour chaque API, vous pouvez utiliser des paramètres d'entrée pour filtrer des informations spécifiques.

Versions de Java

API de versions Java - https://java.oraclecloud.com/javaVersions : Extrait une liste des versions Java d'Oracle. Pour chaque version de Java, cette API présente les informations suivantes :

  • docUrl : Fournit l'URL de la documentation.
  • endOfSupportLifeDate : fournit la date de fin de prise en charge de la version Java.
  • jdkVersion : Fournit le numéro de version de JDK.
  • isSupportedVersion : Indique si la version de JDK est prise en charge ou non. Les valeurs sont Vrai ou Faux.
  • latestReleaseVersion : Fournit le numéro de version le plus récent de la version de JDK.
  • isLts : Indique si la version est prise en charge à long terme (LTS) ou non. Les valeurs sont Vrai ou Faux.

Paramètres d'entrée

  • jdkVersion (chaîne) : filtre le résultat par version Java majeure, telle que 8, 11, 17 ou 21
  • isSupportedVersion (booléen) : Filtre le résultat par statut de soutien Oracle. Valeur acceptée : <true>
  • isLts (booléen) : Filtre le résultat par statut de soutien à long terme. Valeurs acceptées : <true or false>
  • sortBy (chaîne) : trie le résultat par jdkVersion (valeur par défaut) ou endOfSupportLifeDate
  • sortOrder (chaîne) : Trier le résultat par DESC (valeur par défaut) ou ASC

Versions Java

API de versions Java - https://java.oraclecloud.com/javaReleases : Extrait une liste des versions Java publiques d'Oracle, telles que les versions d'UC, de fonctions et de correctifs. Pour chaque version de Java, cette API présente les informations suivantes :
  • artifactContentTypes : Fournit des détails tels que le nombre minimal de jours pendant lesquels une version Java est sous la référence de sécurité et si les commandes de téléchargement de script sont disponibles à partir de la page de téléchargement Java JMS.
  • jdkDetails : Fournit des détails sur les versions Java.
  • licenseDetails : Fournissez des détails tels que le nom d'affichage, le type de licence et l'URL de licence.
  • releaseDate : Fournit la date de publication d'une version JDK particulière.
  • releaseNotesUrl : Affiche l'URL de la version de JDK.
  • releaseType : Indique le type de version, par exemple UC, FONCTION ou PATCH_RELEASE.
  • releaseVersion : Fournit le numéro de version de la version Java particulière.
  • releaseFullVersion : Fournit une version complète, y compris le numéro de version de la version Java particulière, par exemple jdk-22.0.1+8.
  • securityStatus : Indique le statut de sécurité de la version, par exemple UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED ou UNKNOWN.

Paramètres d'entrée

  • jdkVersion (chaîne) : filtre le résultat par version Java majeure, telle que 8, 11, 17 ou 21
  • isSupportedVersion (booléen) : Filtre le résultat par statut de soutien Oracle. Valeur acceptée : <true>
  • isLts (booléen) : Filtre le résultat par statut de soutien à long terme. Valeurs acceptées : <true or false>
  • licenseType (chaîne) : filtre le résultat en fonction du type de licence, par exemple OTN ou NFTC
  • releaseType (chaîne) : filtre le résultat en fonction du type de version, par exemple CPU, FEATURE ou PATCH_RELEASE
  • releaseVersion (chaîne) : filtre le résultat par la version de Java
  • securityStatus (chaîne) : filtre le résultat en fonction du statut de sécurité, par exemple UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED ou UNKNOWN
  • daysUnderSecurityBaseline (entier) : Filtre le résultat en fonction du nombre de jours pendant lesquels il se trouve sous la référence de sécurité. 0 jour indique qu'il est à jour.
  • sortBy (chaîne) : trie le résultat par releaseDate (valeur par défaut), releaseVersion, jdkVersion ou licenseType
  • sortOrder (chaîne) : Trier le résultat par DESC (valeur par défaut) ou ASC

Version Java d'une version spécifique

Version Java de l'API de version spécifique - https://java.oraclecloud.com/javaReleases/<$releaseVersion> (utilisez la valeur releaseVersion de l'API https://java.oraclecloud.com/javaReleases pour voir les détails de cette version. Par exemple, https://java.oraclecloud.com/javaReleases/11.0.17 ou https://java.oraclecloud.com/javaReleases/1.8.0_421.

Cette API extrait des informations complètes sur cette version spécifique, y compris tous les artefacts disponibles pour cette version. Pour chaque version Java, l'API présente les propriétés des artefacts, telles que :

  • downloadFileSizeInBytes : Indique la taille du fichier de l'ensemble.
  • artifactType : Indique le type d'artefact, par exemple JDK, JRE ou SERVER_JRE.
  • osFamily : Indique le système d'exploitation correspondant de l'artefact, par exemple Linux, Windows ou macOS.
  • architecture : Indique l'architecture du système d'exploitation, par exemple aarch64, x64, sparcv9, i586 ou arm32.
  • packageType : Indique les types d'ensemble pris en charge, par exemple zip, exe, dmg, deb, rpm, tar.gz, msi ou tar.Z.
  • downloadCommand : Fournit la commande de téléchargement compatible avec les scripts qui vous permettra de télécharger l'ensemble à partir de la page de téléchargement Java JMS. Assurez-vous de fournir l'ID jeton correct pour un téléchargement transparent.
  • downloadUrl : fournit l'URL de téléchargement compatible avec les scripts que vous pouvez utiliser pour télécharger le paquetage à partir de la page de téléchargement Java JMS.
  • checksumCommand : Fournit la commande de téléchargement conviviale pour les scripts afin d'obtenir la somme de contrôle de l'artefact.
  • checksumUrl : Fournit l'URL de téléchargement avec la somme de contrôle correspondante.

Paramètres d'entrée

  • artifactType (chaîne) : Filtre les artefacts en fonction du type de contenu d'artefact pris en charge, par exemple JDK, JRE ou SERVER_JRE
  • osFamily (chaîne) : Filtre les artefacts par le système d'exploitation pris en charge, par exemple macOS, Windows, Linux ou Solaris
  • architecture (chaîne) : Filtre les artefacts en fonction de l'architecture du système d'exploitation prise en charge, par exemple aarch64, x64, sparcv9, i586 ou arm32
  • packageType (chaîne) : Filtre les artefacts en fonction du type d'ensemble d'artefacts pris en charge, par exemple zip, exe, dmg, deb, rpm, tar.gz, msi ou tar.Z
  • sortBy (chaîne) : trie le résultat par osFamily (valeur par défaut), architecture, artifactType ou packageType
  • sortOrder (chaîne) : Trie le résultat par DESC ou ASC (valeur par défaut)

Versions Java courantes

API des versions Java courantes - https://java.oraclecloud.com/currentJavaReleases : Extrait une liste des versions Java (UC, fonctions et correctifs) d'Oracle actuellement prises en charge. L'API répertorie toutes les versions conformes à la référence de sécurité, c'est-à-dire le champ securityStatus réglé à UP_TO_DATE. Pour chaque version de Java, cette API présente les informations suivantes :

  • artifactContentTypes : Fournit des détails tels que le nombre minimal de jours pendant lesquels une version Java est sous la référence de sécurité et si les commandes de téléchargement de script sont disponibles à partir de la page de téléchargement Java JMS.
  • jdkDetails : Fournit des détails sur les versions Java.
  • licenseDetails : Fournissez des détails tels que le nom d'affichage, le type de licence et l'URL de licence.
  • releaseDate : Fournit la date de publication d'une version JDK particulière.
  • releaseNotesUrl : Affiche l'URL de la version de JDK.
  • releaseType : Indique le type de version, par exemple UC, FONCTION ou PATCH_RELEASE.
  • releaseVersion : Fournit le numéro de version de la version Java particulière.
  • releaseFullVersion : Fournit une version complète, y compris le numéro de version de la version Java particulière, par exemple jdk-22.0.1+8.
  • securityStatus : Indique le statut de sécurité de la version, par exemple UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED ou UNKNOWN.

Paramètres d'entrée

  • jdkVersion (chaîne) : filtre le résultat par version Java majeure, telle que 8, 11, 17 ou 21
  • isSupportedVersion (booléen) : Filtre le résultat par statut de soutien Oracle. Valeur acceptée : <true>
  • isLts (booléen) : Filtre le résultat par statut de soutien à long terme. Valeurs acceptées : <true or false>
  • licenseType (chaîne) : filtre le résultat en fonction du type de licence, par exemple OTN ou NFTC
  • releaseType (chaîne) : filtre le résultat en fonction du type de version, par exemple CPU, FEATURE ou PATCH_RELEASE
  • sortBy (chaîne) : trie le résultat par releaseDate (valeur par défaut), releaseVersion, jdkVersion ou licenseType
  • sortOrder (chaîne) : Trier le résultat par DESC (valeur par défaut) ou ASC

Version Java actuelle d'une version Java spécifique

Version Java courante de l'API de version Java spécifique - https://java.oraclecloud.com/currentJavaReleases/<$jdkVersion> : Utilisez la valeur jdkVersion de l'API https://java.oraclecloud.com/javaVersions pour voir les détails de cette version. Par exemple - https://java.oraclecloud.com/currentJavaReleases/23.

Cette API extrait des informations complètes sur une version spécifique d'une version courante de Java. Pour chaque version de Java, cette API présente les informations suivantes :

  • downloadFileSizeInBytes : Indique la taille du fichier de l'ensemble.
  • artifactType : Indique le type d'artefact, par exemple JDK, JRE ou SERVER_JRE.
  • osFamily : Indique le système d'exploitation correspondant de l'artefact, par exemple Linux, Windows ou macOS.
  • architecture : Indique l'architecture du système d'exploitation, par exemple aarch64, x64, sparcv9, i586 ou arm32.
  • packageType : Indique les types d'ensemble pris en charge, par exemple zip, exe, dmg, deb, rpm, tar.gz, msi ou tar.Z.
  • downloadCommand : fournit la commande de téléchargement compatible avec les scripts qui vous permettra de télécharger le paquetage à partir de la page de téléchargement Java JMS. Assurez-vous de fournir l'ID jeton correct pour un téléchargement transparent.
  • downloadUrl : fournit l'URL de téléchargement compatible avec les scripts que vous pouvez utiliser pour télécharger le paquetage à partir de la page de téléchargement Java JMS.
  • checksumCommand : Fournit la commande de téléchargement conviviale pour les scripts afin d'obtenir la somme de contrôle de l'artefact.
  • checksumUrl : Fournit l'URL de téléchargement avec la somme de contrôle correspondante.

Paramètres d'entrée

  • artifactType (chaîne) : Filtre les artefacts en fonction du type de contenu d'artefact pris en charge, par exemple JDK, JRE ou SERVER_JRE
  • osFamily (chaîne) : Filtre les artefacts par le système d'exploitation pris en charge, par exemple macOS, Windows, Linux ou Solaris
  • architecture (chaîne) : Filtre les artefacts en fonction de l'architecture du système d'exploitation prise en charge, par exemple aarch64, x64, sparcv9, i586 ou arm32
  • packageType (chaîne) : Filtre les artefacts en fonction du type d'ensemble d'artefacts pris en charge, par exemple zip, exe, dmg, deb, rpm, tar.gz, msi ou tar.Z
  • sortBy (chaîne) : trie le résultat par osFamily (valeur par défaut), architecture, artifactType ou packageType
  • sortOrder (chaîne) : Trie le résultat par DESC ou ASC (valeur par défaut)

Utilisation des API REST Java

Vous pouvez utiliser les paramètres d'entrée de l'API Java pour filtrer et extraire uniquement les informations requises. Par exemple, pour filtrer uniquement les artefacts macOS aarch64 dans la version JDK 11.0.17, utilisez :
https://java.oraclecloud.com/javaReleases/11.0.17?osFamily=macos&architecture=aarch64
Pour télécharger la dernière plate-forme JDK 11 pour Linux aarch64 à partir de la page de téléchargement JMS Java, utilisez :
curl -H "token:<$token>" -L -O https://java.oraclecloud.com/java/11/latest/jdk-11_linux-aarch64_bin.tar.gz
Dans la commande de téléchargement, assurez-vous de fournir un ID jeton valide dans le champ <$token>.
Note

Le jeton est facultatif pour télécharger des versions Java sous licence NFTC. Les téléchargements sans jeton valide n'apparaîtront pas dans la production de rapports.

Vous pouvez également utiliser la commande checksum pour vérifier l'intégrité du package.