com.vmware package

Subpackages

Submodules

com.vmware.appliance_client module

The com.vmware.appliance_client module provides classes for managing vCenter Appliance configuration. The module is available starting in vSphere 6.7.

class com.vmware.appliance_client.Health(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Health class provides methods to retrieve the appliance health information. This class was added in vSphere API 6.7

messages(item)

Get health messages. This method was added in vSphere API 6.7

Parameters:item (str) – ID of the data item The parameter must be an identifier for the resource type: com.vmware.appliance.health.
Return type:list of Notification
Returns:List of the health messages
Raise:com.vmware.vapi.std.errors_client.NotFound Unknown health item
Raise:com.vmware.vapi.std.errors_client.Error Generic error
class com.vmware.appliance_client.LocalAccounts(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The LocalAccounts class provides methods to manage local user account. This class was added in vSphere API 6.7

class Config(password=None, old_password=None, full_name=None, email=None, roles=None, enabled=None, password_expires=None, password_expires_at=None, inactive_after_password_expiration=None, days_after_password_expiration=None, min_days_between_password_change=None, max_days_between_password_change=None, warn_days_before_password_expiration=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The LocalAccounts.Config class defines the information required for the account. This class was added in vSphere API 6.7

Tip

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

class Info(fullname=None, email=None, roles=None, enabled=None, has_password=None, last_password_change=None, password_expires_at=None, inactive_at=None, min_days_between_password_change=None, max_days_between_password_change=None, warn_days_before_password_expiration=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The LocalAccounts.Info class defines the local account properties. This class was added in vSphere API 6.7

Tip

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

class UpdateConfig(password=None, old_password=None, full_name=None, email=None, roles=None, enabled=None, password_expires=None, password_expires_at=None, inactive_after_password_expiration=None, days_after_password_expiration=None, min_days_between_password_change=None, max_days_between_password_change=None, warn_days_before_password_expiration=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The LocalAccounts.UpdateConfig class defines the fields that might be updated. This class was added in vSphere API 6.7

Tip

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

create(username, config)

Create a new local user account. This method was added in vSphere API 6.7

Parameters:
  • username (str) – User login name The parameter must be an identifier for the resource type: com.vmware.appliance.local_accounts.
  • config (LocalAccounts.Config) – User configuration
Raise:

com.vmware.vapi.std.errors_client.AlreadyExists If an account already exists
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument If a username is invalid (username is validated against [a-zA-Z0-9][a-zA-Z0-9-.\@]\*[a-zA-Z0-9] pattern)
Raise:

com.vmware.vapi.std.errors_client.Error Generic error
delete(username)

Delete a local user account. This method was added in vSphere API 6.7

Parameters:username (str) – User login name The parameter must be an identifier for the resource type: com.vmware.appliance.local_accounts.
Raise:com.vmware.vapi.std.errors_client.NotFound If the account is not found
Raise:com.vmware.vapi.std.errors_client.Error Generic error
get(username)

Get the local user account information. This method was added in vSphere API 6.7

Parameters:username (str) – User login name
Return type:LocalAccounts.Info
Returns:Local user account information
Raise:com.vmware.vapi.std.errors_client.NotFound If the account is not found
Raise:com.vmware.vapi.std.errors_client.Error Generic error
list()

Get a list of the local user accounts. This method was added in vSphere API 6.7

Return type:list of str
Returns:List of identifiers The return value will contain identifiers for the resource type: com.vmware.appliance.local_accounts.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
set(username, config)

Set local user account properties. This method was added in vSphere API 6.7

Parameters:
  • username (str) – User login name The parameter must be an identifier for the resource type: com.vmware.appliance.local_accounts.
  • config (LocalAccounts.Config) – User configuration
Raise:

com.vmware.vapi.std.errors_client.NotFound If the account is not found
Raise:

com.vmware.vapi.std.errors_client.Error Generic error
update(username, config)

Update selected fields in local user account properties. This method was added in vSphere API 6.7

Parameters:
  • username (str) – User login name The parameter must be an identifier for the resource type: com.vmware.appliance.local_accounts.
  • config (LocalAccounts.UpdateConfig) – User configuration
Raise:

com.vmware.vapi.std.errors_client.NotFound If the account is not found
Raise:

com.vmware.vapi.std.errors_client.Error Generic error
class com.vmware.appliance_client.Monitoring(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

Monitoring class provides methods Get and list monitoring data for requested item.

class FunctionType(string)

Bases: vmware.vapi.bindings.enum.Enum

Monitoring.FunctionType class Defines aggregation function

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.

AVG = FunctionType(string='AVG')

Aggregation takes average per period

COUNT = FunctionType(string='COUNT')

Aggregation takes count per period (sum)

MAX = FunctionType(string='MAX')

Aggregation takes maximums per period

MIN = FunctionType(string='MIN')

Aggregation takes minimums per period

class IntervalType(string)

Bases: vmware.vapi.bindings.enum.Enum

Monitoring.IntervalType class Defines interval between the values in hours and mins, for which aggregation will apply

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.

DAY1 = IntervalType(string='DAY1')

24 hours interval between values. One year has 365 values.

HOURS2 = IntervalType(string='HOURS2')

Two hours interval between values. One month has 360 values.

HOURS6 = IntervalType(string='HOURS6')

Six hour interval between values. One quarter is 360 values.

MINUTES30 = IntervalType(string='MINUTES30')

Thirty minutes interval between values. One week is 336 values.

MINUTES5 = IntervalType(string='MINUTES5')

Five minutes interval between values (finest). One day would have 288 values, one week is 2016.

class MonitoredItem(id=None, name=None, units=None, category=None, instance=None, description=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Monitoring.MonitoredItem class Structure representing requested monitored item data.

Tip

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

class MonitoredItemData(name=None, interval=None, function=None, start_time=None, end_time=None, data=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Monitoring.MonitoredItemData class Structure representing monitored item data.

Tip

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

class MonitoredItemDataRequest(names=None, interval=None, function=None, start_time=None, end_time=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Monitoring.MonitoredItemDataRequest class Structure representing requested monitored item data.

Tip

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

get(stat_id)

Get monitored item info

Parameters:stat_id (str) – statistic item id The parameter must be an identifier for the resource type: com.vmware.appliance.monitoring.
Return type:Monitoring.MonitoredItem
Returns:MonitoredItem structure
Raise:com.vmware.vapi.std.errors_client.Error Generic error
list()

Get monitored items list

Return type:list of Monitoring.MonitoredItem
Returns:list of names
Raise:com.vmware.vapi.std.errors_client.Error Generic error
query(item)

Get monitoring data.

Parameters:item (Monitoring.MonitoredItemDataRequest) – MonitoredItemDataRequest Structure
Return type:list of Monitoring.MonitoredItemData
Returns:list of MonitoredItemData structure
Raise:com.vmware.vapi.std.errors_client.Error Generic error
class com.vmware.appliance_client.Networking(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Networking class provides methods Get Network configurations. This class was added in vSphere API 6.7

class DNSInfo(mode=None, hostname=None, servers=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Networking.DNSInfo class contains information about the DNS configuration of a virtual appliance. This class was added in vSphere API 6.7

Tip

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

class DNSMode(string)

Bases: vmware.vapi.bindings.enum.Enum

The Networking.DNSInfo.DNSMode class describes the source of DNS servers. This enumeration was added in vSphere API 6.7

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.

DHCP = DNSMode(string='DHCP')

The DNS servers addresses are obtained from a DHCP server. This class attribute was added in vSphere API 6.7

STATIC = DNSMode(string='STATIC')

The DNS servers addresses are specified explicitly. This class attribute was added in vSphere API 6.7

class Info(dns=None, interfaces=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Networking.Info class contains information about the network configuration of a virtual appliance. This class was added in vSphere API 6.7

Tip

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

class UpdateSpec(ipv6_enabled=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Networking.UpdateSpec class describes whether to enable or disable ipv6 on interfaces. This class was added in vSphere API 6.7

Tip

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

get()

Get Networking information for all configured interfaces. This method was added in vSphere API 6.7

Return type:Networking.Info
Returns:The Map of network configuration info for all interfaces.
Raise:com.vmware.vapi.std.errors_client.Error Generic error.
reset()

Reset and restarts network configuration on all interfaces, also this will renew the DHCP lease for DHCP IP address. This method was added in vSphere API 6.7

Raise:com.vmware.vapi.std.errors_client.Error Generic error.
update(spec)

Enable or Disable ipv6 on all interfaces. This method was added in vSphere API 6.7

Parameters:spec (Networking.UpdateSpec) – update spec with optional boolean value
Raise:com.vmware.vapi.std.errors_client.Error Generic error.
class com.vmware.appliance_client.Notification(id=None, time=None, message=None, resolution=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Notification class describes a notification that can be reported by the appliance task. This class was added in vSphere API 6.7

Tip

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

class com.vmware.appliance_client.Notifications(info=None, warnings=None, errors=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Notifications class contains info/warning/error messages that can be reported be the appliance task. This class was added in vSphere API 6.7

Tip

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

class com.vmware.appliance_client.Ntp(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

Ntp class provides methods Gets NTP configuration status and tests connection to ntp servers. This class was added in vSphere API 6.7

class LocalizableMessage(id=None, default_message=None, args=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Ntp.LocalizableMessage class Structure representing message. This class was added in vSphere API 6.7

Tip

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

class ServerStatus(string)

Bases: vmware.vapi.bindings.enum.Enum

Ntp.ServerStatus class Status of server during test. This enumeration was added in vSphere API 6.7

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.

SERVER_REACHABLE = ServerStatus(string='SERVER_REACHABLE')

Server is reachable. This class attribute was added in vSphere API 6.7

SERVER_UNREACHABLE = ServerStatus(string='SERVER_UNREACHABLE')

Server is unreachable. This class attribute was added in vSphere API 6.7

class TestRunStatus(server=None, status=None, message=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Ntp.TestRunStatus class Status of the test. This class was added in vSphere API 6.7

Tip

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

get()

Get the NTP configuration status. If you run the ‘timesync.get’ command, you can retrieve the current time synchronization method (NTP- or VMware Tools-based). The ‘ntp’ command always returns the NTP server information, even when the time synchronization mode is not set to NTP. If the time synchronization mode is not NTP-based, the NTP server status is displayed as down. This method was added in vSphere API 6.7

Return type:list of str
Returns:List of NTP servers.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
set(servers)

Set NTP servers. This method updates old NTP servers from configuration and sets the input NTP servers in the configuration. If NTP based time synchronization is used internally, the NTP daemon will be restarted to reload given NTP configuration. In case NTP based time synchronization is not used, this method only replaces servers in the NTP configuration. This method was added in vSphere API 6.7

Parameters:servers (list of str) – List of host names or ip addresses of ntp servers.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
test(servers)

Test the connection to a list of ntp servers. This method was added in vSphere API 6.7

Parameters:servers (list of str) – List of host names or IP addresses of NTP servers.
Return type:list of Ntp.TestRunStatus
Returns:List of test run statuses.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
class com.vmware.appliance_client.Recovery(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Recovery class provides methods to invoke an appliance recovery (backup and restore). This class was added in vSphere API 6.7

class Info(supported=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Recovery.Info class contains the information about the appliance recovery environment. This class was added in vSphere API 6.7

Tip

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

get()

Gets the properties of the appliance Recovery subsystem. This method was added in vSphere API 6.7

Return type:Recovery.Info
Returns:Structure containing the properties of the Recovery subsystem.
Raise:com.vmware.vapi.std.errors_client.Error if any error occurs during the execution of the operation.
class com.vmware.appliance_client.Services(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Service class provides methods to manage a single/set of appliance services. This class was added in vSphere API 6.7

class Info(description=None, state=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Services.Info class contains information about a service. This class was added in vSphere API 6.7

Tip

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

class State(string)

Bases: vmware.vapi.bindings.enum.Enum

The Services.State class defines valid Run State for services. This enumeration was added in vSphere API 6.7

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.

STARTED = State(string='STARTED')

Service Run State is Started, it is fully functional. This class attribute was added in vSphere API 6.7

STARTING = State(string='STARTING')

Service Run State is Starting, it is still not functional. This class attribute was added in vSphere API 6.7

STOPPED = State(string='STOPPED')

Service Run State is Stopped. This class attribute was added in vSphere API 6.7

STOPPING = State(string='STOPPING')

Service Run State is Stopping, it is not functional. This class attribute was added in vSphere API 6.7

get(service)

Returns the state of a service. This method was added in vSphere API 6.7

Parameters:service (str) – identifier of the service whose state is being queried. The parameter must be an identifier for the resource type: com.vmware.appliance.services.
Return type:Services.Info
Returns:Service Info structure.
Raise:com.vmware.vapi.std.errors_client.NotFound if the service associated with service does not exist.
Raise:com.vmware.vapi.std.errors_client.Error if any other error occurs during the execution of the operation.
list()

Lists details of vCenter services. This method was added in vSphere API 6.7

Return type:dict of str and Services.Info
Returns:Map of service identifiers to service Info structures. The key in the return value dict will be an identifier for the resource type: com.vmware.appliance.services.
Raise:com.vmware.vapi.std.errors_client.Error if any error occurs during the execution of the operation.
restart(service)

Restarts a service. This method was added in vSphere API 6.7

Parameters:service (str) – identifier of the service to restart The parameter must be an identifier for the resource type: com.vmware.appliance.services.
Raise:com.vmware.vapi.std.errors_client.NotFound if the service associated with service does not exist.
Raise:com.vmware.vapi.std.errors_client.TimedOut if any timeout occurs during the execution of the restart operation.
Raise:com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the operation is denied in the current state of the service. If a stop or start operation is in progress, issuing a restart operation will lead to this error.
Raise:com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if a restart operation is issued on a service which has startup type null
Raise:com.vmware.vapi.std.errors_client.Error if any other error occurs during the execution of the operation.
start(service)

Starts a service. This method was added in vSphere API 6.7

Parameters:service (str) – identifier of the service to start The parameter must be an identifier for the resource type: com.vmware.appliance.services.
Raise:com.vmware.vapi.std.errors_client.NotFound if the service associated with service does not exist.
Raise:com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the operation is denied in the current state of the service. If a stop or restart operation is in progress, the start operation will not be allowed.
Raise:com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if start operation is issued on a service which has startup type null.
Raise:com.vmware.vapi.std.errors_client.TimedOut if any timeout occurs during the execution of the start operation. Timeout occurs when the service takes longer than StartTimeout to start.
Raise:com.vmware.vapi.std.errors_client.Error if any other error occurs during the execution of the operation.
stop(service)

Stops a service. This method was added in vSphere API 6.7

Parameters:service (str) – identifier of the service to stop The parameter must be an identifier for the resource type: com.vmware.appliance.services.
Raise:com.vmware.vapi.std.errors_client.NotFound if the service associated with service does not exist.
Raise:com.vmware.vapi.std.errors_client.Error if any other error occurs during the execution of the operation.
Raise:com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the operation is denied in the current state of the service. If a stop operation is in progress, issuing another stop operation will lead to this error.
class com.vmware.appliance_client.Shutdown(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

Shutdown class provides methods Performs reboot/shutdown operations on appliance. This class was added in vSphere API 6.7

class ShutdownConfig(shutdown_time=None, action=None, reason=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Shutdown.ShutdownConfig class Structure that defines shutdown configuration returned by the Shutdown.get operation. This class was added in vSphere API 6.7

Tip

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

cancel()

Cancel pending shutdown action. This method was added in vSphere API 6.7

Raise:com.vmware.vapi.std.errors_client.Error Generic error
get()

Get details about the pending shutdown action. This method was added in vSphere API 6.7

Return type:Shutdown.ShutdownConfig
Returns:Configuration of pending shutdown action.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
poweroff(delay, reason)

Power off the appliance. This method was added in vSphere API 6.7

Parameters:
  • delay (long) – Minutes after which poweroff should start. If 0 is specified, poweroff will start immediately.
  • reason (str) – Reason for peforming poweroff.
Raise:

com.vmware.vapi.std.errors_client.Error Generic error
reboot(delay, reason)

Reboot the appliance. This method was added in vSphere API 6.7

Parameters:
  • delay (long) – Minutes after which reboot should start. If 0 is specified, reboot will start immediately.
  • reason (str) – Reason for peforming reboot.
Raise:

com.vmware.vapi.std.errors_client.Error Generic error
class com.vmware.appliance_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

class com.vmware.appliance_client.SubtaskInfo(progress=None, result=None, description=None, service=None, operation=None, parent=None, target=None, status=None, cancelable=None, error=None, start_time=None, end_time=None, user=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The SubtaskInfo class contains information about one of the subtasks that makes up an appliance task. This class was added in vSphere API 6.7

Tip

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

class com.vmware.appliance_client.TaskInfo(progress=None, subtask_order=None, subtasks=None, description=None, service=None, operation=None, parent=None, target=None, status=None, cancelable=None, error=None, start_time=None, end_time=None, user=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The TaskInfo class contains information about an appliance task and the subtasks of which it consists. This class was added in vSphere API 6.7

Tip

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

class com.vmware.appliance_client.Timesync(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

Timesync class provides methods Performs time synchronization configuration. This class was added in vSphere API 6.7

class TimeSyncMode(string)

Bases: vmware.vapi.bindings.enum.Enum

The Timesync.TimeSyncMode class defines time synchronization modes. This enumeration was added in vSphere API 6.7

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.

DISABLED = TimeSyncMode(string='DISABLED')

Time synchronization is disabled. This class attribute was added in vSphere API 6.7

HOST = TimeSyncMode(string='HOST')

VMware Tool-based time synchronization. This class attribute was added in vSphere API 6.7

NTP = TimeSyncMode(string='NTP')

NTP-based time synchronization. This class attribute was added in vSphere API 6.7

get()

Get time synchronization mode. This method was added in vSphere API 6.7

Return type:Timesync.TimeSyncMode
Returns:Time synchronization mode.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
set(mode)

Set time synchronization mode. This method was added in vSphere API 6.7

Parameters:mode (Timesync.TimeSyncMode) – Time synchronization mode.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
class com.vmware.appliance_client.Update(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Update class provides methods to get the status of the appliance update. This class was added in vSphere API 6.7

class Info(state=None, task=None, version=None, latest_query_time=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Update.Info class describes the state of the appliance update. This class was added in vSphere API 6.7

Tip

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

class State(string)

Bases: vmware.vapi.bindings.enum.Enum

The Update.State class defines the various states the appliance update can be in. This enumeration was added in vSphere API 6.7

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.

INSTALL_FAILED = State(string='INSTALL_FAILED')

The appliance update failed and cannot recover. This class attribute was added in vSphere API 6.7

INSTALL_IN_PROGRESS = State(string='INSTALL_IN_PROGRESS')

The appliance update is in progress of installing an update. This class attribute was added in vSphere API 6.7

ROLLBACK_IN_PROGRESS = State(string='ROLLBACK_IN_PROGRESS')

The appliance update failed and recovery is in progress. This class attribute was added in vSphere API 6.7

STAGE_IN_PROGRESS = State(string='STAGE_IN_PROGRESS')

The appliance update is in progress of downloading an update. This class attribute was added in vSphere API 6.7

UPDATES_PENDING = State(string='UPDATES_PENDING')

A new update is available. This class attribute was added in vSphere API 6.7

UP_TO_DATE = State(string='UP_TO_DATE')

The appliance is up to date. This class attribute was added in vSphere API 6.7

cancel()

Request the cancellation the update operation that is currently in progress. This method was added in vSphere API 6.7

Raise:com.vmware.vapi.std.errors_client.Error Generic error
Raise:com.vmware.vapi.std.errors_client.NotAllowedInCurrentState Current task is not cancellable
Raise:com.vmware.vapi.std.errors_client.Unauthenticated session is not authenticated
Raise:com.vmware.vapi.std.errors_client.Unauthorized session is not authorized to perform this operation
get()

Gets the current status of the appliance update. This method was added in vSphere API 6.7

Return type:Update.Info
Returns:Info structure containing the status information about the appliance.
Raise:com.vmware.vapi.std.errors_client.Error Generic error
Raise:com.vmware.vapi.std.errors_client.Unauthenticated session is not authenticated
Raise:com.vmware.vapi.std.errors_client.Unauthorized session is not authorized to perform this operation

com.vmware.cis_client module

The com.vmware.cis_client module provides VMware common infrastructure classes.

class com.vmware.cis_client.Session(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Session class allows API clients to manage session tokens including creating, deleting and obtaining information about sessions.

The call to the Session.create() method is part of the overall authentication process for API clients. For example, the sequence of steps for establishing a session with SAML token is:

  • Connect to lookup service.
  • Discover the secure token service (STS) endpoint URL.
  • Connect to the secure token service to obtain a SAML token.
  • Authenticate to the lookup service using the obtained SAML token.
  • Discover the API endpoint URL from lookup service.
  • Call the Session.create() method. The Session.create() call must include the SAML token.

See the programming guide and samples for additional information about establishing API sessions.

Execution Context and Security Context

To use session based authentication a client should supply the session token obtained through the Session.create() method. The client should add the session token in the security context when using SDK classes. Clients using the REST API should supply the session token as a HTTP header.

Session Lifetime

A session begins with call to the Session.create() method to exchange a SAML token for a API session token. A session ends under the following circumstances:

  • Call to the Session.delete() method.
  • The session expires. Session expiration may be caused by one of the following situations:
  • Client inactivity - For a particular session identified by client requests that specify the associated session ID, the lapsed time since the last request exceeds the maximum interval between requests.
  • Unconditional or absolute session expiration time: At the beginning of the session, the session logic uses the SAML token and the system configuration to calculate absolute expiration time.

When a session ends, the authentication logic will reject any subsequent client requests that specify that session. Any operations in progress will continue to completion.

Error Handling

The Session returns the following exceptions:

  • com.vmware.vapi.std.errors_client.Unauthenticated exception for any exceptions related to the request.
  • com.vmware.vapi.std.errors_client.ServiceUnavailable exception for all exceptions caused by internal service failure.
class Info(user=None, created_time=None, last_accessed_time=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Represents data associated with an API session.

Tip

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

create()

Creates a session with the API. This is the equivalent of login. This method exchanges user credentials supplied in the security context for a session identifier that is to be used for authenticating subsequent calls. To authenticate subsequent calls clients are expected to include the session key.

Return type:

str
Returns:

Newly created session identifier to be used for authenticating further requests.
Raise:

com.vmware.vapi.std.errors_client.Unauthenticated if the session creation fails due to request specific issues. Due to the security nature of the API the details of the error are not disclosed.

Please check the following preconditions if using a SAML token to authenticate:

  • the supplied token is delegate-able.
  • the time of client and server system are synchronized.
  • the token supplied is valid.
  • if bearer tokens are used check that system configuration allows the API endpoint to accept such tokens.
Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable if session creation fails due to server specific issues, for example connection to a back end component is failing. Due to the security nature of this API further details will not be disclosed in the exception. Please refer to component health information, administrative logs and product specific documentation for possible causes.
delete()

Terminates the validity of a session token. This is the equivalent of log out.

A session identifier is expected as part of the request.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the session id is missing from the request or the corresponding session object cannot be found.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if session deletion fails due to server specific issues, for example connection to a back end component is failing. Due to the security nature of this API further details will not be disclosed in the exception. Please refer to component health information, administrative logs and product specific documentation for possible causes.
get()

Returns information about the current session. This method expects a valid session identifier to be supplied.

A side effect of invoking this method may be a change to the session’s last accessed time to the current time if this is supported by the session implementation. Invoking any other method in the API will also update the session’s last accessed time.

This API is meant to serve the needs of various front end projects that may want to display the name of the user. Examples of this include various web based user interfaces and logging facilities.

Return type:Session.Info
Returns:Information about the session.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the session id is missing from the request or the corresponding session object cannot be found.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if session retrieval fails due to server specific issues e.g. connection to back end component is failing. Due to the security nature of this API further details will not be disclosed in the error. Please refer to component health information, administrative logs and product specific documentation for possible causes.
class com.vmware.cis_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

com.vmware.content_client module

The Content module provides classes and classes for configuring global settings and permissions, and for managing libraries in the Content Library Service.

class com.vmware.content_client.Configuration(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Configuration class provides methods to configure the global settings of the Content Library Service.

The configuration settings are used by the Content Library Service to control the behavior of various operations.

get()

Retrieves the current configuration values.

Return type:

ConfigurationModel
Returns:

The ConfigurationModel instance representing the configuration of the Content Library Service.
Raise:

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

  • Method execution requires ContentLibrary.GetConfiguration.
update(model)

Updates the configuration. The update is incremental. Any attribute in the ConfigurationModel class that is None will not be modified. Note that this update method doesn’t guarantee an atomic change of all the properties. In the case of a system crash or failure, some of the properties could be left unchanged while others may be updated.

Parameters:

model (ConfigurationModel) – The ConfigurationModel specifying the settings to update.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if one of the configuration properties is not within the proper range.
Raise:

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

  • Method execution requires ContentLibrary.UpdateConfiguration.
class com.vmware.content_client.ConfigurationModel(automatic_sync_enabled=None, automatic_sync_start_hour=None, automatic_sync_stop_hour=None, maximum_concurrent_item_syncs=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ConfigurationModel class defines the global settings of the Content Library Service.

Tip

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

class com.vmware.content_client.Library(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Library class provides methods to manage and find LibraryModel entities.

The Library class provides support for generic functionality which can be applied equally to all types of libraries. The functionality provided by this class will not affect the properties specific to the type of library. See also LocalLibrary and SubscribedLibrary.

class FindSpec(name=None, type=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Specifies the properties that can be used as a filter to find libraries. When multiple attributes are specified, all properties of the library must match the specification.

Tip

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

RESOURCE_TYPE = 'com.vmware.content.Library'

Resource type for library.

find(spec)

Returns a list of all the visible (as determined by authorization policy) libraries matching the requested Library.FindSpec.

Parameters:

spec (Library.FindSpec) – Specification describing what properties to filter on.
Return type:

list of str
Returns:

The list of identifiers of all the visible libraries matching the given spec. The return value will contain identifiers for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if no properties are specified in the spec.
Raise:

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

  • Method execution requires System.Read.
get(library_id)

Returns a given LibraryModel.

Parameters:

library_id (str) – Identifier of the library to return. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Return type:

LibraryModel
Returns:

The LibraryModel instance with the specified library_id.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the specified library does not exist.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires System.Read.
list()

Returns the identifiers of all libraries of any type in the Content Library.

Return type:

list of str
Returns:

The list of all identifiers of all libraries in the Content Library. The return value will contain identifiers for the resource type: com.vmware.content.Library.
Raise:

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

  • Method execution requires System.Read.
update(library_id, update_spec)

Updates the properties of a library.

This is an incremental update to the library. Any attribute in the LibraryModel class that is None will not be modified.

This method will only update the common properties for all library types. This will not, for example, update the LibraryModel.publish_info of a local library, nor the LibraryModel.subscription_info of a subscribed library. Specific properties are updated in LocalLibrary.update() and SubscribedLibrary.update().

Parameters:
  • library_id (str) – Identifier of the library to update. The parameter must be an identifier for the resource type: com.vmware.content.Library.
  • update_spec (LibraryModel) – Specification of the new property values to set on the library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library associated with library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the update_spec is not valid.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the LibraryModel.version of update_spec is not equal to the current version of the library.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.UpdateLibrary.
class com.vmware.content_client.LibraryModel(id=None, creation_time=None, description=None, last_modified_time=None, last_sync_time=None, name=None, storage_backings=None, type=None, optimization_info=None, version=None, publish_info=None, subscription_info=None, server_guid=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryModel class represents a Content Library resource model.

A LibraryModel is a container for a set of items which represent a usable set of files. The Content Library Service allows for multiple libraries to be created with separate authorization and sharing policies.

Each LibraryModel is a container for a set of com.vmware.content.library_client.ItemModel instances. Each item is a logical object in a library, which may have multiple files.

A LibraryModel may be local or subscribed. A local library has its source of truth about items within this Content Library Service. Items may be added to or removed from the library. A local library may also be private or published. When published, the library is exposed by a network endpoint and can be used by another Content Library Service for synchronization. A private local library cannot be used for synchronization.

A subscribed library is a library which gets its source of truth from another library that may be across a network in another Content Library Service. A subscribed library may have a different name and metadata from the library to which it subscribes, but the set of library items is always the same as those in the source library. Library items cannot be manually added to a subscribed library – they can only be added by adding new items to the source library.

Tip

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

class LibraryType(string)

Bases: vmware.vapi.bindings.enum.Enum

The LibraryModel.LibraryType class defines the type of a LibraryModel.

The type of a library can be used to determine which additional services can be performed with a library.

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.

LOCAL = LibraryType(string='LOCAL')

The library contents are defined and stored by the local Content Library Service installation.

A local library can be retrieved and managed via the LocalLibrary.

SUBSCRIBED = LibraryType(string='SUBSCRIBED')

The library synchronizes its items and content from another published library.

A subscribed library can be retrieved and managed via the SubscribedLibrary.

class com.vmware.content_client.LocalLibrary(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The LocalLibrary class manages local libraries.

The LocalLibrary class provides support for creating and maintaining local library instances. A local library may also use the Library class to manage general library functionality.

create(create_spec, client_token=None)

Creates a new local library.

Parameters:
  • client_token (str or None) – A unique token generated on the client for each creation request. The token should be a universally unique identifier (UUID), for example: b8a2a2e3-2314-43cd-a871-6ede0f429751. This token can be used to guarantee idempotent creation. If not specified creation is not idempotent.
  • create_spec (LibraryModel) – Specification for the new local library.
Return type:

str
Returns:

Identifier of the newly created LibraryModel. The return value will be an identifier for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the create_spec is not valid.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the client_token does not conform to the UUID format.
Raise:

com.vmware.vapi.std.errors_client.Unsupported if using multiple storage backings.
Raise:

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

  • Method execution requires ContentLibrary.CreateLocalLibrary.
delete(library_id)

Deletes the specified local library.

Deleting a local library will remove the entry immediately and begin an asynchronous task to remove all cached content for the library. If the asynchronous task fails, file content may remain on the storage backing. This content will require manual removal.

Parameters:

library_id (str) – Identifier of the local library to delete. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library specified by library_id is not a local library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library specified by library_id does not exist.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.DeleteLocalLibrary.
get(library_id)

Returns a given local library.

Parameters:

library_id (str) – Identifier of the local library to return. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Return type:

LibraryModel
Returns:

The LibraryModel instance associated with library_id.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library specified by library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library specified by library_id is not a local library.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires System.Read.
list()

Returns the identifiers of all local libraries in the Content Library.

Return type:

list of str
Returns:

The list of identifiers of all local libraries in the Content Library. The return value will contain identifiers for the resource type: com.vmware.content.Library.
Raise:

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

  • Method execution requires System.Read.
update(library_id, update_spec)

Updates the properties of a local library.

This is an incremental update to the local library. Attributes that are None in the update specification will be left unchanged.

Parameters:
  • library_id (str) – Identifier of the local library to update. The parameter must be an identifier for the resource type: com.vmware.content.Library.
  • update_spec (LibraryModel) – Specification of the new property values to set on the local library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library specified by library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the library specified by library_id is a published library with JSON persistence enabled (see com.vmware.content.library_client.PublishInfo.persist_json_enabled) and the content of the library has been deleted from the storage backings (see LibraryModel.storage_backings) associated with it.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library specified by library_id is not a local library.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the update_spec is not valid.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the com.vmware.content.library_client.PublishInfo.current_password in the update_spec does not match the existing password of the published library.
Raise:

com.vmware.vapi.std.errors_client.ResourceBusy if the LibraryModel.version of update_spec is None and the library is being concurrently updated by another user.
Raise:

com.vmware.vapi.std.errors_client.ConcurrentChange if the LibraryModel.version of update_spec is not equal to the current version of the library.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.UpdateLocalLibrary.
class com.vmware.content_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

class com.vmware.content_client.SubscribedLibrary(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

class ProbeResult(status=None, ssl_thumbprint=None, error_messages=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The SubscribedLibrary.ProbeResult class defines the subscription information probe result. This describes whether using a given subscription URL is successful or if there are access problems, such as SSL errors.

Tip

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

class Status(string)

Bases: vmware.vapi.bindings.enum.Enum

The SubscribedLibrary.ProbeResult.Status class defines the error status constants for the probe result.

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.

CERTIFICATE_ERROR = Status(string='CERTIFICATE_ERROR')

Indicates that the provided server certificate thumbprint in com.vmware.content.library_client.SubscriptionInfo.ssl_thumbprint is invalid. In this case, the returned null should be set in com.vmware.content.library_client.SubscriptionInfo.ssl_thumbprint.

HOST_NOT_FOUND = Status(string='HOST_NOT_FOUND')

Indicates that the host in the URL could not be found.

INVALID_CREDENTIALS = Status(string='INVALID_CREDENTIALS')

Indicates that the connection was rejected due to invalid credentials.

INVALID_URL = Status(string='INVALID_URL')

Indicates that the supplied URL was not valid.

RESOURCE_NOT_FOUND = Status(string='RESOURCE_NOT_FOUND')

Indicates that the given resource at the URL was not found.

SUCCESS = Status(string='SUCCESS')

Indicates that the probe was successful.

TIMED_OUT = Status(string='TIMED_OUT')

Indicates that the probe timed out while attempting to connect to the URL.

UNKNOWN_ERROR = Status(string='UNKNOWN_ERROR')

Indicates an unspecified error different from the other error cases defined in SubscribedLibrary.ProbeResult.Status.

create(create_spec, client_token=None)

Creates a new subscribed library.

Once created, the subscribed library will be empty. If the LibraryModel.subscription_info property is set, the Content Library Service will attempt to synchronize to the remote source. This is an asynchronous operation so the content of the published library may not immediately appear.

Parameters:
  • client_token (str or None) – Unique token generated on the client for each creation request. The token should be a universally unique identifier (UUID), for example: b8a2a2e3-2314-43cd-a871-6ede0f429751. This token can be used to guarantee idempotent creation. If not specified creation is not idempotent.
  • create_spec (LibraryModel) – Specification for the new subscribed library.
Return type:

str
Returns:

Identifier of the newly created subscribed library. The return value will be an identifier for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the create_spec is not valid.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the client_token does not conform to the UUID format.
Raise:

com.vmware.vapi.std.errors_client.Unsupported if using multiple storage backings.
Raise:

com.vmware.vapi.std.errors_client.ResourceInaccessible if subscribing to a published library which cannot be accessed.
Raise:

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

  • Method execution requires ContentLibrary.CreateSubscribedLibrary.
delete(library_id)

Deletes the specified subscribed library.

Deleting a subscribed library will remove the entry immediately and begin an asynchronous task to remove all cached content for the library. If the asynchronous task fails, file content may remain on the storage backing. This content will require manual removal.

Parameters:

library_id (str) – Identifier of the subscribed library to delete. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library referenced by library_id is not a subscribed library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library referenced by library_id does not exist.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.DeleteSubscribedLibrary.
evict(library_id)

Evicts the cached content of an on-demand subscribed library.

This method allows the cached content of a subscribed library to be removed to free up storage capacity. This method will only work when a subscribed library is synchronized on-demand.

Parameters:

library_id (str) – Identifier of the subscribed library whose content should be evicted. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library specified by library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library specified by library_id is not a subscribed library.
Raise:

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the library specified by library_id does not synchronize on-demand, or if the content of the library specified by library_id has been deleted from the storage backings (see LibraryModel.storage_backings) associated with it.

For instance, this {\@term error) is reported on evicting an on-demand subscribed library that was restored from backup, and the library was deleted after the backup was taken, thus resulting in its content being deleted from the associated storage backings. In this scenario, the metadata of the library is present on a restore, while its content has been deleted.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.EvictSubscribedLibrary.
get(library_id)

Returns a given subscribed library.

Parameters:

library_id (str) – Identifier of the subscribed library to return. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Return type:

LibraryModel
Returns:

The LibraryModel instance that corresponds to library_id.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library associated with library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library associated with library_id is not a subscribed library.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires System.Read.
list()

Returns the identifiers of all subscribed libraries in the Content Library.

Return type:

list of str
Returns:

The list of identifiers of all subscribed libraries in the Content Library. The return value will contain identifiers for the resource type: com.vmware.content.Library.
Raise:

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

  • Method execution requires System.Read.
probe(subscription_info)

Probes remote library subscription information, including URL, SSL certificate and password. The resulting SubscribedLibrary.ProbeResult class describes whether or not the subscription configuration is successful.

Parameters:

subscription_info (com.vmware.content.library_client.SubscriptionInfo) – The subscription info to be probed.
Return type:

SubscribedLibrary.ProbeResult
Returns:

The subscription info probe result.
Raise:

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

  • Method execution requires ContentLibrary.ProbeSubscription.
sync(library_id)

Forces the synchronization of the subscribed library.

Synchronizing a subscribed library forcefully with this method will perform the same synchronization behavior as would run periodically for the library. The com.vmware.content.library_client.SubscriptionInfo.on_demand setting is respected. Calling this method on a library that is already in the process of synchronizing will have no effect.

Parameters:

library_id (str) – Identifier of the subscribed library to synchronize. The parameter must be an identifier for the resource type: com.vmware.content.Library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library specified by library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library specified by library_id is not a subscribed library.
Raise:

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the content of the library specified by library_id has been deleted from the storage backings (see LibraryModel.storage_backings) associated with it.

For instance, this {\@term error) is reported on synchronizing a subscribed library that was restored from backup, and the library was deleted after the backup was taken, thus resulting in its content being deleted from the associated storage backings. In this scenario, the metadata of the library is present on a restore, while its content has been deleted.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if some parameter in the subscribed library subscription info is invalid.
Raise:

com.vmware.vapi.std.errors_client.ResourceInaccessible if the published library cannot be contacted or found.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.SyncLibrary.
update(library_id, update_spec)

Updates the properties of a subscribed library.

This is an incremental update to the subscribed library. Attributes that are None in the update specification will be left unchanged.

Parameters:
  • library_id (str) – Identifier of the subscribed library to update. The parameter must be an identifier for the resource type: com.vmware.content.Library.
  • update_spec (LibraryModel) – Specification of the new property values to set on the subscribed library.
Raise:

com.vmware.vapi.std.errors_client.NotFound if the library specified by library_id does not exist.
Raise:

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the update_spec updates the subscription URL (see com.vmware.content.library_client.SubscriptionInfo.subscription_url) and the content of the library specified by library_id has been deleted from the storage backings (see LibraryModel.storage_backings) associated with it.
Raise:

com.vmware.vapi.std.errors_client.InvalidElementType if the library specified by library_id is not a subscribed library.
Raise:

com.vmware.vapi.std.errors_client.InvalidArgument if the update_spec is not valid.
Raise:

com.vmware.vapi.std.errors_client.ResourceInaccessible if the subscription info is being updated but the published library cannot be contacted or found.
Raise:

com.vmware.vapi.std.errors_client.ResourceBusy if the LibraryModel.version of update_spec is None and the library is being concurrently updated by another user.
Raise:

com.vmware.vapi.std.errors_client.ConcurrentChange if the LibraryModel.version of update_spec is not equal to the current version of the library.
Raise:

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

  • The resource com.vmware.content.Library referenced by the parameter library_id requires ContentLibrary.UpdateSubscribedLibrary.
class com.vmware.content_client.Type(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Type class exposes the com.vmware.content.library_client.ItemModel types that this Content Library Service supports.

A library item has an optional type which can be specified with the com.vmware.content.library_client.ItemModel.type attribute. For items with a type that is supported by a plugin, the Content Library Service may understand the files which are part of the library item and can produce metadata for the item.

In other cases, uploads may require a process in which one upload implies subsequent uploads. For example, an Open Virtualization Format (OVF) package is composed of an OVF descriptor file and the associated virtual disk files. Uploading an OVF descriptor can enable the Content Library Service to understand that the complete OVF package requires additional disk files, and it can set up the transfers for the disks automatically by adding the file entries for the disks when the OVF descriptor is uploaded.

When a type is not supported by a plugin, or the type is not specified, the Content Library Service can handle a library item in a default way, without adding metadata to the item or guiding the upload process.

class Info(description=None, name=None, type=None, vendor=None, version=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Type.Info class describes support for a specific type of data in an com.vmware.content.library_client.ItemModel. The Type.Info can be queried through the Type class. Type support describes plugins in the Content Library which can provide metadata on library items and help manage the transfer process by adding dependent files when a current file is added.

Tip

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

list()

Returns a list of Type.Info instances which describe the type support plugins in this Content Library.

Return type:

list of Type.Info
Returns:

The list of Type.Info instances which describe the type support plugins in this Content Library.
Raise:

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

  • Method execution requires ContentLibrary.TypeIntrospection.

com.vmware.vcenter_client module

The com.vmware.vcenter_client module provides classes for managing VMware vSphere environments. The module is available starting in vSphere 6.5.

class com.vmware.vcenter_client.Cluster(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Cluster class provides methods to manage clusters in the vCenter Server.

class FilterSpec(clusters=None, names=None, folders=None, datacenters=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Cluster.FilterSpec class contains attributes used to filter the results when listing clusters (see Cluster.list()). If multiple attributes are specified, only clusters matching all of the attributes match the filter.

Tip

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

class Info(name=None, resource_pool=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Cluster.Info class contains information about a cluster in vCenter Server.

Tip

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

RESOURCE_TYPE = 'ClusterComputeResource'

The resource type for the vCenter Cluster

class Summary(cluster=None, name=None, ha_enabled=None, drs_enabled=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Cluster.Summary class contains commonly used information about a cluster in vCenter Server.

Tip

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

get(cluster)

Retrieves information about the cluster corresponding to cluster.

Parameters:cluster (str) – Identifier of the cluster. The parameter must be an identifier for the resource type: ClusterComputeResource.
Return type:Cluster.Info
Returns:The Cluster.Info instances that corresponds to the cluster.
Raise:com.vmware.vapi.std.errors_client.NotFound if there is no cluster associated with cluster in the system.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete the request.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the session id is missing from the request or the corresponding session object cannot be found.
Raise:com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t not have the required privileges.
list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) clusters in vCenter matching the Cluster.FilterSpec.

Parameters:filter (Cluster.FilterSpec or None) – Specification of matching clusters for which information should be returned. If None, the behavior is equivalent to a Cluster.FilterSpec with all attributes None which means all clusters match the filter.
Return type:list of Cluster.Summary
Returns:Commonly used information about the clusters matching the Cluster.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 clusters match the Cluster.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.Datacenter(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Datacenter class provides methods to manage datacenters in the vCenter Server.

class CreateSpec(name=None, folder=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datacenter.CreateSpec class defines the information used to create a datacenter.

Tip

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

class FilterSpec(datacenters=None, names=None, folders=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datacenter.FilterSpec class contains attributes used to filter the results when listing datacenters (see Datacenter.list()). If multiple attributes are specified, only datacenters matching all of the attributes match the filter.

Tip

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

class Info(name=None, datastore_folder=None, host_folder=None, network_folder=None, vm_folder=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datacenter.Info class contains information about a datacenter in vCenter Server.

Tip

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

RESOURCE_TYPE = 'Datacenter'

The resource type for the vCenter Datacenter

class Summary(datacenter=None, name=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datacenter.Summary class contains commonly used information about a datacenter in vCenter Server.

Tip

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

create(spec)

Create a new datacenter in the vCenter inventory

Parameters:spec (Datacenter.CreateSpec) – Specification for the new datacenter to be created.
Return type:str
Returns:The identifier of the newly created datacenter The return value will be an identifier for the resource type: Datacenter.
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.AlreadyExists if the datacenter with the same name is already present.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the datacenter name is empty or invalid as per the underlying implementation.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the folder is not specified and the system cannot choose a suitable one.
Raise:com.vmware.vapi.std.errors_client.NotFound if the datacenter folder cannot be found.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
delete(datacenter, force=None)

Delete an empty datacenter from the vCenter Server

Parameters:
  • datacenter (str) – Identifier of the datacenter to be deleted. The parameter must be an identifier for the resource type: Datacenter.
  • force (bool or None) – If true, delete the datacenter even if it is not empty. If None a com.vmware.vapi.std.errors_client.ResourceInUse exception will be reported if the datacenter is not empty. This is the equivalent of passing the value false.
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 there is no datacenter associated with datacenter in the system.
Raise:

com.vmware.vapi.std.errors_client.ResourceInUse if the datacenter associated with datacenter is not empty.
Raise:

com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
get(datacenter)

Retrieves information about the datacenter corresponding to datacenter.

Parameters:datacenter (str) – Identifier of the datacenter. The parameter must be an identifier for the resource type: Datacenter.
Return type:Datacenter.Info
Returns:The Datacenter.Info instances that corresponds to the datacenter.
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 there is no datacenter associated with datacenter in the system.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) datacenters in vCenter matching the Datacenter.FilterSpec.

Parameters:filter (Datacenter.FilterSpec or None) – Specification of matching datacenters for which information should be returned. If None, the behavior is equivalent to a Datacenter.FilterSpec with all attributes None which means all datacenters match the filter.
Return type:list of Datacenter.Summary
Returns:Commonly used information about the datacenters matching the Datacenter.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 datacenters match the Datacenter.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.Datastore(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Datastore class provides methods for manipulating a datastore.

class FilterSpec(datastores=None, names=None, types=None, folders=None, datacenters=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datastore.FilterSpec class contains attributes used to filter the results when listing datastores (see Datastore.list()). If multiple attributes are specified, only datastores matching all of the attributes match the filter.

Tip

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

class Info(name=None, type=None, accessible=None, free_space=None, multiple_host_access=None, thin_provisioning_supported=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datastore.Info class contains information about a datastore.

Tip

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

RESOURCE_TYPE = 'Datastore'

The resource type for the vCenter datastore

class Summary(datastore=None, name=None, type=None, free_space=None, capacity=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datastore.Summary class contains commonly used information about a datastore.

Tip

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

class Type(string)

Bases: vmware.vapi.bindings.enum.Enum

The Datastore.Type class defines the supported types of vCenter datastores.

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.

CIFS = Type(string='CIFS')

Common Internet File System.

NFS = Type(string='NFS')

Network file system v3 (linux & esx servers only).

NFS41 = Type(string='NFS41')

Network file system v4.1 (linux & esx servers only).

VFFS = Type(string='VFFS')

Flash Read Cache (ESX Server only).

VMFS = Type(string='VMFS')

VMware File System (ESX Server only).

VSAN = Type(string='VSAN')

Virtual SAN (ESX Server only).

VVOL = Type(string='VVOL')

vSphere Virtual Volume (ESX Server only).

get(datastore)

Retrieves information about the datastore indicated by datastore.

Parameters:datastore (str) – Identifier of the datastore for which information should be retrieved. The parameter must be an identifier for the resource type: Datastore.
Return type:Datastore.Info
Returns:information about the datastore.
Raise:com.vmware.vapi.std.errors_client.NotFound if the datastore indicated by datastore does not exist.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) datastores in vCenter matching the Datastore.FilterSpec.

Parameters:filter (Datastore.FilterSpec or None) – Specification of matching datastores for which information should be returned. If None, the behavior is equivalent to a Datastore.FilterSpec with all attributes None which means all datastores match the filter.
Return type:list of Datastore.Summary
Returns:Commonly used information about the datastores matching the Datastore.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the Datastore.FilterSpec.types attribute contains a value that is not supported by the server.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the Datastore.FilterSpec.types attribute contains a value that is not supported by the server.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 datastores match the Datastore.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.Deployment(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Deployment class provides methods to get the status of the vCenter appliance deployment. This class was added in vSphere API 6.7

class Info(state=None, progress=None, subtask_order=None, subtasks=None, description=None, service=None, operation=None, parent=None, target=None, status=None, cancelable=None, error=None, start_time=None, end_time=None, user=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Deployment.Info class contains attributes to describe the state of the appliance. This class was added in vSphere API 6.7

Tip

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

class Task(progress=None, result=None, description=None, service=None, operation=None, parent=None, target=None, status=None, cancelable=None, error=None, start_time=None, end_time=None, user=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Deployment.Task class contains attributes to describe a particular deployment task. This class was added in vSphere API 6.7

Tip

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

get()

Get the current status of the appliance deployment. This method was added in vSphere API 6.7

Return type:Deployment.Info
Returns:Info structure containing the status information about the appliance.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.
Raise:com.vmware.vapi.std.errors_client.NotFound if appliance state cannot be determined.
rollback()

Rollback a failed appliance so it can be configured once again. This method was added in vSphere API 6.7

Raise:com.vmware.vapi.std.errors_client.Unsupported if the appliance is not in FAILED state.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the caller is not authenticated.
class com.vmware.vcenter_client.Folder(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Folder class provides methods for manipulating a vCenter Server folder.

class FilterSpec(folders=None, names=None, type=None, parent_folders=None, datacenters=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Folder.FilterSpec class contains attributes used to filter the results when listing folders (see Folder.list()). If multiple attributes are specified, only folders matching all of the attributes match the filter.

Tip

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

RESOURCE_TYPE = 'Folder'

The resource type for the vCenter folder

class Summary(folder=None, name=None, type=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Folder.Summary class contains commonly used information about a folder.

Tip

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

class Type(string)

Bases: vmware.vapi.bindings.enum.Enum

The Folder.Type class defines the type of a vCenter Server folder. The type of a folder determines what what kinds of children can be contained in the folder.

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.

DATACENTER = Type(string='DATACENTER')

A folder that can contain datacenters.

DATASTORE = Type(string='DATASTORE')

A folder that can contain datastores.

HOST = Type(string='HOST')

A folder that can contain compute resources (hosts and clusters).

NETWORK = Type(string='NETWORK')

A folder that can contain networkds.

VIRTUAL_MACHINE = Type(string='VIRTUAL_MACHINE')

A folder that can contain virtual machines.

list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) folders in vCenter matching the Folder.FilterSpec.

Parameters:filter (Folder.FilterSpec or None) – Specification of matching folders for which information should be returned. If None, the behavior is equivalent to a Folder.FilterSpec with all attributes None which means all folders match the filter.
Return type:list of Folder.Summary
Returns:Commonly used information about the folders matching the Folder.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the Folder.FilterSpec.type attribute contains a value that is not supported by the server.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 folders match the Folder.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.Host(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Host class provides methods to manage hosts in the vCenter Server.

class ConnectionState(string)

Bases: vmware.vapi.bindings.enum.Enum

The Host.ConnectionState class defines the connection status of a host.

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.

CONNECTED = ConnectionState(string='CONNECTED')

Host is connected to the vCenter Server

DISCONNECTED = ConnectionState(string='DISCONNECTED')

Host is disconnected from the vCenter Server

NOT_RESPONDING = ConnectionState(string='NOT_RESPONDING')

VirtualCenter is not receiving heartbeats from the server. The state automatically changes to connected once heartbeats are received again.

class CreateSpec(hostname=None, port=None, user_name=None, password=None, folder=None, thumbprint_verification=None, thumbprint=None, force_add=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Host.CreateSpec class defines the information used to create a host.

Tip

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

class ThumbprintVerification(string)

Bases: vmware.vapi.bindings.enum.Enum

The Host.CreateSpec.ThumbprintVerification class defines the thumbprint verification schemes for a host’s SSL certificate.

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.

NONE = ThumbprintVerification(string='NONE')

Accept the host’s thumbprint without verifying it.

THUMBPRINT = ThumbprintVerification(string='THUMBPRINT')

Host’s SSL certificate verified by checking its thumbprint against the specified thumbprint.

class FilterSpec(hosts=None, names=None, folders=None, datacenters=None, standalone=None, clusters=None, connection_states=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Host.FilterSpec class contains attributes used to filter the results when listing hosts (see Host.list()). If multiple attributes are specified, only hosts matching all of the attributes match the filter.

Tip

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

class PowerState(string)

Bases: vmware.vapi.bindings.enum.Enum

The Host.PowerState class defines the power states of a host.

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.

POWERED_OFF = PowerState(string='POWERED_OFF')

The host was specifically powered off by the user through vCenter server. This state is not a cetain state, because after vCenter server issues the command to power off the host, the host might crash, or kill all the processes but fail to power off.

POWERED_ON = PowerState(string='POWERED_ON')

The host is powered on. A host that is entering standby mode is also in this state.

STANDBY = PowerState(string='STANDBY')

The host was specifically put in standby mode, either explicitly by the user, or automatically by DPM. This state is not a cetain state, because after VirtualCenter issues the command to put the host in standby state, the host might crash, or kill all the processes but fail to enter standby mode. A host that is exiting standby mode is also in this state.

RESOURCE_TYPE = 'HostSystem'

The resource type for the vCenter Host.

class Summary(host=None, name=None, connection_state=None, power_state=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Host.Summary class contains commonly used information about a host in vCenter Server.

Tip

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

connect(host)

Connect to the host corresponding to host previously added to the vCenter server.

Parameters:host (str) – Identifier of the host to be reconnected. The parameter must be an identifier for the resource type: HostSystem.
Raise:com.vmware.vapi.std.errors_client.AlreadyInDesiredState if the host associated with host is already connected.
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 there is no host associated with host in the system.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
create(spec)

Add a new standalone host in the vCenter inventory. The newly connected host will be in connected state. The vCenter Server will verify the SSL certificate before adding the host to its inventory. In the case where the SSL certificate cannot be verified because the Certificate Authority is not recognized or the certificate is self signed, the vCenter Server will fall back to thumbprint verification mode as defined by Host.CreateSpec.ThumbprintVerification.

Parameters:spec (Host.CreateSpec) – Specification for the new host to be created.
Return type:str
Returns:The newly created identifier of the host in vCenter. The return value will be an identifier for the resource type: HostSystem.
Raise:com.vmware.vapi.std.errors_client.AlreadyExists if the host with the same name is already present.
Raise:com.vmware.vapi.std.errors_client.Error if installation of VirtualCenter agent on a host fails.
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 host name is invalid.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the host folder is invalid.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the SSL thumbprint specified is invalid.
Raise:com.vmware.vapi.std.errors_client.InvalidElementType if the host folder id does not support vSphere compute resource as its children type.
Raise:com.vmware.vapi.std.errors_client.NotFound if there is no folder associated with the folder attribute in the system.
Raise:com.vmware.vapi.std.errors_client.ResourceInUse if the host is already being managed by another vCenter Server
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if there are not enough licenses to add the host.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the user name or password for the administration account on the host are invalid.
Raise:com.vmware.vapi.std.errors_client.Unauthenticated if the user can not be authenticated.
Raise:com.vmware.vapi.std.errors_client.Unsupported if the software version on the host is not supported.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete the request.
Raise:com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t have the required privileges.
delete(host)

Remove a standalone host from the vCenter Server.

Parameters:host (str) – Identifier of the host to be deleted. The parameter must be an identifier for the resource type: HostSystem.
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 there is no host associated with host in the system.
Raise:com.vmware.vapi.std.errors_client.ResourceInUse if the host associated with host is in a vCenter cluster
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
disconnect(host)

Disconnect the host corresponding to host from the vCenter server

Parameters:host (str) – Identifier of the host to be disconnected. The parameter must be an identifier for the resource type: HostSystem.
Raise:com.vmware.vapi.std.errors_client.AlreadyInDesiredState if the host associated with host is already disconnected.
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 there is no host associated with host in the system.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) hosts in vCenter matching the Host.FilterSpec.

Parameters:filter (Host.FilterSpec or None) – Specification of matching hosts for which information should be returned. If None, the behavior is equivalent to a Host.FilterSpec with all attributes None which means all hosts match the filter.
Return type:list of Host.Summary
Returns:Commonly used information about the hosts matching the Host.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the Host.FilterSpec.connection_states attribute contains a value that is not supported by the server.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 hosts match the Host.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.Network(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Network class provides methods for manipulating a vCenter Server network.

class FilterSpec(networks=None, names=None, types=None, folders=None, datacenters=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Network.FilterSpec class contains attributes used to filter the results when listing networks (see Network.list()). If multiple attributes are specified, only networks matching all of the attributes match the filter.

Tip

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

RESOURCE_TYPE = 'Network'

The resource type for the vCenter network

class Summary(network=None, name=None, type=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Network.Summary class contains commonly used information about a network.

Tip

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

class Type(string)

Bases: vmware.vapi.bindings.enum.Enum

The Network.Type class defines the type of a vCenter Server network. The type of a network can be used to determine what features it supports and which APIs can be used to find more information about the network or change its configuration.

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.

DISTRIBUTED_PORTGROUP = Type(string='DISTRIBUTED_PORTGROUP')

XXX: vCenter based (create and managed through vCenter)

OPAQUE_NETWORK = Type(string='OPAQUE_NETWORK')

A network for whose configuration is managed outside of vSphere. The identifer and name of the network is made available through vSphere so that host and virtual machine virtual ethernet devices can connect to them.

STANDARD_PORTGROUP = Type(string='STANDARD_PORTGROUP')

XXX: ESX based (created and managed on ESX)

list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) networks in vCenter matching the Network.FilterSpec.

Parameters:filter (Network.FilterSpec or None) – Specification of matching networks for which information should be returned. If None, the behavior is equivalent to a Network.FilterSpec with all attributes None which means all networks match the filter.
Return type:list of Network.Summary
Returns:Commonly used information about the networks matching the Network.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the Network.FilterSpec.types attribute contains a value that is not supported by the server.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 networks match the Network.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.ResourcePool(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The ResourcePool class provides methods for manipulating a vCenter Server resource pool.

This class does not include virtual appliances in the inventory of resource pools even though part of the behavior of a virtual appliance is to act like a resource pool.

class FilterSpec(resource_pools=None, names=None, parent_resource_pools=None, datacenters=None, hosts=None, clusters=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourcePool.FilterSpec class contains attributes used to filter the results when listing resource pools (see ResourcePool.list()). If multiple attributes are specified, only resource pools matching all of the attributes match the filter.

Tip

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

class Info(name=None, resource_pools=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourcePool.Info class contains information about a resource pool.

Tip

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

RESOURCE_TYPE = 'ResourcePool'

The resource type for the vCenter resource pool

class Summary(resource_pool=None, name=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourcePool.Summary class contains commonly used information about a resource pool in vCenter Server.

Tip

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

get(resource_pool)

Retrieves information about the resource pool indicated by resource_pool.

Parameters:resource_pool (str) – Identifier of the resource pool for which information should be retrieved. The parameter must be an identifier for the resource type: ResourcePool.
Return type:ResourcePool.Info
Returns:information about the resource pool.
Raise:com.vmware.vapi.std.errors_client.NotFound if the resource pool indicated by resource_pool does not exist.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) resource pools in vCenter matching the ResourcePool.FilterSpec.

Parameters:filter (ResourcePool.FilterSpec or None) – Specification of matching resource pools for which information should be returned. If None, the behavior is equivalent to a ResourcePool.FilterSpec with all attributes None which means all resource pools match the filter.
Return type:list of ResourcePool.Summary
Returns:Commonly used information about the resource pools matching the ResourcePool.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 resource pools match the ResourcePool.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
class com.vmware.vcenter_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

class com.vmware.vcenter_client.VM(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The VM class provides methods for managing the lifecycle of a virtual machine.

class CreateSpec(guest_os=None, name=None, placement=None, hardware_version=None, boot=None, boot_devices=None, cpu=None, memory=None, disks=None, nics=None, cdroms=None, floppies=None, parallel_ports=None, serial_ports=None, sata_adapters=None, scsi_adapters=None, storage_policy=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based creation spec.

Tip

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

class FilterSpec(vms=None, names=None, folders=None, datacenters=None, hosts=None, clusters=None, resource_pools=None, power_states=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.FilterSpec class contains attributes used to filter the results when listing virtual machines (see VM.list()). If multiple attributes are specified, only virtual machines matching all of the attributes match the filter.

Tip

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

class Info(guest_os=None, name=None, power_state=None, hardware=None, boot=None, boot_devices=None, cpu=None, memory=None, disks=None, nics=None, cdroms=None, floppies=None, parallel_ports=None, serial_ports=None, sata_adapters=None, scsi_adapters=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based info.

Tip

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

class PlacementSpec(folder=None, resource_pool=None, host=None, cluster=None, datastore=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.PlacementSpec class contains information used to place a virtual machine onto resources within the vCenter inventory.

Tip

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

class StoragePolicySpec(policy=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.StoragePolicySpec class contains information about the storage policy to be associated with a virtual machine object. This class was added in vSphere API 6.7

Tip

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

class Summary(vm=None, name=None, power_state=None, cpu_count=None, memory_size_mib=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.Summary class contains commonly used information about a virtual machine.

Tip

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

create(spec)

Creates a virtual machine.

Parameters:spec (VM.CreateSpec) – Virtual machine specification.
Return type:str
Returns:ID of newly-created virtual machine. The return value will be an identifier for the resource type: VirtualMachine.
Raise:com.vmware.vapi.std.errors_client.AlreadyExists if a virtual machine with the specified name 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 any of the specified parameters are invalid.
Raise:com.vmware.vapi.std.errors_client.NotFound if any of the resources specified in spec could not be found
Raise:com.vmware.vapi.std.errors_client.ResourceInaccessible if a specified resource (eg. host) is not accessible.
Raise:com.vmware.vapi.std.errors_client.ResourceInUse if any of the specified storage addresses (eg. IDE, SATA, SCSI) result in a storage address conflict.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete the request.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if any of the resources needed to create the virtual machine could not be allocated.
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 required privileges.
Raise:com.vmware.vapi.std.errors_client.Unsupported if guestOS is not supported for the requested virtual hardware version and spec includes None attributes that default to guest-specific values.
delete(vm)

Deletes a virtual machine.

Parameters:vm (str) – Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
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 virtual machine is running (powered on).
Raise:com.vmware.vapi.std.errors_client.NotFound if the virtual machine is not found.
Raise:com.vmware.vapi.std.errors_client.ResourceBusy if the virtual machine is busy performing another operation.
Raise:com.vmware.vapi.std.errors_client.ResourceInaccessible if the virtual machine’s configuration state cannot be accessed.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
get(vm)

Returns information about a virtual machine.

Parameters:vm (str) – Virtual machine identifier. The parameter must be an identifier for the resource type: VirtualMachine.
Return type:VM.Info
Returns:Information about the specified virtual machine.
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 the virtual machine is not found.
Raise:com.vmware.vapi.std.errors_client.ResourceInaccessible if the virtual machine’s configuration state cannot be accessed.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.
list(filter=None)

Returns information about at most 1000 visible (subject to permission checks) virtual machines in vCenter matching the VM.FilterSpec.

Parameters:filter (VM.FilterSpec or None) – Specification of matching virtual machines for which information should be returned. If None, the behavior is equivalent to a VM.FilterSpec with all attributes None which means all virtual machines match the filter.
Return type:list of VM.Summary
Returns:Commonly used information about the virtual machines matching the VM.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.InvalidArgument if the VM.FilterSpec.power_states attribute contains a value that is not supported by the server.
Raise:com.vmware.vapi.std.errors_client.UnableToAllocateResource if more than 1000 virtual machines match the VM.FilterSpec.
Raise:com.vmware.vapi.std.errors_client.ServiceUnavailable if the system is unable to communicate with a service to complete 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 doesn’t have the required privileges.