azure-docs icon indicating copy to clipboard operation
azure-docs copied to clipboard

Confusing statement around error codes

Open drwharris opened this issue 2 years ago • 1 comments

The details for "status" state

An HTTP response status codes-like number, and must be 409

Is 409 the only code? or are other 400 codes also acceptable?


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

drwharris avatar Feb 15 '23 00:02 drwharris

@drwharris Thanks for your feedback! We will investigate and update as appropriate.

Naveenommi-MSFT avatar Feb 15 '23 01:02 Naveenommi-MSFT

@drwharris The http code is different from the status value in the json (body) response. The http status code can be anything of the form 4xx, but the status value in the json response need to be 409. I hope this clarify your query.

YashikaTyagii avatar Feb 20 '23 03:02 YashikaTyagii

status

Is the documentation being updated? or are you just commenting here?

The current description for status appears to be trying to detail internal functionality which is just confusing. At this point in time, the only valid value is 409 so just state that.

This "An HTTP response status codes-like number, and must be 409" Should be changed to "Currently only accepts 409"

drwharris avatar Feb 21 '23 01:02 drwharris