Azure-docs: KeyVault Error responses page should reflect the actual API REST responses

[skeet70]

This page currently isn't very useful when writing error handling code that interacts with the API.

The common structure of errors that come back from the actual service seems to be { "error": { "code": "Unauthorized" | ???, "message": "Human readable message about problem" } }. More documentation about the possible error codes and possible other error structures (seems like sometimes something like { "error": "invalid_client", "error_description": "CODE: desc" } comes back) would be greatly appreciated.

Right now I'm just manually poking the API to try to write reasonable parsers for the different possible error codes. Something like https://docs.microsoft.com/en-us/rest/api/storageservices/common-rest-api-error-codes would be great.

---

Document Details

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

• ID: f100710e-39df-0ec7-60c2-cef95d7cde33
• Version Independent ID: da2e2e96-0b32-2bd8-1802-8023c404a6ab
• Content: REST API error codes - Azure Key Vault
• Content Source: articles/key-vault/rest-error-codes.md
• Service: key-vault
• GitHub Login: @msmbaldwin
• Microsoft Alias: mbaldwin

[SaurabhSharma-MSFT]

@skeet70 Thanks for the feedback ! I have assigned this issue to content author to investigate and update the document as appropriate.

[sebansal]

We are working on documenting.

[sebansal]

Added a new document to capture Key vault rest API error codes, will continue adding more here
https://docs.microsoft.com/en-us/azure/key-vault/general/common-error-codes

[sebansal]

please-close