[Doc] API Content Gaps

As a result of time spent within stx-fault, there are API reference content
gaps:

- "The API document should be modified to match the description returned from
  API query": changed both the name of the desciption.
- "Wrong "links" reference: changed to existing StarlingX stx-fault API
  reference.
- Additional: Remove <U+200B> character.

More Information:

- [Starlingx-discuss] API requests: stx-fault [0]
- Etherpad StarlingX APIs Review [1]

[0] http://lists.starlingx.io/pipermail/starlingx-discuss/2018-December/002150.html
[1] https://etherpad.openstack.org/p/stx-apis

Story: 2004877
Task: 29153

Change-Id: Ifb3da9492b74b4ecf7be265294af5d2e604d56e5
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
This commit is contained in:
Abraham Arce 2019-01-28 07:40:36 -06:00
parent 6493976162
commit d911b3972a
1 changed files with 7 additions and 7 deletions

View File

@ -51,8 +51,8 @@ itemNotFound (404)
] ]
} }
], ],
"description":"StarlingX Fault API allows for the management of physical servers. This includes inventory collection and configuration of hosts, ports, interfaces, CPUs, disk, memory, and system configuration. The API also supports the configuration of the cloud's SNMP interface. ", "description":"Fault Management is an OpenStack project which provides REST API services for alarms and logs.",
"name":"stx-fault API" "name":"Fault Management API"
} }
This operation does not accept a request body. This operation does not accept a request body.
@ -88,7 +88,7 @@ itemNotFound (404)
"rel": "self" "rel": "self"
}, },
{ {
"href": "http://www.windriver.com/developer/fm/dev/api-spec-v1.html", "href": "https://docs.starlingx.io/api-ref/stx-fault/index.html",
"type": "text/html", "type": "text/html",
"rel": "describedby" "rel": "describedby"
} }
@ -211,7 +211,7 @@ itemNotFound (404)
Shows information about a specific alarm Shows information about a specific alarm
****************************************** ******************************************
.. rest_method:: GET /v1/alarms/{alarm_uuid} .. rest_method:: GET /v1/alarms/{alarm_uuid}
**Normal response codes** **Normal response codes**
@ -282,7 +282,7 @@ This operation does not accept a request body.
Deletes a specific alarm Deletes a specific alarm
************************** **************************
.. rest_method:: DELETE /v1/alarms/{alarm_uuid} .. rest_method:: DELETE /v1/alarms/{alarm_uuid}
NOTE Typically this command should NOT be used. I.e typically alarms NOTE Typically this command should NOT be used. I.e typically alarms
will be and should be cleared by the system when the alarm condition will be and should be cleared by the system when the alarm condition
@ -438,7 +438,7 @@ itemNotFound (404)
Shows information about a specific event log Shows information about a specific event log
********************************************** **********************************************
.. rest_method:: GET /v1/event_log/{log_uuid} .. rest_method:: GET /v1/event_log/{log_uuid}
**Normal response codes** **Normal response codes**
@ -602,7 +602,7 @@ This operation does not accept a request body.
Modifies the value of an event suppression Modifies the value of an event suppression
******************************************** ********************************************
.. rest_method:: PATCH /v1/event_suppression/{event_suppression_uuid} .. rest_method:: PATCH /v1/event_suppression/{event_suppression_uuid}
**Normal response codes** **Normal response codes**