vmware.vsphere.host¶
- vmware.vsphere.host.find(search, service_instance_content=None):
not documented yet
- vmware.vsphere.host.get(attr_name, attr_value, obj, **kwargs):
Get a specific host identified by an attribute. Will only return the first object that matches
- Parameters:
attr_name – Name of the attribute that shall be used for selecting the object. Can also be “rel_path” to match a specific path within a folder-structure. Be aware, that this will trigger a ‘get_dict’ which may take a while.
attr_value – Value which attr_name must contain
obj (object) – The object within we shall search for the host
- Returns:
First object that matched the selection. Returns bool:False if no match was found
- Return type:
object
- Keyword Arguments:
vc_obj (
object) vCenter-object that was created by vmware.vsphere.get_content(). This will overwrite the object that was registered as default by vmware.vsphere.default()
- vmware.vsphere.host.get_dict(obj, **kwargs):
Get all hosts beneath the object and return a dictionary.
- Parameters:
obj (object) – The object within we shall search for hosts (datacenter or cluster)
- Returns:
Dictionary containing a key -> value pair per host
- Return type:
dict
- Keyword Arguments:
key (
string) String containing the attribute-name that shall be used as the dictionary-key. May be “rel_path” to construct a relative path, which is descriptive and unique containing all the folders (default). Make sure to choose a unique attribute, otherwise elements will overwrite each other.
- vmware.vsphere.host.get_list(obj, **kwargs):
Get all hosts beneath the object and return a list. This function is much faster than get_dict() when the vCenter-object is present (passed within kwargs or present as default)
- Parameters:
obj (object) – The object within we shall search for hosts
- Returns:
List of objects
- Return type:
list
- Keyword Arguments:
vc_obj (
object) vCenter-object that was created by vmware.vsphere.get_content(). This will overwrite the object that was registered as default by vmware.vsphere.default()
- vmware.vsphere.host.is_host(obj):
Check if passed object is a host
- Parameters:
obj (object) – The object
- Returns:
True if it is a host, false if not
- Return type:
bool
- vmware.vsphere.host.is_type(obj):
Check if passed object is a host
- Parameters:
obj (object) – The object
- Returns:
True if it is a host, false if not
- Return type:
bool
- vmware.vsphere.host.list(service_instance_content=None, cache=True):
not documented yet