The purpose of the API is to provide programmatic access to accurate versioning data for various platforms.
If you write a lot of scripts or custom code which needs to find the latest version of something, then hopefully this API can help.
For example, if you know your current ESXi build but want to programmatically check if this is the latest version or not, then you can send a simple HTTP GET request to this API to get the latest build number into your code for comparison.
Please be aware that the API is in BETA.
Since the API is under relatively low load, I have decided not to require any access tokens, headers, signup or authentication. If I need to limit request frequencies in the future then this may change of course.
The following systems are included and I will commit to keeping the data up to date within 1 working day. I gather much of the data automatically but I expect that I may need to intervene manually at times while I’m building the API features up.
The “systems” which you can query are in the list of supported platforms below. Please use these values in your API queries:
Solution | API value |
VMware ESXi | esxi |
VMware vCenter Server | vcenter |
Vmware Horizon | horizon |
VMware NSX for vSphere | nsx_vsphere |
VMware Site Recovery Manager – Appliance | srm_appliance |
VMware vRealize Automation – Appliance | vra_appliance |
VMware vRealize Orchestrator – Appliance | vro_appliance |
VMware vRealize Operations Manager | vrops |
VMware vSphere Replication | vr |
Not much required here, use the sample request below for an idea on how to use the API.
Simply send a HTTP GET request to http://api.virtualg.uk/system/vcenter
Change vcenter to the desired system type which you want to return the latest version information for (See supported API values in the table above)
Example in PowerShell:
$url = "http://api.virtualg.uk/system/vcenter" $result = Invoke-WebRequest $url -Method GET | ConvertFrom-Json Write-Host $result.latest_release_name Write-Host $result.latest_release_build Write-Host $result.latest_release_date
This will return a JSON formatted response. There are currently 3 things returned:
vCenter Server 7.0 Update 1 16860138 2020-10-06
I am 100% committed to improving this system over time. Please send me any feedback you have which will make the system better or more useful for you.
I am looking to add functionality for non-VMware systems soon, let me know what you would like to see!
I will do my best to add new systems within 1 working day.
I’ll tweet about updates via @VirtualG_UK or you can subscribe to the mailing list to keep up to date with this and other activities on the blog.
This is a project built for use by the IT community. Please don’t rely on this for any commercial purposes etc
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.