Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/*
Copyright (c) 2015 Red Hat, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.ovirt.engine.sdk4.services;
import java.io.IOException;
import java.lang.String;
import org.ovirt.engine.sdk4.Request;
import org.ovirt.engine.sdk4.Response;
import org.ovirt.engine.sdk4.Service;
import org.ovirt.engine.sdk4.builders.TicketBuilder;
import org.ovirt.engine.sdk4.types.GraphicsConsole;
import org.ovirt.engine.sdk4.types.ProxyTicket;
import org.ovirt.engine.sdk4.types.Ticket;
public interface VmGraphicsConsoleService extends Service {
/**
* Gets graphics console configuration of the virtual machine.
*/
public interface GetRequest extends Request {
/**
* Use the following query to obtain the current run-time configuration of the graphics console.
*
* [source]
* ----
* GET /ovit-engine/api/vms/123/graphicsconsoles/456?current=true
* ----
*
* The default value is `false`.
*/
GetRequest current(Boolean current);
}
/**
* Gets graphics console configuration of the virtual machine.
*/
public interface GetResponse extends Response {
/**
* The information about the graphics console of the virtual machine.
*/
GraphicsConsole console();
}
/**
* Gets graphics console configuration of the virtual machine.
*/
GetRequest get();
public interface ProxyTicketRequest extends Request {
/**
* Indicates if the generation of the ticket should be performed asynchronously.
*/
ProxyTicketRequest async(Boolean async);
}
public interface ProxyTicketResponse extends Response {
ProxyTicket proxyTicket();
}
ProxyTicketRequest proxyTicket();
/**
* Generates the file which is compatible with `remote-viewer` client.
*
* Use the following request to generate remote viewer connection file of the graphics console.
* Note that this action generates the file only if virtual machine is running.
*
* [source]
* ----
* POST /ovirt-engine/api/vms/123/graphicsconsoles/456/remoteviewerconnectionfile
* ----
*
* The `remoteviewerconnectionfile` action does not take any action specific parameters,
* so the request body should contain an empty `action`:
*
* [source,xml]
* ----
*
* ----
*
* The response contains the file, which can be used with `remote-viewer` client.
*
* [source,xml]
* ----
*
*
* [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=...
*
*
* ----
*
* E.g., to fetch the content of remote viewer connection file and save it into temporary file, user can use
* oVirt Python SDK as follows:
*
* [source,python]
* ----
* # 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)
* ----
*
* When you create the remote viewer connection file, then you can connect to virtual machine graphic console,
* as follows:
*
* [source,bash]
* ----
* #!/bin/sh -ex
*
* remote-viewer --ovirt-ca-file=/etc/pki/ovirt-engine/ca.pem /tmp/remote_viewer_connection_file.vv
* ----
*/
public interface RemoteViewerConnectionFileRequest extends Request {
}
/**
* Generates the file which is compatible with `remote-viewer` client.
*
* Use the following request to generate remote viewer connection file of the graphics console.
* Note that this action generates the file only if virtual machine is running.
*
* [source]
* ----
* POST /ovirt-engine/api/vms/123/graphicsconsoles/456/remoteviewerconnectionfile
* ----
*
* The `remoteviewerconnectionfile` action does not take any action specific parameters,
* so the request body should contain an empty `action`:
*
* [source,xml]
* ----
*
* ----
*
* The response contains the file, which can be used with `remote-viewer` client.
*
* [source,xml]
* ----
*
*
* [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=...
*
*
* ----
*
* E.g., to fetch the content of remote viewer connection file and save it into temporary file, user can use
* oVirt Python SDK as follows:
*
* [source,python]
* ----
* # 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)
* ----
*
* When you create the remote viewer connection file, then you can connect to virtual machine graphic console,
* as follows:
*
* [source,bash]
* ----
* #!/bin/sh -ex
*
* remote-viewer --ovirt-ca-file=/etc/pki/ovirt-engine/ca.pem /tmp/remote_viewer_connection_file.vv
* ----
*/
public interface RemoteViewerConnectionFileResponse extends Response {
/**
* Contains the file which is compatible with `remote-viewer` client.
*
* User can use the content of this attribute to create a file, which can be passed to `remote-viewer` client to
* connect to virtual machine graphic console.
*/
String remoteViewerConnectionFile();
}
/**
* Generates the file which is compatible with `remote-viewer` client.
*
* Use the following request to generate remote viewer connection file of the graphics console.
* Note that this action generates the file only if virtual machine is running.
*
* [source]
* ----
* POST /ovirt-engine/api/vms/123/graphicsconsoles/456/remoteviewerconnectionfile
* ----
*
* The `remoteviewerconnectionfile` action does not take any action specific parameters,
* so the request body should contain an empty `action`:
*
* [source,xml]
* ----
*
* ----
*
* The response contains the file, which can be used with `remote-viewer` client.
*
* [source,xml]
* ----
*
*
* [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=...
*
*
* ----
*
* E.g., to fetch the content of remote viewer connection file and save it into temporary file, user can use
* oVirt Python SDK as follows:
*
* [source,python]
* ----
* # 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)
* ----
*
* When you create the remote viewer connection file, then you can connect to virtual machine graphic console,
* as follows:
*
* [source,bash]
* ----
* #!/bin/sh -ex
*
* remote-viewer --ovirt-ca-file=/etc/pki/ovirt-engine/ca.pem /tmp/remote_viewer_connection_file.vv
* ----
*/
RemoteViewerConnectionFileRequest remoteViewerConnectionFile();
/**
* Remove the graphics console from the virtual machine.
*/
public interface RemoveRequest extends Request {
/**
* Indicates if the remove should be performed asynchronously.
*/
RemoveRequest async(Boolean async);
}
/**
* Remove the graphics console from the virtual machine.
*/
public interface RemoveResponse extends Response {
}
/**
* Remove the graphics console from the virtual machine.
*/
RemoveRequest remove();
/**
* Generates a time-sensitive authentication token for accessing this virtual machine's console.
*
* [source]
* ----
* POST /ovirt-engine/api/vms/123/graphicsconsoles/456/ticket
* ----
*
* The client-provided action optionally includes a desired ticket value and/or an expiry time in seconds.
*
* In any case, the response specifies the actual ticket value and expiry used.
*
* [source,xml]
* ----
*
*
* abcd12345
* 120
*
*
* ----
*/
public interface TicketRequest extends Request {
TicketRequest ticket(Ticket ticket);
/**
* The generated ticket that can be used to access this console.
*/
TicketRequest ticket(TicketBuilder ticket);
}
/**
* Generates a time-sensitive authentication token for accessing this virtual machine's console.
*
* [source]
* ----
* POST /ovirt-engine/api/vms/123/graphicsconsoles/456/ticket
* ----
*
* The client-provided action optionally includes a desired ticket value and/or an expiry time in seconds.
*
* In any case, the response specifies the actual ticket value and expiry used.
*
* [source,xml]
* ----
*
*
* abcd12345
* 120
*
*
* ----
*/
public interface TicketResponse extends Response {
/**
* The generated ticket that can be used to access this console.
*/
Ticket ticket();
}
/**
* Generates a time-sensitive authentication token for accessing this virtual machine's console.
*
* [source]
* ----
* POST /ovirt-engine/api/vms/123/graphicsconsoles/456/ticket
* ----
*
* The client-provided action optionally includes a desired ticket value and/or an expiry time in seconds.
*
* In any case, the response specifies the actual ticket value and expiry used.
*
* [source,xml]
* ----
*
*
* abcd12345
* 120
*
*
* ----
*/
TicketRequest ticket();
/**
* Service locator method, returns individual service on which the URI is dispatched.
*/
Service service(String path);
}
