com.vmware.esx.settings.clusters.software.drafts package

Submodules

com.vmware.esx.settings.clusters.software.drafts.software_client module

The com.vmware.esx.settings.clusters.software.drafts.software_client module provides classes to manage draft of the software documents for ESX cluster.

class com.vmware.esx.settings.clusters.software.drafts.software_client.AddOn(config)

Bases: VapiInterface

The AddOn class provides methods to manage the OEM add-on specification in a software draft.

Parameters:: config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

RESOURCE_TYPE = 'com.vmware.esx.settings.add_on': Resource type for add-on resource

delete(cluster, draft)

Deletes the desired OEM add-on specification in the software draft.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

get(cluster, draft)

Returns the OEM add-on specification in a software draft.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

com.vmware.esx.settings_client.AddOnInfo

Returns:

OEM add-on specification.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system or no add-on specification is set.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

set(cluster, draft, spec)

Sets a new desired OEM add-on specification in the software draft. It will overwrite the existing desired OEM add-on specification if one already exists.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
spec (com.vmware.esx.settings_client.AddOnSpec) – AddOn specification.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

class com.vmware.esx.settings.clusters.software.drafts.software_client.BaseImage(config)

Bases: VapiInterface

The BaseImage class provides methods to manage the base-image specification in a software draft.

Parameters:: config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

RESOURCE_TYPE = 'com.vmware.esx.settings.base_image': Resource type for base-image resource

get(cluster, draft)

Returns the base-image specification in a software draft.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

com.vmware.esx.settings_client.BaseImageInfo

Returns:

Base-image specification.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

set(cluster, draft, spec)

Sets a new desired base-image specification in the software draft. It will overwrite the existing desired base-image specification if one already exists.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
spec (com.vmware.esx.settings_client.BaseImageSpec) – Base-image specification.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

class com.vmware.esx.settings.clusters.software.drafts.software_client.Components(config)

Bases: VapiInterface

The Components class provides methods to manage component specification in a software draft.

Parameters:: config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

RESOURCE_TYPE = 'com.vmware.esx.settings.component': Resource type for component resource

class UpdateSpec(components_to_set=None, components_to_delete=None)

Bases: VapiStruct

The Components.UpdateSpec class contains attributes that are specified to update list of components in the draft.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

components_to_set ((dict of str and (str or None)) or None) – List of components to be updated. If the component already exists in the draft, the version is updated, else it is added. If a component is provided without version, then its version will be chosen based on constraints in the system. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.esx.settings.component. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.esx.settings.component. If None, no components will be added or updated.
components_to_delete (set of str or None) – List of components to be removed. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.esx.settings.component. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.esx.settings.component. If None, no components will be removed.

delete(cluster, draft, component)

Deletes the given component from the software draft.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
component (str) – Identifier of the component. The parameter must be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

get(cluster, draft, component)

Returns the component version for the given component in the software draft.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
component (str) – Identifier of the component. The parameter must be an identifier for the resource type: com.vmware.esx.settings.component.

Return type:

com.vmware.esx.settings_client.ComponentInfo or None

Returns:

Information about component version. If None then version will be chosen based on the constraints in the system.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft or no component associated with component in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

list(cluster, draft)

Returns the components that comprise the software draft.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

dict of str and com.vmware.esx.settings_client.ComponentInfo

Returns:

Map of component version information keyed by the component identifier. The key in the return value dict will be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

set(cluster, draft, component, version=None)

Set the component version for a given component in the software draft. This will overwrite any existing version for the given component.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
component (str) – Identifier of the component. The parameter must be an identifier for the resource type: com.vmware.esx.settings.component.
version (str or None) – Component version. This attribute is currently required. In the future,if this attribute is None then version is chosen based on the constraints in the system.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

update(cluster, draft, spec)

Updates the list of components in a given draft. This allows set and/or delete of multiple components in a batch operation.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
spec (Components.UpdateSpec) – Update specification containing list of components to add and/or delete.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

class com.vmware.esx.settings.clusters.software.drafts.software_client.EffectiveComponents(config)

Bases: VapiInterface

The EffectiveComponents class provides methods to manage effective list of components.

Parameters:: config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

list(cluster, draft)

Returns the components that comprise the desired software state of the cluster.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

dict of str and com.vmware.esx.settings_client.EffectiveComponentInfo

Returns:

Map of effective components keyed by their identifier. The key in the return value dict will be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

list_with_removed_components(cluster, draft)

Returns the list of all the effective components. Pass the param “with-removed-components” to get even the removed components. This method was added in vSphere API 8.0.3.0.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

dict of str and com.vmware.esx.settings_client.EffectiveComponentInfo

Returns:

Map of effective components keyed by their identifier. The key in the return value dict will be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no such cluster cluster in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

class com.vmware.esx.settings.clusters.software.drafts.software_client.HardwareSupport(config)

Bases: VapiInterface

The HardwareSupport class provides methods to manage a cluster’s Hardware Support Package (HSP) configuration in working copy documents.

Parameters:: config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

delete(cluster, draft)

Deletes a given cluster’s working copy document Hardware Support Package (HSP) configuration.

Parameters:

cluster (str) – Identifier for the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of image working copy document being updated The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster named cluster, no working copy document draft in the system, or no Hardware Support Package (HSP) configured as part of the working copy document.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

get(cluster, draft)

Returns a given cluster’s working copy document Hardware Support Package (HSP) configuration.

Parameters:

cluster (str) – Identifier for the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of image working copy document being updated The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

com.vmware.esx.settings_client.HardwareSupportInfo

Returns:

Hardware Support Package (HSP) configured for use

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster named cluster, no working copy document draft in the system, or no Hardware Support Package (HSP) configured as part of the working copy document.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

set(cluster, draft, spec)

Replaces a given cluster’s working copy document Hardware Support Package (HSP) configuration.

Parameters:

cluster (str) – Identifier for the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of image working copy document being updated The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
spec (com.vmware.esx.settings_client.HardwareSupportSpec) – new Hardware Support Package (HSP) configuration for the cluster

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster named cluster, no working copy document draft in the system, or no Hardware Support Package (HSP) configured as part of the working copy document.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

class com.vmware.esx.settings.clusters.software.drafts.software_client.RemovedComponents(config)

Bases: VapiInterface

The RemovedComponents class provides methods to manage removal of components in a software draft. This class was added in vSphere API 8.0.3.0.

Parameters:: config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

RESOURCE_TYPE = 'com.vmware.esx.settings.component': Resource type for component resource. This class attribute was added in vSphere API 8.0.3.0.

delete(cluster, draft, component)

Deletes the given component from the removed components section of the software draft. This method was added in vSphere API 8.0.3.0.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
component (str) – Identifier of the component. The parameter must be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized If the caller does not have the necessary privileges.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

get(cluster, draft, component)

Returns the component information for the given removed component in the software draft. This method was added in vSphere API 8.0.3.0.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
component (str) – Identifier of the component. The parameter must be an identifier for the resource type: com.vmware.esx.settings.component.

Return type:

com.vmware.esx.settings_client.ComponentInfo

Returns:

Information about component version.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft or no component associated with component in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized If the caller does not have the necessary privileges.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

list(cluster, draft)

Returns the components that comprise the removed components section of the software draft. This method was added in vSphere API 8.0.3.0.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.

Return type:

dict of str and com.vmware.esx.settings_client.ComponentInfo

Returns:

Map of component information keyed by the component identifier. The key in the return value dict will be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is some unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized If the caller does not have the necessary privileges.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Read.

set(cluster, draft, component)

Set the component to be removed in the software draft. This method was added in vSphere API 8.0.3.0.

Parameters:

cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
draft (str) – Identifier of the working copy document. The parameter must be an identifier for the resource type: com.vmware.esx.settings.draft.
component (str) – Identifier of the component. The parameter must be an identifier for the resource type: com.vmware.esx.settings.component.

Raise:

com.vmware.vapi.std.errors_client.Error If there is unknown internal error. The accompanying error message will give more details about the failure.

Raise:

com.vmware.vapi.std.errors_client.NotFound If there is no cluster associated with cluster or no draft associated with draft in the system.

Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable If the service is not available.

Raise:

com.vmware.vapi.std.errors_client.Unauthenticated If the caller is not authenticated.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized If the caller does not have the necessary privileges.

Raise:

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Write.
The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareSpecification.Write.

class com.vmware.esx.settings.clusters.software.drafts.software_client.StubFactory(stub_config)

Bases: StubFactoryBase

Initialize StubFactoryBase

Parameters:: stub_config (vmware.vapi.bindings.stub.StubConfiguration) – Stub config instance