o2ims/adapter/clients/ocloud_client.py

   1 # Copyright (C) 2022 Wind River Systems, Inc.
   2 #
   3 #  Licensed under the Apache License, Version 2.0 (the "License");
   4 #  you may not use this file except in compliance with the License.
   5 #  You may obtain a copy of the License at
   6 #
   7 #      http://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 #  Unless required by applicable law or agreed to in writing, software
  10 #  distributed under the License is distributed on an "AS IS" BASIS,
  11 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 #  See the License for the specific language governing permissions and
  13 #  limitations under the License.
  14
  15 # client talking to Stx standalone
  16
  17 import uuid
  18 import json
  19 from typing import List
  20 # Optional,  Set
  21
  22 from cgtsclient.client import get_client as get_stx_client
  23 from cgtsclient.exc import EndpointException
  24 from dcmanagerclient.api.client import client as get_dc_client
  25
  26 from o2common.config import config
  27 from o2common.service.client.base_client import BaseClient
  28 from o2ims.domain import stx_object as ocloudModel
  29 from o2ims.domain.resource_type import ResourceTypeEnum
  30
  31 from o2common.helper import o2logging
  32 logger = o2logging.get_logger(__name__)
  33
  34
  35 CGTSCLIENT_ENDPOINT_ERROR_MSG = \
  36     'Must provide Keystone credentials or user-defined endpoint and token'
  37
  38
  39 class StxOcloudClient(BaseClient):
  40     def __init__(self, driver=None):
  41         super().__init__()
  42         self.driver = driver if driver else StxClientImp()
  43
  44     def _get(self, id) -> ocloudModel.StxGenericModel:
  45         return self.driver.getInstanceInfo()
  46
  47     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
  48         return [self.driver.getInstanceInfo()]
  49
  50     def _set_stx_client(self):
  51         pass
  52
  53
  54 class StxResourcePoolClient(BaseClient):
  55     def __init__(self):
  56         super().__init__()
  57         self.driver = StxClientImp()
  58
  59     def _get(self, id) -> ocloudModel.StxGenericModel:
  60         return self.driver.getResourcePoolDetail(id)
  61
  62     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
  63         return self.driver.getResourcePoolList(**filters)
  64
  65     def _set_stx_client(self):
  66         pass
  67
  68
  69 class StxDmsClient(BaseClient):
  70     def __init__(self):
  71         super().__init__()
  72         self.driver = StxClientImp()
  73
  74     def _get(self, name) -> ocloudModel.StxGenericModel:
  75         return self.driver.getK8sDetail(name)
  76
  77     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
  78         return self.driver.getK8sList(**filters)
  79
  80     def _set_stx_client(self):
  81         pass
  82
  83
  84 class StxPserverClient(BaseClient):
  85     def __init__(self):
  86         super().__init__()
  87         self.driver = StxClientImp()
  88
  89     def _get(self, id) -> ocloudModel.StxGenericModel:
  90         return self.driver.getPserver(id)
  91
  92     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
  93         return self.driver.getPserverList(**filters)
  94
  95     def _set_stx_client(self):
  96         self.driver.setStxClient(self._pool_id)
  97
  98
  99 class StxCpuClient(BaseClient):
 100     def __init__(self):
 101         super().__init__()
 102         # self._pserver_id = pserver_id
 103         self.driver = StxClientImp()
 104
 105     def _get(self, id) -> ocloudModel.StxGenericModel:
 106         return self.driver.getCpu(id)
 107
 108     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 109         return self.driver.getCpuList(**filters)
 110
 111     def _set_stx_client(self):
 112         self.driver.setStxClient(self._pool_id)
 113
 114
 115 class StxMemClient(BaseClient):
 116     def __init__(self):
 117         super().__init__()
 118         self.driver = StxClientImp()
 119
 120     def _get(self, id) -> ocloudModel.StxGenericModel:
 121         return self.driver.getMem(id)
 122
 123     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 124         return self.driver.getMemList(**filters)
 125
 126     def _set_stx_client(self):
 127         self.driver.setStxClient(self._pool_id)
 128
 129
 130 class StxEthClient(BaseClient):
 131     def __init__(self):
 132         super().__init__()
 133         self.driver = StxClientImp()
 134
 135     def _get(self, id) -> ocloudModel.StxGenericModel:
 136         return self.driver.getEthernet(id)
 137
 138     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 139         return self.driver.getEthernetList(**filters)
 140
 141     def _set_stx_client(self):
 142         self.driver.setStxClient(self._pool_id)
 143
 144
 145 class StxIfClient(BaseClient):
 146     def __init__(self):
 147         super().__init__()
 148         self.driver = StxClientImp()
 149
 150     def _get(self, id) -> ocloudModel.StxGenericModel:
 151         return self.driver.getIf(id)
 152
 153     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 154         return self.driver.getIfList(**filters)
 155
 156     def _set_stx_client(self):
 157         self.driver.setStxClient(self._pool_id)
 158
 159
 160 class StxIfPortClient(BaseClient):
 161     def __init__(self):
 162         super().__init__()
 163         self.driver = StxClientImp()
 164
 165     def _get(self, id) -> ocloudModel.StxGenericModel:
 166         return self.driver.getPort(id)
 167
 168     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 169         return self.driver.getPortList(**filters)
 170
 171     def _set_stx_client(self):
 172         self.driver.setStxClient(self._pool_id)
 173
 174
 175 class StxDevClient(BaseClient):
 176     def __init__(self):
 177         super().__init__()
 178         self.driver = StxClientImp()
 179
 180     def _get(self, id) -> ocloudModel.StxGenericModel:
 181         return self.driver.getDevice(id)
 182
 183     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 184         return self.driver.getDeviceList(**filters)
 185
 186     def _set_stx_client(self):
 187         self.driver.setStxClient(self._pool_id)
 188
 189
 190 class StxAccClient(BaseClient):
 191     def __init__(self):
 192         super().__init__()
 193         self.driver = StxClientImp()
 194
 195     def _get(self, id) -> ocloudModel.StxGenericModel:
 196         return self.driver.getAccelerator(id)
 197
 198     def _list(self, **filters) -> List[ocloudModel.StxGenericModel]:
 199         return self.driver.getAcceleratorList(**filters)
 200
 201     def _set_stx_client(self):
 202         self.driver.setStxClient(self._pool_id)
 203
 204
 205 # internal driver which implement client call to Stx Standalone and DC instance
 206 class StxClientImp(object):
 207     def __init__(self, stx_client=None, dc_client=None):
 208         super().__init__()
 209         self.stxclient = stx_client if stx_client else self.getStxClient()
 210         self.dcclient = dc_client if dc_client else self.getDcmanagerClient()
 211         # if subcloud_id is not None:
 212         # self.stxclient = self.getSubcloudClient(subcloud_id)
 213
 214     def getStxClient(self):
 215         os_client_args = config.get_stx_access_info()
 216         config_client = get_stx_client(**os_client_args)
 217         return config_client
 218
 219     def getDcmanagerClient(self):
 220         os_client_args = config.get_dc_access_info()
 221         config_client = get_dc_client(**os_client_args)
 222         return config_client
 223
 224     def getSubcloudClient(self, subcloud_id):
 225         subcloud = self.dcclient.subcloud_manager.\
 226             subcloud_additional_details(subcloud_id)
 227         logger.debug('subcloud name: %s, oam_floating_ip: %s' %
 228                      (subcloud[0].name, subcloud[0].oam_floating_ip))
 229         try:
 230             os_client_args = config.get_stx_access_info(
 231                 region_name=subcloud[0].name,
 232                 subcloud_hostname=subcloud[0].oam_floating_ip)
 233             # logger.info(os_client_args)
 234             config_client = get_stx_client(**os_client_args)
 235         except EndpointException as e:
 236             msg = e.format_message()
 237             if CGTSCLIENT_ENDPOINT_ERROR_MSG in msg:
 238                 os_client_args = config.get_stx_access_info(
 239                     region_name=subcloud[0].name, sub_is_https=True,
 240                     subcloud_hostname=subcloud[0].oam_floating_ip)
 241                 # logger.info(os_client_args)
 242                 config_client = get_stx_client(**os_client_args)
 243             else:
 244                 raise ValueError('Stx endpoint exception: %s' % msg)
 245         except Exception:
 246             raise ValueError('cgtsclient get subcloud client failed')
 247
 248         return config_client
 249
 250     def setStxClient(self, resource_pool_id):
 251         systems = self.stxclient.isystem.list()
 252         if resource_pool_id == systems[0].uuid:
 253             logger.debug('Stx Client not change: %s' % resource_pool_id)
 254             return
 255
 256         subclouds = self.getSubcloudList()
 257         for subcloud in subclouds:
 258             subcloud_stxclient = self.getSubcloudClient(subcloud.subcloud_id)
 259             systems = subcloud_stxclient.isystem.list()
 260             # logger.debug('subcloud %s id: %s' %
 261             #  (systems[0].name, systems[0].uuid))
 262             # logger.debug('subcloud: %s' % (systems[0].to_dict()))
 263             if resource_pool_id == systems[0].uuid:
 264                 self.stxclient = subcloud_stxclient
 265
 266     def getInstanceInfo(self) -> ocloudModel.StxGenericModel:
 267         systems = self.stxclient.isystem.list()
 268         logger.debug('systems:' + str(systems[0].to_dict()))
 269         # logger.debug('systems[0] uuid: ' + str(systems[0].uuid))
 270         return ocloudModel.StxGenericModel(
 271             ResourceTypeEnum.OCLOUD, systems[0]) if systems else None
 272
 273     def getSubcloudList(self):
 274         self.dcclient = self.getDcmanagerClient()
 275         subs = self.dcclient.subcloud_manager.list_subclouds()
 276         known_subs = [sub for sub in subs if sub.sync_status != 'unknown']
 277         return known_subs
 278
 279     def getResourcePoolList(self, **filters) -> List[
 280             ocloudModel.StxGenericModel]:
 281         systems = self.stxclient.isystem.list()
 282         logger.debug('system controller distributed_cloud_role:' +
 283                      str(systems[0].distributed_cloud_role))
 284
 285         if systems[0].distributed_cloud_role is None or \
 286                 systems[0].distributed_cloud_role != 'systemcontroller':
 287             return [ocloudModel.StxGenericModel(
 288                 ResourceTypeEnum.RESOURCE_POOL,
 289                 self._respoolconverter(systems[0]))]
 290
 291         pools = []
 292         if config.get_system_controller_as_respool():
 293             pools.append(systems[0])
 294
 295         subclouds = self.getSubcloudList()
 296         logger.debug('subclouds numbers: %s' % len(subclouds))
 297         for subcloud in subclouds:
 298             try:
 299                 subcloud_stxclient = self.getSubcloudClient(
 300                     subcloud.subcloud_id)
 301                 systems = subcloud_stxclient.isystem.list()
 302                 logger.debug('systems:' + str(systems[0].to_dict()))
 303                 pools.append(systems[0])
 304             except Exception as ex:
 305                 logger.warning('Failed get cgstclient of subcloud %s: %s' %
 306                                (subcloud.name, ex))
 307                 continue
 308
 309         return [ocloudModel.StxGenericModel(
 310             ResourceTypeEnum.RESOURCE_POOL,
 311                 self._respoolconverter(
 312                     respool)) for respool in pools if respool]
 313
 314     def getResourcePoolDetail(self, id):
 315         self.setStxClient(id)
 316         systems = self.stxclient.isystem.list()
 317         logger.debug('systems:' + str(systems[0].to_dict()))
 318         return ocloudModel.StxGenericModel(
 319             ResourceTypeEnum.RESOURCE_POOL,
 320             self._respoolconverter(systems[0])) if systems else None
 321
 322     def getPserverList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 323         hosts = self.stxclient.ihost.list()
 324         logger.debug('host 1:' + str(hosts[0].to_dict()))
 325         return [ocloudModel.StxGenericModel(
 326             ResourceTypeEnum.PSERVER, self._hostconverter(host))
 327             for host in hosts if host and (host.availability == 'available'
 328                                            or host.availability == 'online'
 329                                            or host.availability == 'degraded')]
 330
 331     def getPserver(self, id) -> ocloudModel.StxGenericModel:
 332         host = self.stxclient.ihost.get(id)
 333         logger.debug('host:' + str(host.to_dict()))
 334         return ocloudModel.StxGenericModel(
 335             ResourceTypeEnum.PSERVER, self._hostconverter(host))
 336
 337     def _checkLabelExistOnHost(self, client, label_to_check, host_id,
 338                                check_value=False) -> bool:
 339         labels = client.label.list(host_id)
 340         if check_value:
 341             return any(label_to_check['key'] == label.label_key and
 342                        label_to_check['value'] == label.label_value
 343                        for label in labels)
 344         else:
 345             return any(label_to_check['key'] == label.label_key
 346                        for label in labels)
 347
 348     def _checkLabelExistOnCluster(self, client, label_to_check,
 349                                   check_value=False) -> bool:
 350         hosts = client.ihost.list()
 351         for host in hosts:
 352             if self._checkLabelExistOnHost(client, label_to_check,
 353                                            host.uuid, check_value):
 354                 if check_value:
 355                     logger.info(
 356                         f"host {host.hostname} has the label "
 357                         f"{label_to_check['key']} with value "
 358                         f"{label_to_check['value']}")
 359                 else:
 360                     logger.info(
 361                         f"host {host.hostname} has the label "
 362                         f"{label_to_check['key']}")
 363                 return True
 364         return False
 365
 366     def _setK8sCapabilities(self, client, k8scluster):
 367         capabilities = {}
 368         label_OS_2chk = {'key': 'OS', 'value': 'low_latency'}
 369         if self._checkLabelExistOnCluster(client, label_OS_2chk, True):
 370             logger.debug("low latency host inside of the k8s cluster")
 371             capabilities[label_OS_2chk['key']] = label_OS_2chk['value']
 372         setattr(k8scluster, 'capabilities', json.dumps(capabilities))
 373         return k8scluster
 374
 375     def getLabelList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 376         hostid = filters.get('hostid', None)
 377         assert (hostid is not None), 'missing hostid to query label list'
 378         labels = self.stxclient.label.list(hostid)
 379         return [ocloudModel.StxGenericModel(
 380             ResourceTypeEnum.PSERVER_LABEL,
 381             self._labelconverter(label)) for label in labels if label]
 382
 383     def getK8sList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 384         def process_cluster(client, cluster):
 385             setattr(cluster, 'cloud_name', systems[0].name)
 386             cluster = self._setK8sCapabilities(client, cluster)
 387             logger.debug('k8sresources cluster_api_endpoint: ' +
 388                          str(cluster.cluster_api_endpoint))
 389             return ocloudModel.StxGenericModel(ResourceTypeEnum.DMS,
 390                                                self._k8sconverter(cluster),
 391                                                self._k8shasher(cluster))
 392
 393         systems = self.stxclient.isystem.list()
 394         distributed_cloud_role = systems[0].distributed_cloud_role
 395         logger.debug((
 396             f'system controller distributed_cloud_role: '
 397             f'{distributed_cloud_role}'))
 398
 399         k8s_list = []
 400
 401         if distributed_cloud_role is None or distributed_cloud_role != \
 402                 'systemcontroller':
 403             k8s_list.extend(
 404                 [process_cluster(self.stxclient, k8s)
 405                  for k8s in self.stxclient.kube_cluster.list() if k8s])
 406             return k8s_list
 407
 408         if config.get_system_controller_as_respool():
 409             k8s_list.extend(
 410                 [process_cluster(self.stxclient, k8s)
 411                  for k8s in self.stxclient.kube_cluster.list() if k8s])
 412
 413         subclouds = self.getSubcloudList()
 414         logger.debug(f'subclouds numbers: {len(subclouds)}')
 415
 416         for subcloud in subclouds:
 417             try:
 418                 subcloud_stxclient = self.getSubcloudClient(
 419                     subcloud.subcloud_id)
 420                 systems = subcloud_stxclient.isystem.list()
 421                 k8sclusters = subcloud_stxclient.kube_cluster.list()
 422                 k8s_list.extend([process_cluster(subcloud_stxclient, k8s)
 423                                 for k8s in k8sclusters if k8s])
 424             except Exception as ex:
 425                 logger.warning((
 426                     f'Failed to get cgstclient of subcloud '
 427                     f'{subcloud.name}: {ex}'))
 428                 continue
 429
 430         return k8s_list
 431
 432     def getK8sDetail(self, name) -> ocloudModel.StxGenericModel:
 433         def process_k8s_cluster(client, k8s_cluster, cloud_name):
 434             setattr(k8s_cluster, 'cloud_name', cloud_name)
 435             k8s_cluster = self._setK8sCapabilities(client, k8s_cluster)
 436             return k8s_cluster
 437
 438         systems = self.stxclient.isystem.list()
 439         system_name = systems[0].name
 440
 441         if not name:
 442             k8s_clusters = self.stxclient.kube_cluster.list()
 443             k8s_cluster = process_k8s_cluster(
 444                 self.stxclient, k8s_clusters.pop(), system_name)
 445         else:
 446             sname = name.split('.')
 447             cloud_name = '.'.join(sname[:-1])
 448             k8s_name = sname[-1]
 449
 450             if cloud_name == system_name:
 451                 k8s_cluster = process_k8s_cluster(
 452                     self.stxclient,
 453                     self.stxclient.kube_cluster.get(k8s_name), cloud_name)
 454             else:
 455                 subclouds = self.getSubcloudList()
 456                 subcloud_id = next(
 457                     sub.subcloud_id for sub in subclouds
 458                     if sub.name == cloud_name)
 459                 subcloud_stxclient = self.getSubcloudClient(subcloud_id)
 460                 k8s_cluster = process_k8s_cluster(
 461                     subcloud_stxclient,
 462                     subcloud_stxclient.kube_cluster.get(k8s_name), cloud_name)
 463
 464         if not k8s_cluster:
 465             return None
 466
 467         logger.debug(f'k8sresource: {k8s_cluster.to_dict()}')
 468         return ocloudModel.StxGenericModel(
 469             ResourceTypeEnum.DMS, self._k8sconverter(k8s_cluster),
 470             self._k8shasher(k8s_cluster))
 471
 472     def getCpuList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 473         hostid = filters.get('hostid', None)
 474         assert (hostid is not None), 'missing hostid to query icpu list'
 475         cpulist = self.stxclient.icpu.list(hostid)
 476         return [ocloudModel.StxGenericModel(
 477             ResourceTypeEnum.PSERVER_CPU,
 478             self._cpuconverter(cpures)) for cpures in cpulist if cpures]
 479
 480     def getCpu(self, id) -> ocloudModel.StxGenericModel:
 481         cpuinfo = self.stxclient.icpu.get(id)
 482         return ocloudModel.StxGenericModel(
 483             ResourceTypeEnum.PSERVER_CPU, self._cpuconverter(cpuinfo))
 484
 485     def getMemList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 486         hostid = filters.get('hostid', None)
 487         assert (hostid is not None), 'missing hostid to query imem list'
 488         memlist = self.stxclient.imemory.list(hostid)
 489         return [ocloudModel.StxGenericModel(
 490             ResourceTypeEnum.PSERVER_RAM,
 491             self._memconverter(memories)) for memories in memlist if memories]
 492
 493     def getMem(self, id) -> ocloudModel.StxGenericModel:
 494         meminfo = self.stxclient.imemory.get(id)
 495         return ocloudModel.StxGenericModel(
 496             ResourceTypeEnum.PSERVER_RAM, self._memconverter(meminfo))
 497
 498     def getEthernetList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 499         hostid = filters.get('hostid', None)
 500         assert (hostid is not None), 'missing hostid to query port list'
 501         ethlist = self.stxclient.ethernet_port.list(hostid)
 502         return [ocloudModel.StxGenericModel(
 503             ResourceTypeEnum.PSERVER_ETH,
 504             self._ethconverter(eth)) for eth in ethlist if eth]
 505
 506     def getEthernet(self, id) -> ocloudModel.StxGenericModel:
 507         ethinfo = self.stxclient.ethernet_port.get(id)
 508         return ocloudModel.StxGenericModel(
 509             ResourceTypeEnum.PSERVER_ETH, self._ethconverter(ethinfo))
 510
 511     def getIfList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 512         hostid = filters.get('hostid', None)
 513         assert (hostid is not None), 'missing hostid to query iinterface list'
 514         iflist = self.stxclient.iinterface.list(hostid)
 515         return [ocloudModel.StxGenericModel(
 516             ResourceTypeEnum.PSERVER_IF,
 517             self._ifconverter(ifs)) for ifs in iflist if ifs]
 518
 519     def getIf(self, id) -> ocloudModel.StxGenericModel:
 520         ifinfo = self.stxclient.iinterface.get(id)
 521         return ocloudModel.StxGenericModel(
 522             ResourceTypeEnum.PSERVER_IF, self._ifconverter(ifinfo))
 523
 524     def getPortList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 525         ifid = filters.get('interfaceid', None)
 526         assert (ifid is not None), 'missing interface id to query port list'
 527         portlist = self.stxclient.iinterface.list_ports(ifid)
 528         return [ocloudModel.StxGenericModel(
 529             ResourceTypeEnum.PSERVER_IF_PORT,
 530             port) for port in portlist if port]
 531
 532     def getPort(self, id) -> ocloudModel.StxGenericModel:
 533         portinfo = self.stxclient.port.get(id)
 534         return ocloudModel.StxGenericModel(
 535             ResourceTypeEnum.PSERVER_IF_PORT, portinfo)
 536
 537     def getDeviceList(self, **filters) -> List[ocloudModel.StxGenericModel]:
 538         hostid = filters.get('hostid', None)
 539         assert (hostid is not None), 'missing hostid to query pci device list'
 540         pci_dev_list = self.stxclient.pci_device.list(hostid)
 541         return [ocloudModel.StxGenericModel(
 542             ResourceTypeEnum.PSERVER_PCI_DEV,
 543             self._devconverter(pci_dev))
 544             for pci_dev in pci_dev_list if pci_dev]
 545
 546     def getDevice(self, id) -> ocloudModel.StxGenericModel:
 547         pciinfo = self.stxclient.pci_device.get(id)
 548         return ocloudModel.StxGenericModel(
 549             ResourceTypeEnum.PSERVER_PCI_DEV, self._devconverter(pciinfo))
 550
 551     def getAcceleratorList(self, **filters) -> \
 552             List[ocloudModel.StxGenericModel]:
 553         hostid = filters.get('hostid', None)
 554         assert (hostid is not None), 'missing hostid to query accelerator list'
 555         pci_dev_list = self.stxclient.pci_device.list(hostid)
 556         acc_list = []
 557         for pci_dev in pci_dev_list:
 558             if pci_dev.pvendor_id in ['8086']:
 559                 if pci_dev.pdevice_id in ['0d5c', '0d5d']:
 560                     logger.info('Accelerator vendor ID: {}, device ID: {}'.
 561                                 format(pci_dev.pvendor_id, pci_dev.pdevice_id))
 562                     acc_list.append(ocloudModel.StxGenericModel(
 563                         ResourceTypeEnum.PSERVER_ACC,
 564                         self._devconverter(pci_dev)))
 565         return acc_list
 566
 567     def getAccelerator(self, id) -> ocloudModel.StxGenericModel:
 568         pciinfo = self.stxclient.pci_device.get(id)
 569         return ocloudModel.StxGenericModel(
 570             ResourceTypeEnum.PSERVER_ACC, self._devconverter(pciinfo))
 571
 572     def _getIsystems(self):
 573         return self.stxclient.isystem.list()
 574
 575     def _getIsystem(self, id=None):
 576         if id:
 577             return self.stxclient.isystem.get(id)
 578         else:
 579             isystems = self.stxclient.isystem.list()
 580             if len(isystems) != 1 and not id:
 581                 raise Exception('No system uuid was provided and '
 582                                 'more than one system exists in the account.')
 583             return isystems[0]
 584
 585     @ staticmethod
 586     def _respoolconverter(res_pool):
 587         setattr(res_pool, 'name', res_pool.region_name)
 588         return res_pool
 589
 590     @ staticmethod
 591     def _hostconverter(host):
 592         selected_keys = [
 593             "hostname", "personality", "id", "mgmt_ip", "mgmt_mac",
 594             "software_load", "capabilities",
 595             "operational", "availability", "administrative",
 596             "boot_device", "rootfs_device", "install_state", "subfunctions",
 597             "clock_synchronization", "max_cpu_mhz_allowed"
 598         ]
 599         content = host.to_dict()
 600         filtered = dict(
 601             filter(lambda item: item[0] in selected_keys, content.items()))
 602         setattr(host, 'filtered', filtered)
 603         setattr(host, 'name', host.hostname)
 604         return host
 605
 606     @ staticmethod
 607     def _labelconverter(label):
 608         selected_keys = [
 609             "uuid", "label_key", "label_value", "host_uuid"
 610         ]
 611         content = label.to_dict()
 612         print(content)
 613         filtered = dict(
 614             filter(lambda item: item[0] in selected_keys, content.items()))
 615         setattr(label, 'filtered', filtered)
 616         setattr(label, 'name', label.uuid.split(
 617             '-', 1)[0] + '-label-' + label.label_key)
 618         setattr(label, 'updated_at', None)
 619         setattr(label, 'created_at', None)
 620         return label
 621
 622     @ staticmethod
 623     def _cpuconverter(cpu):
 624         selected_keys = [
 625             "cpu", "core", "thread", "allocated_function", "numa_node",
 626             "cpu_model", "cpu_family"
 627         ]
 628         content = cpu.to_dict()
 629         filtered = dict(
 630             filter(lambda item: item[0] in selected_keys, content.items()))
 631         setattr(cpu, 'filtered', filtered)
 632         setattr(cpu, 'name', cpu.ihost_uuid.split(
 633             '-', 1)[0] + '-cpu-'+str(cpu.cpu))
 634         return cpu
 635
 636     @ staticmethod
 637     def _memconverter(mem):
 638         selected_keys = [
 639             "memtotal_mib", "memavail_mib", "vm_hugepages_use_1G",
 640             "vm_hugepages_possible_1G", "hugepages_configured",
 641             "vm_hugepages_avail_1G", "vm_hugepages_nr_1G",
 642             "vm_hugepages_nr_4K", "vm_hugepages_nr_2M",
 643             "vm_hugepages_possible_2M", "vm_hugepages_avail_2M",
 644             "platform_reserved_mib", "numa_node"
 645         ]
 646         content = mem.to_dict()
 647         filtered = dict(
 648             filter(lambda item: item[0] in selected_keys, content.items()))
 649         setattr(mem, 'filtered', filtered)
 650         setattr(mem, 'name', mem.ihost_uuid.split('-', 1)[0] +
 651                 '-mem-node-'+str(mem.numa_node))
 652         return mem
 653
 654     @ staticmethod
 655     def _ethconverter(eth):
 656         selected_keys = [
 657             "name", "namedisplay", "dev_id", "pdevice", "capabilities",
 658             "type", "driver", "mac", "numa_node",
 659             "pciaddr", "pclass", "psvendor", "psdevice",
 660             "sriov_totalvfs", "sriov_numvfs", "dpdksupport",
 661             "sriov_vf_driver", "sriov_vf_pdevice_id", "interface_uuid"
 662         ]
 663         content = eth.to_dict()
 664         filtered = dict(
 665             filter(lambda item: item[0] in selected_keys, content.items()))
 666         setattr(eth, 'filtered', filtered)
 667         setattr(eth, 'name', eth.host_uuid.split('-', 1)[0] + '-'+eth.name)
 668         setattr(eth, 'updated_at', None)
 669         setattr(eth, 'created_at', None)
 670         return eth
 671
 672     @ staticmethod
 673     def _ifconverter(ifs):
 674         selected_keys = [
 675             "ifname", "iftype", "imac", "vlan_id", "imtu",
 676             "ifclass", "uses", "max_tx_rate",
 677             "sriov_vf_driver", "sriov_numvfs", "ptp_role"
 678         ]
 679         content = ifs.to_dict()
 680         filtered = dict(
 681             filter(lambda item: item[0] in selected_keys, content.items()))
 682         setattr(ifs, 'filtered', filtered)
 683         setattr(ifs, 'name', ifs.ihost_uuid.split('-', 1)[0] + '-'+ifs.ifname)
 684         setattr(ifs, 'updated_at', None)
 685         setattr(ifs, 'created_at', None)
 686         return ifs
 687
 688     @ staticmethod
 689     def _devconverter(dev):
 690         selected_keys = [
 691             "name", "pdevice", "pciaddr", "pvendor_id", "pvendor",
 692             "pclass_id", "pclass", "psvendor", "psdevice",
 693             "sriov_totalvfs", "sriov_numvfs", "numa_node"
 694         ]
 695         content = dev.to_dict()
 696         filtered = dict(
 697             filter(lambda item: item[0] in selected_keys, content.items()))
 698         setattr(dev, 'filtered', filtered)
 699         setattr(dev, 'name', dev.host_uuid.split('-', 1)[0] + '-'+dev.name)
 700         return dev
 701
 702     @ staticmethod
 703     def _k8sconverter(cluster):
 704         setattr(cluster, 'name', cluster.cloud_name +
 705                 '.' + cluster.cluster_name)
 706         setattr(cluster, 'uuid',
 707                 uuid.uuid3(uuid.NAMESPACE_URL, cluster.cluster_name))
 708         setattr(cluster, 'updated_at', None)
 709         setattr(cluster, 'created_at', None)
 710         setattr(cluster, 'events', [])
 711         logger.debug('k8s cluster name/uuid:' +
 712                      cluster.name + '/' + str(cluster.uuid))
 713         return cluster
 714
 715     @ staticmethod
 716     def _k8shasher(cluster):
 717         return str(hash((cluster.cluster_name, cluster.cloud_name,
 718                          cluster.cluster_api_endpoint, cluster.admin_user,
 719                          cluster.capabilities)))