Azure / azure-rest-api-specs

The source for REST API specifications for Microsoft Azure.
MIT License
2.67k stars 5.1k forks source link

[FEATURE REQ] Need more detailed description for ResourceUriParameter #30116

Open ChenxiJiang333 opened 3 months ago

ChenxiJiang333 commented 3 months ago

API Spec link

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/monitor/common-types/v2/commonMonitoringTypes.json#L244

API Spec version

2024-02-01

Please describe the feature.

image The current description for ResourceUriParameter is too sample that may cause confusions, it's better include the expected format like: https://learn.microsoft.com/en-us/rest/api/resources/resources/get-by-id?view=rest-resources-2021-04-01#uri-parameters.

microsoft-github-policy-service[bot] commented 3 months ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @SameergMS, @dadunl.