Azure / Azure/azure-rest-api-specs

ProviderResourceType has `properties` field and needs additional context info

Open
#22,635 2 comments 0 reactions 0 assignees View on GitHub
customer-reported question Service Attention
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.