com.vmware.appliance

Interface Services

All Superinterfaces:

Service, ServicesTypes

All Known Implementing Classes:

ServicesStub

public interface Services
extends Service, ServicesTypes

The Service interface provides methods to manage a single/set of appliance services. This interface was added in vSphere API 6.7.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.appliance.ServicesTypes

ServicesTypes.Info, ServicesTypes.State

Method Summary

Methods

Modifier and Type	Method and Description
ServicesTypes.Info	get(java.lang.String service) Returns the state of a service.
void	get(java.lang.String service, AsyncCallback<ServicesTypes.Info> asyncCallback) Returns the state of a service.
void	get(java.lang.String service, AsyncCallback<ServicesTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns the state of a service.
ServicesTypes.Info	get(java.lang.String service, InvocationConfig invocationConfig) Returns the state of a service.
java.util.Map<java.lang.String,ServicesTypes.Info>	list() Lists details of vCenter services.
void	list(AsyncCallback<java.util.Map<java.lang.String,ServicesTypes.Info>> asyncCallback) Lists details of vCenter services.
void	list(AsyncCallback<java.util.Map<java.lang.String,ServicesTypes.Info>> asyncCallback, InvocationConfig invocationConfig) Lists details of vCenter services.
java.util.Map<java.lang.String,ServicesTypes.Info>	list(InvocationConfig invocationConfig) Lists details of vCenter services.
void	restart(java.lang.String service) Restarts a service.
void	restart(java.lang.String service, AsyncCallback<java.lang.Void> asyncCallback) Restarts a service.
void	restart(java.lang.String service, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Restarts a service.
void	restart(java.lang.String service, InvocationConfig invocationConfig) Restarts a service.
void	start(java.lang.String service) Starts a service.
void	start(java.lang.String service, AsyncCallback<java.lang.Void> asyncCallback) Starts a service.
void	start(java.lang.String service, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Starts a service.
void	start(java.lang.String service, InvocationConfig invocationConfig) Starts a service.
void	stop(java.lang.String service) Stops a service.
void	stop(java.lang.String service, AsyncCallback<java.lang.Void> asyncCallback) Stops a service.
void	stop(java.lang.String service, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Stops a service.
void	stop(java.lang.String service, InvocationConfig invocationConfig) Stops a service.

Method Detail

start

void start(java.lang.String service)

Starts a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service to start The parameter must be an identifier for the resource type: com.vmware.appliance.services.

Throws:

NotFound - if the service associated with service does not exist.

NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or restart operation is in progress, the start operation will not be allowed.

NotAllowedInCurrentState - if start operation is issued on a service which has startup type StartupType#DISABLED.

TimedOut - if any timeout occurs during the execution of the start operation. Timeout occurs when the service takes longer than StartTimeout to start.

Error - if any other error occurs during the execution of the operation.

start

void start(java.lang.String service,
         InvocationConfig invocationConfig)

Starts a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service to start The parameter must be an identifier for the resource type: com.vmware.appliance.services.

invocationConfig - Configuration for the method invocation.

Throws:

NotFound - if the service associated with service does not exist.

NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or restart operation is in progress, the start operation will not be allowed.

NotAllowedInCurrentState - if start operation is issued on a service which has startup type StartupType#DISABLED.

TimedOut - if any timeout occurs during the execution of the start operation. Timeout occurs when the service takes longer than StartTimeout to start.

Error - if any other error occurs during the execution of the operation.

start

void start(java.lang.String service,
         AsyncCallback<java.lang.Void> asyncCallback)

Starts a service. This method was added in vSphere API 6.7.

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

Operation Errors:
NotFound - if the service associated with service does not exist.
NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or restart operation is in progress, the start operation will not be allowed.
NotAllowedInCurrentState - if start operation is issued on a service which has startup type StartupType#DISABLED.
TimedOut - if any timeout occurs during the execution of the start operation. Timeout occurs when the service takes longer than StartTimeout to start.
Error - if any other error occurs during the execution of the operation.

Parameters:

service - identifier of the service to start The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

start

void start(java.lang.String service,
         AsyncCallback<java.lang.Void> asyncCallback,
         InvocationConfig invocationConfig)

Starts a service. This method was added in vSphere API 6.7.

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

Operation Errors:
NotFound - if the service associated with service does not exist.
NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or restart operation is in progress, the start operation will not be allowed.
NotAllowedInCurrentState - if start operation is issued on a service which has startup type StartupType#DISABLED.
TimedOut - if any timeout occurs during the execution of the start operation. Timeout occurs when the service takes longer than StartTimeout to start.
Error - if any other error occurs during the execution of the operation.

Parameters:

service - identifier of the service to start The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

invocationConfig - Configuration for the method invocation.

stop

void stop(java.lang.String service)

Stops a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service to stop The parameter must be an identifier for the resource type: com.vmware.appliance.services.

Throws:

NotFound - if the service associated with service does not exist.

Error - if any other error occurs during the execution of the operation.

NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop operation is in progress, issuing another stop operation will lead to this error.

stop

void stop(java.lang.String service,
        InvocationConfig invocationConfig)

Stops a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service to stop The parameter must be an identifier for the resource type: com.vmware.appliance.services.

invocationConfig - Configuration for the method invocation.

Throws:

NotFound - if the service associated with service does not exist.

Error - if any other error occurs during the execution of the operation.

NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop operation is in progress, issuing another stop operation will lead to this error.

stop

void stop(java.lang.String service,
        AsyncCallback<java.lang.Void> asyncCallback)

Stops a service. This method was added in vSphere API 6.7.

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

Operation Errors:
NotFound - if the service associated with service does not exist.
Error - if any other error occurs during the execution of the operation.
NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop operation is in progress, issuing another stop operation will lead to this error.

Parameters:

service - identifier of the service to stop The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

stop

void stop(java.lang.String service,
        AsyncCallback<java.lang.Void> asyncCallback,
        InvocationConfig invocationConfig)

Stops a service. This method was added in vSphere API 6.7.

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

Operation Errors:
NotFound - if the service associated with service does not exist.
Error - if any other error occurs during the execution of the operation.
NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop operation is in progress, issuing another stop operation will lead to this error.

Parameters:

service - identifier of the service to stop The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

invocationConfig - Configuration for the method invocation.

restart

void restart(java.lang.String service)

Restarts a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service to restart The parameter must be an identifier for the resource type: com.vmware.appliance.services.

Throws:

NotFound - if the service associated with service does not exist.

TimedOut - if any timeout occurs during the execution of the restart operation.

NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or start operation is in progress, issuing a restart operation will lead to this error.

NotAllowedInCurrentState - if a restart operation is issued on a service which has startup type StartupType#DISABLED

Error - if any other error occurs during the execution of the operation.

restart

void restart(java.lang.String service,
           InvocationConfig invocationConfig)

Restarts a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service to restart The parameter must be an identifier for the resource type: com.vmware.appliance.services.

invocationConfig - Configuration for the method invocation.

Throws:

NotFound - if the service associated with service does not exist.

TimedOut - if any timeout occurs during the execution of the restart operation.

NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or start operation is in progress, issuing a restart operation will lead to this error.

NotAllowedInCurrentState - if a restart operation is issued on a service which has startup type StartupType#DISABLED

Error - if any other error occurs during the execution of the operation.

restart

void restart(java.lang.String service,
           AsyncCallback<java.lang.Void> asyncCallback)

Restarts a service. This method was added in vSphere API 6.7.

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

Operation Errors:
NotFound - if the service associated with service does not exist.
TimedOut - if any timeout occurs during the execution of the restart operation.
NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or start operation is in progress, issuing a restart operation will lead to this error.
NotAllowedInCurrentState - if a restart operation is issued on a service which has startup type StartupType#DISABLED
Error - if any other error occurs during the execution of the operation.

Parameters:

service - identifier of the service to restart The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

restart

void restart(java.lang.String service,
           AsyncCallback<java.lang.Void> asyncCallback,
           InvocationConfig invocationConfig)

Restarts a service. This method was added in vSphere API 6.7.

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

Operation Errors:
NotFound - if the service associated with service does not exist.
TimedOut - if any timeout occurs during the execution of the restart operation.
NotAllowedInCurrentState - if the operation is denied in the current state of the service. If a stop or start operation is in progress, issuing a restart operation will lead to this error.
NotAllowedInCurrentState - if a restart operation is issued on a service which has startup type StartupType#DISABLED
Error - if any other error occurs during the execution of the operation.

Parameters:

service - identifier of the service to restart The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

invocationConfig - Configuration for the method invocation.

get

ServicesTypes.Info get(java.lang.String service)

Returns the state of a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service whose state is being queried. The parameter must be an identifier for the resource type: com.vmware.appliance.services.

Returns:

Service Info structure.

Throws:

NotFound - if the service associated with service does not exist.

Error - if any other error occurs during the execution of the operation.

get

ServicesTypes.Info get(java.lang.String service,
                     InvocationConfig invocationConfig)

Returns the state of a service. This method was added in vSphere API 6.7.

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

Parameters:

service - identifier of the service whose state is being queried. The parameter must be an identifier for the resource type: com.vmware.appliance.services.

invocationConfig - Configuration for the method invocation.

Returns:

Service Info structure.

Throws:

NotFound - if the service associated with service does not exist.

Error - if any other error occurs during the execution of the operation.

get

void get(java.lang.String service,
       AsyncCallback<ServicesTypes.Info> asyncCallback)

Returns the state of a service. This method was added in vSphere API 6.7.

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

Operation Result:
Service Info structure.

Operation Errors:
NotFound - if the service associated with service does not exist.
Error - if any other error occurs during the execution of the operation.

Parameters:

service - identifier of the service whose state is being queried. The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

get

void get(java.lang.String service,
       AsyncCallback<ServicesTypes.Info> asyncCallback,
       InvocationConfig invocationConfig)

Returns the state of a service. This method was added in vSphere API 6.7.

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

Operation Result:
Service Info structure.

Operation Errors:
NotFound - if the service associated with service does not exist.
Error - if any other error occurs during the execution of the operation.

Parameters:

service - identifier of the service whose state is being queried. The parameter must be an identifier for the resource type: com.vmware.appliance.services.

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

invocationConfig - Configuration for the method invocation.

list

java.util.Map<java.lang.String,ServicesTypes.Info> list()

Lists details of vCenter services. This method was added in vSphere API 6.7.

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

Returns:

Map of service identifiers to service Info structures. The key in the return value Map will be an identifier for the resource type: com.vmware.appliance.services.

Throws:

Error - if any error occurs during the execution of the operation.

list

java.util.Map<java.lang.String,ServicesTypes.Info> list(InvocationConfig invocationConfig)

Lists details of vCenter services. This method was added in vSphere API 6.7.

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

Parameters:

invocationConfig - Configuration for the method invocation.

Returns:

Map of service identifiers to service Info structures. The key in the return value Map will be an identifier for the resource type: com.vmware.appliance.services.

Throws:

Error - if any error occurs during the execution of the operation.

list

void list(AsyncCallback<java.util.Map<java.lang.String,ServicesTypes.Info>> asyncCallback)

Lists details of vCenter services. This method was added in vSphere API 6.7.

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

Operation Result:
Map of service identifiers to service Info structures. The key in the return value Map will be an identifier for the resource type: com.vmware.appliance.services.

Operation Errors:
Error - if any error occurs during the execution of the operation.

Parameters:

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

list

void list(AsyncCallback<java.util.Map<java.lang.String,ServicesTypes.Info>> asyncCallback,
        InvocationConfig invocationConfig)

Lists details of vCenter services. This method was added in vSphere API 6.7.

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

Operation Result:
Map of service identifiers to service Info structures. The key in the return value Map will be an identifier for the resource type: com.vmware.appliance.services.

Operation Errors:
Error - if any error occurs during the execution of the operation.

Parameters:

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

invocationConfig - Configuration for the method invocation.