549fe62bba
This provides the verification of the action console output. * Return codes updated based on what's in the code * Parameters fixed (length -1 is not actually a thing, it's suggestion for future enhancement; console output described; server_id should be in path). * Add preamble for request example * Clean up language on preamble Part of bp:api-ref-in-rst Change-Id: I7071a1e528b0aa8df16589facee4ed4fd62f7b4b
47 lines
1.1 KiB
ReStructuredText
47 lines
1.1 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
Show Console Output (Os-Getconsoleoutput Action)
|
|
================================================
|
|
|
|
.. rest_method:: POST /v2.1/{tenant_id}/servers/{server_id}/action
|
|
|
|
Shows console output for a server instance.
|
|
|
|
This returns the text of the console since boot in a REST
|
|
response. The console content may be large, you can limit it with the
|
|
optional ``length`` parameter.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403),
|
|
notFound(404), conflict(409), methodNotImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- tenant_id: tenant_id
|
|
- server_id: server_id_path
|
|
- os-getConsoleOutput: os-getConsoleOutput
|
|
- length: length
|
|
|
|
**Example Get console output**
|
|
|
|
This requests the last 50 lines of the server in question.
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-console-output/console-output-post-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- output: console_output
|
|
|
|
**Example Get console output: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-console-output/console-output-post-resp.json
|
|
:language: javascript
|