com.vmware.vcenter.namespace_management package¶

Submodules¶

com.vmware.vcenter.namespace_management.cns_client module¶

The com.vmware.vcenter.namespace_management.cns_client module provides classes for configuration of Persistent Services capabilities on VC clusters.

class com.vmware.vcenter.namespace_management.cns_client.MaintenanceActionType(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The MaintenanceActionType class contains actions to be taken when an entity enters maintenance mode.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the MaintenanceActionType instance.

EnsureAccessibility = MaintenanceActionType(string='EnsureAccessibility')¶: The entity is going down temporarily for maintenance. Still need to ensure application availability and storage accessibility at least in a degraded level.

NoAction = MaintenanceActionType(string='NoAction')¶: Admin override to not delay or stop the entity from entering maintenance mode.

PermanentRemoval = MaintenanceActionType(string='PermanentRemoval')¶: The entity is getting permanently removed. Move applications, rebuild storage on other entities before allowing to proceed.

class com.vmware.vcenter.namespace_management.cns_client.StubFactory(stub_config)¶

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

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

com.vmware.vcenter.namespace_management.software_client module¶

The com.vmware.vcenter.namespace_management.software_client module provides classes for managing namespaces software components.

class com.vmware.vcenter.namespace_management.software_client.Clusters(config)¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The Clusters class provides methods to upgrade the vSphere clusters.

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

class Info(current_version=None, available_versions=None, last_upgraded_date=None, messages=None, state=None, upgrade_status=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.Info class contains detailed information about the cluster upgrade status and related information.

Tip

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

Parameters

current_version (str) – Current version of the cluster.
available_versions (list of str) – Set of available versions can be upgraded to.
last_upgraded_date (datetime.datetime or None) – Date of last successful upgrade. If None, the cluster has not yet been upgraded.
messages (list of Clusters.Message) – Current set of messages associated with the cluster version.
state (Clusters.State) – Current state of the upgrade.
upgrade_status (Clusters.UpgradeStatus or None) – Information about upgrade in progress. If None, the cluster upgrade is not in progress.

class Message(severity=None, details=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.Message class contains the information about the object configuration.

Tip

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

Parameters

severity (Clusters.Message.Severity) – Type of the message.
details (com.vmware.vapi.std_client.LocalizableMessage) – Details about the message.

class Severity(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The Clusters.Message.Severity class represents the severity of the message.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the Severity instance.

ERROR = Severity(string='ERROR')¶: Error message. This is accompanied by vCenter event and/or alarm.

INFO = Severity(string='INFO')¶: Informational message. This may be accompanied by vCenter event.

WARNING = Severity(string='WARNING')¶: Warning message. This may be accompanied by vCenter event.

class Result(res=None, exception=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.Result class contains the result of batch upgrade method.

Tip

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

Parameters

res (Clusters.Result.Res) – The result of batch upgrade method.
exception (Exception) – Exception when cluster pre-check failed during upgrade invocation. This attribute is optional and it is only relevant when the value of res is Clusters.Result.Res.REJECTED.

class Res(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The Clusters.Result.Res class represents the upgrade invocation result for each cluster.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the Res instance.

REJECTED = Res(string='REJECTED')¶: Upgrade is rejected. This implies pre-check failed when invoking upgrade of the cluster.

STARTED = Res(string='STARTED')¶: Upgrade is started.

class State(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The Clusters.State class describes the state of the upgrade.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the State instance.

ERROR = State(string='ERROR')¶: Upgrade failed and need user intervention.

PENDING = State(string='PENDING')¶: Upgrade is in progress.

READY = State(string='READY')¶: Cluster is ready when there is no upgrade or upgrade is completed.

class Summary(cluster=None, cluster_name=None, current_version=None, available_versions=None, last_upgraded_date=None, desired_version=None, state=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.Summary class contains basic information about the cluster upgrade related information.

Tip

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

Parameters

cluster (str) – Identifier for the cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource.
cluster_name (str) – Name of the cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource.name. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource.name.
current_version (str) – Current version of the cluster.
available_versions (list of str) – Set of versions available for upgrade.
last_upgraded_date (datetime.datetime or None) – Date of last successful upgrade. If None, the cluster has not yet been upgraded.
desired_version (str or None) – Desired version the cluster will be upgraded to. If None, the cluster upgrade is not in progress.
state (Clusters.State) – Current state of the upgrade.

class UpgradeProgress(total=None, completed=None, message=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.UpgradeProgress class contains detailed information about the cluster upgrade progess.

Tip

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

Parameters

total (long) – Total amount of the work for the operation. The work here represents the number of master nodes in the cluster need to be upgraded.
completed (long) – The amount of work completed for the operation. The value can only be incremented. The number or master nodes which upgrade completed.
message (com.vmware.vapi.std_client.LocalizableMessage) – Message about the work progress.

class UpgradeSpec(desired_version=None, ignore_precheck_warnings=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.UpgradeSpec class contains the specification required to upgrade a cluster.

Tip

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

Parameters

desired_version (str) – Version number the cluster is going to be upgraded to.
ignore_precheck_warnings (bool or None) – If true, the upgrade workflow will ignore any pre-check warnings and proceed with the upgrade. If None, the upgrade workflow will not ignore pre-check warnings and fail the upgrade. It is equivalent to setting the value to false. The workflow adopts a conservative approach of failing the upgrade if None to solely let the user decide whether to force the upgrade despite the warnings.

class UpgradeStatus(desired_version=None, messages=None, progress=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Clusters.UpgradeStatus class contains detailed information about the cluster when upgraded is in progress.

Tip

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

Parameters

desired_version (str or None) – Desired version the cluster will be upgraded to. If None, the cluster upgrade is not in progress.
messages (list of Clusters.Message) – Current set of messages associated with the upgrade state.
progress (Clusters.UpgradeProgress or None) – Information about upgrade progess. If None, the cluster upgrade is not in progress.

get(cluster)¶

Returns upgrade related information of a specific cluster.

Parameters: cluster (str) – Identifier for the cluster which will be upgraded. The parameter must be an identifier for the resource type: ClusterComputeResource.
Return type: Clusters.Info
Returns: Information about the upgrade of the specified WCP enabled cluster.
Raise: com.vmware.vapi.std.errors_client.NotFound if cluster could not be located.
Raise: com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.
Raise: com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.
Raise: com.vmware.vapi.std.errors_client.Unauthorized if the user does not have System.Read privilege.
Raise: com.vmware.vapi.std.errors_client.Unsupported if the cluster is not WCP enabled.

list()¶

Returns upgrade related information about all WCP enabled clusters.

Return type: list of Clusters.Summary
Returns: List of upgrade summary of all WCP enabled clusters.
Raise: com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.
Raise: com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.
Raise: com.vmware.vapi.std.errors_client.Unauthorized if the user does not have System.Read privilege.

upgrade(cluster, spec)¶

Upgrade the cluster to a specific version. This operation upgrades the components on control plane VMs and worker plane hosts based on the selected version. Before upgrading, this operation performs pre-checks and sets the evaluation response in Info.UpgradeStatus.messages with various Message.Severity levels. Depending on the severity, the upgrade may or may not proceed beyond prechecks. Here is a list of severities and corresponding behavior: - ERROR: Upgrade does not proceed beyond precheck operation - WARNING: Upgrade proceeds beyond precheck operation only if UpgradeSpec.ignorePrecheckWarnings is set to true - INFO: Upgrade proceeds beyond precheck operation uninterrupted

Parameters

cluster (str) – Identifier for the cluster which will be upgraded. The parameter must be an identifier for the resource type: ClusterComputeResource.
spec (Clusters.UpgradeSpec) – Specification for upgrading the cluster.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.Unsupported if pre-check failed of the cluster.

Raise

com.vmware.vapi.std.errors_client.NotFound if cluster could not be located.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have Namespaces.Upgrade privilege.

upgrade_multiple(specs)¶

Upgrade a set of clusters to its corresponding specific version.

Parameters: specs (dict of str and Clusters.UpgradeSpec) – Specifications for upgrading selected clusters. The key in the parameter dict must be an identifier for the resource type: ClusterComputeResource.
Return type: dict of str and Clusters.Result
Returns: Pre-check result when invoking upgrade for each cluster. The key in the return value dict will be an identifier for the resource type: ClusterComputeResource.
Raise: com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.
Raise: com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.
Raise: com.vmware.vapi.std.errors_client.Unauthorized if the user does not have Namespaces.Upgrade privilege on all specified clusters.

class com.vmware.vcenter.namespace_management.software_client.StubFactory(stub_config)¶

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

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

com.vmware.vcenter.namespace_management.stats_client module¶

The com.vmware.vcenter.namespace_management.stats_client module provides classes for gathering statistics related to various Namespaces related components.

class com.vmware.vcenter.namespace_management.stats_client.StubFactory(stub_config)¶

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

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

class com.vmware.vcenter.namespace_management.stats_client.TimeSeries(config)¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The TimeSeries class provides methods to gather statistical values for clusters, namespaces and pods.

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

class PodIdentifier(namespace=None, pod_name=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

Pod identifier. These are the fields required to uniquely identify a pod.

Tip

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

Parameters

namespace (str) – The namespace that the pod is running in. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.
pod_name (str) – The name of the pod itself.

class Spec(obj_type=None, pod=None, namespace=None, cluster=None, start=None, end=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

This structure is sent in a request for TimeSeries data and is used to specify what object stats should be returned for.

Tip

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

Parameters

obj_type (TimeSeries.Spec.ObjType) – Type of statistics object that the request is operating on.
pod (TimeSeries.PodIdentifier) – Pod Identifier for queries on an individual pod. This attribute is optional and it is only relevant when the value of objType is TimeSeries.Spec.ObjType.POD.
namespace (str) – Namespace name for queries for a namespace. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance. This attribute is optional and it is only relevant when the value of objType is TimeSeries.Spec.ObjType.NAMESPACE.
cluster (str) – Cluster identifier for queries for a cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource. This attribute is optional and it is only relevant when the value of objType is TimeSeries.Spec.ObjType.CLUSTER.
start (long) – UNIX timestamp value indicating when the requested series of statistical samples should begin. https://en.wikipedia.org/wiki/Unix_time
end (long) – UNIX timestamp value indicating when the requested series of statistical samples should end. https://en.wikipedia.org/wiki/Unix_time

class ObjType(string)¶

Bases: vmware.vapi.bindings.enum.Enum

Type of statistics object that this request is operating on.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the ObjType instance.

CLUSTER = ObjType(string='CLUSTER')¶: The CLUSTER object type is used when specifying a vSphere cluster.

NAMESPACE = ObjType(string='NAMESPACE')¶: The NAMESPACE object type is used to specify a namespace.

POD = ObjType(string='POD')¶: The POD object type is used to specify an individual pod within a namespace.

class TimeSeries(counter=None, time_stamps=None, values=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

A set of timestamps and statistical values representing a time series. The lengths of TimeSeries.TimeSeries.time_stamps and TimeSeries.TimeSeries.values will always match each other.

Tip

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

Parameters

counter (str) – Counter identifier.
time_stamps (list of long) – Sequence of UNIX timestamp values at which statistical values were sampled. https://en.wikipedia.org/wiki/Unix_time
values (list of long) – Sequence of sampled values corresponding to the timestamps in tss.

get(spec)¶

Gather statistical values for a cluster, namespace, or pod.

Parameters: spec (TimeSeries.Spec) – Specification of the statistical values that should be returned.
Return type: list of TimeSeries.TimeSeries
Returns: A list of TimeSeries values for each counter specified in the request.
Raise: com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.
Raise: com.vmware.vapi.std.errors_client.InvalidArgument if the start time in TimeSeries.Spec.start is invalid, or the end time in TimeSeries.Spec.end is invalid.
Raise: com.vmware.vapi.std.errors_client.NotFound if the specified cluster in TimeSeries.Spec.cluster or the namespace in TimeSeries.Spec.namespace or TimeSeries.Spec.pod does not exist.
Raise: com.vmware.vapi.std.errors_client.Unsupported if the specified cluster in TimeSeries.Spec.cluster is not enabled for Namespaces.
Raise: com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.
Raise: com.vmware.vapi.std.errors_client.Unauthorized if the user does not have System.Read privilege.

com.vmware.vcenter.namespace_management.supervisor_services_client module¶

The com.vmware.vcenter.namespace_management.supervisor_services_client module provides classes for managing supervisor services that are extensions to the Supervisor.

class com.vmware.vcenter.namespace_management.supervisor_services_client.ClusterSupervisorServices(config)¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The ClusterSupervisorServices class provides methods to manage a Supervisor Service on the vSphere Supervisors. This class was added in vSphere API 7.0.3.0.

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

class ConfigStatus(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The ClusterSupervisorServices.ConfigStatus class describes the status of reaching the desired state configuration for the Supervisor Service. This enumeration was added in vSphere API 7.0.3.0.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the ConfigStatus instance.

CONFIGURED = ConfigStatus(string='CONFIGURED')¶: The Supervisor Service has been configured correctly (i.e. the provided YAML content has been applied successfully to the cluster). This class attribute was added in vSphere API 7.0.3.0.

CONFIGURING = ConfigStatus(string='CONFIGURING')¶: The Supervisor Service is being installed. This class attribute was added in vSphere API 7.0.3.0.

ERROR = ConfigStatus(string='ERROR')¶: Failed to install the Supervisor Service, user intervention needed. This class attribute was added in vSphere API 7.0.3.0.

REMOVING = ConfigStatus(string='REMOVING')¶: The Supervisor Service is being deleted. This class attribute was added in vSphere API 7.0.3.0.

class CreateSpec(supervisor_service=None, version=None, service_config=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ClusterSupervisorServices.CreateSpec class provides a specification required to create a Supervisor Service on a vSphere Supervisor. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

supervisor_service (str) – Identifier of the Supervisor Service. This Supervisor Service must be in the ACTIVATED state. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
version (str) – Identifier of the Supervisor Service version which contains the service definition. This Supervisor Service version must be in the ACTIVATED state. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.
service_config ((dict of str and str) or None) – A generic key-value map for additional configuration parameters required during service creation. As an example, a third party operator might reference a private registry using parameters such as “registryName” for the registry name, “registryUsername” and “registryPassword” for the registry credentials. This attribute was added in vSphere API 7.0.3.0. If None, no additional configuration parameters will be applied when installing a Supervisor Service in the vSphere Supervisor.

class Info(desired_version=None, service_namespace=None, config_status=None, messages=None, current_version=None, display_name=None, description=None, prefix=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ClusterSupervisorServices.Info class contains the detailed information about a Supervisor Service on the vSphere Supervisor. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

desired_version (str) – The desired version of this Supervisor Service. This attribute was added in vSphere API 7.0.3.0.
service_namespace (str or None) – Identifier of the namespace to allocate the Supervisor Service’s operators. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance. If None, there is an error when creating the service namespace or the namespace has not been created yet.
config_status (ClusterSupervisorServices.ConfigStatus) – Current setting for ClusterSupervisorServices.ConfigStatus. This attribute was added in vSphere API 7.0.3.0.
messages (list of ClusterSupervisorServices.Message) – Current set of messages associated with the Supervisor Service on the vSphere Supervisor. This attribute was added in vSphere API 7.0.3.0.
current_version (str or None) – The current version for the Supervisor Service. This attribute was added in vSphere API 7.0.3.0. If None, there is no version installed for the Supervisor Service.
display_name (str) – A human readable name of the Supervisor Service. This attribute was added in vSphere API 7.0.3.0.
description (str or None) – A human readable description of the Supervisor Service. This attribute was added in vSphere API 7.0.3.0. If None, the description for the service version is empty.
prefix (str or None) – The prefix that will be added to the names of the Supervisor Service’s kubernetes resources. This attribute was added in vSphere API 7.0.3.0. If None, the prefix is not assigned yet.

class Message(severity=None, details=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ClusterSupervisorServices.Message class contains the information about the Supervisor Service configuration on a vSphere Supervisor. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

severity (ClusterSupervisorServices.Message.MessageSeverity) – Type of the message. This attribute was added in vSphere API 7.0.3.0.
details (com.vmware.vapi.std_client.LocalizableMessage or None) – Details about the message. This attribute was added in vSphere API 7.0.3.0. If None, message details are not required for taking actions.

class MessageSeverity(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The ClusterSupervisorServices.Message.MessageSeverity class represents the severity of the message. This enumeration was added in vSphere API 7.0.3.0.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the MessageSeverity instance.

ERROR = MessageSeverity(string='ERROR')¶: Error message. This is accompanied by vCenter event and/or alarm. This class attribute was added in vSphere API 7.0.3.0.

INFO = MessageSeverity(string='INFO')¶: Informational message. This may be accompanied by vCenter event. This class attribute was added in vSphere API 7.0.3.0.

WARNING = MessageSeverity(string='WARNING')¶: Warning message. This may be accompanied by vCenter event. This class attribute was added in vSphere API 7.0.3.0.

class SetSpec(version=None, service_config=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ClusterSupervisorServices.SetSpec class provides a specification required to set a new configuration on a Supervisor Service in a vSphere Supervisor. This class is applied in entirety, replacing the current specification fully. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

version (str) – Identifier of the Supervisor Service version which contains the service definition. This Supervisor Service version must be in the ACTIVATED state. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.
service_config ((dict of str and str) or None) – A generic key-value map for additional configuration parameters required during service upgrade. As an example, a third party operator might reference a private registry using parameters such as “registryName” for the registry name, “registryUsername” and “registryPassword” for the registry credentials. This attribute was added in vSphere API 7.0.3.0. If None, no additional configuration parameters will be applied when upgrading a Supervisor Service in the vSphere Supervisor.

class Summary(supervisor_service=None, desired_version=None, config_status=None, current_version=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ClusterSupervisorServices.Summary class contains the basic information about a Supervisor Service on the vSphere Supervisor. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

supervisor_service (str) – The identifier of the Supervisor Service. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
desired_version (str) – The desired version of this Supervisor Service. This attribute was added in vSphere API 7.0.3.0.
config_status (ClusterSupervisorServices.ConfigStatus) – Current setting for ClusterSupervisorServices.ConfigStatus. This attribute was added in vSphere API 7.0.3.0.
current_version (str or None) – The current version for the Supervisor Service. This attribute was added in vSphere API 7.0.3.0. If None, there is no version installed for the Supervisor Service.

create(cluster, spec)¶

Create a Supervisor Service on the specified vSphere Supervisor. This method will apply the Supervisor Service version’s service definition on the cluster. This method is possible only when the Supervisor Service and Supervisor Service version are in the ACTIVATED state. A Supervisor can be running on one or multiple vSphere Zones, and each vSphere Zone is associated with one or more vSphere Clusters. If a Supervisor running on the specified vSphere Cluster is running on additional vSphere Clusters, this operation will apply to Supervisor components running on the other vSphere Clusters in addition to the specified vSphere Cluster. To call this API on a Supervisor with multiple vSphere Clusters, use com.vmware.vcenter.namespace_management.supervisors.Topology#get to get the vSphere Clusters associated with the given Supervisor. Any cluster from the list returned can be used as the input of this API. This method was added in vSphere API 7.0.3.0.

Parameters

cluster (str) – Identifier for the Supervisor on which to create the service. The parameter must be an identifier for the resource type: ClusterComputeResource.
spec (ClusterSupervisorServices.CreateSpec) – Specification for the Supervisor Service on the cluster.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.InvalidArgument if spec contains any errors.

Raise

com.vmware.vapi.std.errors_client.AlreadyExists if a Supervisor Service ID defined in spec exists on the Supervisor

Raise

com.vmware.vapi.std.errors_client.NotFound if the specified cluster with ID cluster or Supervisor Service with the Supervisor Service ID defined in spec or version with the ID {param.name version} could not be located.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor doesn’t support Supervisor Services, or if the Supervisor Service cannot be created in the current state, e.g. the supervisor service version is in the DEACTIVATED state.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege on the specified cluster.

delete(cluster, supervisor_service)¶

Delete a Supervisor Service on the specified vSphere Supervisor. This method will remove the Supervisor Service with the specified identifier from the cluster, by removing the corresponding namespace and deleting the operator(s) associated with the Supervisor Service. Note that this operation doesn’t deal with the application instances that are created by the associated operator(s), so existing application instances could be orphaned if users don’t clean or migrate them. A Supervisor can be running on one or multiple vSphere Zones, and each vSphere Zone is associated with one or more vSphere Clusters. If a Supervisor running on the specified vSphere Cluster is running on additional vSphere Clusters, this operation will apply to Supervisor components running on the other vSphere Clusters in addition to the specified vSphere Cluster. To call this API on a Supervisor with multiple vSphere Clusters, use com.vmware.vcenter.namespace_management.supervisors.Topology#get to get the vSphere Clusters associated with the given Supervisor. Any cluster from the list returned can be used as the input of this API. This method was added in vSphere API 7.0.3.0.

Parameters

cluster (str) – Identifier for the Supervisor from which to delete the service. The parameter must be an identifier for the resource type: ClusterComputeResource.
supervisor_service (str) – Identifier for the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor with the ID cluster or the Supervisor Service does not exist on the Supervisor.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor doesn’t support Supervisor Services.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege on the specified cluster.

get(cluster, supervisor_service)¶

Return information about the specific Supervisor Service on the specified vSphere Supervisor. A Supervisor can be running on one or multiple vSphere Zones, and each vSphere Zone is associated with one or more vSphere Clusters. If a Supervisor running on the specified vSphere Cluster is running on additional vSphere Clusters, this operation will apply to Supervisor components running on the other vSphere Clusters in addition to the specified vSphere Cluster. To call this API on a Supervisor with multiple vSphere Clusters, use com.vmware.vcenter.namespace_management.supervisors.Topology#get to get the vSphere Clusters associated with the given Supervisor. Any cluster from the list returned can be used as the input of this API. This method was added in vSphere API 7.0.3.0.

Parameters

cluster (str) – Identifier for the cluster on which to get the service. The parameter must be an identifier for the resource type: ClusterComputeResource.
supervisor_service (str) – Identifier for the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.

Return type

ClusterSupervisorServices.Info

Returns

The information for the specified Supervisor Service on the specified cluster.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor with the ID cluster or the Supervisor Service does not exist on the Supervisor.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor doesn’t support Supervisor Services.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege on the specified cluster.

list(cluster)¶

Return the summaries about all Supervisor Services on the specified vSphere Supervisor. A Supervisor can be running on one or multiple vSphere Zones, and each vSphere Zone is associated with one or more vSphere Clusters. If a Supervisor running on the specified vSphere Cluster is running on additional vSphere Clusters, this operation will apply to Supervisor components running on the other vSphere Clusters in addition to the specified vSphere Cluster. To call this API on a Supervisor with multiple vSphere Clusters, use com.vmware.vcenter.namespace_management.supervisors.Topology#get to get the vSphere Clusters associated with the given Supervisor. Any cluster from the list returned can be used as the input of this API. This method was added in vSphere API 7.0.3.0.

Parameters: cluster (str) – Identifier for the cluster on which to list the services. The parameter must be an identifier for the resource type: ClusterComputeResource.
Return type: list of ClusterSupervisorServices.Summary
Returns: The list of summaries of all Supervisor Services on the cluster.
Raise: com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.
Raise: com.vmware.vapi.std.errors_client.NotFound if Supervisor with the ID cluster could not be located.
Raise: com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor doesn’t support Supervisor Services.
Raise: com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.
Raise: com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege on the specified cluster.

set(cluster, supervisor_service, spec)¶

Set a new configuration to the specified Supervisor Service on the specified vSphere Supervisor. This method will apply the new Supervisor Service version’s service definition to the existing Supervisor Service on the cluster. This method requires that the specified Supervisor Service is already installed in the specified Supervisor. Note that this operation doesn’t interfere with the application instances that are created by the associated operator(s). So users should make sure the new version is still compatible with the existing application instances. A Supervisor can be running on one or multiple vSphere Zones, and each vSphere Zone is associated with one or more vSphere Clusters. If a Supervisor running on the specified vSphere Cluster is running on additional vSphere Clusters, this operation will apply to Supervisor components running on the other vSphere Clusters in addition to the specified vSphere Cluster. To call this API on a Supervisor with multiple vSphere Clusters, use com.vmware.vcenter.namespace_management.supervisors.Topology#get to get the vSphere Clusters associated with the given Supervisor. Any cluster from the list returned can be used as the input of this API. This method was added in vSphere API 7.0.3.0.

Parameters

cluster (str) – Identifier for the Supervisor from which to delete the service. The parameter must be an identifier for the resource type: ClusterComputeResource.
supervisor_service (str) – Identifier for the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
spec (ClusterSupervisorServices.SetSpec) – Specification for the Supervisor Service on the cluster.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.InvalidArgument if spec contains any errors.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor with the ID cluster or Supervisor Service with the ID supervisor_service or version with the ID {param.name version} could not be located, or the Supervisor Service does not exist on the Supervisor.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor doesn’t support Supervisor Services or the specified version is not in the ACTIVATED state.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege on the specified cluster.

class com.vmware.vcenter.namespace_management.supervisor_services_client.StubFactory(stub_config)¶

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

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

class com.vmware.vcenter.namespace_management.supervisor_services_client.Versions(config)¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The Versions class provides methods to manage a version object of a Supervisor Service. A Supervisor Service version can be enabled on the vSphere Supervisor. This class was added in vSphere API 7.0.3.0.

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

class ContentType(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The Versions.ContentType class defines the type of content that describes the format of Supervisor Service version definition. This enumeration was added in vSphere API 7.0.3.0.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the ContentType instance.

CUSTOM_YAML = ContentType(string='CUSTOM_YAML')¶: The Supervisor Service version definition is provided as inline YAML document that follows a plain Kubernetes YAML format. This class attribute was added in vSphere API 7.0.3.0.

VSPHERE_APPS_YAML = ContentType(string='VSPHERE_APPS_YAML')¶: The Supervisor Service version definition is provided as inline YAML document that follows the vSphere application service format. This class attribute was added in vSphere API 7.0.3.0.

class CreateSpec(custom_spec=None, vsphere_spec=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Versions.CreateSpec class provides a specification required to create a Supervisor Service version. Exactly one of Versions.CreateSpec.custom_spec or Versions.CreateSpec.vsphere_spec must be set. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

custom_spec (Versions.CustomCreateSpec or None) –
The specification required to create a Supervisor Service version from inline content that is based on a plain Kubernetes YAML format.

. This attribute was added in vSphere API 7.0.3.0. If set, the service version will be created from inline content based on a plain Kubernetes YAML format.
vsphere_spec (Versions.VsphereCreateSpec or None) –
The specification required to create a Supervisor Service version from inline content that is based on the vSphere application service format.

. This attribute was added in vSphere API 7.0.3.0. If set, the service version will be created from inline content based on the vSphere application service format.

class CustomCreateSpec(version=None, display_name=None, description=None, content=None, trusted_provider=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Versions.CustomCreateSpec class provides a specification required to create a Supervisor Service version from a plain Kubernetes YAML format. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

version (str) – The identifier of the Supervisor Service version. This must be a semantic version. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.
display_name (str) – A human readable name of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0.
description (str or None) – A human readable description of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0. If None, the description for the service version will be empty.
content (str) – Inline content that contains all service definition of the version, which shall be base64 encoded. The service definition here follows a plain Kubernetes YAML format. This attribute was added in vSphere API 7.0.3.0.
trusted_provider (bool or None) – Whether or not the Supervisor Service version is from a trusted provider, this field must be set to false if the service version is not from a trusted provider. If it is set to be true, but the content is not signed or the signature is invalid, an InvalidArgument will be thrown. This attribute was added in vSphere API 7.0.3.0. If None, the default value is true. In this case, the content must be signed and will be verified.

class Info(display_name=None, description=None, eula=None, content_type=None, content=None, trust_verified=None, state=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Versions.Info class contains detailed information about a Supervisor Service version. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

display_name (str) – The human readable name of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0.
description (str or None) – A human-readable description of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0. If None, no description is available for the Supervisor Service version.
eula (str or None) – The End User License Agreement (EULA) associated with the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0. If None, no EULA is available for the Supervisor Service version.
content_type (Versions.ContentType) – The content type of content. This attribute was added in vSphere API 7.0.3.0.
content (str or None) – Inline content that contains base64 encoded service definition for the version. This attribute was added in vSphere API 7.0.3.0. If None, no content is available for the Supervisor Service version.
trust_verified (bool) – If true, the Supervisor Service version is from trusted provider and the trust is verified. This attribute was added in vSphere API 7.0.3.0.
state (Versions.State) – The current Versions.State of the version. This attribute was added in vSphere API 7.0.3.0.

class State(string)¶

Bases: vmware.vapi.bindings.enum.Enum

The Versions.State class defines the state of a Supervisor Service version. This enumeration was added in vSphere API 7.0.3.0.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters: string (str) – String value for the State instance.

ACTIVATED = State(string='ACTIVATED')¶: The is the default state of a Supervisor Service version upon creation. In this state, all operations on the version should work as normal. This class attribute was added in vSphere API 7.0.3.0.

DEACTIVATED = State(string='DEACTIVATED')¶: The is the deactivated state of a Supervisor Service version. In this state, certain operations on the version are disallowed, for example, the version cannot be created on the vSphere Supervisor clusters. This class attribute was added in vSphere API 7.0.3.0.

class Summary(version=None, display_name=None, state=None, description=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Versions.Summary class contains the basic information about a Supervisor Service version. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

version (str) – The identifier of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.
display_name (str) – A human readable name of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0.
state (Versions.State) – The current Versions.State of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0.
description (str or None) – A human readable description of the Supervisor Service version. This attribute was added in vSphere API 7.0.3.0. If None, no description is available for the service version.

class VsphereCreateSpec(content=None, trusted_provider=None, accept_eula=None)¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Versions.VsphereCreateSpec class provides a specification required to create a Supervisor Service version from vSphere application service format, which shall contain the Supervisor Service identifier, version identifier, display name and description information. This class was added in vSphere API 7.0.3.0.

Tip

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

Parameters

content (str) – Inline content that contains all service definition of the version in vSphere application service format, which shall be base64 encoded. This attribute was added in vSphere API 7.0.3.0.
trusted_provider (bool or None) – Whether or not the Supervisor Service version is from a trusted provider, this field must be set to false if the service version is not from a trusted provider. If it is set to be true, but the content is not signed or the signature is invalid, an InvalidArgument will be thrown. This attribute was added in vSphere API 7.0.3.0. If None, the default value is true. In this case, the content must be signed and will be verified.
accept_eula (bool or None) – Whether or not the End User License Agreement (EULA) that is specified in the content is accepted. If a EULA is specified, this attribute must be set to be true so that the Supervisor Service version can be created. This attribute was added in vSphere API 7.0.3.0. If None, the default value is false.

activate(supervisor_service, version)¶

Activate a Supervisor Service version. This method will change the Versions.State of the version to ACTIVATED state. This method was added in vSphere API 7.0.3.0.

Parameters

supervisor_service (str) – Identifier for the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
version (str) – Identifier of the version. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor Service version cannot be activated in the current state, for example, the Supervisor Service is in DEACTIVATED state.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor Service with the ID supervisor_service or version with the ID {param.name version} could not be located.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege.

create(supervisor_service, spec)¶

Create a Supervisor Service version based on the provided service definition information for the version. This method was added in vSphere API 7.0.3.0.

Parameters

supervisor_service (str) – Identifier of the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
spec (Versions.CreateSpec) – Specification for the Supervisor Service version to be created.

Raise

com.vmware.vapi.std.errors_client.AlreadyExists if a Supervisor Service version with the same identifier already exists.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.InvalidArgument if an invalid field in spec is specified or if it contains any errors. For example, when the field trusted is set to be true, but no signature is provided or it is invalid or when a EULA is specified but not accepted.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor Service version cannot be created in the current state, for example, the Supervisor Service is in DEACTIVATED state.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor Service with the ID supervisor_service could not be located.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t have the SupervisorServices.Manage privilege.

deactivate(supervisor_service, version)¶

Deactivate a Supervisor Service version. This method will change the Versions.State of the version to DEACTIVATED state, which will make sure the version cannot be created on any Supervisor cluster. Note that this method should be called before deleting the version. This method was added in vSphere API 7.0.3.0.

Parameters

supervisor_service (str) – Identifier for the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
version (str) – Identifier of the version. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor Service version cannot be deactivated in the current state, for example, the Supervisor Service is in ACTIVATED state and this version is the last version of the Supervisor Service in ACTIVATED state.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor Service with the ID supervisor_service or version with the ID version could not be located.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have the SupervisorServices.Manage privilege.

delete(supervisor_service, version)¶

Delete a Supervisor Service version. This method only deletes the Supervisor Service version from vCenter if the version is in DEACTIVATED state and all instances of the version are removed from all Supervisors. Note that the deactivate method should be called to deactivate the version before the version can be deleted.

Note that deleting the last version of the supervisor_service does not delete the supervisor_service instance automatically.. This method was added in vSphere API 7.0.3.0.

Parameters

supervisor_service (str) – Identifier of the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
version (str) – Identifier of the version. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request, e.g. if it is unable to reach a vSphere Supervisor that has the version enabled.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the Supervisor Service version cannot be deleted in the current state, e.g. the version is not in DEACTIVATED state.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor Service with the ID supervisor_service or version with the ID {param.name version} could not be located.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t have the SupervisorServices.Manage privilege.

get(supervisor_service, version)¶

Return the information for the specified Supervisor Service version. This method was added in vSphere API 7.0.3.0.

Parameters

supervisor_service (str) – Identifier of the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
version (str) – Identifier of the version. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.supervisor_services.Version.

Return type

Versions.Info

Returns

Information for the specified Supervisor Service version.

Raise

com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.

Raise

com.vmware.vapi.std.errors_client.NotFound if Supervisor Service with the ID supervisor_service or version with the ID {param.name version} could not be located.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t have the System.Read privilege.

list(supervisor_service)¶

Return the information about all versions of the Supervisor Service. This method was added in vSphere API 7.0.3.0.

Parameters: supervisor_service (str) – Identifier of the Supervisor Service. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespace_management.SupervisorService.
Return type: list of Versions.Summary
Returns: The list of summary of all service versions of the Supervisor Service.
Raise: com.vmware.vapi.std.errors_client.Error if the system reports an error while responding to the request.
Raise: com.vmware.vapi.std.errors_client.NotFound if service with the ID supervisor_service could not be located.
Raise: com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.
Raise: com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t have the System.Read privilege.