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 la CPU de juillet 2019. Ces API RESTful offrent un accès aux données de version Java essentielles, ce qui permet aux administrateurs système d'intégrer les informations de version Java de manière transparente dans leurs workflows opérationnels.

Les API sont accessibles via le domaine java.oraclecloud.com et peuvent être utilisées sans authentification ni autorisation. Ils fournissent également des commandes de téléchargement convivial de script pour télécharger la version Java requise via le téléchargement Java JMS.

API REST Java

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

Versions Java

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

  • docUrl : fournit l'URL de documentation.
  • endOfSupportLifeDate : fournit la date de fin de prise en charge de la version de Java.
  • jdkVersion : fournit le numéro de version du kit JDK.
  • isSupportedVersion : indique si la version de JDK est prise en charge. Les valeurs disponibles sont True et False.
  • 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 disponibles sont True et False.

Paramètres d'entrée

  • jdkVersion (chaîne) : filtre le résultat en fonction de la version majeure de Java telle que 8, 11, 17 ou 21
  • isSupportedVersion (booléen) : filtre le résultat en fonction du statut du support technique Oracle. Valeur acceptée : <true>
  • isLts (booléen) : filtre le résultat en fonction du statut de prise en charge à 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) : triez le résultat par DESC (valeur par défaut) ou ASC

Versions de Java

API des versions Java - https://java.oraclecloud.com/javaReleases : extrait la liste des versions Java d'Oracle publiquement disponibles, telles que les versions CPU, Feature et Patch. 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 de Java figure sous la ligne de base de sécurité et si des commandes de téléchargement de script sont disponibles à partir de la page de téléchargement de Java JMS.
  • jdkDetails : fournit des détails sur les versions Java.
  • licenseDetails : fournit 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 de JDK particulière.
  • releaseNotesUrl : affiche l'URL de la version de JDK.
  • releaseType : indique le type de version (UC, FEATURE ou PATCH_RELEASE, par exemple).
  • releaseVersion : fournit le numéro de version de la version Java particulière.
  • releaseFullVersion : fournit la version complète, y compris le numéro de build de la version Java particulière, par exemple, jdk-22.0.1+8.
  • securityStatus : indique le statut de sécurité de la version, tel que UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED ou UNKNOWN.

Paramètres d'entrée

  • jdkVersion (chaîne) : filtre le résultat en fonction de la version majeure de Java telle que 8, 11, 17 ou 21
  • isSupportedVersion (booléen) : filtre le résultat en fonction du statut du support technique Oracle. Valeur acceptée : <true>
  • isLts (booléen) : filtre le résultat en fonction du statut de prise en charge à long terme. Valeurs acceptées : <true or false>
  • licenseType (chaîne) : filtre le résultat en fonction du type de licence, tel que OTN ou NFTC
  • releaseType (chaîne) : filtre le résultat en fonction du type de version, tel que CPU, FEATURE ou PATCH_RELEASE
  • releaseVersion (chaîne) : filtre le résultat en fonction de la version de Java
  • securityStatus (chaîne) : filtre le résultat en fonction du statut de sécurité, tel que UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED ou UNKNOWN
  • daysUnderSecurityBaseline (entier) : filtre le résultat en fonction du nombre de jours 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) : triez le résultat par DESC (valeur par défaut) ou ASC

Version de Java 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 visualiser 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 de Java, l'API présente les propriétés des artefacts, telles que :

  • downloadFileSizeInBytes : indique la taille de fichier du package.
  • artifactType : indique le type d'artefact, tel que JDK, JRE ou SERVER_JRE.
  • osFamily : indique le système d'exploitation correspondant de l'artefact, tel que Linux, Windows ou macOS.
  • architecture : indique l'architecture du système d'exploitation, telle que aarch64, x64, sparcv9, i586 ou arm32.
  • packageType : indique les types de package pris en charge, tels que zip, exe, dmg, deb, rpm, tar.gz, msi ou tar.Z.
  • downloadCommand : fournit la commande de téléchargement convivial de script qui vous permet de télécharger le package à partir de la page de téléchargement Java JMS. Assurez-vous de fournir un ID de jeton correct pour un téléchargement transparent.
  • downloadUrl : fournit l'URL de téléchargement conviviale de script que vous pouvez utiliser pour télécharger le package à partir de la page de téléchargement Java JMS.
  • checksumCommand : fournit la commande de téléchargement conviviale de script pour 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, tel que JDK, JRE ou SERVER_JRE
  • osFamily (chaîne) : filtre les artefacts en fonction du système d'exploitation pris en charge, tel que macOS, Windows, Linux ou Solaris
  • architecture (chaîne) : filtre les artefacts en fonction de l'architecture de système d'exploitation prise en charge, telle que aarch64, x64, sparcv9, i586 ou arm32
  • packageType (chaîne) : filtre les artefacts en fonction du type de package d'artefact pris en charge, tel que 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 actuelles de Java

API des versions Java actuelles - https://java.oraclecloud.com/currentJavaReleases : extrait la liste des versions Java Oracle actuellement prises en charge (versions CPU, Feature et Patch). L'API répertorie toutes les versions conformes à la référence de sécurité, à savoir l'ensemble de champs securityStatus défini sur 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 de Java figure sous la ligne de base de sécurité et si des commandes de téléchargement de script sont disponibles à partir de la page de téléchargement de Java JMS.
  • jdkDetails : fournit des détails sur les versions Java.
  • licenseDetails : fournit 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 de JDK particulière.
  • releaseNotesUrl : affiche l'URL de la version de JDK.
  • releaseType : indique le type de version (UC, FEATURE ou PATCH_RELEASE, par exemple).
  • releaseVersion : fournit le numéro de version de la version Java particulière.
  • releaseFullVersion : fournit la version complète, y compris le numéro de build de la version Java particulière, par exemple, jdk-22.0.1+8.
  • securityStatus : indique le statut de sécurité de la version, tel que UP_TO_DATE, UPDATE_REQUIRED, UPGRADE_REQUIRED ou UNKNOWN.

Paramètres d'entrée

  • jdkVersion (chaîne) : filtre le résultat en fonction de la version majeure de Java telle que 8, 11, 17 ou 21
  • isSupportedVersion (booléen) : filtre le résultat en fonction du statut du support technique Oracle. Valeur acceptée : <true>
  • isLts (booléen) : filtre le résultat en fonction du statut de prise en charge à long terme. Valeurs acceptées : <true or false>
  • licenseType (chaîne) : filtre le résultat en fonction du type de licence, tel que OTN ou NFTC
  • releaseType (chaîne) : filtre le résultat en fonction du type de version, tel que 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) : triez le résultat par DESC (valeur par défaut) ou ASC

Version actuelle de Java d'une version de Java spécifique

Version Java en cours 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 visualiser 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 en cours de Java. Pour chaque version de Java, cette API présente les informations suivantes :

  • downloadFileSizeInBytes : indique la taille de fichier du package.
  • artifactType : indique le type d'artefact, tel que JDK, JRE ou SERVER_JRE.
  • osFamily : indique le système d'exploitation correspondant de l'artefact, tel que Linux, Windows ou macOS.
  • architecture : indique l'architecture du système d'exploitation, telle que aarch64, x64, sparcv9, i586 ou arm32.
  • packageType : indique les types de package pris en charge, tels que zip, exe, dmg, deb, rpm, tar.gz, msi ou tar.Z.
  • downloadCommand : fournit la commande de téléchargement convivial de script qui vous permet de télécharger le package à partir de la page de téléchargement Java JMS. Assurez-vous de fournir un ID de jeton correct pour un téléchargement transparent.
  • downloadUrl : fournit l'URL de téléchargement conviviale de script que vous pouvez utiliser pour télécharger le package à partir de la page de téléchargement Java JMS.
  • checksumCommand : fournit la commande de téléchargement conviviale de script pour 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, tel que JDK, JRE ou SERVER_JRE
  • osFamily (chaîne) : filtre les artefacts en fonction du système d'exploitation pris en charge, tel que macOS, Windows, Linux ou Solaris
  • architecture (chaîne) : filtre les artefacts en fonction de l'architecture de système d'exploitation prise en charge, telle que aarch64, x64, sparcv9, i586 ou arm32
  • packageType (chaîne) : filtre les artefacts en fonction du type de package d'artefact pris en charge, tel que 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)

Utiliser 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 de Java JMS, utilisez la commande suivante :
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 de jeton valide dans le champ <$token>.
Remarque

Le jeton est facultatif pour le téléchargement de versions Java sous licence NFTC. Les téléchargements sans jeton valide n'apparaîtront pas dans Reporting.

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