com.vmware.esx.settings.hosts.software

Interface Drafts

All Superinterfaces:

DraftsTypes, Service

All Known Implementing Classes:

DraftsStub

public interface Drafts
extends Service, DraftsTypes

The Drafts interface provides methods to manage working copy of software documents. This interface was added in vSphere API 8.0.0.1.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.esx.settings.hosts.software.DraftsTypes

DraftsTypes._VAPI_OPERATIONS, DraftsTypes.CommitSpec, DraftsTypes.FilterSpec, DraftsTypes.ImportSpec, DraftsTypes.Info, DraftsTypes.Metadata, DraftsTypes.SourceType, DraftsTypes.StatusType, DraftsTypes.Summary, DraftsTypes.ValidateResult

Field Summary

Fields inherited from interface com.vmware.esx.settings.hosts.software.DraftsTypes

_VAPI_SERVICE_ID, RESOURCE_TYPE

Method Summary

Modifier and Type	Method and Description
java.lang.String	commit_Task(java.lang.String host, java.lang.String draft, DraftsTypes.CommitSpec spec) Commits the specified draft as the desired state document.
void	commit_Task(java.lang.String host, java.lang.String draft, DraftsTypes.CommitSpec spec, AsyncCallback<java.lang.String> asyncCallback) Commits the specified draft as the desired state document.
void	commit_Task(java.lang.String host, java.lang.String draft, DraftsTypes.CommitSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Commits the specified draft as the desired state document.
java.lang.String	commit_Task(java.lang.String host, java.lang.String draft, DraftsTypes.CommitSpec spec, InvocationConfig invocationConfig) Commits the specified draft as the desired state document.
java.lang.String	create(java.lang.String host) Creates a new software draft from the desired document.
void	create(java.lang.String host, AsyncCallback<java.lang.String> asyncCallback) Creates a new software draft from the desired document.
void	create(java.lang.String host, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates a new software draft from the desired document.
java.lang.String	create(java.lang.String host, InvocationConfig invocationConfig) Creates a new software draft from the desired document.
void	delete(java.lang.String host, java.lang.String draft) Deletes the software draft.
void	delete(java.lang.String host, java.lang.String draft, AsyncCallback<java.lang.Void> asyncCallback) Deletes the software draft.
void	delete(java.lang.String host, java.lang.String draft, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Deletes the software draft.
void	delete(java.lang.String host, java.lang.String draft, InvocationConfig invocationConfig) Deletes the software draft.
DraftsTypes.Info	get(java.lang.String host, java.lang.String draft) Returns the information about given software draft.
void	get(java.lang.String host, java.lang.String draft, AsyncCallback<DraftsTypes.Info> asyncCallback) Returns the information about given software draft.
void	get(java.lang.String host, java.lang.String draft, AsyncCallback<DraftsTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns the information about given software draft.
DraftsTypes.Info	get(java.lang.String host, java.lang.String draft, InvocationConfig invocationConfig) Returns the information about given software draft.
java.lang.String	importSoftwareSpec(java.lang.String host, DraftsTypes.ImportSpec spec) Imports the desired software specification.
void	importSoftwareSpec(java.lang.String host, DraftsTypes.ImportSpec spec, AsyncCallback<java.lang.String> asyncCallback) Imports the desired software specification.
void	importSoftwareSpec(java.lang.String host, DraftsTypes.ImportSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Imports the desired software specification.
java.lang.String	importSoftwareSpec(java.lang.String host, DraftsTypes.ImportSpec spec, InvocationConfig invocationConfig) Imports the desired software specification.
java.util.Map<java.lang.String,DraftsTypes.Summary>	list(java.lang.String host, DraftsTypes.FilterSpec filter) Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec.
void	list(java.lang.String host, DraftsTypes.FilterSpec filter, AsyncCallback<java.util.Map<java.lang.String,DraftsTypes.Summary>> asyncCallback) Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec.
void	list(java.lang.String host, DraftsTypes.FilterSpec filter, AsyncCallback<java.util.Map<java.lang.String,DraftsTypes.Summary>> asyncCallback, InvocationConfig invocationConfig) Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec.
java.util.Map<java.lang.String,DraftsTypes.Summary>	list(java.lang.String host, DraftsTypes.FilterSpec filter, InvocationConfig invocationConfig) Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec.
java.lang.String	scan_Task(java.lang.String host, java.lang.String draft) Scans the host against the software draft.
void	scan_Task(java.lang.String host, java.lang.String draft, AsyncCallback<java.lang.String> asyncCallback) Scans the host against the software draft.
void	scan_Task(java.lang.String host, java.lang.String draft, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Scans the host against the software draft.
java.lang.String	scan_Task(java.lang.String host, java.lang.String draft, InvocationConfig invocationConfig) Scans the host against the software draft.
java.lang.String	validate_Task(java.lang.String host, java.lang.String draft) Validates the software draft.
void	validate_Task(java.lang.String host, java.lang.String draft, AsyncCallback<java.lang.String> asyncCallback) Validates the software draft.
void	validate_Task(java.lang.String host, java.lang.String draft, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Validates the software draft.
java.lang.String	validate_Task(java.lang.String host, java.lang.String draft, InvocationConfig invocationConfig) Validates the software draft.

Method Detail

commit_Task

java.lang.String commit_Task(java.lang.String host,
                             java.lang.String draft,
                             DraftsTypes.CommitSpec spec)

Commits the specified draft as the desired state document. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. It will also validate the document before committing it. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

spec - The spec to be used to create the commit.

Returns:

identifier for the task created by this API invocation

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotAllowedInCurrentState - If there is another operation in progress.

NotFound - If there is no host associated with host or if there is no draft associated with draft in the system.

InvalidArgument - If validation of the software document fails. The value of the data property of Error will be a class that contains all the properties defined in DraftsTypes.ValidateResult.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

commit_Task

java.lang.String commit_Task(java.lang.String host,
                             java.lang.String draft,
                             DraftsTypes.CommitSpec spec,
                             InvocationConfig invocationConfig)

Commits the specified draft as the desired state document. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. It will also validate the document before committing it. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

spec - The spec to be used to create the commit.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotAllowedInCurrentState - If there is another operation in progress.

NotFound - If there is no host associated with host or if there is no draft associated with draft in the system.

InvalidArgument - If validation of the software document fails. The value of the data property of Error will be a class that contains all the properties defined in DraftsTypes.ValidateResult.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

commit_Task

void commit_Task(java.lang.String host,
                 java.lang.String draft,
                 DraftsTypes.CommitSpec spec,
                 AsyncCallback<java.lang.String> asyncCallback)

Commits the specified draft as the desired state document. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. It will also validate the document before committing it. This method was added in vSphere API 8.0.0.1.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotAllowedInCurrentState - If there is another operation in progress.
NotFound - If there is no host associated with host or if there is no draft associated with draft in the system.
InvalidArgument - If validation of the software document fails. The value of the data property of Error will be a class that contains all the properties defined in DraftsTypes.ValidateResult.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

spec - The spec to be used to create the commit.

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

commit_Task

void commit_Task(java.lang.String host,
                 java.lang.String draft,
                 DraftsTypes.CommitSpec spec,
                 AsyncCallback<java.lang.String> asyncCallback,
                 InvocationConfig invocationConfig)

Commits the specified draft as the desired state document. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. It will also validate the document before committing it. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotAllowedInCurrentState - If there is another operation in progress.
NotFound - If there is no host associated with host or if there is no draft associated with draft in the system.
InvalidArgument - If validation of the software document fails. The value of the data property of Error will be a class that contains all the properties defined in DraftsTypes.ValidateResult.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

spec - The spec to be used to create the commit.

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

invocationConfig - Configuration for the method invocation.

create

java.lang.String create(java.lang.String host)

Creates a new software draft from the desired document. It will be deleted, when the draft is committed successfully. This method was added in vSphere API 8.0.0.1.

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

Parameters:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

Returns:

Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

AlreadyExists - If there is already a draft created by this user.

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

create

java.lang.String create(java.lang.String host,
                        InvocationConfig invocationConfig)

Creates a new software draft from the desired document. It will be deleted, when the draft is committed successfully. This method was added in vSphere API 8.0.0.1.

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:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

invocationConfig - Configuration for the method invocation.

Returns:

Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

AlreadyExists - If there is already a draft created by this user.

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

create

void create(java.lang.String host,
            AsyncCallback<java.lang.String> asyncCallback)

Creates a new software draft from the desired document. It will be deleted, when the draft is committed successfully. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Operation Errors:
AlreadyExists - If there is already a draft created by this user.
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

Parameters:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

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

create

void create(java.lang.String host,
            AsyncCallback<java.lang.String> asyncCallback,
            InvocationConfig invocationConfig)

Creates a new software draft from the desired document. It will be deleted, when the draft is committed successfully. This method was added in vSphere API 8.0.0.1.

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:
Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Operation Errors:
AlreadyExists - If there is already a draft created by this user.
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

Parameters:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

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

invocationConfig - Configuration for the method invocation.

delete

void delete(java.lang.String host,
            java.lang.String draft)

Deletes the software draft. This method was added in vSphere API 8.0.0.1.

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

Parameters:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

delete

void delete(java.lang.String host,
            java.lang.String draft,
            InvocationConfig invocationConfig)

Deletes the software draft. This method was added in vSphere API 8.0.0.1.

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:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

invocationConfig - Configuration for the method invocation.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

delete

void delete(java.lang.String host,
            java.lang.String draft,
            AsyncCallback<java.lang.Void> asyncCallback)

Deletes the software draft. This method was added in vSphere API 8.0.0.1.

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

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

Parameters:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

delete

void delete(java.lang.String host,
            java.lang.String draft,
            AsyncCallback<java.lang.Void> asyncCallback,
            InvocationConfig invocationConfig)

Deletes the software draft. This method was added in vSphere API 8.0.0.1.

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 - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

Parameters:

host - Identifier of the host The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the draft. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

invocationConfig - Configuration for the method invocation.

get

DraftsTypes.Info get(java.lang.String host,
                     java.lang.String draft)

Returns the information about given software draft. This method was added in vSphere API 8.0.0.1.

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

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Returns:

Information about the Software Draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

get

DraftsTypes.Info get(java.lang.String host,
                     java.lang.String draft,
                     InvocationConfig invocationConfig)

Returns the information about given software draft. This method was added in vSphere API 8.0.0.1.

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:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the Software Draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

get

void get(java.lang.String host,
         java.lang.String draft,
         AsyncCallback<DraftsTypes.Info> asyncCallback)

Returns the information about given software draft. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
Information about the Software Draft.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

get

void get(java.lang.String host,
         java.lang.String draft,
         AsyncCallback<DraftsTypes.Info> asyncCallback,
         InvocationConfig invocationConfig)

Returns the information about given software draft. This method was added in vSphere API 8.0.0.1.

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:
Information about the Software Draft.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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,DraftsTypes.Summary> list(java.lang.String host,
                                                         DraftsTypes.FilterSpec filter)

Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec. This method was added in vSphere API 8.0.0.1.

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

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

filter - Filter to be applied while returning drafts. If null, all drafts will be returned.

Returns:

Map of software drafts keyed by their identifiers. The key in the return value Map will be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

list

java.util.Map<java.lang.String,DraftsTypes.Summary> list(java.lang.String host,
                                                         DraftsTypes.FilterSpec filter,
                                                         InvocationConfig invocationConfig)

Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec. This method was added in vSphere API 8.0.0.1.

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:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

filter - Filter to be applied while returning drafts. If null, all drafts will be returned.

invocationConfig - Configuration for the method invocation.

Returns:

Map of software drafts keyed by their identifiers. The key in the return value Map will be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

list

void list(java.lang.String host,
          DraftsTypes.FilterSpec filter,
          AsyncCallback<java.util.Map<java.lang.String,DraftsTypes.Summary>> asyncCallback)

Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
Map of software drafts keyed by their identifiers. The key in the return value Map will be an identifier for the resource type: com.vmware.esx.settings.draft.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

filter - Filter to be applied while returning drafts. If null, all drafts will be returned.

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

list

void list(java.lang.String host,
          DraftsTypes.FilterSpec filter,
          AsyncCallback<java.util.Map<java.lang.String,DraftsTypes.Summary>> asyncCallback,
          InvocationConfig invocationConfig)

Returns information about the software drafts for the specified host that match the DraftsTypes.FilterSpec. This method was added in vSphere API 8.0.0.1.

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:
Map of software drafts keyed by their identifiers. The key in the return value Map will be an identifier for the resource type: com.vmware.esx.settings.draft.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

filter - Filter to be applied while returning drafts. If null, all drafts will be returned.

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

invocationConfig - Configuration for the method invocation.

validate_Task

java.lang.String validate_Task(java.lang.String host,
                               java.lang.String draft)

Validates the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Returns:

identifier for the task created by this API invocation

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

validate_Task

java.lang.String validate_Task(java.lang.String host,
                               java.lang.String draft,
                               InvocationConfig invocationConfig)

Validates the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

validate_Task

void validate_Task(java.lang.String host,
                   java.lang.String draft,
                   AsyncCallback<java.lang.String> asyncCallback)

Validates the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

validate_Task

void validate_Task(java.lang.String host,
                   java.lang.String draft,
                   AsyncCallback<java.lang.String> asyncCallback,
                   InvocationConfig invocationConfig)

Validates the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

invocationConfig - Configuration for the method invocation.

scan_Task

java.lang.String scan_Task(java.lang.String host,
                           java.lang.String draft)

Scans the host against the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Returns:

identifier for the task created by this API invocation

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

scan_Task

java.lang.String scan_Task(java.lang.String host,
                           java.lang.String draft,
                           InvocationConfig invocationConfig)

Scans the host against the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host or no draft associated with draft in the system.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

scan_Task

void scan_Task(java.lang.String host,
               java.lang.String draft,
               AsyncCallback<java.lang.String> asyncCallback)

Scans the host against the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

scan_Task

void scan_Task(java.lang.String host,
               java.lang.String draft,
               AsyncCallback<java.lang.String> asyncCallback,
               InvocationConfig invocationConfig)

Scans the host against the software draft. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host or no draft associated with draft in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

draft - Identifier of the working copy of the document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

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

invocationConfig - Configuration for the method invocation.

importSoftwareSpec

java.lang.String importSoftwareSpec(java.lang.String host,
                                    DraftsTypes.ImportSpec spec)

Imports the desired software specification. This method was added in vSphere API 8.0.0.1.

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

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

spec - Specification to import desired software specification.

Returns:

Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host in the system or if the source type of import specification is of either LATEST_RECOMMENDATION or CURRENT_SERIES_RECOMMENDATION, and a recommendation does not exist for the host. It was either never generated or deleted due to changes in host state such as a new desired image spec being committed.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

importSoftwareSpec

java.lang.String importSoftwareSpec(java.lang.String host,
                                    DraftsTypes.ImportSpec spec,
                                    InvocationConfig invocationConfig)

Imports the desired software specification. This method was added in vSphere API 8.0.0.1.

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:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

spec - Specification to import desired software specification.

invocationConfig - Configuration for the method invocation.

Returns:

Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Throws:

Error - If there is unknown internal error. The accompanying error message will give more details about the failure.

NotFound - If there is no host associated with host in the system or if the source type of import specification is of either LATEST_RECOMMENDATION or CURRENT_SERIES_RECOMMENDATION, and a recommendation does not exist for the host. It was either never generated or deleted due to changes in host state such as a new desired image spec being committed.

ServiceUnavailable - If the service is not available.

Unauthenticated - If the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

importSoftwareSpec

void importSoftwareSpec(java.lang.String host,
                        DraftsTypes.ImportSpec spec,
                        AsyncCallback<java.lang.String> asyncCallback)

Imports the desired software specification. This method was added in vSphere API 8.0.0.1.

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

Invocation Result:
Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system or if the source type of import specification is of either LATEST_RECOMMENDATION or CURRENT_SERIES_RECOMMENDATION, and a recommendation does not exist for the host. It was either never generated or deleted due to changes in host state such as a new desired image spec being committed.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

spec - Specification to import desired software specification.

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

importSoftwareSpec

void importSoftwareSpec(java.lang.String host,
                        DraftsTypes.ImportSpec spec,
                        AsyncCallback<java.lang.String> asyncCallback,
                        InvocationConfig invocationConfig)

Imports the desired software specification. This method was added in vSphere API 8.0.0.1.

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:
Identifier of the working copy of the document. The return value will be an identifier for the resource type: com.vmware.esx.settings.draft.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system or if the source type of import specification is of either LATEST_RECOMMENDATION or CURRENT_SERIES_RECOMMENDATION, and a recommendation does not exist for the host. It was either never generated or deleted due to changes in host state such as a new desired image spec being committed.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Write.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

spec - Specification to import desired software specification.

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

invocationConfig - Configuration for the method invocation.