Azure / Azure/azure-rest-api-specs
Spec for Certificates_CreateOrUpdate says reponse code as 200 instead of 202
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
Certificate generation using `Azure.ResourceManager.AppService` SDK is failing as mentioned in this [issue](https://github.com/Azure/azure-sdk-for-net/issues/37116). The certificate API is returning 202, but [rest-api-spec](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/web/resource-manager/Microsoft.Web/stable/2022-09-01/Certificates.json#L189#L193) says it will return 200. The certificate is getting created but since SDK only accepts 200, it throws error.
[Current Create Certificate Spec](https://github.com/Azure/azure-rest-api-specs/blob/main/specification/web/resource-manager/Microsoft.Web/stable/2022-09-01/Certificates.json#L189#L193)
```
"responses": {
"200": {
"description": "OK.",
"schema": {
"$ref": "#/definitions/Certificate"
}
}
```
The REST API Spec should be updated to indicate that it returns 202 for Certificate creation.
Contributor guide
Research direction
Open specification/web/resource-manager/Microsoft.Web/stable/2022-09-01/Certificates.json and inspect the Certificates_CreateOrUpdate response around lines 189–193. Compare the documented response with the linked API behavior and confirm the spec accepts the certificate creation response code. Done means the response documentation matches the API behavior and no other response details are changed.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- api
- Issue type
- Bug
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 55/100