diff --git a/api-guide/source/faults.rst b/api-guide/source/faults.rst index d8cf0638895e..8a88fa429e72 100644 --- a/api-guide/source/faults.rst +++ b/api-guide/source/faults.rst @@ -109,8 +109,24 @@ Instance Faults Nova often adds an instance fault DB entry for an exception that happens while processing an API request. This often includes more administrator -focused information, such as a stack trace. -However, there is currently no API to retrieve this information. +focused information, such as a stack trace. For a server with status +``ERROR`` or ``DELETED``, a ``GET /servers/{server_id}`` request will include +a ``fault`` object in the response body for the ``server`` resource. For +example:: + + GET https://10.211.2.122/compute/v2.1/servers/c76a7603-95be-4368-87e9-7b9b89fb1d7e + { + "server": { + "id": "c76a7603-95be-4368-87e9-7b9b89fb1d7e", + "fault": { + "created": "2018-04-10T13:49:40Z", + "message": "No valid host was found.", + "code": 500 + }, + "status": "ERROR", + ... + } + } Notifications -------------