MicrosoftDocs / feedback

📢 docs.microsoft.com site feedback
https://learn.microsoft.com
Creative Commons Attribution 4.0 International
239 stars 160 forks source link

getLocations API documenation is missing? #3271

Open adibiton opened 3 years ago

adibiton commented 3 years ago

Describe the bug We are using the following API call on our Portal UI code: https://management.azure.com/locations?api-version=2017-03-01 in order to fetch azure regions - however I can't find it on the documentation - the only API I can find is listing locations based on subscriptionId (https://docs.microsoft.com/en-us/rest/api/resources/subscriptions/listlocations). Is this API documented somewhere?

Desktop (please complete the following information):

welcome[bot] commented 3 years ago

Thank you for creating the issue! One of our team members will get back to you shortly with additional information. If this is a product issue, please close this and contact the particular product's support instead (see https://support.microsoft.com/allproducts for the list of support websites).

gewarren commented 3 years ago

@rloutlaw Can you answer about whether the getLocations API is documented?

rloutlaw commented 3 years ago

Thanks for the tag-in :)

The endpoint above isn't an Azure Resource Manager(ARM) REST API call-that's what we have documented over at docs.microsoft.com/rest/api/azure . I reviewed our list of API docs and I couldn't find one that corresponded to this API mentioned by @adibiton

If there is docs for this-it's not on docs.microsoft.com , and I would strongly suggest if possible to update the call to use the ARM APIs or (if you do not need the results in source code) to look at the docs for az account list-locations or Get-AzLocation.

adibiton commented 3 years ago

Thanks @rloutlaw I'm not sure I understood your replay - this API is being used by the (UI) Portal, is it not documented by design? is there an equ. call with ARM API?