Azure / Azure/azure-rest-api-specs

[BUG] The definition of AppService in Swagger is inconsistent with the value returned by the Service.

Open
#40,887 0 comments 0 reactions 0 assignees View on GitHub
App Services bug
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

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.