com.vmware.appliance.update

Interface Pending

All Superinterfaces:

PendingTypes, Service

All Known Implementing Classes:

PendingStub

public interface Pending
extends Service, PendingTypes

The Pending interface provides methods to manipulate pending updates. This interface was added in vSphere API 6.7.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.appliance.update.PendingTypes

PendingTypes.Info, PendingTypes.PrecheckResult, PendingTypes.Question, PendingTypes.SourceType

Field Summary

Fields inherited from interface com.vmware.appliance.update.PendingTypes

_VAPI_SERVICE_ID

Method Summary

Modifier and Type	Method and Description
PendingTypes.Info	get(java.lang.String version) Gets update information.
void	get(java.lang.String version, AsyncCallback<PendingTypes.Info> asyncCallback) Gets update information.
void	get(java.lang.String version, AsyncCallback<PendingTypes.Info> asyncCallback, InvocationConfig invocationConfig) Gets update information.
PendingTypes.Info	get(java.lang.String version, InvocationConfig invocationConfig) Gets update information.
void	install(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData) Starts operation of installing the appliance update.
void	install(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, AsyncCallback<java.lang.Void> asyncCallback) Starts operation of installing the appliance update.
void	install(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Starts operation of installing the appliance update.
void	install(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, InvocationConfig invocationConfig) Starts operation of installing the appliance update.
java.util.List<Summary>	list(PendingTypes.SourceType sourceType, java.lang.String url) Checks if new updates are available.
void	list(PendingTypes.SourceType sourceType, java.lang.String url, AsyncCallback<java.util.List<Summary>> asyncCallback) Checks if new updates are available.
void	list(PendingTypes.SourceType sourceType, java.lang.String url, AsyncCallback<java.util.List<Summary>> asyncCallback, InvocationConfig invocationConfig) Checks if new updates are available.
java.util.List<Summary>	list(PendingTypes.SourceType sourceType, java.lang.String url, InvocationConfig invocationConfig) Checks if new updates are available.
PendingTypes.PrecheckResult	precheck(java.lang.String version) Runs update precheck.
void	precheck(java.lang.String version, AsyncCallback<PendingTypes.PrecheckResult> asyncCallback) Runs update precheck.
void	precheck(java.lang.String version, AsyncCallback<PendingTypes.PrecheckResult> asyncCallback, InvocationConfig invocationConfig) Runs update precheck.
PendingTypes.PrecheckResult	precheck(java.lang.String version, InvocationConfig invocationConfig) Runs update precheck.
void	stage(java.lang.String version) Starts staging the appliance update.
void	stage(java.lang.String version, AsyncCallback<java.lang.Void> asyncCallback) Starts staging the appliance update.
void	stage(java.lang.String version, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Starts staging the appliance update.
void	stage(java.lang.String version, InvocationConfig invocationConfig) Starts staging the appliance update.
void	stageAndInstall(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData) Starts operation of installing the appliance update.
void	stageAndInstall(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, AsyncCallback<java.lang.Void> asyncCallback) Starts operation of installing the appliance update.
void	stageAndInstall(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Starts operation of installing the appliance update.
void	stageAndInstall(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, InvocationConfig invocationConfig) Starts operation of installing the appliance update.
Notifications	validate(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData) Validates the user provided data before the update installation.
void	validate(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, AsyncCallback<Notifications> asyncCallback) Validates the user provided data before the update installation.
void	validate(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, AsyncCallback<Notifications> asyncCallback, InvocationConfig invocationConfig) Validates the user provided data before the update installation.
Notifications	validate(java.lang.String version, java.util.Map<java.lang.String,java.lang.String> userData, InvocationConfig invocationConfig) Validates the user provided data before the update installation.

Method Detail

list

java.util.List<Summary> list(PendingTypes.SourceType sourceType,
                             java.lang.String url)

Checks if new updates are available. 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:

sourceType - type of the source

url - specific URL to check at If null then URL is taken from the policy settings

Returns:

List of the update summaries

Throws:

Error - Generic error

NotFound - source is not found

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

list

java.util.List<Summary> list(PendingTypes.SourceType sourceType,
                             java.lang.String url,
                             InvocationConfig invocationConfig)

Checks if new updates are available. 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:

sourceType - type of the source

url - specific URL to check at If null then URL is taken from the policy settings

invocationConfig - Configuration for the method invocation.

Returns:

List of the update summaries

Throws:

Error - Generic error

NotFound - source is not found

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

list

void list(PendingTypes.SourceType sourceType,
          java.lang.String url,
          AsyncCallback<java.util.List<Summary>> asyncCallback)

Checks if new updates are available. This method was added in vSphere API 6.7.

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

Invocation Result:
List of the update summaries

Operation Errors:
Error - Generic error
NotFound - source is not found
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation

Parameters:

sourceType - type of the source

url - specific URL to check at If null then URL is taken from the policy settings

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

list

void list(PendingTypes.SourceType sourceType,
          java.lang.String url,
          AsyncCallback<java.util.List<Summary>> asyncCallback,
          InvocationConfig invocationConfig)

Checks if new updates are available. 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.

Invocation Result:
List of the update summaries

Operation Errors:
Error - Generic error
NotFound - source is not found
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation

Parameters:

sourceType - type of the source

url - specific URL to check at If null then URL is taken from the policy settings

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

invocationConfig - Configuration for the method invocation.

get

PendingTypes.Info get(java.lang.String version)

Gets update information. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

Returns:

Update

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - the update is not found

AlreadyInDesiredState - if the update of this version is already installed

get

PendingTypes.Info get(java.lang.String version,
                      InvocationConfig invocationConfig)

Gets update information. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

invocationConfig - Configuration for the method invocation.

Returns:

Update

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - the update is not found

AlreadyInDesiredState - if the update of this version is already installed

get

void get(java.lang.String version,
         AsyncCallback<PendingTypes.Info> asyncCallback)

Gets update information. This method was added in vSphere API 6.7.

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

Invocation Result:
Update

Operation Errors:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - the update is not found
AlreadyInDesiredState - if the update of this version is already installed

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

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

get

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

Gets update information. 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.

Invocation Result:
Update

Operation Errors:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - the update is not found
AlreadyInDesiredState - if the update of this version is already installed

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

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

invocationConfig - Configuration for the method invocation.

precheck

PendingTypes.PrecheckResult precheck(java.lang.String version)

Runs update precheck. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

Returns:

PrecheckResult

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - the update is not found

AlreadyInDesiredState - if this version is already installed

NotAllowedInCurrentState - if another operation is in progress

precheck

PendingTypes.PrecheckResult precheck(java.lang.String version,
                                     InvocationConfig invocationConfig)

Runs update precheck. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

invocationConfig - Configuration for the method invocation.

Returns:

PrecheckResult

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - the update is not found

AlreadyInDesiredState - if this version is already installed

NotAllowedInCurrentState - if another operation is in progress

precheck

void precheck(java.lang.String version,
              AsyncCallback<PendingTypes.PrecheckResult> asyncCallback)

Runs update precheck. This method was added in vSphere API 6.7.

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

Invocation Result:
PrecheckResult

Operation Errors:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - the update is not found
AlreadyInDesiredState - if this version is already installed
NotAllowedInCurrentState - if another operation is in progress

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

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

precheck

void precheck(java.lang.String version,
              AsyncCallback<PendingTypes.PrecheckResult> asyncCallback,
              InvocationConfig invocationConfig)

Runs update precheck. 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.

Invocation Result:
PrecheckResult

Operation Errors:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - the update is not found
AlreadyInDesiredState - if this version is already installed
NotAllowedInCurrentState - if another operation is in progress

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

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

invocationConfig - Configuration for the method invocation.

stage

void stage(java.lang.String version)

Starts staging the appliance update. The updates are searched for in the following order: staged, CDROM, URL. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - the update is not found

AlreadyInDesiredState - if the update of this version is already installed

AlreadyExists - the update is already staged

NotAllowedInCurrentState - if appliance update state prevents staging

stage

void stage(java.lang.String version,
           InvocationConfig invocationConfig)

Starts staging the appliance update. The updates are searched for in the following order: staged, CDROM, URL. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

invocationConfig - Configuration for the method invocation.

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - the update is not found

AlreadyInDesiredState - if the update of this version is already installed

AlreadyExists - the update is already staged

NotAllowedInCurrentState - if appliance update state prevents staging

stage

void stage(java.lang.String version,
           AsyncCallback<java.lang.Void> asyncCallback)

Starts staging the appliance update. The updates are searched for in the following order: staged, CDROM, URL. 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:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - the update is not found
AlreadyInDesiredState - if the update of this version is already installed
AlreadyExists - the update is already staged
NotAllowedInCurrentState - if appliance update state prevents staging

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

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

stage

void stage(java.lang.String version,
           AsyncCallback<java.lang.Void> asyncCallback,
           InvocationConfig invocationConfig)

Starts staging the appliance update. The updates are searched for in the following order: staged, CDROM, URL. 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:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - the update is not found
AlreadyInDesiredState - if the update of this version is already installed
AlreadyExists - the update is already staged
NotAllowedInCurrentState - if appliance update state prevents staging

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

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

invocationConfig - Configuration for the method invocation.

validate

Notifications validate(java.lang.String version,
                       java.util.Map<java.lang.String,java.lang.String> userData)

Validates the user provided data before the update installation. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

Returns:

Issues struct with the issues found during the validation

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - if the update is not found

AlreadyInDesiredState - if the update of this version is already installed

NotAllowedInCurrentState - if appliance update state prevents running an check

validate

Notifications validate(java.lang.String version,
                       java.util.Map<java.lang.String,java.lang.String> userData,
                       InvocationConfig invocationConfig)

Validates the user provided data before the update installation. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

invocationConfig - Configuration for the method invocation.

Returns:

Issues struct with the issues found during the validation

Throws:

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - if the update is not found

AlreadyInDesiredState - if the update of this version is already installed

NotAllowedInCurrentState - if appliance update state prevents running an check

validate

void validate(java.lang.String version,
              java.util.Map<java.lang.String,java.lang.String> userData,
              AsyncCallback<Notifications> asyncCallback)

Validates the user provided data before the update installation. This method was added in vSphere API 6.7.

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

Invocation Result:
Issues struct with the issues found during the validation

Operation Errors:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - if the update is not found
AlreadyInDesiredState - if the update of this version is already installed
NotAllowedInCurrentState - if appliance update state prevents running an check

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

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

validate

void validate(java.lang.String version,
              java.util.Map<java.lang.String,java.lang.String> userData,
              AsyncCallback<Notifications> asyncCallback,
              InvocationConfig invocationConfig)

Validates the user provided data before the update installation. 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.

Invocation Result:
Issues struct with the issues found during the validation

Operation Errors:
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - if the update is not found
AlreadyInDesiredState - if the update of this version is already installed
NotAllowedInCurrentState - if appliance update state prevents running an check

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

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

invocationConfig - Configuration for the method invocation.

install

void install(java.lang.String version,
             java.util.Map<java.lang.String,java.lang.String> userData)

Starts operation of installing the appliance update. Will fail is the update is not staged. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

Throws:

Error - Generic error

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - if the update is not found

AlreadyInDesiredState - if the update of this version is already installed

NotAllowedInCurrentState - if appliance update state prevents running an update or not staged

install

void install(java.lang.String version,
             java.util.Map<java.lang.String,java.lang.String> userData,
             InvocationConfig invocationConfig)

Starts operation of installing the appliance update. Will fail is the update is not staged. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

invocationConfig - Configuration for the method invocation.

Throws:

Error - Generic error

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - if the update is not found

AlreadyInDesiredState - if the update of this version is already installed

NotAllowedInCurrentState - if appliance update state prevents running an update or not staged

install

void install(java.lang.String version,
             java.util.Map<java.lang.String,java.lang.String> userData,
             AsyncCallback<java.lang.Void> asyncCallback)

Starts operation of installing the appliance update. Will fail is the update is not staged. 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:
Error - Generic error
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - if the update is not found
AlreadyInDesiredState - if the update of this version is already installed
NotAllowedInCurrentState - if appliance update state prevents running an update or not staged

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

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

install

void install(java.lang.String version,
             java.util.Map<java.lang.String,java.lang.String> userData,
             AsyncCallback<java.lang.Void> asyncCallback,
             InvocationConfig invocationConfig)

Starts operation of installing the appliance update. Will fail is the update is not staged. 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:
Error - Generic error
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - if the update is not found
AlreadyInDesiredState - if the update of this version is already installed
NotAllowedInCurrentState - if appliance update state prevents running an update or not staged

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

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

invocationConfig - Configuration for the method invocation.

stageAndInstall

void stageAndInstall(java.lang.String version,
                     java.util.Map<java.lang.String,java.lang.String> userData)

Starts operation of installing the appliance update. Will stage update if not already staged The updates are searched for in the following order: staged, CDROM, URL. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

Throws:

Error - Generic error

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - if the update is not found

AlreadyInDesiredState - if the update of this version is already installed

NotAllowedInCurrentState - if appliance update state prevents running an update

stageAndInstall

void stageAndInstall(java.lang.String version,
                     java.util.Map<java.lang.String,java.lang.String> userData,
                     InvocationConfig invocationConfig)

Starts operation of installing the appliance update. Will stage update if not already staged The updates are searched for in the following order: staged, CDROM, URL. 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:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

invocationConfig - Configuration for the method invocation.

Throws:

Error - Generic error

Error - Generic error

Unauthenticated - session is not authenticated

Unauthorized - session is not authorized to perform this operation

NotFound - if the update is not found

AlreadyInDesiredState - if the update of this version is already installed

NotAllowedInCurrentState - if appliance update state prevents running an update

stageAndInstall

void stageAndInstall(java.lang.String version,
                     java.util.Map<java.lang.String,java.lang.String> userData,
                     AsyncCallback<java.lang.Void> asyncCallback)

Starts operation of installing the appliance update. Will stage update if not already staged The updates are searched for in the following order: staged, CDROM, URL. 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:
Error - Generic error
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - if the update is not found
AlreadyInDesiredState - if the update of this version is already installed
NotAllowedInCurrentState - if appliance update state prevents running an update

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

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

stageAndInstall

void stageAndInstall(java.lang.String version,
                     java.util.Map<java.lang.String,java.lang.String> userData,
                     AsyncCallback<java.lang.Void> asyncCallback,
                     InvocationConfig invocationConfig)

Starts operation of installing the appliance update. Will stage update if not already staged The updates are searched for in the following order: staged, CDROM, URL. 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:
Error - Generic error
Error - Generic error
Unauthenticated - session is not authenticated
Unauthorized - session is not authorized to perform this operation
NotFound - if the update is not found
AlreadyInDesiredState - if the update of this version is already installed
NotAllowedInCurrentState - if appliance update state prevents running an update

Parameters:

version - Update version The parameter must be an identifier for the resource type: com.vmware.appliance.update.pending.

userData - map of user provided data with IDs The key in the parameter Map must be an identifier for the resource type: com.vmware.applicance.update.pending.dataitem.

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

invocationConfig - Configuration for the method invocation.