Visit Azul.com Support

Using Azul Zing Metadata API

Table of Contents
Need help?
Schedule a consultation with an Azul performance expert.
Contact Us

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.

Note
By using an authentication key, this API can also be used by Azul Customers to download Stable builds of Zing. Contact [email protected] to receive your personal key.

OpenAPI

You can also use the Metadata Swagger UI on api.azul.com to try the various APIs and filtering options. This will also present you with the CURL command to get the same results through the terminal.

Example: Searching a Zing Version

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:

Note
This is an example at the time of the document being written. You may see a different output depending on the currently available Java versions.
 
[ { "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" }, ... ]

Downloading Zing

The returned data contains the download_url field that contains a direct link to the download file of the Zing version.

Based on the output of the search example above:

 
"download_url": "https://cdn.azul.com/zing-zvm/ZVM24.08.0.0/zing24.08.0.0-5-jdk17.0.12-linux.aarch64.rpm"