Azure / Azure/azure-rest-api-specs
ProviderResourceType has `properties` field and needs additional context info
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
The specification has **Properties** field defined in ProviderResourceType but was not returned for any of resource providers such as Microsoft.ApiManagement, Microsoft.Network etc. when querying through Rest API https://learn.microsoft.com/en-us/rest/api/resources/provider-resource-types/list?tabs=HTTP.
Any additional context about this field in the documentation would really help.
https://github.com/Azure/azure-rest-api-specs/blob/0ab32bfd501f969be8c080f841def7efef133de7/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/resources.json#L5048-L5055
Contributor guide
Research direction
Open specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/resources.json at ProviderResourceType, especially lines 5048-5055, and compare the Properties field with the provider-resource-types/list REST response for Microsoft.ApiManagement or Microsoft.Network. Document what additional context the field needs and why it is not returned; done means the specification explains this behavior clearly.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100