api: Address issues with remote consoles APIs

* Add a note explaining presence of xvpvnc console type
* Make 'url' mandatory in create response
* Remove unnecessary description fields: we will populate these later
* De-deuplcate request body schemas
* Re-add references to the rdp console to the api-ref

Change-Id: I5555b8cf7a83fad689e98522850b5550b49566ed
Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
This commit is contained in:
Stephen Finucane
2025-06-10 10:46:58 +01:00
parent 485ee768d6
commit c4f81a54d5
5 changed files with 73 additions and 122 deletions
+8 -5
View File
@@ -5986,17 +5986,20 @@ remote_console:
remote_console_protocol:
description: |
The protocol of remote console. The valid values are ``vnc``, ``spice``,
``serial`` and ``mks``. The protocol ``mks`` is added since Microversion
``2.8``.
``rdp``, ``serial`` and ``mks``. The protocol ``mks`` is added since
Microversion ``2.8``. The protocol ``rdp`` requires the Hyper-V driver
which was removed in the 29.0.0 (Caracal) release.
in: body
required: true
type: string
remote_console_type:
description: |
The type of remote console. The valid values are ``novnc``,
``spice-html5``, ``spice-direct``, ``serial``, and ``webmks``. The type
``webmks`` was added in Microversion ``2.8``, and the type
``spice-direct`` was added in Microversion ``2.99``.
``rdp-html5``, ``spice-html5``, ``spice-direct``, ``serial``, and
``webmks``. The type ``webmks`` was added in Microversion ``2.8`` and the
type ``spice-direct`` was added in Microversion ``2.99``. The type
``rdp-html5`` requires the Hyper-V driver which was removed in the 29.0.0
(Caracal) release.
in: body
required: true
type: string