How to programatically identify the latest stable REST API version of Azure management REST

If you are making direct calls to the Azure REST API you notice that you need to provide the API version for that specific REST endpoint.

Sometimes the version provided in the Microsoft documentation is wrong.


If you provide an invalid API version you receive an error message that contains the available API versions.

However, should you wish to programatically determine the current latest API version you can use the providers API.

https://learn.microsoft.com/rest/api/resources/providers

For example if you would like to know the latest Web Apps API version you can call the providers API and provide the namespace in which the Web Apps API resides (the provider API version is currently 2021-04-01).

https://management.azure.com/providers/Microsoft.Web?api-version=2021-04-01

As you can see from the results here shown in Postman there is a resource type of "Sites" (again Microsoft are a bit inconsistent in their naming between the API and the documentation - web apps are infact "sites" in the REST API).

You can see the current API version is 2023-01-01 (not what is shown in the documentation).



The equivilant in the Azure Az PowerShell cmdlets would be the Get-AzResourceProvider cmdlet.

Get-AzResourceProvider -ProviderNamespace "Microsoft.Web"



Comments

Post a Comment

Popular posts from this blog

Windows Server 2016, 2019, 2022, Windows 10 and Windows 11: Date and time "Some settings are managed by your organization".

Image
When you're using the new "Modern" date and time settings in Windows Server 2016, 2019, 2022, Windows 10 and Windows 11 you may find that you can't set the correct date and time and the value "Some settings are managed by your organization". - While you're here - Why not check out our Windows Server Documentation and Audit Tool? The simplest way around this is to go back to the proper control panel using Start, Run, "Control.exe" and searching for "Set the date".  Within here you can set the date and time manually as required If you try and click the Change time zone button you may again get access denied... To resolve this open an elevated command prompt by right clicking the command prompt and selecting Run as Administrator  From there run the command rundll32.exe shell32.dll,Control_RunDLL timedate.cpl This will open the Data and Time control panel app elevated as an Administrator.
Read more

TFTPD32 or TFTPD64 reports Bind error 10013 An attempt was made to access a socket in a way forbidden by its access permissions.

Image
When you start the trivial FTP (TFTP) server application TFTPD32 or TDTPD64 you may see the following error Bind error 10013 An attempt was made to access a socket in a way forbidden by its access permissions. This can be because another application is using this port. The easiest way to check if (and which) application is using the port is as administrator run an elevated command prompt and enter netstat -anb > ports.txt Then open ports.txt in Notepad and search for :69, you'll quickly be able to see the process using the required port - While you're here - Why not check out our Windows Server Documentation and Audit Tool?
Read more

Windows Server 2019 desktop icons such as My Computer, Windows cannot access the specified device, path, or file.

Image
In Windows Server 2019 you may notice that the desktop icons such as My Computer are missing, however when you goto Personalization > Themes > Desktop icon settings You see the error Windows cannot access the specified device, path, or file. You may not have the appropriate permissions to access the item. The quickest way to resolve this is to ignore the modern UI and desk.cpl ,5 From here you can easily add the My Computer icon - While you're here - Why not check out our Windows Server Documentation and Audit Tool?
Read more