public interface Software extends Service, SoftwareTypes
Software
interface provides methods to get and extract the current
software specification applied to the host. This interface was added in vSphere
API 7.0.2.0.SoftwareTypes.ConnectionSpec, SoftwareTypes.HostCredentials, SoftwareTypes.Info
_VAPI_SERVICE_ID
Modifier and Type | Method and Description |
---|---|
SoftwareTypes.Info |
get(SoftwareTypes.ConnectionSpec spec)
Returns details about the current software specification applied to the host.
|
void |
get(SoftwareTypes.ConnectionSpec spec,
AsyncCallback<SoftwareTypes.Info> asyncCallback)
Returns details about the current software specification applied to the host.
|
void |
get(SoftwareTypes.ConnectionSpec spec,
AsyncCallback<SoftwareTypes.Info> asyncCallback,
InvocationConfig invocationConfig)
Returns details about the current software specification applied to the host.
|
SoftwareTypes.Info |
get(SoftwareTypes.ConnectionSpec spec,
InvocationConfig invocationConfig)
Returns details about the current software specification applied to the host.
|
SoftwareTypes.Info get(SoftwareTypes.ConnectionSpec spec)
Synchronous method overload. Result of the invocation will be reported as a method return value.
spec
- ConnectionSpec connection spec for the host.InvalidArgument
- if the ConnectionSpec.HostCredentials#hostName
property of spec
is invalid.Error
- If there is some unknown internal error. The accompanying error message will
give more details about the failure.NotFound
- If there is no ConnectionSpec.HostCredentials#hostName
property
associated with host id in the system.ServiceUnavailable
- If the service is not available.Unauthenticated
- if the caller is not authenticated.UnverifiedPeer
- If the SSL certificate of the target node cannot be validated by comparing with
the thumbprint provided in ConnectionSpec.HostCredentials#sslThumbPrint
.Unauthorized
- if you do not have all of the privileges described as follows: VcIntegrity.lifecycleSoftwareSpecification.Read
.
SoftwareTypes.Info get(SoftwareTypes.ConnectionSpec spec, InvocationConfig invocationConfig)
Synchronous method overload. Result of the invocation will be
reported as a method return value.
Use invocationConfig
to specify configuration for this particular invocation.
spec
- ConnectionSpec connection spec for the host.invocationConfig
- Configuration for the method invocation.InvalidArgument
- if the ConnectionSpec.HostCredentials#hostName
property of spec
is invalid.Error
- If there is some unknown internal error. The accompanying error message will
give more details about the failure.NotFound
- If there is no ConnectionSpec.HostCredentials#hostName
property
associated with host id in the system.ServiceUnavailable
- If the service is not available.Unauthenticated
- if the caller is not authenticated.UnverifiedPeer
- If the SSL certificate of the target node cannot be validated by comparing with
the thumbprint provided in ConnectionSpec.HostCredentials#sslThumbPrint
.Unauthorized
- if you do not have all of the privileges described as follows: VcIntegrity.lifecycleSoftwareSpecification.Read
.
void get(SoftwareTypes.ConnectionSpec spec, AsyncCallback<SoftwareTypes.Info> asyncCallback)
Asynchronous method overload. Result of the invocation will be
reported via the specified asyncCallback
.
Invocation Result:
Info details about the current software specification applied to the host.
Operation Errors:
InvalidArgument
- if the ConnectionSpec.HostCredentials#hostName
property of spec
is invalid.
Error
- If there is some unknown internal error. The accompanying error message will
give more details about the failure.
NotFound
- If there is no ConnectionSpec.HostCredentials#hostName
property
associated with host id in the system.
ServiceUnavailable
- If the service is not available.
Unauthenticated
- if the caller is not authenticated.
UnverifiedPeer
- If the SSL certificate of the target node cannot be validated by comparing with
the thumbprint provided in ConnectionSpec.HostCredentials#sslThumbPrint
.
Unauthorized
- if you do not have all of the privileges described as follows:
VcIntegrity.lifecycleSoftwareSpecification.Read
.
spec
- ConnectionSpec connection spec for the host.asyncCallback
- Receives the status (progress, result or error) of the operation invocation.void get(SoftwareTypes.ConnectionSpec spec, AsyncCallback<SoftwareTypes.Info> asyncCallback, InvocationConfig invocationConfig)
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:
Info details about the current software specification applied to the host.
Operation Errors:
InvalidArgument
- if the ConnectionSpec.HostCredentials#hostName
property of spec
is invalid.
Error
- If there is some unknown internal error. The accompanying error message will
give more details about the failure.
NotFound
- If there is no ConnectionSpec.HostCredentials#hostName
property
associated with host id in the system.
ServiceUnavailable
- If the service is not available.
Unauthenticated
- if the caller is not authenticated.
UnverifiedPeer
- If the SSL certificate of the target node cannot be validated by comparing with
the thumbprint provided in ConnectionSpec.HostCredentials#sslThumbPrint
.
Unauthorized
- if you do not have all of the privileges described as follows:
VcIntegrity.lifecycleSoftwareSpecification.Read
.
spec
- ConnectionSpec connection spec for the host.asyncCallback
- Receives the status (progress, result or error) of the operation invocation.invocationConfig
- Configuration for the method invocation.