Azure / Azure/azure-rest-api-specs
What is the difference between FileShare and FileShareItem?
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
https://github.com/Azure/azure-rest-api-specs/blob/4af52aaac2c3b4af4a0e61378d33c5bc050e65e2/specification/storage/resource-manager/Microsoft.Storage/stable/2023-01-01/file.json#L723
In list result, FileShareItem is returned. And we need to convert it to FileShare. I don't see any difference between these two types except the name of property field. Can we return the FileShare in list results? thanks!
related: https://github.com/Azure/azure-sdk-for-go/issues/21859
Contributor guide
Research direction
Read specification/storage/resource-manager/Microsoft.Storage/stable/2023-01-01/file.json around line 723, then compare the FileShare and FileShareItem definitions and their list-result usage. Done means documenting the distinction and reaching an agreed decision on whether the list result should use FileShare.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- api
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100