nova/api-ref/source/servers-action-console-outp...

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