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

Enable function lock for F1-F12 on HP ZBook mobile workstations

Image
When you press the function keys on a HP ZBook mobile workstation you may find that they don't operate as expected. This is because of function lock, if you hold the fn key the function keys work as expected. You can lock the function keys on as described in this document. https://support.hp.com/gb-en/document/c02035108 However there are two things to note Firstly following a BIOS upgrade (which occurs automatically if you have the preinstalled HP software still installed) you may lose your locked function keys and have to reapply.   Secondly the HP documentation states you press the fn lock and fn keys at the same time as per the image below from the page.  While you're here - Why not check out our Windows Server Documentation and Audit Tool? This is not the case, you need to press and hold the fn key, and then tap the fn lock key to toggle function lock, not an obvious thing when you start work first thing in the morning and are hammering the function keys try
Read more