Azure / Azure/azure-rest-api-specs

Spec for Certificates_CreateOrUpdate says reponse code as 200 instead of 202

Open
#25,620 1 comment 2 reactions 0 assignees View on GitHub
customer-reported question Service Attention
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

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.