6.268. VmGraphicsConsole

가상 머신의 그래픽 콘솔 구성을 검색합니다.

GET /ovit-engine/api/vms/123/graphicsconsoles/456?current=true

원격viewer 클라이언트와 호환되는 파일을 생성합니다.

다음 요청을 사용하여 그래픽 콘솔의 원격 뷰어 연결 파일을 생성합니다. 이 작업은 가상 머신이 실행 중인 경우에만 파일이 생성됩니다.

POST /ovirt-engine/api/vms/123/graphicsconsoles/456/remoteviewerconnectionfile

remoteviewerconnectionfile 작업에서는 작업별 매개 변수를 사용하지 않으므로 요청 본문에 빈 작업이 포함되어야 합니다.

<action/>

응답에는 remote-viewer 클라이언트와 함께 사용할 수 있는 파일이 포함되어 있습니다.

<action>
  <remote_viewer_connection_file>
    [virt-viewer]
    type=spice
    host=192.168.1.101
    port=-1
    password=123456789
    delete-this-file=1
    fullscreen=0
    toggle-fullscreen=shift+f11
    release-cursor=shift+f12
    secure-attention=ctrl+alt+end
    tls-port=5900
    enable-smartcard=0
    enable-usb-autoshare=0
    usb-filter=null
    tls-ciphers=DEFAULT
    host-subject=O=local,CN=example.com
    ca=...
  </remote_viewer_connection_file>
</action>

예를 들어 원격 뷰어 연결 파일의 내용을 가져와서 임시 파일에 저장하려면 사용자는 다음과 같이 oVirt Python SDK를 사용할 수 있습니다.

# Find the virtual machine:
vm = vms_service.list(search='name=myvm')[0]

# Locate the service that manages the virtual machine, as that is where
# the locators are defined:
vm_service = vms_service.vm_service(vm.id)

# Find the graphic console of the virtual machine:
graphics_consoles_service = vm_service.graphics_consoles_service()
graphics_console = graphics_consoles_service.list()[0]

# Generate the remote viewer connection file:
console_service = graphics_consoles_service.console_service(graphics_console.id)
remote_viewer_connection_file = console_service.remote_viewer_connection_file()

# Write the content to file "/tmp/remote_viewer_connection_file.vv"
path = "/tmp/remote_viewer_connection_file.vv"
with open(path, "w") as f:
    f.write(remote_viewer_connection_file)

원격 뷰어 연결 파일을 만들 때 다음과 같이 가상 머신 그래픽 콘솔에 연결할 수 있습니다.

#!/bin/sh -ex

remote-viewer --ovirt-ca-file=/etc/pki/ovirt-engine/ca.pem /tmp/remote_viewer_connection_file.vv

가상 머신에서 그래픽 콘솔을 제거합니다.

이 가상 머신의 콘솔에 액세스하기 위해 시간에 민감한 인증 토큰을 생성합니다.

POST /ovirt-engine/api/vms/123/graphicsconsoles/456/ticket

클라이언트 제공 작업에는 필요한 티켓 값 및/또는 만료 시간(초)이 포함됩니다.

모든 경우 응답은 사용된 실제 티켓 값과 만료를 지정합니다.

<action>
  <ticket>
    <value>abcd12345</value>
    <expiry>120</expiry>
  </ticket>
</action>