Azure / Azure/azure-rest-api-specs

The `responses` property of `WebApps_Get` operation should not include `404`

Open
#9,734 2 comments 0 reactions 0 assignees View on GitHub
Service Attention Web Apps
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
3d 2h
Merged PRs (30d)
424

Description

Original issue: https://github.com/terraform-providers/terraform-provider-azurerm/issues/2704

Problematic swagger: https://github.com/Azure/azure-rest-api-specs/blob/09ac2b33d780dbf2f74de2083012f62aaa33c451/specification/web/resource-manager/Microsoft.Web/stable/2019-08-01/WebApps.json#L130

A `GET` operation is supposed to return explicit errors when the client received `404` which indicates the resource does not exist, and it would never be the result that the client is expecting.

Contributor guide

Open the contributing guide

Research direction

Open the linked Microsoft.Web stable 2019-08-01 WebApps.json at the WebApps_Get operation around line 130 and inspect its responses definition. Confirm that the 404 response is listed there, then update the specification so the operation no longer includes it and run the repository's relevant specification validation. Done means the WebApps_Get responses match the stated GET error behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.