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.

Parameters

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

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.

Parameters

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

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.

Parameters
  • password (str) – Password. This attribute was added in vSphere API 6.7.

  • old_password (str or None) – Old password of the user (required in case of the password change, not required if superAdmin user changes the password of the other user). This attribute was added in vSphere API 6.7. If None, user may not have password set.

  • full_name (str or None) – Full name of the user. This attribute was added in vSphere API 6.7. If None, user will have no fullname.

  • email (str or None) – Email address of the local account. This attribute was added in vSphere API 6.7. If None, user will have no email.

  • roles (list of str) – User roles. This attribute was added in vSphere API 6.7. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.appliance.roles. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.appliance.roles.

  • enabled (bool or None) – Flag indicating if the account is enabled. This attribute was added in vSphere API 6.7. If None, defaults to True

  • password_expires (bool or None) – Flag indicating if the account password expires. This attribute was added in vSphere API 6.7. If None, defaults to True.

  • password_expires_at (datetime.datetime or None) – Date when the account’s password will expire. This attribute was added in vSphere API 6.7. If None, will be taken from system defaults (see local-accounts/policy).

  • inactive_after_password_expiration (bool or None) – Flag indicating if the account will be locked after password expiration. This attribute was added in vSphere API 6.7. If None, defaults to True.

  • days_after_password_expiration (long or None) – Number of days after password expiration before the account will be locked. This attribute was added in vSphere API 6.7. If None, will be taken from system defaults (see local-accounts/policy).

  • min_days_between_password_change (long or None) – Minimum number of days between password change. This attribute was added in vSphere API 6.7. If None, will be taken from system defaults (see local-accounts/policy).

  • max_days_between_password_change (long or None) – Maximum number of days between password change. This attribute was added in vSphere API 6.7. If None, will be taken from system defaults (see local-accounts/policy).

  • warn_days_before_password_expiration (long or None) – Number of days of warning before password expires. This attribute was added in vSphere API 6.7. If None, will be taken from system defaults (see local-accounts/policy).

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.

Parameters
  • fullname (str or None) – Full name of the user. This attribute was added in vSphere API 6.7. If None, the value was never set.

  • email (str or None) – Email address of the local account. This attribute was added in vSphere API 6.7. If None, the value was never set.

  • roles (list of str) – User roles. This attribute was added in vSphere API 6.7. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.appliance.roles. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.appliance.roles.

  • enabled (bool) – Flag indicating if the account is enabled. This attribute was added in vSphere API 6.7.

  • has_password (bool) – Is the user password set. This attribute was added in vSphere API 6.7.

  • last_password_change (datetime.datetime or None) – Date and time password was changed. This attribute was added in vSphere API 6.7. If None, the password was never set.

  • password_expires_at (datetime.datetime or None) – Date when the account’s password will expire. This attribute was added in vSphere API 6.7. If None, the password never expires.

  • inactive_at (datetime.datetime or None) – Date and time account will be locked after password expiration. This attribute was added in vSphere API 6.7. If None, account will not be locked.

  • min_days_between_password_change (long or None) – Minimum number of days between password change. This attribute was added in vSphere API 6.7. If None, pasword can be changed any time.

  • max_days_between_password_change (long or None) – Maximum number of days between password change. This attribute was added in vSphere API 6.7. If None, password never expires.

  • warn_days_before_password_expiration (long or None) – Number of days of warning before password expires. This attribute was added in vSphere API 6.7. If None, a user is never warned.

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.

Parameters
  • password (str or None) – Password. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • old_password (str or None) – Old password of the user (required in case of the password change, not required if superAdmin user changes the password of the other user). This attribute was added in vSphere API 6.7. If None, user may not have password set.

  • full_name (str or None) – Full name of the user. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • email (str or None) – Email address of the local account. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • roles (list of str or None) – User roles. This attribute was added in vSphere API 6.7. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.appliance.roles. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.appliance.roles. If None, value will not be changed

  • enabled (bool or None) – Flag indicating if the account is enabled. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • password_expires (bool or None) – Flag indicating if the account password expires. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • password_expires_at (datetime.datetime or None) – Date when the account’s password will expire. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • inactive_after_password_expiration (bool or None) – Flag indicating if the account will be locked after password expiration. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • days_after_password_expiration (long or None) – Number of days after password expiration before the account will be locked. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • min_days_between_password_change (long or None) – Minimum number of days between password change. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • max_days_between_password_change (long or None) – Maximum number of days between password change. This attribute was added in vSphere API 6.7. If None, value will not be changed

  • warn_days_before_password_expiration (long or None) – Number of days of warning before password expires. This attribute was added in vSphere API 6.7. If None, value will not be changed

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.

Parameters

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

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.

Parameters

string (str) – String value for the FunctionType instance.

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.

Parameters

string (str) – String value for the IntervalType instance.

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.

Parameters
  • id (str) – monitored item ID Ex: CPU, MEMORY When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.appliance.monitoring. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.appliance.monitoring.

  • name (str) – monitored item name Ex: “Network write speed”

  • units (str) – Y-axis label EX: “Mbps”, “%”

  • category (str) – category Ex: network, storage etc

  • instance (str) – instance name Ex: eth0

  • description (str) – monitored item description Ex: com.vmware.applmgmt.mon.descr.net.rx.packetRate.eth0

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.

Parameters
  • name (str) – Monitored item IDs Ex: CPU, MEMORY, STORAGE_TOTAL When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.appliance.monitoring. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.appliance.monitoring.

  • interval (Monitoring.IntervalType) – interval between values in hours, minutes

  • function (Monitoring.FunctionType) – aggregation function

  • start_time (datetime.datetime) – Start time in UTC

  • end_time (datetime.datetime) – End time in UTC

  • data (list of str) – list of values

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.

Parameters
  • names (list of str) – monitored item IDs Ex: CPU, MEMORY When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.appliance.monitoring. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.appliance.monitoring.

  • interval (Monitoring.IntervalType) – interval between values in hours, minutes

  • function (Monitoring.FunctionType) – aggregation function

  • start_time (datetime.datetime) – Start time in UTC

  • end_time (datetime.datetime) – End time in UTC

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.

Parameters

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

class ChangeSpec(hostname=None, sso_user=None, sso_password=None, dns=None, ipv4=None, ipv6=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Tip

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

Parameters
  • hostname (str) – New hostname to assign to the management network of vCenter appliance. This attribute was added in vSphere API 6.7.3.

  • sso_user (str) – vCenter Server SSO administrator username. This attribute was added in vSphere API 6.7.3.

  • sso_password (str) – vCenter Server SSO administrator Password. This attribute was added in vSphere API 6.7.3.

  • dns (com.vmware.appliance.networking.dns_client.Servers.DNSServerConfig or None) – DNS Configuration to set for the machine. This attribute was added in vSphere API 6.7.3. If None DNS settings will not be changed

  • ipv4 (com.vmware.appliance.networking.interfaces_client.Ipv4.Config or None) – IPv4 Configuration to set for the machine. This attribute was added in vSphere API 6.7.3. If None IPv4 settings will not be changed

  • ipv6 (com.vmware.appliance.networking.interfaces_client.Ipv6.Config or None) – IPv6 Configuration to set for the machine. This attribute was added in vSphere API 6.7.3. If None IPv6 settings will not be changed

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.

Parameters
  • mode (Networking.DNSInfo.DNSMode) – DNS mode. This attribute was added in vSphere API 6.7.

  • hostname (str) – Hostname. This attribute was added in vSphere API 6.7.

  • servers (list of str) – Servers. This attribute was added in vSphere API 6.7.

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.

Parameters

string (str) – String value for the DNSMode instance.

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.

Parameters
  • dns (Networking.DNSInfo) – DNS configuration. This attribute was added in vSphere API 6.7.

  • interfaces (dict of str and com.vmware.appliance.networking_client.Interfaces.InterfaceInfo) – Interface configuration as a key-value map where key is a network interface name, for example, “nic0”. This attribute was added in vSphere API 6.7. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.appliance.networking.interfaces. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.appliance.networking.interfaces.

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.

Parameters

ipv6_enabled (bool or None) – IPv6 Enabled or not. This attribute was added in vSphere API 6.7. If unspecified, leaves the current state of Ipv6.

change_task(spec)

Changes the Hostname/IP of the management network of vCenter appliance. The Hostname/IP change invokes the PNID change process which involves LDAP entry modification, updating registry entries, configuration files modification and network configuration changes. vCenter server is expected to be down for few minutes during these changes. This method was added in vSphere API 6.7.3.

Parameters

spec (Networking.ChangeSpec) – Information required to change the hostname.

Raise

com.vmware.vapi.std.errors_client.Unsupported if it’s not embedded node

Raise

com.vmware.vapi.std.errors_client.InvalidArgument if passed arguments are invalid.

Raise

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

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if another change task is in progress

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.

Parameters
  • id (str) – The notification id. This attribute was added in vSphere API 6.7.

  • time (datetime.datetime or None) – The time the notification was raised/found. This attribute was added in vSphere API 6.7. Only if the time information is available.

  • message (com.vmware.vapi.std_client.LocalizableMessage) – The notification message. This attribute was added in vSphere API 6.7.

  • resolution (com.vmware.vapi.std_client.LocalizableMessage or None) – The resolution message, if any. This attribute was added in vSphere API 6.7. Only set for warnings and errors.

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.

Parameters
  • info (list of Notification or None) – Info notification messages reported. This attribute was added in vSphere API 6.7. Only set if an info was reported by the appliance task.

  • warnings (list of Notification or None) – Warning notification messages reported. This attribute was added in vSphere API 6.7. Only set if an warning was reported by the appliance task.

  • errors (list of Notification or None) – Error notification messages reported. This attribute was added in vSphere API 6.7. Only set if an error was reported by the appliance task.

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.

Parameters

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

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.

Parameters
  • id (str) – id in message bundle. This attribute was added in vSphere API 6.7.

  • default_message (str) – text in english. This attribute was added in vSphere API 6.7.

  • args (list of str) – nested data. This attribute was added in vSphere API 6.7.

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.

Parameters

string (str) – String value for the ServerStatus instance.

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.

Parameters
  • server (str) – Server name associated with the test run. This attribute was added in vSphere API 6.7.

  • status (Ntp.ServerStatus) – Server status. This attribute was added in vSphere API 6.7.

  • message (Ntp.LocalizableMessage) – Message associated with status. This attribute was added in vSphere API 6.7.

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.

Parameters

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

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.

Parameters

supported (bool) – Is recovery supported in this appliance. This attribute was added in vSphere API 6.7.

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.

Parameters

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

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.

Parameters
  • description (str) – Service description. This attribute was added in vSphere API 6.7.

  • state (Services.State) – Running State. This attribute was added in vSphere API 6.7.

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.

Parameters

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

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.

Parameters

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

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.

Parameters
  • shutdown_time (datetime.datetime or None) – Shutdown time. This attribute was added in vSphere API 6.7. shutdownTime Optional value of pending shutdown time

  • action (str) – The pending shutdown operation. The string values for pending operations can be ‘poweroff’, ‘reboot’ or ‘’. This attribute was added in vSphere API 6.7.

  • reason (str) – The reason behind the shutdown action. This attribute was added in vSphere API 6.7.

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

Initialize StubFactoryBase

Parameters

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

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.

Parameters
  • progress (com.vmware.cis.task_client.Progress) – Progress of the operation. This attribute was added in vSphere API 6.7. This attribute is optional and it is only relevant when the value of #status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • result (Notifications or None) – Result of the operation. If an operation reports partial results before it completes, this attribute could be set before the null has the value com.vmware.cis.task_client.Status.SUCCEEDED. The value could change as the operation progresses. This attribute was added in vSphere API 6.7. This attribute will be None if result is not available at the current step of the operation.

  • description (com.vmware.vapi.std_client.LocalizableMessage) – Description of the operation associated with the task.

  • service (str) – Identifier of the service containing the operation. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.service. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.service.

  • operation (str) – Identifier of the operation associated with the task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.operation. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.operation.

  • parent (str or None) – Parent of the current task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.cis.task. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.cis.task. This attribute will be None if the task has no parent.

  • target (com.vmware.vapi.std_client.DynamicID or None) – Identifier of the target created by the operation or an existing one the operation performed on. This attribute will be None if the operation has no target or multiple targets.

  • status (com.vmware.cis.task_client.Status) – Status of the operation associated with the task.

  • cancelable (bool) – Flag to indicate whether or not the operation can be cancelled. The value may change as the operation progresses.

  • error (Exception or None) – Description of the error if the operation status is “FAILED”. If None the description of why the operation failed will be included in the result of the operation (see com.vmware.cis.task_client.Info.result).

  • start_time (datetime.datetime) – Time when the operation is started. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • end_time (datetime.datetime) – Time when the operation is completed. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.SUCCEEDED or com.vmware.cis.task_client.Status.FAILED.

  • user (str or None) – Name of the user who performed the operation. This attribute will be None if the operation is performed by the system.

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.

Parameters
  • progress (com.vmware.cis.task_client.Progress) – Progress of the task. This attribute was added in vSphere API 6.7. This attribute is optional and it is only relevant when the value of #status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • subtask_order (list of str) – List of tasks that make up this appliance task in the order they are being run. This attribute was added in vSphere API 6.7.

  • subtasks (dict of str and SubtaskInfo) – Information about the subtasks that this appliance task consists of. This attribute was added in vSphere API 6.7.

  • description (com.vmware.vapi.std_client.LocalizableMessage) – Description of the operation associated with the task.

  • service (str) – Identifier of the service containing the operation. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.service. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.service.

  • operation (str) – Identifier of the operation associated with the task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.operation. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.operation.

  • parent (str or None) – Parent of the current task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.cis.task. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.cis.task. This attribute will be None if the task has no parent.

  • target (com.vmware.vapi.std_client.DynamicID or None) – Identifier of the target created by the operation or an existing one the operation performed on. This attribute will be None if the operation has no target or multiple targets.

  • status (com.vmware.cis.task_client.Status) – Status of the operation associated with the task.

  • cancelable (bool) – Flag to indicate whether or not the operation can be cancelled. The value may change as the operation progresses.

  • error (Exception or None) – Description of the error if the operation status is “FAILED”. If None the description of why the operation failed will be included in the result of the operation (see com.vmware.cis.task_client.Info.result).

  • start_time (datetime.datetime) – Time when the operation is started. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • end_time (datetime.datetime) – Time when the operation is completed. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.SUCCEEDED or com.vmware.cis.task_client.Status.FAILED.

  • user (str or None) – Name of the user who performed the operation. This attribute will be None if the operation is performed by the system.

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.

Parameters

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

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.

Parameters

string (str) – String value for the TimeSyncMode instance.

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.

Parameters

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

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.

Parameters
  • state (Update.State) – State of the appliance update. This attribute was added in vSphere API 6.7.

  • task (TaskInfo or None) – The running or completed update task. This attribute was added in vSphere API 6.7.

  • version (str) – Version of base appliance if state is UP_TO_DATE Version of update being staged or installed if state is INSTALL_IN_PROGRESS or STAGE_IN_PROGRESS Version of update staged if state is UPDATES_PENDING Version of update failed if state is INSTALL_FAILED or ROLLBACK_IN_PROGRESS. This attribute was added in vSphere API 6.7.

  • latest_query_time (datetime.datetime or None) – Timestamp of latest query to update repository. This attribute was added in vSphere API 6.7. If None the update was never queried

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.

Parameters

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

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:

Parameters

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

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.

Parameters
  • user (str) – Fully qualified name of the end user that created the session, for example Administrator\@vsphere.local. A typical use case for this information is in Graphical User Interfaces (GUI) or logging systems to visualize the identity of the current user.

  • created_time (datetime.datetime) – Time when the session was created.

  • last_accessed_time (datetime.datetime) – Last time this session was used by passing the session key for invoking an API.

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

Initialize StubFactoryBase

Parameters

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

class com.vmware.cis_client.Tasks(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Tasks class provides methods for managing the task related to a long running operation. This class was added in vSphere API 6.7.1.

Parameters

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

class FilterSpec(tasks=None, services=None, operations=None, status=None, targets=None, users=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

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

Currently at least one of Tasks.FilterSpec.tasks or Tasks.FilterSpec.services must be specified and not empty.. This class was added in vSphere API 6.7.1.

Tip

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

Parameters
  • tasks (set of str or None) – Identifiers of tasks that can match the filter. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.cis.task. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.cis.task. This attribute may be None if services is specified. Currently all tasks must be from the same provider. If None or empty, tasks with any identifier will match the filter.

  • services (set of str or None) – Identifiers of services. Tasks created by operations in these services match the filter (see com.vmware.cis.task_client.CommonInfo.service). This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.vapi.service. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.vapi.service. This attribute may be None if tasks is specified. Currently all services must be from the same provider. If this attribute is None or empty, tasks for any service will match the filter.

  • operations (set of str or None) –

    Identifiers of operations. Tasks created by these operations match the filter (see com.vmware.cis.task_client.CommonInfo.operation).

    Note that an operation identifier by itself is not globally unique. To filter on an operation, the identifier of the service interface containing the operation should also be specified in services.. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.vapi.operation. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.vapi.operation. If None or empty, tasks associated with any operation will match the filter.

  • status (set of com.vmware.cis.task_client.Status or None) – Status that a task must have to match the filter (see com.vmware.cis.task_client.CommonInfo.status). This attribute was added in vSphere API 6.7.1. If None or empty, tasks with any status match the filter.

  • targets (list of com.vmware.vapi.std_client.DynamicID or None) – Identifiers of the targets the operation for the associated task created or was performed on (see com.vmware.cis.task_client.CommonInfo.target). This attribute was added in vSphere API 6.7.1. If None or empty, tasks associated with operations on any target match the filter.

  • users (set of str or None) – Users who must have initiated the operation for the associated task to match the filter (see com.vmware.cis.task_client.CommonInfo.user). This attribute was added in vSphere API 6.7.1. If None or empty, tasks associated with operations initiated by any user match the filter.

class GetSpec(return_all=None, exclude_result=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Tasks.GetSpec class describes what data should be included when retrieving information about a task. This class was added in vSphere API 6.7.1.

Tip

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

Parameters
  • return_all (bool or None) – If true, all data, including operation-specific data, will be returned, otherwise only the data described in com.vmware.cis.task_client.Info will be returned. This attribute was added in vSphere API 6.7.1. If None, only the data described in com.vmware.cis.task_client.Info will be returned.

  • exclude_result (bool or None) – If true, the result will not be included in the task information, otherwise it will be included. This attribute was added in vSphere API 6.7.1. If None, the result of the operation will be included in the task information.

RESOURCE_TYPE = 'com.vmware.cis.task'

Resource type for task. This class attribute was added in vSphere API 6.7.1.

cancel(task)

Cancel a running operation associated with the task. This is the best effort attempt. Operation may not be cancelled anymore once it reaches certain stage. This method was added in vSphere API 6.7.1.

Parameters

task (str) – Task identifier. The parameter must be an identifier for the resource type: com.vmware.cis.task.

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 task is already canceled or completed.

Raise

com.vmware.vapi.std.errors_client.NotFound if the task is not found.

Raise

com.vmware.vapi.std.errors_client.ResourceInaccessible if the task’s 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.

Raise

com.vmware.vapi.std.errors_client.Unsupported if the task is not cancelable.

get(task, spec=None)

Returns information about a task. This method was added in vSphere API 6.7.1.

Parameters
  • task (str) – Task identifier. The parameter must be an identifier for the resource type: com.vmware.cis.task.

  • spec (Tasks.GetSpec or None) – Specification on what to get for a task. If None, the behavior is equivalent to a Tasks.GetSpec with all attributes None which means only the data described in com.vmware.cis.task_client.Info will be returned and the result of the operation will be return.

Return type

com.vmware.cis.task_client.Info

Returns

Information about the specified task.

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 task is not found.

Raise

com.vmware.vapi.std.errors_client.ResourceInaccessible if the task’s 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_spec=None, result_spec=None)

Returns information about at most 1000 visible (subject to permission checks) tasks matching the Tasks.FilterSpec. All tasks must be in the same provider. This method was added in vSphere API 6.7.1.

Parameters
  • filter_spec (Tasks.FilterSpec or None) – Specification of matching tasks. This is currently required. In the future, if it is None, the behavior is equivalent to a Tasks.FilterSpec with all attributes None which means all tasks match the filter.

  • result_spec (Tasks.GetSpec or None) – Specification of what to return for a task. If None, the behavior is equivalent to a Tasks.GetSpec with all attributes None which means only the data describe in com.vmware.cis.task_client.Info will be returned and the result of the operation will be return.

Return type

dict of str and com.vmware.cis.task_client.Info

Returns

Map of task identifier to information about the task. The key in the return value dict will be an identifier for the resource type: com.vmware.cis.task.

Raise

com.vmware.vapi.std.errors_client.InvalidArgument if any of the specified parameters are invalid.

Raise

com.vmware.vapi.std.errors_client.ResourceInaccessible if a task’s state cannot be accessed or over 1000 tasks matching the Tasks.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.

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.

Parameters

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

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.

Parameters
  • automatic_sync_enabled (bool) –

    Whether automatic synchronization is enabled.

    When automatic synchronization is enabled, the Content Library Service will automatically synchronize all subscribed libraries on a daily basis. Subscribed libraries with the com.vmware.content.library_client.SubscriptionInfo.automatic_sync_enabled flag turned on will be synchronized every hour between ConfigurationModel.automatic_sync_start_hour and ConfigurationModel.automatic_sync_stop_hour. This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is optional for the update method.

  • automatic_sync_start_hour (long) – The hour at which the automatic synchronization will start. This value is between 0 (midnight) and 23 inclusive. This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is optional for the update method.

  • automatic_sync_stop_hour (long) – The hour at which the automatic synchronization will stop. Any active synchronization operation will continue to run, however no new synchronization operations will be triggered after the stop hour. This value is between 0 (midnight) and 23 inclusive. This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is optional for the update method.

  • maximum_concurrent_item_syncs (long) –

    The maximum allowed number of library items to synchronize concurrently from remote libraries. This must be a positive number. The service may not be able to guarantee the requested concurrency if there is no available capacity.

    This setting is global across all subscribed libraries.

    This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is optional for the update method.

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.

Parameters

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

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.

Parameters
  • name (str or None) – Name of the library to search. The name is case-insensitive. See LibraryModel.name. If not specified any name will be searched.

  • type (LibraryModel.LibraryType or None) – Library type to search. See LibraryModel.type. If not specified any library type will be searched.

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.

Parameters
  • id (str) – An identifier which uniquely identifies this LibraryModel. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.content.Library. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.content.Library. This attribute is not used for the create method. It will not be present in the return value of the get or list methods. It is not used for the update method.

  • creation_time (datetime.datetime) – The date and time when this library was created. This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

  • description (str) – A human-readable description for this library. This attribute is optional for the create method. Leaving it None during creation will result in an empty string value. It will always be present in the result of a get or list method. It is optional for the update method. Leaving it None during update indicates that the description should be left unchanged.

  • last_modified_time (datetime.datetime) –

    The date and time when this library was last updated.

    This attribute is updated automatically when the library properties are changed. This attribute is not affected by adding, removing, or modifying a library item or its content within the library. Tagging the library or syncing the subscribed library does not alter this attribute. This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

  • last_sync_time (datetime.datetime) –

    The date and time when this library was last synchronized.

    This attribute applies only to subscribed libraries. It is updated every time a synchronization is triggered on the library. The value is None for a local library. This attribute is not used for the create method. It is optional in the return value of the get or list methods. It is not used for the update method.

  • name (str) –

    The name of the library.

    A Library is identified by a human-readable name. Library names cannot be undefined or an empty string. Names do not have to be unique. This attribute must be provided for the create method. It will always be present in the return value of the get or list methods. It is optional for the update method.

  • storage_backings (list of com.vmware.content.library_client.StorageBacking) –

    The list of default storage backings which are available for this library.

    A com.vmware.content.library_client.StorageBacking defines a default storage location which can be used to store files for library items in this library. Some library items, for instance, virtual machine template items, support files that may be distributed across various storage backings. One or more item files may or may not be located on the default storage backing.

    Multiple default storage locations are not currently supported but may become supported in future releases. This attribute must be provided for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

  • type (LibraryModel.LibraryType) –

    The type (LOCAL, SUBSCRIBED) of this library.

    This value can be used to determine what additional services and information can be available for this library. This attribute is not used for the create and update methods. It will always be present in the result of a get method. This attribute is not used for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

  • optimization_info (com.vmware.content.library_client.OptimizationInfo) – Defines various optimizations and optimization parameters applied to this library. This attribute is optional for the create method. It is optional in the return value of the get or list methods. It is optional for the update method.

  • version (str) –

    A version number which is updated on metadata changes. This value allows clients to detect concurrent updates and prevent accidental clobbering of data.

    This value represents a number which is incremented every time library properties, such as name or description, are changed. It is not incremented by changes to a library item within the library, including adding or removing items. It is also not affected by tagging the library. This attribute is not used for the create method. It will always be present in the result of a get or list method. It is optional for the update method. Leaving it None during update indicates that you do not need to detect concurrent updates.

  • publish_info (com.vmware.content.library_client.PublishInfo) –

    Defines how this library is published so that it can be subscribed to by a remote subscribed library.

    The com.vmware.content.library_client.PublishInfo defines where and how the metadata for this local library is accessible. A local library is only published publically if com.vmware.content.library_client.PublishInfo.published is true. This attribute is optional for the create and update methods. If not specified during creation, the default is for the library to not be published. If not specified during update, the attribute is left unchanged.

  • subscription_info (com.vmware.content.library_client.SubscriptionInfo) –

    Defines the subscription behavior for this Library.

    The com.vmware.content.library_client.SubscriptionInfo defines how this subscribed library synchronizes to a remote source. Setting the value will determine the remote source to which the library synchronizes, and how. Changing the subscription will result in synchronizing to a new source. If the new source differs from the old one, the old library items and data will be lost. Setting com.vmware.content.library_client.SubscriptionInfo.automatic_sync_enabled to false will halt subscription but will not remove existing cached data. This attribute is optional for the create and update methods. If not specified during creation, a default will be created without an active subscription. If not specified during update, the attribute is left unchanged.

  • server_guid (str) – The unique identifier of the vCenter server where the library exists. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.VCenter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.VCenter. This attribute is optional for the create method. It will always be present in the return value of the get or list methods. It is not used for the update method.

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.

Parameters

string (str) – String value for the LibraryType instance.

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.

Parameters

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

class DestinationSpec(subscription=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The LocalLibrary.DestinationSpec class contains information required to publish the library to a specific subscription. This class was added in vSphere API 6.7.2.

Tip

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

Parameters

subscription (str) – Identifier of the subscription associated with the subscribed library. This attribute was added in vSphere API 6.7.2. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.content.library.Subscriptions. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.content.library.Subscriptions.

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.

  • The resource Datastore referenced by the attribute com.vmware.content.library_client.StorageBacking.datastore_id requires Datastore.AllocateSpace.

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.NotAllowedInCurrentState if the library contains a library item that cannot be deleted in its current state. For example, the library item contains a virtual machine template and a virtual machine is checked out of the library item.

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.

publish(library_id, subscriptions=None)

Publishes the library to specified subscriptions. If no subscriptions are specified, then publishes the library to all its subscriptions. This method was added in vSphere API 6.7.2.

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

  • subscriptions (list of LocalLibrary.DestinationSpec or None) – The list of subscriptions to publish this library to.

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 library specified by library_id does not exist.

Raise

com.vmware.vapi.std.errors_client.InvalidArgument If one or more subscriptions is not valid.

Raise

com.vmware.vapi.std.errors_client.InvalidElementType If the library specified by library_id is a subscribed library.

Raise

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState If the library specified by library_id is not a published library.

Raise

com.vmware.vapi.std.errors_client.Unauthenticated If the user that requested the method cannot be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized If the user that requested the method is not authorized to perform the method.

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.PublishLibrary.

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

Initialize StubFactoryBase

Parameters

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

class com.vmware.content_client.SubscribedLibrary(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

Parameters

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

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.

Parameters
  • status (SubscribedLibrary.ProbeResult.Status) – The status of probe result. This will be one of SUCCESS, INVALID_URL, TIMED_OUT, HOST_NOT_FOUND, RESOURCE_NOT_FOUND, INVALID_CREDENTIALS, CERTIFICATE_ERROR, UNKNOWN_ERROR.

  • ssl_thumbprint (str or None) – The SSL thumbprint for the remote endpoint. An SSL thumbprint is only returned if the host is secured with SSL/TLS.

  • error_messages (list of com.vmware.vapi.std_client.LocalizableMessage) – If the probe result is in an error status, this attribute will contain the detailed error messages.

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.

Parameters

string (str) – String value for the Status instance.

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.

  • The resource Datastore referenced by the attribute com.vmware.content.library_client.StorageBacking.datastore_id requires Datastore.AllocateSpace.

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.

Parameters

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

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.

Parameters
  • description (str) – A description of the type support offered by the plugin.

  • name (str) – The name of the plugin which provides the type support.

  • type (str) –

    The type which the plugin supports.

    To upload a library item of the type supported by the plugin, the com.vmware.content.library_client.ItemModel.type attribute of the item should be set to this value.

  • vendor (str) – The name of the vendor who created the type support plugin.

  • version (str) – The version number of the type support plugin.

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.vapi_client module

The com.vmware.vapi_client component provides API infrastructure classes and standard types that can be used in the interface specification of any class.

class com.vmware.vapi_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

Parameters

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

com.vmware.vcenter_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.

Parameters

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

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.

Parameters
  • clusters (set of str or None) – Identifiers of clusters that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ClusterComputeResource. If None or empty, clusters with any identifier match the filter.

  • names (set of str or None) – Names that clusters must have to match the filter (see Cluster.Info.name). If None or empty, clusters with any name match the filter.

  • folders (set of str or None) – Folders that must contain the cluster for the cluster to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, clusters in any folder match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the cluster for the cluster to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, clusters in any datacenter match the filter.

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.

Parameters
  • name (str) – The name of the cluster

  • resource_pool (str) – Identifier of the root resource pool of the cluster When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool.

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.

Parameters
  • cluster (str) – Identifier of the cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource.

  • name (str) – Name of the cluster.

  • ha_enabled (bool) – Flag indicating whether the vSphere HA feature is enabled for the cluster.

  • drs_enabled (bool) – Flag indicating whether the vSphere DRS service is enabled for the cluster.

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.

Parameters

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

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.

Parameters
  • name (str) – The name of the datacenter to be created.

  • folder (str or None) – Datacenter folder in which the new datacenter should be created. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose a suitable folder for the datacenter; if a folder cannot be chosen, the datacenter creation operation will fail.

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.

Parameters
  • datacenters (set of str or None) – Identifiers of datacenters that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, datacenters with any identifier match the filter.

  • names (set of str or None) – Names that datacenters must have to match the filter (see Datacenter.Info.name). If None or empty, datacenters with any name match the filter.

  • folders (set of str or None) – Folders that must contain the datacenters for the datacenter to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, datacenters in any folder match the filter.

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.

Parameters
  • name (str) – The name of the datacenter.

  • datastore_folder (str) – The root datastore folder associated with the datacenter. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder.

  • host_folder (str) – The root host and cluster folder associated with the datacenter. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder.

  • network_folder (str) – The root network folder associated with the datacenter. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder.

  • vm_folder (str) – The root virtual machine folder associated with the datacenter. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder.

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.

Parameters
  • datacenter (str) – Identifier of the datacenter. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datacenter.

  • name (str) – Name of the datacenter.

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.

Parameters

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

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.

Parameters
  • datastores (set of str or None) – Identifiers of datastores that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datastore. If None or empty, datastores with any identifier match the filter.

  • names (set of str or None) – Names that datastores must have to match the filter (see Datastore.Info.name). If None or empty, datastores with any name match the filter.

  • types (set of Datastore.Type or None) – Types that datastores must have to match the filter (see Datastore.Summary.type). If None or empty, datastores with any type match the filter.

  • folders (set of str or None) – Folders that must contain the datastore for the datastore to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, datastores in any folder match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the datastore for the datastore to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, datastores in any datacenter match the filter.

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.

Parameters
  • name (str) – Name of the datastore.

  • type (Datastore.Type) – Type (VMFS, NFS, NFS41, CIFS, VSAN, VFFS, VVOL) of the datastore.

  • accessible (bool) – Whether or not this datastore is accessible.

  • free_space (long or None) –

    Available space of this datastore, in bytes.

    The server periodically updates this value.

    This attribute will be None if the available space of this datastore is not known.

  • multiple_host_access (bool) – Whether or not ore than one host in the datacenter has been configured with access to the datastore.

  • thin_provisioning_supported (bool) – Whether or not the datastore supports thin provisioning on a per file basis. When thin provisioning is used, backing storage is lazily allocated.

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.

Parameters
  • datastore (str) – Identifier of the datastore. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore.

  • name (str) – Name of the datastore.

  • type (Datastore.Type) – Type (VMFS, NFS, NFS41, CIFS, VSAN, VFFS, VVOL) of the datatore.

  • free_space (long or None) –

    Available space of this datastore, in bytes.

    The server periodically updates this value.

    This attribute will be None if the available space of this datastore is not known.

  • capacity (long or None) –

    Capacity of this datastore, in bytes.

    The server periodically updates this value.

    This attribute will be None if the capacity of this datastore is not known.

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.

Parameters

string (str) – String value for the Type instance.

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 2500 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 2500 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.

Parameters

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

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.

Parameters
  • state (com.vmware.vcenter.deployment_client.ApplianceState) – State of the vCenter Server Appliance. This attribute was added in vSphere API 6.7.

  • progress (com.vmware.cis.task_client.Progress) – The progress info of the current appliance status. This attribute was added in vSphere API 6.7. This attribute is optional and it is only relevant when the value of #status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • subtask_order (list of str or None) – The ordered list of subtasks for this deployment operation. This attribute was added in vSphere API 6.7. Only set when the appliance state is RUNNING_IN_PROGRESS, FAILED, CANCELLED and SUCCEEDED.

  • subtasks ((dict of str and Deployment.Task) or None) – The map of the deployment subtasks and their status infomation. This attribute was added in vSphere API 6.7. Only set when the appliance state is RUNNING_IN_PROGRESS, FAILED, CANCELLED and SUCCEEDED.

  • description (com.vmware.vapi.std_client.LocalizableMessage) – Description of the operation associated with the task.

  • service (str) – Identifier of the service containing the operation. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.service. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.service.

  • operation (str) – Identifier of the operation associated with the task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.operation. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.operation.

  • parent (str or None) – Parent of the current task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.cis.task. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.cis.task. This attribute will be None if the task has no parent.

  • target (com.vmware.vapi.std_client.DynamicID or None) – Identifier of the target created by the operation or an existing one the operation performed on. This attribute will be None if the operation has no target or multiple targets.

  • status (com.vmware.cis.task_client.Status) – Status of the operation associated with the task.

  • cancelable (bool) – Flag to indicate whether or not the operation can be cancelled. The value may change as the operation progresses.

  • error (Exception or None) – Description of the error if the operation status is “FAILED”. If None the description of why the operation failed will be included in the result of the operation (see com.vmware.cis.task_client.Info.result).

  • start_time (datetime.datetime) – Time when the operation is started. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • end_time (datetime.datetime) – Time when the operation is completed. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.SUCCEEDED or com.vmware.cis.task_client.Status.FAILED.

  • user (str or None) – Name of the user who performed the operation. This attribute will be None if the operation is performed by the system.

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.

Parameters
  • progress (com.vmware.cis.task_client.Progress) – The progress info of this deployment task. This attribute was added in vSphere API 6.7. This attribute is optional and it is only relevant when the value of #status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • result (com.vmware.vcenter.deployment_client.Notifications or None) – Result of the task. This attribute was added in vSphere API 6.7. This attribute will be None if result is not available at the current step of the task.

  • description (com.vmware.vapi.std_client.LocalizableMessage) – Description of the operation associated with the task.

  • service (str) – Identifier of the service containing the operation. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.service. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.service.

  • operation (str) – Identifier of the operation associated with the task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vapi.operation. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vapi.operation.

  • parent (str or None) – Parent of the current task. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.cis.task. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.cis.task. This attribute will be None if the task has no parent.

  • target (com.vmware.vapi.std_client.DynamicID or None) – Identifier of the target created by the operation or an existing one the operation performed on. This attribute will be None if the operation has no target or multiple targets.

  • status (com.vmware.cis.task_client.Status) – Status of the operation associated with the task.

  • cancelable (bool) – Flag to indicate whether or not the operation can be cancelled. The value may change as the operation progresses.

  • error (Exception or None) – Description of the error if the operation status is “FAILED”. If None the description of why the operation failed will be included in the result of the operation (see com.vmware.cis.task_client.Info.result).

  • start_time (datetime.datetime) – Time when the operation is started. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.RUNNING, com.vmware.cis.task_client.Status.BLOCKED, com.vmware.cis.task_client.Status.SUCCEEDED, or com.vmware.cis.task_client.Status.FAILED.

  • end_time (datetime.datetime) – Time when the operation is completed. This attribute is optional and it is only relevant when the value of status is one of com.vmware.cis.task_client.Status.SUCCEEDED or com.vmware.cis.task_client.Status.FAILED.

  • user (str or None) – Name of the user who performed the operation. This attribute will be None if the operation is performed by the system.

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.

Parameters

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

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.

Parameters
  • folders (set of str or None) – Identifiers of folders that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, folders with any identifier match the filter.

  • names (set of str or None) – Names that folders must have to match the filter (see Folder.Summary.name). If None or empty, folders with any name match the filter.

  • type (Folder.Type or None) – Type that folders must have to match the filter (see Folder.Summary.type). If None, folders with any type match the filter.

  • parent_folders (set of str or None) – Folders that must contain the folder for the folder to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, folder in any folder match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the folder for the folder to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, folder in any datacenter match the filter.

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.

Parameters
  • folder (str) – Identifier of the folder. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder.

  • name (str) – Name of the vCenter Server folder.

  • type (Folder.Type) – Type (DATACENTER, DATASTORE, HOST, NETWORK, VIRTUAL_MACHINE) of the vCenter Server folder.

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.

Parameters

string (str) – String value for the Type instance.

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.

Parameters

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

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.

Parameters

string (str) – String value for the ConnectionState instance.

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.

Parameters
  • hostname (str) – The IP address or DNS resolvable name of the host.

  • port (long or None) – The port of the host. If None, port 443 will be used.

  • user_name (str) – The administrator account on the host.

  • password (str) – The password for the administrator account on the host.

  • folder (str or None) – Host and cluster folder in which the new standalone host should be created. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose a suitable folder for the host; if a folder cannot be chosen, the host creation operation will fail.

  • thumbprint_verification (Host.CreateSpec.ThumbprintVerification) – Type of host’s SSL certificate verification to be done.

  • thumbprint (str) – The thumbprint of the SSL certificate, which the host is expected to have. The thumbprint is always computed using the SHA1 hash and is the string representation of that hash in the format: xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx where, ‘x’ represents a hexadecimal digit. This attribute is optional and it is only relevant when the value of thumbprintVerification is Host.CreateSpec.ThumbprintVerification.THUMBPRINT.

  • force_add (bool or None) – Whether host should be added to the vCenter Server even if it is being managed by another vCenter Server. The original vCenterServer loses connection to the host. If None, forceAdd is default to false.

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.

Parameters

string (str) – String value for the ThumbprintVerification instance.

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.

Parameters
  • hosts (set of str or None) – Identifiers of hosts that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: HostSystem. If None or empty, hosts with any identifier match the filter.

  • names (set of str or None) – Names that hosts must have to match the filter (see Host.Summary.name). If None or empty, hosts with any name match the filter.

  • folders (set of str or None) – Folders that must contain the hosts for the hosts to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, hosts in any folder match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the hosts for the hosts to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, hosts in any datacenter match the filter.

  • standalone (bool or None) – If true, only hosts that are not part of a cluster can match the filter, and if false, only hosts that are are part of a cluster can match the filter. If None Hosts can match filter independent of whether they are part of a cluster or not. If this field is true and Host.FilterSpec.clusters os not empty, no hosts will match the filter.

  • clusters (set of str or None) – Clusters that must contain the hosts for the hosts to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ClusterComputeResource. If None or empty, hosts in any cluster and hosts that are not in a cluster match the filter. If this attribute is not empty and Host.FilterSpec.standalone is true, no hosts will match the filter.

  • connection_states (set of Host.ConnectionState or None) – Connection states that a host must be in to match the filter (see Host.Summary.connection_state. If None or empty, hosts in any connection state match the filter.

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.

Parameters

string (str) – String value for the PowerState instance.

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.

Parameters
  • host (str) – Identifier of the host. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem.

  • name (str) – Name of the host.

  • connection_state (Host.ConnectionState) – Connection status of the host

  • power_state (Host.PowerState) – Power state of the host This attribute is optional and it is only relevant when the value of connectionState is Host.ConnectionState.CONNECTED.

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 2500 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 2500 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.

Parameters

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

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.

Parameters
  • networks (set of str or None) – Identifiers of networks that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Network. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Network. If None or empty, networks with any identifier match the filter.

  • names (set of str or None) – Names that networks must have to match the filter (see Network.Summary.name). If None or empty, networks with any name match the filter.

  • types (set of Network.Type or None) – Types that networks must have to match the filter (see Network.Summary.type). If None, networks with any type match the filter.

  • folders (set of str or None) – Folders that must contain the network for the network to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, networks in any folder match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the network for the network to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, networks in any datacenter match the filter.

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.

Parameters
  • network (str) – Identifier of the network. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Network. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Network.

  • name (str) – Name of the network.

  • type (Network.Type) – Type (STANDARD_PORTGROUP, DISTRIBUTED_PORTGROUP, OPAQUE_NETWORK) of the vCenter Server network.

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.

Parameters

string (str) – String value for the Type instance.

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.

Parameters

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

class CreateSpec(name=None, parent=None, cpu_allocation=None, memory_allocation=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The class contains information used to create a resource pool, see ResourcePool.create(). This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • name (str) – Name of the resource pool. This attribute was added in vSphere API 7.0.0.

  • parent (str) – Parent of the created resource pool. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool.

  • cpu_allocation (ResourcePool.ResourceAllocationCreateSpec or None) – Resource allocation for CPU. This attribute was added in vSphere API 7.0.0. if None or empty, use the default CPU allocation specification.

  • memory_allocation (ResourcePool.ResourceAllocationCreateSpec or None) – Resource allocation for memory. This attribute was added in vSphere API 7.0.0. if None or empty, use the default memory allocation specification.

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.

Parameters
  • resource_pools (set of str or None) – Identifiers of resource pools that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ResourcePool. If None or empty, resource pools with any identifier match the filter.

  • names (set of str or None) – Names that resource pools must have to match the filter (see ResourcePool.Info.name). If None or empty, resource pools with any name match the filter.

  • parent_resource_pools (set of str or None) – Resource pools that must contain the resource pool for the resource pool to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ResourcePool. If None or empty, resource pools in any resource pool match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the resource pool for the resource pool to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, resource pools in any datacenter match the filter.

  • hosts (set of str or None) – Hosts that must contain the resource pool for the resource pool to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: HostSystem. If None or empty, resource pools in any host match the filter.

  • clusters (set of str or None) – Clusters that must contain the resource pool for the resource pool to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ClusterComputeResource. If None or empty, resource pools in any cluster match the filter.

class Info(name=None, resource_pools=None, cpu_allocation=None, memory_allocation=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.

Parameters
  • name (str) – Name of the vCenter Server resource pool.

  • resource_pools (set of str) – Identifiers of the child resource pools contained in this resource pool. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ResourcePool.

  • cpu_allocation (ResourcePool.ResourceAllocationInfo) – Resource allocation information for CPU. This attribute was added in vSphere API 7.0.0. This attribute is optional because it was added in a newer version than its parent node.

  • memory_allocation (ResourcePool.ResourceAllocationInfo) – Resource allocation information for memory. This attribute was added in vSphere API 7.0.0. This attribute is optional because it was added in a newer version than its parent node.

RESOURCE_TYPE = 'ResourcePool'

The resource type for the vCenter resource pool

class ResourceAllocationCreateSpec(reservation=None, expandable_reservation=None, limit=None, shares=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourcePool.ResourceAllocationCreateSpec class contains resource allocation information used to create a resource pool, see ResourcePool.create(). This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • reservation (long or None) – Amount of resource that is guaranteed available to a resource pool. Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MB fo memory, and MHz for CPU. This attribute was added in vSphere API 7.0.0. If None or empty, ResourcePool.ResourceAllocationCreateSpec.reservation will be set to 0.

  • expandable_reservation (bool or None) – In a resource pool with an expandable reservation, the reservation can grow beyond the specified value, if the parent resource pool has unreserved resources. A non-expandable reservation is called a fixed reservation. This attribute was added in vSphere API 7.0.0. If None or empty, ResourcePool.ResourceAllocationCreateSpec.expandable_reservation will be set to true.

  • limit (long or None) – The utilization of a resource pool will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MB for memory, and MHz for CPU. This attribute was added in vSphere API 7.0.0. If None or empty, ResourcePool.ResourceAllocationCreateSpec.limit will be set to -1.

  • shares (ResourcePool.SharesInfo or None) – Shares are used in case of resource contention. This attribute was added in vSphere API 7.0.0. If None or empty, ResourcePool.ResourceAllocationCreateSpec.shares will be set to ‘ResourcePool.SharesInfo.Level.NORMAL’.

class ResourceAllocationInfo(reservation=None, expandable_reservation=None, limit=None, shares=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourcePool.ResourceAllocationInfo class contains resource allocation information of a resource pool. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • reservation (long) – Amount of resource that is guaranteed available to a resource pool. Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MB fo memory, and MHz for CPU. This attribute was added in vSphere API 7.0.0.

  • expandable_reservation (bool) – In a resource pool with an expandable reservation, the reservation can grow beyond the specified value, if the parent resource pool has unreserved resources. A non-expandable reservation is called a fixed reservation. This attribute was added in vSphere API 7.0.0.

  • limit (long) – The utilization of a resource pool will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MB for memory, and MHz for CPU. This attribute was added in vSphere API 7.0.0.

  • shares (ResourcePool.SharesInfo) – Shares are used in case of resource contention. This attribute was added in vSphere API 7.0.0.

class ResourceAllocationUpdateSpec(reservation=None, expandable_reservation=None, limit=None, shares=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourceAllocationUpdateSpec class descrives the updates to be made to the resource allocation settings of a resource pool. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • reservation (long or None) – Amount of resource that is guaranteed available to a resource pool. Reserved resources are not wasted if they are not used. If the utilization is less than the reservation, the resources can be utilized by other running virtual machines. Units are MB fo memory, and MHz for CPU. This attribute was added in vSphere API 7.0.0. If None or empty, reservation will be set to 0.

  • expandable_reservation (bool or None) – In a resource pool with an expandable reservation, the reservation can grow beyond the specified value, if the parent resource pool has unreserved resources. A non-expandable reservation is called a fixed reservation. This attribute was added in vSphere API 7.0.0. If None or empty, expandableReservation will be set to true.

  • limit (long or None) – The utilization of a resource pool will not exceed this limit, even if there are available resources. This is typically used to ensure a consistent performance of resource pools independent of available resources. If set to -1, then there is no fixed limit on resource usage (only bounded by available resources and shares). Units are MB for memory, and MHz for CPU. This attribute was added in vSphere API 7.0.0. If None or empty, limit will be set to -1.

  • shares (ResourcePool.SharesInfo or None) – Shares are used in case of resource contention. This attribute was added in vSphere API 7.0.0. If None or empty, shares will be set to ‘ResourcePool.SharesInfo.Level.NORMAL’.

class SharesInfo(level=None, shares=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourcePool.SharesInfo class provides specification of shares.

Shares are used to determine relative allocation between resource consumers. In general, a consumer with more shares gets proportionally more of the resource, subject to certain other constraints.. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • level (ResourcePool.SharesInfo.Level) – The allocation level. It maps to a pre-determined set of numeric values for shares. If the shares value does not map to a predefined size, then the level is set as CUSTOM. This attribute was added in vSphere API 7.0.0.

  • shares (long) –

    When ResourcePool.SharesInfo.level is set to CUSTOM, it is the number of shares allocated. Otherwise, this value is ignored.

    There is no unit for this value. It is a relative measure based on the settings for other resource pools.. This attribute was added in vSphere API 7.0.0. This attribute is optional and it is only relevant when the value of level is ResourcePool.SharesInfo.Level.CUSTOM.

class Level(string)

Bases: vmware.vapi.bindings.enum.Enum

The ResourcePool.SharesInfo.Level class defines the possible values for the allocation level. This enumeration was added in vSphere API 7.0.0.

Note

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

Parameters

string (str) – String value for the Level instance.

CUSTOM = Level(string='CUSTOM')

If set, in case there is resource contention the server uses the shares value to determine the resource allocation. This class attribute was added in vSphere API 7.0.0.

HIGH = Level(string='HIGH')
For CPU: Shares = 2000 * nmumber of virtual CPUs.

For Memory: Shares = 20 * virtual machine memory size in MB.

. This class attribute was added in vSphere API 7.0.0.

LOW = Level(string='LOW')
For CPU: Shares = 500 * number of virtual CPUs.

For Memory: Shares = 5 * virtual machine memory size in MB.

. This class attribute was added in vSphere API 7.0.0.

NORMAL = Level(string='NORMAL')
For CPU: Shares = 1000 * number of virtual CPUs.

For Memory: Shares = 10 * virtual machine memory size in MB.

. This class attribute was added in vSphere API 7.0.0.

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.

Parameters
  • resource_pool (str) – Identifier of the resource pool. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool.

  • name (str) – Name of the resource pool.

class UpdateSpec(name=None, cpu_allocation=None, memory_allocation=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The class contains specification for updating the configuration of a resource pool. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • name (str or None) – Name of the resource pool. This attribute was added in vSphere API 7.0.0. if None or empty, the name of the resource pool will not be changed.

  • cpu_allocation (ResourcePool.ResourceAllocationUpdateSpec or None) – Resource allocation for CPU. This attribute was added in vSphere API 7.0.0. if None or empty, the CPU allocation of the resource pool will not be changed.

  • memory_allocation (ResourcePool.ResourceAllocationUpdateSpec or None) – Resource allocation for memory. This attribute was added in vSphere API 7.0.0. if None or empty, the memory allocation of the resource pool will not be changed.

create(spec)

Creates a resource pool. This method was added in vSphere API 7.0.0.

Parameters

spec (ResourcePool.CreateSpec) – Specification of the new resource pool to be created, see ResourcePool.CreateSpec.

Return type

str

Returns

The identifier of the newly created resource pool. The return value will be an identifier for the resource type: ResourcePool.

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 a parameter passed in the spec is invalid.

Raise

com.vmware.vapi.std.errors_client.NotFound If the resource specified in parent could not be found

Raise

com.vmware.vapi.std.errors_client.ResourceInaccessible If the specified resource in parent is not accessible.

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 resource pool 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.Unauthorized if you do not have all of the privileges described as follows:

  • The resource ResourcePool referenced by the attribute ResourcePool.CreateSpec.parent requires Resource.CreatePool.

delete(resource_pool)

Deletes a resource pool. This method was added in vSphere API 7.0.0.

Parameters

resource_pool (str) – Identifier of the resource pool to be deleted. The parameter must be an identifier for the resource type: ResourcePool.

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 resource pool is not 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.

Raise

com.vmware.vapi.std.errors_client.Unsupported If the resource pool is a root resource pool.

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.

Raise

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

  • The resource ResourcePool referenced by the parameter resource_pool requires System.Read.

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.

update(resource_pool, spec)

Updates the configuration of a resource pool. This method was added in vSphere API 7.0.0.

Parameters
  • resource_pool (str) – Identifier of the resource pool. The parameter must be an identifier for the resource type: ResourcePool.

  • spec (ResourcePool.UpdateSpec) – Specification for updating the configuration of the resource pool.

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 is invalid.

Raise

com.vmware.vapi.std.errors_client.NotFound If the resource pool is not 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.UnableToAllocateResource If any of the resources needed to reconfigure the resource pool 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.Unauthorized if you do not have all of the privileges described as follows:

  • The resource ResourcePool referenced by the parameter resource_pool requires Resource.EditPool.

class com.vmware.vcenter_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

Parameters

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

class com.vmware.vcenter_client.VM(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

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

Parameters

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

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

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.ClonePlacementSpec class contains information used to place a clone of a virtual machine onto resources within the vCenter inventory. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • folder (str or None) – Virtual machine folder into which the cloned virtual machine should be placed. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. If attribute is None, the system will use the virtual machine folder of the source virtual machine. If this results in a conflict due to other placement parameters, the virtual machine clone operation will fail.

  • resource_pool (str or None) – Resource pool into which the cloned virtual machine should be placed. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool. If attribute is None, the system will use the resource pool of the source virtual machine. If this results in a conflict due to other placement parameters, the virtual machine clone operation will fail.

  • host (str or None) –

    Host onto which the cloned virtual machine should be placed.

    If host and resourcePool are both specified, resourcePool must belong to host.

    If host and cluster are both specified, host must be a member of cluster.. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem. If this attribute is unset, if resourcePool is unset, the cloned virtual machine will use the host of the source virtual machine. if resourcePool is set, and the target is a standalone host, the host is used. if resourcePool is set, and the target is a DRS cluster, a host will be picked by DRS. if resourcePool is set, and the target is a cluster without DRS, InvalidArgument will be thrown.

  • cluster (str or None) –

    Cluster into which the cloned virtual machine should be placed.

    If cluster and resourcePool are both specified, resourcePool must belong to cluster.

    If cluster and host are both specified, host must be a member of cluster.. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource. If resourcePool or host is specified, it is recommended that this attribute be None.

  • datastore (str or None) – Datastore on which the cloned virtual machine’s configuration state should be stored. This datastore will also be used for any virtual disks that are created as part of the virtual machine clone operation unless individually overridden. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. If attribute is None, the system will use the datastore of the source virtual machine.

class CloneSpec(source=None, name=None, placement=None, disks_to_remove=None, disks_to_update=None, power_on=None, guest_customization_spec=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based clone spec. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • source (str) – Virtual machine to clone from. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: VirtualMachine. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: VirtualMachine.

  • name (str) – Virtual machine name. This attribute was added in vSphere API 7.0.0.

  • placement (VM.ClonePlacementSpec or None) – Virtual machine placement information. This attribute was added in vSphere API 7.0.0. If this attribute is None, the system will use the values from the source virtual machine. If specified, each field will be used for placement. If the fields result in disjoint placement the operation will fail. If the fields along with the placement values of the source virtual machine result in disjoint placement the operation will fail.

  • disks_to_remove (set of str or None) – Set of Disks to Remove. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.vcenter.vm.hardware.Disk. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.vcenter.vm.hardware.Disk. If None, all disks will be copied. If the same identifier is in VM.CloneSpec.disks_to_update InvalidArgument fault will be returned.

  • disks_to_update ((dict of str and VM.DiskCloneSpec) or None) – Map of Disks to Update. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk. If None, all disks will copied to the datastore specified in the VM.ClonePlacementSpec.datastore attribute of VM.CloneSpec.placement. If the same identifier is in VM.CloneSpec.disks_to_remove InvalidArgument fault will be thrown.

  • power_on (bool or None) – Attempt to perform a VM.CloneSpec.power_on after clone. This attribute was added in vSphere API 7.0.0. If None, the virtual machine will not be powered on.

  • guest_customization_spec (VM.GuestCustomizationSpec or None) – Guest customization spec to apply to the virtual machine after the virtual machine is deployed. This attribute was added in vSphere API 7.0.0. If None, the guest operating system is not customized after clone.

class ComputePlacementSpec(resource_pool=None, host=None, cluster=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.ComputePlacementSpec class contains information used to place a virtual machine on compute resources.

Tip

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

Parameters
  • resource_pool (str or None) – Resource pool into which the virtual machine should be placed. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool. This attribute is currently required if both host and cluster are None. In the future, if this attribute is None, the system will attempt to choose a suitable resource pool for the virtual machine; if a resource pool cannot be chosen, the virtual machine creation operation will fail.

  • host (str or None) –

    Host onto which the virtual machine should be placed.

    If host and resourcePool are both specified, resourcePool must belong to host.

    If host and cluster are both specified, host must be a member of cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem. This attribute may be None if resourcePool or cluster is specified. If None, the system will attempt to choose a suitable host for the virtual machine; if a host cannot be chosen, the virtual machine creation operation will fail.

  • cluster (str or None) –

    Cluster into which the virtual machine should be placed.

    If cluster and resourcePool are both specified, resourcePool must belong to cluster.

    If cluster and host are both specified, host must be a member of cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource. If resourcePool or host is specified, it is recommended that this attribute be None.

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.

Parameters
class DiskCloneSpec(datastore=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based disk clone spec. This class was added in vSphere API 7.0.0.

Tip

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

Parameters

datastore (str or None) – Destination datastore to clone disk. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. This attribute is currently required. In the future, if this attribute is None disk will be copied to the datastore specified in the VM.ClonePlacementSpec.datastore attribute of VM.CloneSpec.placement.

class DiskRelocateSpec(datastore=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based disk relocate spec. This class was added in vSphere API 7.0.0.

Tip

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

Parameters

datastore (str or None) – Destination datastore to relocate disk. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. This attribute is currently required. In the future, if this attribute is unset, disk will use the datastore specified in VM.RelocatePlacementSpec.datastore attribute of VM.RelocateSpec.placement.

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.

Parameters
  • vms (set of str or None) – Identifiers of virtual machines that can match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: VirtualMachine. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: VirtualMachine. If None or empty, virtual machines with any identifier match the filter.

  • names (set of str or None) – Names that virtual machines must have to match the filter (see VM.Info.name). If None or empty, virtual machines with any name match the filter.

  • folders (set of str or None) – Folders that must contain the virtual machine for the virtual machine to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Folder. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Folder. If None or empty, virtual machines in any folder match the filter.

  • datacenters (set of str or None) – Datacenters that must contain the virtual machine for the virtual machine to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: Datacenter. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: Datacenter. If None or empty, virtual machines in any datacenter match the filter.

  • hosts (set of str or None) – Hosts that must contain the virtual machine for the virtual machine to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: HostSystem. If None or empty, virtual machines on any host match the filter.

  • clusters (set of str or None) – Clusters that must contain the virtual machine for the virtual machine to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ClusterComputeResource. If None or empty, virtual machines in any cluster match the filter.

  • resource_pools (set of str or None) – Resource pools that must contain the virtual machine for the virtual machine to match the filter. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: ResourcePool. If None or empty, virtual machines in any resource pool match the filter.

  • power_states (set of com.vmware.vcenter.vm_client.Power.State or None) – Power states that a virtual machine must be in to match the filter (see com.vmware.vcenter.vm_client.Power.Info.state. If None or empty, virtual machines in any power state match the filter.

class GuestCustomizationSpec(name=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.GuestCustomizationSpec class contains information required to customize a virtual machine when deploying it. This class was added in vSphere API 7.0.0.

Tip

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

Parameters

name (str or None) – Name of the customization specification. This attribute was added in vSphere API 7.0.0. If None, no guest customization is performed.

class Info(guest_os=None, name=None, identity=None, power_state=None, instant_clone_frozen=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.

Parameters
  • guest_os (com.vmware.vcenter.vm_client.GuestOS) – Guest OS.

  • name (str) – Virtual machine name.

  • identity (com.vmware.vcenter.vm_client.Identity.Info) – Identity of the virtual machine. This attribute was added in vSphere API 6.7.1. This attribute is optional because it was added in a newer version than its parent node.

  • power_state (com.vmware.vcenter.vm_client.Power.State) – Power state of the virtual machine.

  • instant_clone_frozen (bool) – Indicates whether the virtual machine is frozen for instant clone, or not. This attribute was added in vSphere API 6.7.1. This attribute is optional because it was added in a newer version than its parent node.

  • hardware (com.vmware.vcenter.vm_client.Hardware.Info) – Virtual hardware version information.

  • boot (com.vmware.vcenter.vm.hardware_client.Boot.Info) – Boot configuration.

  • boot_devices (list of com.vmware.vcenter.vm.hardware.boot_client.Device.Entry) – Boot device configuration. If the list has no entries, a server-specific default boot sequence is used.

  • cpu (com.vmware.vcenter.vm.hardware_client.Cpu.Info) – CPU configuration.

  • memory (com.vmware.vcenter.vm.hardware_client.Memory.Info) – Memory configuration.

  • disks (dict of str and com.vmware.vcenter.vm.hardware_client.Disk.Info) – List of disks. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk.

  • nics (dict of str and com.vmware.vcenter.vm.hardware_client.Ethernet.Info) – List of Ethernet adapters. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

  • cdroms (dict of str and com.vmware.vcenter.vm.hardware_client.Cdrom.Info) – List of CD-ROMs. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

  • floppies (dict of str and com.vmware.vcenter.vm.hardware_client.Floppy.Info) – List of floppy drives. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Floppy. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Floppy.

  • parallel_ports (dict of str and com.vmware.vcenter.vm.hardware_client.Parallel.Info) – List of parallel ports. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort.

  • serial_ports (dict of str and com.vmware.vcenter.vm.hardware_client.Serial.Info) – List of serial ports. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.SerialPort. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.SerialPort.

  • sata_adapters (dict of str and com.vmware.vcenter.vm.hardware.adapter_client.Sata.Info) – List of SATA adapters. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.SataAdapter. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.SataAdapter.

  • scsi_adapters (dict of str and com.vmware.vcenter.vm.hardware.adapter_client.Scsi.Info) – List of SCSI adapters. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ScsiAdapter. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ScsiAdapter.

class InstantClonePlacementSpec(folder=None, resource_pool=None, datastore=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.InstantClonePlacementSpec class contains information used to place an InstantClone of a virtual machine onto resources within the vCenter inventory. This class was added in vSphere API 6.7.1.

Tip

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

Parameters
  • folder (str or None) – Virtual machine folder into which the InstantCloned virtual machine should be placed. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. If attribute is None, the system will use the virtual machine folder of the source virtual machine.

  • resource_pool (str or None) – Resource pool into which the InstantCloned virtual machine should be placed. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool. If attribute is None, the system will use the resource pool of the source virtual machine.

  • datastore (str or None) – Datastore on which the InstantCloned virtual machine’s configuration state should be stored. This datastore will also be used for any virtual disks that are created as part of the virtual machine InstantClone operation. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. If attribute is None, the system will use the datastore of the source virtual machine.

class InstantCloneSpec(source=None, name=None, placement=None, nics_to_update=None, disconnect_all_nics=None, parallel_ports_to_update=None, serial_ports_to_update=None, bios_uuid=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based InstantClone spec. This class was added in vSphere API 6.7.1.

Tip

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

Parameters
  • source (str) – Virtual machine to InstantClone from. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: VirtualMachine. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: VirtualMachine.

  • name (str) – Name of the new virtual machine. This attribute was added in vSphere API 6.7.1.

  • placement (VM.InstantClonePlacementSpec or None) – Virtual machine placement information. This attribute was added in vSphere API 6.7.1. If this attribute is None, the system will use the values from the source virtual machine. If specified, each field will be used for placement. If the fields result in disjoint placement the operation will fail. If the fields along with the placement values of the source virtual machine result in disjoint placement the operation will fail.

  • nics_to_update ((dict of str and com.vmware.vcenter.vm.hardware_client.Ethernet.UpdateSpec) or None) – Map of NICs to update. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet. If None, no NICs will be updated.

  • disconnect_all_nics (bool or None) – Indicates whether all NICs on the destination virtual machine should be disconnected from the newtwork. This attribute was added in vSphere API 6.7.1. If None, connection status of all NICs on the destination virtual machine will be the same as on the source virtual machine.

  • parallel_ports_to_update ((dict of str and com.vmware.vcenter.vm.hardware_client.Parallel.UpdateSpec) or None) – Map of parallel ports to Update. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.ParallelPort. If None, no parallel ports will be updated.

  • serial_ports_to_update ((dict of str and com.vmware.vcenter.vm.hardware_client.Serial.UpdateSpec) or None) – Map of serial ports to Update. This attribute was added in vSphere API 6.7.1. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.SerialPort. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.SerialPort. If None, no serial ports will be updated.

  • bios_uuid (str or None) – 128-bit SMBIOS UUID of a virtual machine represented as a hexadecimal string in “12345678-abcd-1234-cdef-123456789abc” format. This attribute was added in vSphere API 6.7.1. If None, will be generated.

class InventoryPlacementSpec(folder=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.InventoryPlacementSpec class contains information used to place a virtual machine in the vCenter inventory.

Tip

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

Parameters

folder (str or None) – Virtual machine folder into which the virtual machine should be placed. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose a suitable folder for the virtual machine; if a folder cannot be chosen, the virtual machine creation operation will fail.

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.

Parameters
  • folder (str or None) – Virtual machine folder into which the virtual machine should be placed. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose a suitable folder for the virtual machine; if a folder cannot be chosen, the virtual machine creation operation will fail.

  • resource_pool (str or None) – Resource pool into which the virtual machine should be placed. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool. This attribute is currently required if both host and cluster are None. In the future, if this attribute is None, the system will attempt to choose a suitable resource pool for the virtual machine; if a resource pool cannot be chosen, the virtual machine creation operation will fail.

  • host (str or None) –

    Host onto which the virtual machine should be placed.

    If host and resourcePool are both specified, resourcePool must belong to host.

    If host and cluster are both specified, host must be a member of cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem. This attribute may be None if resourcePool or cluster is specified. If None, the system will attempt to choose a suitable host for the virtual machine; if a host cannot be chosen, the virtual machine creation operation will fail.

  • cluster (str or None) –

    Cluster into which the virtual machine should be placed.

    If cluster and resourcePool are both specified, resourcePool must belong to cluster.

    If cluster and host are both specified, host must be a member of cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource. If resourcePool or host is specified, it is recommended that this attribute be None.

  • datastore (str or None) – Datastore on which the virtual machine’s configuration state should be stored. This datastore will also be used for any virtual disks that are created as part of the virtual machine creation operation. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose suitable storage for the virtual machine; if storage cannot be chosen, the virtual machine creation operation will fail.

RESOURCE_TYPE = 'VirtualMachine'

Resource type for virtual machines.

class RegisterPlacementSpec(folder=None, resource_pool=None, host=None, cluster=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.RegisterPlacementSpec class contains information used to place a virtual machine, created from existing virtual machine files on storage, onto resources within the vCenter inventory. This class was added in vSphere API 6.8.7.

Tip

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

Parameters
  • folder (str or None) – Virtual machine folder into which the virtual machine should be placed. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose a suitable folder for the virtual machine; if a folder cannot be chosen, the virtual machine creation operation will fail.

  • resource_pool (str or None) – Resource pool into which the virtual machine should be placed. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool. This attribute is currently required if both host and cluster are None. In the future, if this attribute is None, the system will attempt to choose a suitable resource pool for the virtual machine; if a resource pool cannot be chosen, the virtual machine creation operation will fail.

  • host (str or None) –

    Host onto which the virtual machine should be placed.

    If host and resourcePool are both specified, resourcePool must belong to host.

    If host and cluster are both specified, host must be a member of cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem. This attribute may be None if resourcePool or cluster is specified. If None, the system will attempt to choose a suitable host for the virtual machine; if a host cannot be chosen, the virtual machine creation operation will fail.

  • cluster (str or None) –

    Cluster into which the virtual machine should be placed.

    If cluster and resourcePool are both specified, resourcePool must belong to cluster.

    If cluster and host are both specified, host must be a member of cluster. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource. If resourcePool or host is specified, it is recommended that this attribute be None.

class RegisterSpec(datastore=None, path=None, datastore_path=None, name=None, placement=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.RegisterSpec class contains information used to create a virtual machine from existing virtual machine files on storage.

The location of the virtual machine files on storage must be specified by providing either VM.RegisterSpec.datastore and VM.RegisterSpec.path or by providing VM.RegisterSpec.datastore_path. If VM.RegisterSpec.datastore and VM.RegisterSpec.path are set, VM.RegisterSpec.datastore_path must be None, and if VM.RegisterSpec.datastore_path is set, VM.RegisterSpec.datastore and VM.RegisterSpec.path must be None.. This class was added in vSphere API 6.8.7.

Tip

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

Parameters
  • datastore (str or None) – Identifier of the datastore on which the virtual machine’s configuration state is stored. This attribute was added in vSphere API 6.8.7. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. If None, VM.RegisterSpec.path must also be None and VM.RegisterSpec.datastore_path must be set.

  • path (str or None) – Path to the virtual machine’s configuration file on the datastore corresponding to {\@link #datastore). This attribute was added in vSphere API 6.8.7. If None, VM.RegisterSpec.datastore must also be None and VM.RegisterSpec.datastore_path must be set.

  • datastore_path (str or None) – Datastore path for the virtual machine’s configuration file in the format “[datastore name] path”. For example “[storage1] Test-VM/Test-VM.vmx”. This attribute was added in vSphere API 6.8.7. If None, both VM.RegisterSpec.datastore and VM.RegisterSpec.path must be set.

  • name (str or None) – Virtual machine name. This attribute was added in vSphere API 6.8.7. If None, the display name from the virtual machine’s configuration file will be used.

  • placement (VM.RegisterPlacementSpec or None) – Virtual machine placement information. This attribute was added in vSphere API 6.8.7. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose suitable resources on which to place the virtual machine.

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

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.RelocatePlacementSpec class contains information used to change the placement of an existing virtual machine within the vCenter inventory. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • folder (str or None) – Virtual machine folder into which the virtual machine should be placed. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. If this attribute is None, the virtual machine will stay in the current folder.

  • resource_pool (str or None) – Resource pool into which the virtual machine should be placed. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool. If this attribute is None, the virtual machine will stay in the current resource pool.

  • host (str or None) –

    Host onto which the virtual machine should be placed.

    If host and resourcePool are both specified, resourcePool must belong to host.

    If host and cluster are both specified, host must be a member of cluster.. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem. If this attribute is unset, if resourcePool is unset, the virtual machine will remain on the current host. if resourcePool is set, and the target is a standalone host, the host is used. if resourcePool is set, and the target is a DRS cluster, a host will be picked by DRS. if resourcePool is set, and the target is a cluster without DRS, InvalidArgument will be thrown.

  • cluster (str or None) –

    Cluster into which the virtual machine should be placed.

    If cluster and resourcePool are both specified, resourcePool must belong to cluster.

    If cluster and host are both specified, host must be a member of cluster.. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ClusterComputeResource. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ClusterComputeResource. If resourcePool or host is specified, it is recommended that this attribute be None.

  • datastore (str or None) – Datastore on which the virtual machine’s configuration state should be stored. This datastore will also be used for any virtual disks that are associated with the virtual machine, unless individually overridden. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. If this attribute is None, the virtual machine will remain on the current datastore.

class RelocateSpec(placement=None, disks=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Document-based relocate spec. This class was added in vSphere API 7.0.0.

Tip

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

Parameters
  • placement (VM.RelocatePlacementSpec or None) – Virtual machine placement information. This attribute was added in vSphere API 7.0.0. If this attribute is None, the system will use the values from the source virtual machine. If specified, each field will be used for placement. If the fields result in disjoint placement the operation will fail. If the fields along with the other existing placement of the virtual machine result in disjoint placement the operation will fail.

  • disks ((dict of str and VM.DiskRelocateSpec) or None) – Individual disk relocation map. This attribute was added in vSphere API 7.0.0. When clients pass a value of this class as a parameter, the key in the attribute dict must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk. When methods return a value of this class as a return value, the key in the attribute dict will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk. If None, all disks will migrate to the datastore specified in the VM.RelocatePlacementSpec.datastore attribute of VM.RelocateSpec.placement.

class StoragePlacementSpec(datastore=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The VM.StoragePlacementSpec class contains information used to store a virtual machine’s files.

Tip

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

Parameters

datastore (str or None) – Datastore on which the virtual machine’s configuration state should be stored. This datastore will also be used for any virtual disks that are created as part of the virtual machine creation operation. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. This attribute is currently required. In the future, if this attribute is None, the system will attempt to choose suitable storage for the virtual machine; if storage cannot be chosen, the virtual machine creation operation will fail.

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.

Parameters

policy (str) – Identifier of the storage policy which should be associated with the virtual machine. This attribute was added in vSphere API 6.7. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vcenter.StoragePolicy. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vcenter.StoragePolicy.

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.

Parameters
  • vm (str) – Identifier of the virtual machine. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: VirtualMachine. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: VirtualMachine.

  • name (str) – Name of the Virtual machine.

  • power_state (com.vmware.vcenter.vm_client.Power.State) – Power state of the virtual machine.

  • cpu_count (long or None) – Number of CPU cores. This attribute will be None if the virtual machine configuration is not available. For example, the configuration information would be unavailable if the server is unable to access the virtual machine files on disk, and is often also unavailable during the intial phases of virtual machine creation.

  • memory_size_mib (long or None) – Memory size in mebibytes. This attribute will be None if the virtual machine configuration is not available. For example, the configuration information would be unavailable if the server is unable to access the virtual machine files on disk, and is often also unavailable during the intial phases of virtual machine creation.

clone(spec)

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.

Parameters

spec (VM.CloneSpec) – Virtual machine clone 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.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 clone 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.Unauthorized if you do not have all of the privileges described as follows:

  • The resource Datastore referenced by the attribute VM.DiskCloneSpec.datastore requires Datastore.AllocateSpace.

  • The resource Datastore referenced by the attribute VM.ClonePlacementSpec.datastore requires Datastore.AllocateSpace.

  • The resource Folder referenced by the attribute VM.ClonePlacementSpec.folder requires VirtualMachine.Inventory.CreateFromExisting.

  • The resource ResourcePool referenced by the attribute VM.ClonePlacementSpec.resource_pool requires Resource.AssignVMToPool.

  • The resource VirtualMachine referenced by the attribute VM.CloneSpec.source requires VirtualMachine.Provisioning.Clone.

clone_task(spec)

Creates a virtual machine from an existing virtual machine.

. This method was added in vSphere API 7.0.0.

Parameters

spec (VM.CloneSpec) – Virtual machine clone specification.

Return type

class

vmware.vapi.stdlib.client.task.Task

Returns

Task instance

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.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 clone 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.Unauthorized if you do not have all of the privileges described as follows:

  • The resource Datastore referenced by the attribute VM.DiskCloneSpec.datastore requires Datastore.AllocateSpace.

  • The resource Datastore referenced by the attribute VM.ClonePlacementSpec.datastore requires Datastore.AllocateSpace.

  • The resource Folder referenced by the attribute VM.ClonePlacementSpec.folder requires VirtualMachine.Inventory.CreateFromExisting.

  • The resource ResourcePool referenced by the attribute VM.ClonePlacementSpec.resource_pool requires Resource.AssignVMToPool.

  • The resource VirtualMachine referenced by the attribute VM.CloneSpec.source requires VirtualMachine.Provisioning.Clone.

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, NVMe) 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.

Raise

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

  • The resource Folder referenced by the attribute VM.InventoryPlacementSpec.folder requires VirtualMachine.Inventory.Create.

  • The resource ResourcePool referenced by the attribute VM.ComputePlacementSpec.resource_pool requires Resource.AssignVMToPool.

  • The resource Datastore referenced by the attribute VM.StoragePlacementSpec.datastore requires Datastore.AllocateSpace.

  • The resource Network referenced by the attribute com.vmware.vcenter.vm.hardware_client.Ethernet.BackingSpec.network requires Network.Assign.

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.

Raise

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

  • The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Delete.

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.

Raise

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

  • The resource VirtualMachine referenced by the parameter vm requires System.Read.

instant_clone(spec)

Create an instant clone of an existing virtual machine. This method was added in vSphere API 6.7.1.

Parameters

spec (VM.InstantCloneSpec) – Virtual machine InstantCloneSpec.

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.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 an instant clone 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.Unauthorized if you do not have all of the privileges described as follows:

  • The resource VirtualMachine referenced by the attribute VM.InstantCloneSpec.source requires VirtualMachine.Provisioning.Clone and VirtualMachine.Inventory.CreateFromExisting.

  • The resource Folder referenced by the attribute VM.InstantClonePlacementSpec.folder requires VirtualMachine.Interact.PowerOn.

  • The resource ResourcePool referenced by the attribute VM.InstantClonePlacementSpec.resource_pool requires Resource.AssignVMToPool.

  • The resource Datastore referenced by the attribute VM.InstantClonePlacementSpec.datastore requires Datastore.AllocateSpace.

  • The resource Network referenced by the attribute com.vmware.vcenter.vm.hardware_client.Ethernet.BackingSpec.network requires Network.Assign.

list(filter=None)

Returns information about at most 4000 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 4000 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.

register(spec)

Creates a virtual machine from existing virtual machine files on storage. This method was added in vSphere API 6.8.7.

Parameters

spec (VM.RegisterSpec) – Specification of the location of the virtual machine files and the placement of the new virtual machine.

Return type

str

Returns

Identifier of the 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 or if a virtual machine using the specified virtual machine files 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.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 register the virtual machine could not be allocated.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user doesn’t have the required privileges.

Raise

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

  • The resource Datastore referenced by the attribute VM.RegisterSpec.datastore requires System.Read.

  • The resource Folder referenced by the attribute VM.InventoryPlacementSpec.folder requires VirtualMachine.Inventory.Register.

  • The resource ResourcePool referenced by the attribute VM.ComputePlacementSpec.resource_pool requires Resource.AssignVMToPool.

relocate(vm, spec)

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.

Parameters
  • vm (str) – Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

  • spec (VM.RelocateSpec) – Relocate specification.

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 or the given “vm” 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.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.

Raise

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

  • The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate.

  • The resource ResourcePool referenced by the attribute VM.RelocatePlacementSpec.resource_pool requires Resource.AssignVMToPool.

relocate_task(vm, spec)

Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks.

. This method was added in vSphere API 7.0.0.

Parameters
  • vm (str) – Existing Virtual machine to relocate. The parameter must be an identifier for the resource type: VirtualMachine.

  • spec (VM.RelocateSpec) – Relocate specification.

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 or the given “vm” 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.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.

Raise

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

  • The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate.

  • The resource ResourcePool referenced by the attribute VM.RelocatePlacementSpec.resource_pool requires Resource.AssignVMToPool.

unregister(vm)

Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine’s files from storage. All high-level information stored with the management server (ESXi or vCenter) is removed, including information such as statistics, resource pool association, permissions, and alarms. This method was added in vSphere API 6.8.7.

Parameters

vm (str) – Identifier of the virtual machine to be unregistered. The parameter must be an identifier for the resource type: VirtualMachine.

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 there is no virtual machine associated with vm in the system.

Raise

com.vmware.vapi.std.errors_client.ResourceBusy if the virtual machine is busy performing another operation.

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.

Raise

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

  • The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Unregister.

com.vmware.vstats_client module

The com.vmware.vstats_client component provides API classes and types used in the vStats service.

class com.vmware.vstats_client.AcqSpecs(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The AcqSpecs class provides methods to perform acquisition specification related operations. An acquisition specification defines the statistical data that should be collected at desired sampling rates from the underlying providers. It designates the resources and their counters which should be sampled, and a desired sampling rate. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class CounterSpec(cid_mid=None, set_id=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The AcqSpecs.CounterSpec class designates a counter or counter set in an acquisition specification. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • cid_mid (CidMid or None) – Counter and optional meatadata identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None the setId field will be used.

  • set_id (str or None) – Counter set identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.CounterSet. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.CounterSet. When None the cidMid field will be used.

class CreateSpec(counters=None, resources=None, interval=None, expiration=None, memo_=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The AcqSpecs.CreateSpec class contains information for a new data acquisition specification. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • counters (AcqSpecs.CounterSpec) – Designates the counter(s) to be sampled. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • resources (list of RsrcId) – A set of resource identifiers representing a single resource to be monitored. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • interval (long or None) – Desired sampling rate in seconds. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None default of 10s will be used.

  • expiration (long or None) – Expiration time for this acquisition specification in Unix UTC number of seconds (since epoch). Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None or 0, default expiration duration is 100 minutes.

  • memo (str or None) – Consumer provided text about this acquisition specification. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None default empty string will be used.

class FilterSpec(page=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The AcqSpecs.FilterSpec class contains attributes used to filter the results when listing acquisition specifications. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters

page (str or None) – Used to retrieve paged data for larger result sets. The value of this token is generated by server and returned as next attribute in the result of list methods. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. None the first page of results will be returned.

class Info(id=None, counters=None, resources=None, interval=None, expiration=None, memo_=None, status=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The AcqSpecs.Info class is the information about an acquisition specification. It specifies the statistical data that should be collected at desired sampling rates. It designates the resources and their counters which should be sampled, and a desired sampling rate. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • id (str) – Acquisition specification identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.AcqSpec. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.AcqSpec.

  • counters (AcqSpecs.CounterSpec) – Designates the counter(s) to be sampled. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • resources (list of RsrcId) – A set of resource identifiers representing a single resource to be monitored. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • interval (long or None) – Desired sampling rate in seconds. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None, default interval is 10 seconds.

  • expiration (long or None) – Expiration time for this acquisition specification represented as Unix UTC number of seconds (since epoch). Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None or 0, default expiration duration is 100 minutes.

  • memo (str) – Consumer provided text about this Acquisition Specification. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • status (AcqSpecs.Status) – Acquisition Specification status. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class ListResult(acq_specs=None, next=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The AcqSpecs.ListResult class contains attributes used to return the acquisition specifications. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • acq_specs (list of AcqSpecs.Info) – List of acquisition specifications received. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • next (str or None) – The next attribute is a token used to retrieve paged data for larger result sets. This is opaque token generated by the server. It is to be sent in the AcqSpecs.FilterSpec.page attribute to issue a subsequent call to the list method for retrieving results that did not fit the current page. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. set when there are more results to retrieve.

RESOURCE_TYPE = 'com.vmware.vstats.model.AcqSpec'

Resource type for acquisition specifications. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class Status(string)

Bases: vmware.vapi.bindings.enum.Enum

Describes the status of an Acquisition Specification. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the Status instance.

DISABLED = Status(string='DISABLED')

The acquisition specification is disabled. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

ENABLED = Status(string='ENABLED')

The acquisition specification is enabled. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

EXPIRED = Status(string='EXPIRED')

The acquisition specification is expired. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class UpdateSpec(counters=None, resources=None, interval=None, expiration=None, memo_=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The AcqSpecs.UpdateSpec class contains attributes that can be updated in an acquisition specification. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • counters (AcqSpecs.CounterSpec or None) – Designates the counter(s) to be sampled. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None, the value is unchanged.

  • resources (list of RsrcId or None) – A set of resource identifiers representing a single resource to be monitored. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None, the value is unchanged.

  • interval (long or None) – Desired sampling rate in seconds. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None, the value is unchanged.

  • expiration (long or None) – Expiration time for this acquisition specification in Unix UTC number of seconds (since epoch). When this attribute is 0, the default expiration duration is 100 minutes. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None, the value is unchanged.

  • memo (str or None) – Consumer provided text about this Acquisition Specification. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. If None, the value is unchanged.

create(acq_spec)

Create a new acquisition specification record. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

acq_spec (AcqSpecs.CreateSpec) – Specification for the acquisition of stats data.

Return type

str

Returns

Identifier of the newly created acquisition specification. The return value will be an identifier for the resource type: com.vmware.vstats.model.AcqSpec.

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 acq_spec contain any errors.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

delete(id)

Delete an acquisition specification. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

id (str) – Acquisition specification ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.AcqSpec.

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 id is invalid.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

get(id)

Returns information about a specific acquisition specification. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

id (str) – Acquisition specification ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.AcqSpec.

Return type

AcqSpecs.Info

Returns

Information about the desired acquisition specification.

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 id is invalid.

Raise

com.vmware.vapi.std.errors_client.NotFound acquisition specification could not be located.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

list(filter=None)

Returns information about all acquisition specifications. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

filter (AcqSpecs.FilterSpec or None) – Criteria for selecting records to return. When set filtering will be applied to the result.

Return type

AcqSpecs.ListResult

Returns

List of acquisition specification records.

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.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

update(id, acq_spec)

Update an existing acquisition specification. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters
  • id (str) – Acquisition specification ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.AcqSpec.

  • acq_spec (AcqSpecs.UpdateSpec) – Updated acquisition specification.

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 acquisition specification could not be located.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.CidMid(cid=None, mid=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The CidMid class is used to designate a counter. It contains a counter id that identifies the semantical counter. There is optional metadata identifier that identifies the particular generation of the counter. When counter metadata is not designated vStats will use a default for the counter metadata. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • cid (str) – Counter Id. CID is a string with rather strong semantic consistency across deployments and versions. If two CIDs are identical it implies the corresponding counters are the same. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Counter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Counter.

  • mid (str or None) – MID is a 64-bit integer with strong consistency. Given a particular CID=cid, if two MIDs are the same, then the corresponding counter-metadata objects are same. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata. When this attribute is None vStats will use default for the counter metadata as obtained from the provider.

class com.vmware.vstats_client.CounterMetadata(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The CounterMetadata class provides access to the different historical editions of counters. As computing platforms evolve over time the measurement units for different characteristics of the systems change. As such changes occur, counters will receive different editions reflected in a new metadata record. For example computer memory had changes from kilobytes through megabytes into gigabytes. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class CounterEditionStatus(string)

Bases: vmware.vapi.bindings.enum.Enum

Counter metadata status. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the CounterEditionStatus instance.

CURRENT = CounterEditionStatus(string='CURRENT')

The counter edition is current. This implies a support commitment. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

DEFAULT = CounterEditionStatus(string='DEFAULT')

The counter edition is current and is the default. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

DEPRECATED = CounterEditionStatus(string='DEPRECATED')

The counter edition is deprecated. It will be decommissioned rather soon. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

EXPERIMENTAL = CounterEditionStatus(string='EXPERIMENTAL')

The counter edition is experimental. Consumers shouldn’t rely on it for the long haul. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

REMOVED = CounterEditionStatus(string='REMOVED')

The counter edition was removed. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class FilterSpec(status=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The CounterMetadata.FilterSpec class is used to filter the counter metadata list. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters

status (CounterMetadata.CounterEditionStatus or None) – Counter edition status. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None no filtering on counter metadata status will be made.

class Info(cid=None, mid=None, status=None, type=None, units=None, scale=None, user_info=None, pid=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The CounterMetadata.Info class contains information about CounterMetadata. It represents edition of the Counter. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • cid (str) – Counter Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Counter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Counter.

  • mid (str) – Metadata Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata.

  • status (CounterMetadata.CounterEditionStatus) – Counter Edition status. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • type (CounterMetadata.SampleType) – Numeric properties of the sampled data. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • units (CounterMetadata.MetricUnits) – The units of the measurement. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • scale (CounterMetadata.UnitsFactor or None) – Additional multiplier factors to be used with units. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None default of ONE is used.

  • user_info (UserInfo or None) – Human legible localizable text about the counter. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. This attribute is None in the current version.

  • pid (str or None) – ID of the respective provider. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Provider. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Provider. This attribute is None in the current version.

class MetricUnits(string)

Bases: vmware.vapi.bindings.enum.Enum

Unit used by a metric. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the MetricUnits instance.

AMPERE = MetricUnits(string='AMPERE')

Ampere. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

BIT = MetricUnits(string='BIT')

Bit. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

BITSPERSECOND = MetricUnits(string='BITSPERSECOND')

Bits per second. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

BYTE = MetricUnits(string='BYTE')

Byte. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

BYTESPERSECOND = MetricUnits(string='BYTESPERSECOND')

Bytes per second. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

CANDELA = MetricUnits(string='CANDELA')

Candela. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

CELSIUS = MetricUnits(string='CELSIUS')

Celsius. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

GRAM = MetricUnits(string='GRAM')

Gram. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

HERTZ = MetricUnits(string='HERTZ')

Hertz. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

JOULE = MetricUnits(string='JOULE')

Joule. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

KELVIN = MetricUnits(string='KELVIN')

Kelvin. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

KILOGRAM = MetricUnits(string='KILOGRAM')

Kilogram. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

METER = MetricUnits(string='METER')

Meter. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

METERSPERSECOND = MetricUnits(string='METERSPERSECOND')

Meters per second. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

METERSPERSECONDSQUARED = MetricUnits(string='METERSPERSECONDSQUARED')

Meters per second squared. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

MOLE = MetricUnits(string='MOLE')

Mole. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

NUMBER = MetricUnits(string='NUMBER')

Number. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

PERCENT = MetricUnits(string='PERCENT')

Percent. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

SECOND = MetricUnits(string='SECOND')

Second. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

VOLT = MetricUnits(string='VOLT')

Volt. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

VOLTAMPERE = MetricUnits(string='VOLTAMPERE')

Volt Ampere. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

WATT = MetricUnits(string='WATT')

Watt. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class SampleType(string)

Bases: vmware.vapi.bindings.enum.Enum

Type of the sampled data. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the SampleType instance.

ABSOLUTE = SampleType(string='ABSOLUTE')

Absolute value samples. Represents an actual value of the counter. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

DELTA = SampleType(string='DELTA')

Delta samples. Represents an amount of change for the counter between the current time-stamp and the last time-stamp when the counter was sampled. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

FRACTION = SampleType(string='FRACTION')

Fraction samples. Implies range from 0.00 to 1.00. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

LOGN = SampleType(string='LOGN')

Log(n) samples. A natural logarithm of the value. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

RATE = SampleType(string='RATE')

Rate samples. Represents a value that has been normalized over the time period. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

RAW = SampleType(string='RAW')

Raw samples. The value unprocessed as-is sampled. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class UnitsFactor(string)

Bases: vmware.vapi.bindings.enum.Enum

Unit factor of measurement. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the UnitsFactor instance.

ATTO = UnitsFactor(string='ATTO')

Atto 10^-18. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

CENTI = UnitsFactor(string='CENTI')

Centi 10^-2. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

DECA = UnitsFactor(string='DECA')

Deca 10. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

DECI = UnitsFactor(string='DECI')

Deci 10^-1. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

EXA = UnitsFactor(string='EXA')

Exa 10^18. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

EXBI = UnitsFactor(string='EXBI')

Exbi 2^60, 1024^6. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

FEMTO = UnitsFactor(string='FEMTO')

Femto 10^-15. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

GIBI = UnitsFactor(string='GIBI')

Gibi 2^30, 1024^3. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

GIGA = UnitsFactor(string='GIGA')

Giga 10^9. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

HECTO = UnitsFactor(string='HECTO')

Hecto 10^2. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

KIBI = UnitsFactor(string='KIBI')

Kibi 2^10, 1024. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

KILO = UnitsFactor(string='KILO')

Kilo 10^3. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

MEBI = UnitsFactor(string='MEBI')

Mebi 2^20, 1024^2. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

MEGA = UnitsFactor(string='MEGA')

Mega 10^6. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

MICRO = UnitsFactor(string='MICRO')

Micro 10^-6. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

MILLI = UnitsFactor(string='MILLI')

Milli 10^-3. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

NANO = UnitsFactor(string='NANO')

Nano 10^-9. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

ONE = UnitsFactor(string='ONE')

One. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

PEBI = UnitsFactor(string='PEBI')

Pebi 2^50, 1024^5. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

PETA = UnitsFactor(string='PETA')

Peta 10^15. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

PIKO = UnitsFactor(string='PIKO')

Pico 10^-12. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

TEBI = UnitsFactor(string='TEBI')

Tebi 2^40, 1024^4. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

TERA = UnitsFactor(string='TERA')

Tera 10^12. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

YOBI = UnitsFactor(string='YOBI')

Yobi 2^80, 1024^8. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

YOCTO = UnitsFactor(string='YOCTO')

Yocto 10^-24. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

YOTTA = UnitsFactor(string='YOTTA')

Yotta 10^24. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

ZEBI = UnitsFactor(string='ZEBI')

Zebi 2^70, 1024^7. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

ZEPTO = UnitsFactor(string='ZEPTO')

Zepto 10^-21. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

ZETTA = UnitsFactor(string='ZETTA')

Zetta 10^21. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

get(cid, mid)

Returns information about a specific CounterMetadata. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters
  • cid (str) – Counter ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.Counter.

  • mid (str) – CounterMetadata ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata.

Return type

CounterMetadata.Info

Returns

Information about the desired CounterMetadata.

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 Counter or CounterMetadata could not be located.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

get_default(cid)

This method returns the “default” CounterMetadata. A Counter has at least one related metadata object. Usually, stats providers (for example hosts) are in agreement about the default metadata. In this case the returned list has a single metadata object.

Sometimes, when providers are in “disagreement” about the default, then the returned list would include all the possible “defaults”. This potential ambiguity isn’t a real issue because consumers of the vStats API rarely need to specify the “mid” of metadata. Therefore, this API is used primarily for informational purposes.. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

cid (str) – Counter ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.Counter.

Return type

list of CounterMetadata.Info

Returns

List of counter metadata records.

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 cid is invalid.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

list(cid, filter=None)

Returns information about all counter metadata records for a specific Counter. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters
  • cid (str) – Counter ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.Counter.

  • filter (CounterMetadata.FilterSpec or None) – Filter specification. When None no filtering will be performed.

Return type

list of CounterMetadata.Info

Returns

List of counter metadata for the specified counter.

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 Counter could not be located.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.CounterSets(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The CounterSets class provides methods for accessing groupings of counters. Counter-sets allow consumers to use groups of counters. The counters may relate to different resource types. When an AcqSpecs record refers to a counter-set, only the relevant counters apply. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class Info(id=None, counters=None, user_info=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The CounterSets.Info class contains information about a set of counters. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • id (str) – Counter set identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • counters (list of CidMid) – List of Counter CidMids. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • user_info (UserInfo or None) – Human legible localizable conter set description. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. In future versions it may be possible to have custom counter sets that lack localizable descriptions.

RESOURCE_TYPE = 'com.vmware.vstats.model.CounterSet'

Resource type for counter sets. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

get(counter_set)

Returns information about a specific counter set. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

counter_set (str) – identifier of the counter set to retrieve. The parameter must be an identifier for the resource type: com.vmware.vstats.model.CounterSet.

Return type

CounterSets.Info

Returns

Information about the desired CounterSet.

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 counter_set is invalid.

Raise

com.vmware.vapi.std.errors_client.NotFound if the requested counter set could not be located.

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

list()

Returns information about all the counter sets. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Return type

list of CounterSets.Info

Returns

List of counter sets.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.Counters(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Counters class provides methods to perform various Counter related operations. Counter is derived from metric. It applies the metric to a particular class of a resource. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class FilterSpec(cid=None, types=None, metric=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Counters.FilterSpec class contains fields that can be used to filter list of counters. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • cid (str or None) – Counter identifier that will be listed. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Counter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Counter. If None counter filter will not be applied.

  • types (list of str or None) – Resource type filter. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.vstats.model.RsrcType. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.vstats.model.RsrcType. If None resource type filter will not be applied.

  • metric (str or None) – Metric for which counters will be listed. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Metric. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Metric. If None metric filter will not be applied.

class Info(cid=None, metric=None, resource_address_schema=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Counters.Info class contains the counter information. Counter is derived from metric. It applies the metric to a particular class of a resource. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • cid (str) – Counter Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Counter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Counter.

  • metric (str) – A metric is typically human-legible ASCII/English name of a measurable aspect, for example “length” and “temperature”. It is not internationalizable. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Metric. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Metric.

  • resource_address_schema (str) – Describes formally how to address (or identify) the resources the counter could be bound to (or instantiated for). Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.RsrcAddrSchema. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.RsrcAddrSchema.

RESOURCE_TYPE = 'com.vmware.vstats.model.Counter'

Resource type for counters. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

get(cid)

Returns information about a specific Counter. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

cid (str) – Counter ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.Counter.

Return type

Counters.Info

Returns

Information about the requested counter.

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 cid is invalid.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

list(filter=None)

Returns information about all counters matching the filter parameters. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

filter (Counters.FilterSpec or None) – Filters the returned records. When None no filtering will be applied.

Return type

list of Counters.Info

Returns

List of Counters.

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.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.Data(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Data class provides methods to query measurement and statistic data. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class DataPoint(cid=None, mid=None, rid=None, ts=None, val=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Data.DataPoint class is an instance of a measurement or stat. A data point is comprised of a Counter, CounterMetadata, Resource, timestamp and value. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • cid (str) – Counter Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Counter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Counter.

  • mid (str) – CounterMetadata Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.CounterMetadata.

  • rid (str) – Resource Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • ts (long) – Timestamp for the data point. format: 64-bit integer. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • val (float) – Stat value. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class DataPointsResult(data_points=None, next=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Data.DataPointsResult class contains attributes used to return DataPoints. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • data_points (list of Data.DataPoint) – List of DataPoints received. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • next (str or None) – The next attribute is a token used to retrieve paged data for larger result sets. This is opaque token generated by the server. It is to be sent in the Data.FilterSpec.page attribute to issue a subsequent call to the query method for retrieving results that did not fit the current page. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. set when there are more results to retrieve.

class FilterSpec(start=None, end=None, cid=None, metric=None, types=None, resources=None, order=None, page=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Data.FilterSpec class contains attributes used to filter the results when listing DataPoint. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • start (long or None) – Start of a time window (included), timestamp in seconds UTC. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None the result will not be limited by start time.

  • end (long or None) – End of a time window (excluded), timestamp in seconds UTC. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None the result will not be limited by end time.

  • cid (str or None) – Counter ID. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Counter. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Counter. When None the result will not be filtered by counter.

  • metric (str or None) – Metric name. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Metric. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Metric. When None the result will not be filtered by metric name.

  • types (list of str or None) – List of Resource types. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.vstats.model.RsrcType. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.vstats.model.RsrcType. When None the result will not be filtered by resource types.

  • resources (list of str or None) –

    Resources to include in the query. Each resource is specified through a composite string that follows the following format.

    type.<resource type>[.<scheme>]=<resource id>

    resource type specifies the type of resource for example VM, VCPU etc.

    scheme is an optional element to disambiguate the resource as needed for example to differentiate managed object id from uuid.

    resource id is the unique resource identifier value for example: vm-41

    Example values include: type.VM=vm-41, type.VCPU=1, type.VM.moid=vm-41. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When left None the result will not be filtered for specific resources.

  • order (str or None) – Directs the server to order the returned data. Passing a value of DEFAULT will apply default ordering of the results that makes them easier for consumption. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this parameter is None the server will not order the result, save computational time and therefore the API will operate faster.

  • page (str or None) – Used to retrieve paged data for larger result sets. The value of this token is generated by server and returned as next attribute in the result of queryDataPoints methods. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None the first page of results will be returned.

query_data_points(filter=None)

Returns Data.DataPointsResult matching the filter parameters.

/vstats/data/dp?types=VM&types=VCPU

/vstats/data/dp?rsrcs=type.HOST=host-16&rsrcs=type.VM=vm-31. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

filter (Data.FilterSpec or None) – Specification to match DataPoints. When set filtering will be applied to the result.

Return type

Data.DataPointsResult

Returns

Data points matching the filter.

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.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.Metrics(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Metrics class provides method to list metrics. A metric is a fundamental concept. It means a measurable aspect or property. For instance, temperature, count, velocity, data size, bandwidth. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

RESOURCE_TYPE = 'com.vmware.vstats.model.Metric'

Resource type for metrics. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class Summary(metric=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The Metrics.Summary class contains metric summary. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters

metric (str) – Metric name. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Metric. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Metric.

list()

Returns list of available Metrics as supplied by the discovered providers. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Return type

list of Metrics.Summary

Returns

List of Metrics.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.Providers(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The Providers class manages list of statistical data provider services that are currently used. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

RESOURCE_TYPE = 'com.vmware.vstats.model.Provider'

Resource type for data providers. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class Summary(id=None, id_value=None, type=None, scheme=None, metadata=None, tracking_sn=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

Providers.Summary class describes a statistical data provider. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • id (str) – Provider identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.Provider. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.Provider.

  • id_value (str) – The ID given to the provider by its respective inventory. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • type (str) – Provider type. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • scheme (str or None) – An optional designation of the scheme. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When None the provider is not designating a specific scheme.

  • metadata (str or None) – Schema-less metadata with extra information for the provider. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. As supplied by the provider.

  • tracking_sn (long or None) – Timestamp which is obtained when querying counters from a provider and is used as since parameter when new counter listing is needed. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. {term unset} if no timestamp has been obtained yet.

list()

Returns a list of stats providers. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Return type

list of Providers.Summary

Returns

List of stats providers.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.QueryPredicate(string)

Bases: vmware.vapi.bindings.enum.Enum

The QueryPredicate enum describes how to query an id present in a RsrcId. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the QueryPredicate instance.

ALL = QueryPredicate(string='ALL')

Matching all available id-s. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

EQUAL = QueryPredicate(string='EQUAL')

Matching id-s by equality. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class com.vmware.vstats_client.ResourceAddressSchemas(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The ResourceAddressSchemas class manages inventory of resource addressing schemas used by Counters. Each schema consists of a named list of resource identifiers of specific resource type. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class Info(id=None, schema=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourceAddressSchemas.Info class defines addressing schema for a counter. This is set of named placeholders for different resource types. For example a network link between VMs will take two arguments “source” and “destination” both of type VM. For each argument query capability is defined. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • id (str) – Identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.RsrcAddrSchema. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.RsrcAddrSchema.

  • schema (list of ResourceAddressSchemas.ResourceIdDefinition) – List of :class:`ResourceAddressSchemas.ResourceIdDefinition`s. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class QueryCapabilities(string)

Bases: vmware.vapi.bindings.enum.Enum

Declares which predicates are supported by the ResourceAddressSchemas.ResourceIdDefinition. Warning: This enumeration is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Note

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

Parameters

string (str) – String value for the QueryCapabilities instance.

EQUAL = QueryCapabilities(string='EQUAL')

Equal. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

EQUAL_ALL = QueryCapabilities(string='EQUAL_ALL')

Supports both Equality and Aggregation. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

RESOURCE_TYPE = 'com.vmware.vstats.model.RsrcAddrSchema'

Resource type for resource addressing schemas. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class ResourceIdDefinition(key=None, type=None, query_options=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourceAddressSchemas.ResourceIdDefinition class describes a single identifier of the Resource Addressing Schema. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • key (str) – Designates a semantic key for the resource identifier. This could be “vm” for virtual machine whose CPU usage is metered or “source” to identify the virtual machine that is origin of measured network traffic. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • type (str) – Type of the resource. This represents various entities for which statistical data is gathered such as virtual machines, containers, servers, disks etc. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.RsrcType. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.RsrcType.

  • query_options (ResourceAddressSchemas.QueryCapabilities) – Designates the supported query-options. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

get(id)

Returns information about a specific resource address schema. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

id (str) – Resource address schema identifier.

Return type

ResourceAddressSchemas.Info

Returns

Information about the desired resource address schema.

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 id is invalid.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.ResourceAddresses(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The ResourceAddresses class provides methods to perform resource addressing queries. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

class FilterSpec(types=None, resources=None, page=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

ResourceAddresses.FilterSpec class describes filter criteria for resource addresses. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • types (list of str or None) – List of Resource types. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must contain identifiers for the resource type: com.vmware.vstats.model.RsrcType. When methods return a value of this class as a return value, the attribute will contain identifiers for the resource type: com.vmware.vstats.model.RsrcType. When None the result will not be filtered by resource types.

  • resources (list of str or None) –

    Resources to include in the query. Each resource is specified through a composite string that follows the following format.

    type.<resource type>[.<scheme>]=<resource id>

    resource type specifies the type of resource for example VM, VCPU etc.

    scheme is an optional element to disambiguate the resource as needed for example to differentiate managed object id from uuid.

    resource id is the unique resource identifier value for example: vm-41

    Example values include: type.VM=vm-41, type.VCPU=1, type.VM.moid=vm-41. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When left None the result will not be filtered for specific resources.

  • page (str or None) – The page field is used to retrieve paged data for large result sets. It is an opaque paging token obtained from a prior call to the ResourceAddresses.list() API. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. when set a follow up page in a paged result set will be delivered.

class Info(id=None, resource_ids=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourceAddresses.Info class contains global address of a specific Resource. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • id (str) – Identifier. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.RsrcAddr. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.RsrcAddr.

  • resource_ids (list of RsrcId) – List of Resource Identifiers. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class ListResult(rsrc_addrs=None, next=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourceAddresses.ListResult class contains attributes used to return the resource addresses. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • rsrc_addrs (list of ResourceAddresses.Info) – List of Resource Addresses received. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • next (str or None) – Used to retrieve paged data for larger result sets. Token is generated by server. The value of this field should be supplied in a subsequent call to ResourceAddresses.list() method. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. None when there are no more pages of data to be retrieved.

RESOURCE_TYPE = 'com.vmware.vstats.model.RsrcAddr'

Resource type for ResourceAddresses. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

get(id)

Returns information about a specific Resource Address. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

id (str) – Resource Address ID. The parameter must be an identifier for the resource type: com.vmware.vstats.model.RsrcAddr.

Return type

ResourceAddresses.Info

Returns

Information about the desired Resource Address.

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 id is invalid.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

list(filter=None)

Returns the list of Resource Addresses matching the filter parameters. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

filter (ResourceAddresses.FilterSpec or None) – Criteria for selecting records to return. If None all records will be returned.

Return type

ResourceAddresses.ListResult

Returns

Matching resource addresses.

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.Unauthenticated if the user can not be authenticated.

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.ResourceTypes(config)

Bases: vmware.vapi.bindings.stub.VapiInterface

The ResourceTypes class provides list of resource types. Resource refers to any item or concept that could have measurable properties. It is a prerequisite that a resource can be identified.

Example resource types are virtual machine, virtual disk etc.. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Parameters

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

RESOURCE_TYPE = 'com.vmware.vstats.model.RsrcType'

Resource type for resource types. Warning: This class attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

class Summary(type=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The ResourceTypes.Summary class contains information of addressable resource. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters

type (str) – Resource type. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.vstats.model.RsrcType. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.vstats.model.RsrcType.

list()

Returns a list of available resource types. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Return type

list of ResourceTypes.Summary

Returns

List of resource types.

Raise

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

Raise

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

Raise

com.vmware.vapi.std.errors_client.Unauthorized if the user does not have sufficient privileges.

class com.vmware.vstats_client.RsrcId(key=None, type=None, id_value=None, predicate=None, scheme=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The RsrcId class specifies identification of a resource to be monitored by an acquisition specification record. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • key (str or None) – Key relates to the corresponding ResourceIdDefinition of the related resource address schema. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None, type attribute will be used.

  • type (str or None) – Type of the resource identified by the Resource Id. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None, in current version the api will throw InvalidArgument error. To be made optional in future.

  • id_value (str) – The id value binding the related resource id definition. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • predicate (QueryPredicate or None) – Predicate to use to match resource Ids. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None, default predicate is EQUAL.

  • scheme (str or None) – An optional designation of the scheme. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments. When this attribute is None, default scheme is moid (ManagedObject Identifier).

class com.vmware.vstats_client.StubFactory(stub_config)

Bases: vmware.vapi.bindings.stub.StubFactoryBase

Initialize StubFactoryBase

Parameters

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

class com.vmware.vstats_client.UserInfo(label=None, description=None)

Bases: vmware.vapi.bindings.struct.VapiStruct

The UserInfo class contains human legible, localizable description, used for VMware provided objects. Warning: This class is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tip

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

Parameters
  • label (com.vmware.vapi.std_client.LocalizableMessage) – Short label. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

  • description (com.vmware.vapi.std_client.LocalizableMessage) – Detailed description of the object. Warning: This attribute is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.