Azure / Azure/azure-rest-api-specs
[BUG] The definition of AppService in Swagger is inconsistent with the value returned by the Service.
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 424
Description
### API Spec link
https://github.com/Azure/azure-rest-api-specs/blob/0d9b77817effe915b68e20d1a1830bf3b682cbd3/specification/web/resource-manager/Microsoft.Web/AppService/stable/2021-02-01/WebApps.json#L4764
### API Spec version
2021-02-01
### Describe the bug
There is two customer issue related:
https://github.com/Azure/azure-sdk-for-net/issues/50743
https://github.com/Azure/azure-sdk-for-net/issues/37585
Request:
GET /subscriptions/<>/resourceGroups/<>/providers/Microsoft.Web/sites/<>/hybridconnection/<>?api-version=2021-02-01
Response:
{"id":"sdktest456","name":"Microsoft.Web/sites","type":"East US"}
The Type here is mismatch for resourceType. Or the whole response is incorrect.
### Expected behavior
{"id":"","name":"sdktest456","type":"Microsoft.Web/sites","location":"East US"}
### Actual behavior
{"id":"sdktest456","name":"Microsoft.Web/sites","type":"East US"}
### Reproduction Steps
Request:
GET /subscriptions/<>/resourceGroups/<>/providers/Microsoft.Web/sites/<>/hybridconnection/<>?api-version=2021-02-01
### Environment
_No response_
Contributor guide
Research direction
Start with specification/web/resource-manager/Microsoft.Web/AppService/stable/2021-02-01/WebApps.json at line 4764 and compare the AppService definition with the documented request and response. Review the linked azure-sdk-for-net issues for context, then verify the expected and actual payload shapes; done means the specification accurately matches the service response or the discrepancy is clarified.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- api
- Issue type
- Bug
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 42/100