Using Azul Zing Metadata API
Table of Contents
This section explains how to use the Azul Metadata API for Azul Zing Builds of OpenJDK (Zing).
About the API
The Azul Metadata API is a free utility for viewing metadata and downloading Azul Zing Builds of OpenJDK (Zing). Documentation on API endpoints can be found on api.azul.com/metadata/v1/docs/swagger.
Via the Swagger UI, the API can be called to try the various APIs and filtering options, and also presents you with the CURL command to get the same results through the terminal.
Searching a Zing Version
|
Note
|
This is just an example at the time of the document being written. You may see a different output depending on the currently available Java versions. |
For instance, to find the Zing downloads with the following criteria:
-
java_version:17 -
os:Ubuntu -
arch:arm
the following CURL command is returned:
curl -X GET \
"https://api.azul.com/metadata/v1/zing/packages/?java_version=17&os=ubuntu&arch=arm&java_package_type=jdk&release_status=ga&availability_types=CA&certifications=tck&page=1&page_size=100" \
-H "accept: application/json"
This returns the following result:
[
{
"build_type": "stream",
"distro_build_number": 5,
"distro_version": [
24,
8,
0,
0
],
"download_url": "https://cdn.azul.com/zing-zvm/ZVM24.08.0.0/zing24.08.0.0-5-jdk17.0.12-linux.aarch64.rpm",
"java_version": [
17,
0,
12
],
"latest": true,
"name": "zing24.08.0.0-5-jdk17.0.12-linux.aarch64.rpm",
"openjdk_build_number": 7,
"package_uuid": "0969bebb-3d2a-47c7-979b-99018f852c17",
"product": "zing"
},
...
]
Download Zing
The returned data contains the download_url field that contains a direct link to the download file of the Zing version.
In case of the previous example:
"download_url": "https://cdn.azul.com/zing-zvm/ZVM24.08.0.0/zing24.08.0.0-5-jdk17.0.12-linux.aarch64.rpm"
Data Model
The Swagger UI also provides more info about the JSON data model that is returned by the API and can be opened to learn more about all the fields.
