azure-docs icon indicating copy to clipboard operation
azure-docs copied to clipboard

Unclear API Endpoint

Open desireewilliams opened this issue 2 years ago • 4 comments

All of the documentation and examples start the endpoint description at /kv and there is nothing that indicates what the begining of the endpoint should be. My Assumption was /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.AppConfiguration/configurationStores/{app-config-store-name}/kv, however all I get back is 404's. Where is this endpoint?


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

desireewilliams avatar Oct 28 '22 16:10 desireewilliams

@desireewilliams Thanks for your feedback! We will investigate and update as appropriate.

AjayBathini-MSFT avatar Oct 29 '22 04:10 AjayBathini-MSFT

@desireewilliams The Prerequisites section documents cover it. The endpoint is https://{myconfig}.azconfig.io/kv and all the REST endpoint follows the same.

https://{yourwebconfigurationresourcename}.azconfig.io/kv

Let me know if you have any queries or concerns.

MayankBargali-MSFT avatar Oct 31 '22 05:10 MayankBargali-MSFT

@MayankBargali-MSFT thank you for pointing out where the document was. However, I started over in the Azure RM REST API documentation, and followed a link trail over to here. Versioning, in the context of where I was, was 2022-05-01, and the beginning of the URL was in the overview, not in what I would assume to be a changelog. Unless you know it's there, you have to spend a bit of time searching for it.

desireewilliams avatar Oct 31 '22 15:10 desireewilliams

@maud-lv Can you please provide your input.

MayankBargali-MSFT avatar Nov 02 '22 12:11 MayankBargali-MSFT

@desireewilliams, thanks for the feedback. I hope this PR #102013 can make it a bit clearer.

zhenlan avatar Nov 28 '22 21:11 zhenlan

It is clearer, thank you!

desireewilliams avatar Nov 28 '22 21:11 desireewilliams