com.vmware.vcenter.vm.console

Class TicketsStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.vcenter.vm.console.TicketsStub

All Implemented Interfaces:

Service, Tickets, TicketsTypes

public class TicketsStub
extends com.vmware.vapi.internal.bindings.Stub
implements Tickets

Remote stub implementation of the Tickets API service.

WARNING: Internal class, subject to change in future versions.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.vcenter.vm.console.TicketsTypes

TicketsTypes.CreateSpec, TicketsTypes.Summary, TicketsTypes.Type

Field Summary

Fields inherited from class com.vmware.vapi.internal.bindings.Stub

apiProvider, converter, ifaceId, securityContext

Fields inherited from interface com.vmware.vcenter.vm.console.TicketsTypes

_VAPI_SERVICE_ID

Constructor Summary

Constructors

Constructor and Description
TicketsStub(ApiProvider apiProvider, StubConfigurationBase config)
TicketsStub(ApiProvider apiProvider, com.vmware.vapi.internal.bindings.TypeConverter typeConverter, StubConfigurationBase config)

Method Summary

Modifier and Type	Method and Description
TicketsTypes.Summary	create(java.lang.String vm, TicketsTypes.CreateSpec spec) Creates a virtual machine console ticket of a given ticket type.
void	create(java.lang.String vm, TicketsTypes.CreateSpec spec, AsyncCallback<TicketsTypes.Summary> asyncCallback) Creates a virtual machine console ticket of a given ticket type.
void	create(java.lang.String vm, TicketsTypes.CreateSpec spec, AsyncCallback<TicketsTypes.Summary> asyncCallback, InvocationConfig invocationConfig) Creates a virtual machine console ticket of a given ticket type.
TicketsTypes.Summary	create(java.lang.String vm, TicketsTypes.CreateSpec spec, InvocationConfig invocationConfig) Creates a virtual machine console ticket of a given ticket type.

Methods inherited from class com.vmware.vapi.internal.bindings.Stub

invokeMethod, invokeMethodAsync, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TicketsStub

public TicketsStub(ApiProvider apiProvider,
                   com.vmware.vapi.internal.bindings.TypeConverter typeConverter,
                   StubConfigurationBase config)

TicketsStub

public TicketsStub(ApiProvider apiProvider,
                   StubConfigurationBase config)

Method Detail

create

public TicketsTypes.Summary create(java.lang.String vm,
                                   TicketsTypes.CreateSpec spec)

Description copied from interface: Tickets

Creates a virtual machine console ticket of a given ticket type. The created ticket is a one time use URI. The validity of the ticket is 30 minutes, if not used with in the time frame the ticket expires.

The TicketsTypes.Type.VMRC ticket contains the IP address or the DNS resolvable name of the vCenter server. This ticket requires installation of VMware Workstation, VMware Fusion or VMRC to be installed on the machine where the ticket has to be opened. This ticket can be acquired even when the VM is turned off.

The TicketsTypes.Type.WEBMKS ticket contains the IP address of the DNS resolvable name of the ESX server. This ticket requires user to embed this ticket in a HTML page using VMware HTML Console SDK - https://www.vmware.com/support/developer/html-console This ticket can be acquired only when the VM is turned on.

. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Specified by:

create in interface Tickets

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Specification for the console ticket to be created.

Returns:

Commonly used information about the virtual machine console ticket.

create

public TicketsTypes.Summary create(java.lang.String vm,
                                   TicketsTypes.CreateSpec spec,
                                   InvocationConfig invocationConfig)

Description copied from interface: Tickets

Creates a virtual machine console ticket of a given ticket type. The created ticket is a one time use URI. The validity of the ticket is 30 minutes, if not used with in the time frame the ticket expires.

The TicketsTypes.Type.VMRC ticket contains the IP address or the DNS resolvable name of the vCenter server. This ticket requires installation of VMware Workstation, VMware Fusion or VMRC to be installed on the machine where the ticket has to be opened. This ticket can be acquired even when the VM is turned off.

The TicketsTypes.Type.WEBMKS ticket contains the IP address of the DNS resolvable name of the ESX server. This ticket requires user to embed this ticket in a HTML page using VMware HTML Console SDK - https://www.vmware.com/support/developer/html-console This ticket can be acquired only when the VM is turned on.

. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

create in interface Tickets

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Specification for the console ticket to be created.

invocationConfig - Configuration for the method invocation.

Returns:

Commonly used information about the virtual machine console ticket.

create

public void create(java.lang.String vm,
                   TicketsTypes.CreateSpec spec,
                   AsyncCallback<TicketsTypes.Summary> asyncCallback)

Description copied from interface: Tickets

Creates a virtual machine console ticket of a given ticket type. The created ticket is a one time use URI. The validity of the ticket is 30 minutes, if not used with in the time frame the ticket expires.

The TicketsTypes.Type.VMRC ticket contains the IP address or the DNS resolvable name of the vCenter server. This ticket requires installation of VMware Workstation, VMware Fusion or VMRC to be installed on the machine where the ticket has to be opened. This ticket can be acquired even when the VM is turned off.

The TicketsTypes.Type.WEBMKS ticket contains the IP address of the DNS resolvable name of the ESX server. This ticket requires user to embed this ticket in a HTML page using VMware HTML Console SDK - https://www.vmware.com/support/developer/html-console This ticket can be acquired only when the VM is turned on.

. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
Commonly used information about the virtual machine console ticket.

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if the CreateSpec#type) property contains a value that is not supported by the server.
{@link com.vmware.vapi.std.errors.NotAllowedInCurrentState} - if the virtual machine is powered off and requested ticket type is {@link com.vmware.vcenter.vm.console.TicketsTypes.Type#WEBMKS}
{@link com.vmware.vapi.std.errors.NotFound} - if the virtual machine is not found.
{@link com.vmware.vapi.std.errors.ResourceInaccessible} - if the virtual machine's configuration or execution state cannot be accessed.
{@link com.vmware.vapi.std.errors.ServiceUnavailable} - if the system is unable to communicate with a service to complete the request.
{@link com.vmware.vapi.std.errors.Unauthenticated} - if the user can not be authenticated.
{@link com.vmware.vapi.std.errors.Unauthorized} - if the user doesn't have the required privileges.

Specified by:

create in interface Tickets

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Specification for the console ticket to be created.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

create

public void create(java.lang.String vm,
                   TicketsTypes.CreateSpec spec,
                   AsyncCallback<TicketsTypes.Summary> asyncCallback,
                   InvocationConfig invocationConfig)

Description copied from interface: Tickets

Creates a virtual machine console ticket of a given ticket type. The created ticket is a one time use URI. The validity of the ticket is 30 minutes, if not used with in the time frame the ticket expires.

The TicketsTypes.Type.VMRC ticket contains the IP address or the DNS resolvable name of the vCenter server. This ticket requires installation of VMware Workstation, VMware Fusion or VMRC to be installed on the machine where the ticket has to be opened. This ticket can be acquired even when the VM is turned off.

The TicketsTypes.Type.WEBMKS ticket contains the IP address of the DNS resolvable name of the ESX server. This ticket requires user to embed this ticket in a HTML page using VMware HTML Console SDK - https://www.vmware.com/support/developer/html-console This ticket can be acquired only when the VM is turned on.

. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
Commonly used information about the virtual machine console ticket.

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if the CreateSpec#type) property contains a value that is not supported by the server.
{@link com.vmware.vapi.std.errors.NotAllowedInCurrentState} - if the virtual machine is powered off and requested ticket type is {@link com.vmware.vcenter.vm.console.TicketsTypes.Type#WEBMKS}
{@link com.vmware.vapi.std.errors.NotFound} - if the virtual machine is not found.
{@link com.vmware.vapi.std.errors.ResourceInaccessible} - if the virtual machine's configuration or execution state cannot be accessed.
{@link com.vmware.vapi.std.errors.ServiceUnavailable} - if the system is unable to communicate with a service to complete the request.
{@link com.vmware.vapi.std.errors.Unauthenticated} - if the user can not be authenticated.
{@link com.vmware.vapi.std.errors.Unauthorized} - if the user doesn't have the required privileges.

Specified by:

create in interface Tickets

Parameters:

vm - Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.

spec - Specification for the console ticket to be created.

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.