Trees       Indices       Help   
python-cm_api
Package cm_api :: Package endpoints :: Module hosts :: Class ApiHost
[hide private]
[frames] | no frames]

Class ApiHost

source code

         object --+    
                  |    
types.BaseApiObject --+
                      |
                     ApiHost
Instance Methods [hide private]
 
__init__(self, resource_root, hostId=None, hostname=None, ipAddress=None, rackId=None)
Initializes internal state and sets all known writable properties of the object to None.		 source code
 
__str__(self)
Default implementation of __str__.		 source code
 
_path(self) source code
 
_cmd(self, cmd, data=None) source code
 
_put(self)
Update this resource.		 source code
 
get_config(self, view=None)
Retrieve the host's configuration.		 source code
 
update_config(self, config)
Update the host's configuration.		 source code
 
get_metrics(self, from_time=None, to_time=None, metrics=None, ifs=[], storageIds=[], view=None)
Retrieve metric readings for the host.		 source code
 
enter_maintenance_mode(self)
Put the host in maintenance mode.		 source code
 
exit_maintenance_mode(self)
Take the host out of maintenance mode.		 source code
 
set_rack_id(self, rackId)
Update the rack ID of this host.		 source code

Inherited from types.BaseApiObject: __setattr__, to_json_dict

Inherited from types.BaseApiObject (private): _check_attr, _get_resource_root, _require_min_api_version, _set_attrs, _update

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __sizeof__, __subclasshook__

Class Methods [hide private]

Inherited from types.BaseApiObject: from_json_dict

Inherited from types.BaseApiObject (private): _get_attributes

Static Methods [hide private]

Inherited from types.BaseApiObject: init

Class Variables [hide private]
  _ATTRIBUTES = {'hostId': None, 'hostname': None, 'ipAddress': ...

Inherited from types.BaseApiObject (private): _WHITELIST

Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self, resource_root, hostId=None, hostname=None, ipAddress=None, rackId=None)
(Constructor)

source code 

Initializes internal state and sets all known writable properties of the object to None. Then initializes the properties given in the provided attributes dictionary.

Parameters:
  • resource_root - API resource object.
  • attrs - optional dictionary of attributes to set. This should only contain r/w attributes.
Overrides: object.__init__
(inherited documentation)

__str__(self)
(Informal representation operator)

source code 

Default implementation of __str__. Uses the type name and the first attribute retrieved from the attribute map to create the string.

Overrides: object.__str__
(inherited documentation)

_put(self)

source code 

Update this resource.

Returns:
The updated object.

get_config(self, view=None)

source code 

Retrieve the host's configuration.

The 'summary' view contains strings as the dictionary values. The full view contains ApiConfig instances as the values.

Parameters:
  • view - View to materialize ('full' or 'summary') @return Dictionary with configuration data.

update_config(self, config)

source code 

Update the host's configuration.

@param config Dictionary with configuration to update. @return Dictionary with updated configuration.

get_metrics(self, from_time=None, to_time=None, metrics=None, ifs=[], storageIds=[], view=None)

source code 

Retrieve metric readings for the host.

Parameters:
  • from_time - A datetime; start of the period to query (optional).
  • to_time - A datetime; end of the period to query (default = now).
  • metrics - List of metrics to query (default = all).
  • ifs - network interfaces to query. Default all, use None to disable.
  • storageIds - storage IDs to query. Default all, use None to disable.
  • view - View to materialize ('full' or 'summary') @return List of metrics and their readings.

enter_maintenance_mode(self)

source code 

Put the host in maintenance mode.

Returns:
Reference to the completed command.

Since: API v2

exit_maintenance_mode(self)

source code 

Take the host out of maintenance mode.

Returns:
Reference to the completed command.

Since: API v2


Class Variable Details [hide private]

_ATTRIBUTES

Value:
{'hostId': None, 'hostname': None, 'ipAddress': None, 'rackId': None, \
'status': ROAttr(), 'lastHeartbeat': ROAttr(datetime.datetime), 'roleR\
efs': ROAttr(ApiRoleRef), 'healthSummary': ROAttr(), 'healthChecks': R\
OAttr(), 'hostUrl': ROAttr(), 'commissionState': ROAttr(), 'maintenanc\
eMode': ROAttr(), 'maintenanceOwners': ROAttr(), 'numCores': ROAttr(),\
 'totalPhysMemBytes': ROAttr(),}

   Trees       Indices       Help   
python-cm_api
Generated by Epydoc 3.0.1 on Mon Mar 30 14:44:56 2015 http://epydoc.sourceforge.net