Merge "docs: using the correct format and real world example for fault message"

api-guide/source/faults.rst

@@ -64,10 +64,9 @@ information about the fault in the body of the response.
 .. code::
 
     {
-       "computeFault":{
+       "itemNotFound":{
-          "code":500,
+          "code": 404,
-          "message":"Fault!",
+          "message":"Aggregate agg_h1 could not be found."
-          "details":"Error Details..."
        }
     }
 
@@ -126,10 +125,10 @@ created timestamp that specify when the fault occurred.
                 "id": "52415800-8b69-11e0-9b19-734f216543fd"
             },
             "fault" : {
-                "code" : 404,
+                "code" : 500,
                 "created": "2010-08-10T11:59:59Z",
-                "message" : "Could not find image 52415800-8b69-11e0-9b19-734f6f007777",
+                "message": "No valid host was found. There are not enough hosts available.",
-                "details" : "Fault details"
+                "details": [snip]
             },
             "links": [
                 {