def attach_vcenter(self,
vc_server_name,
vc_server_host,
vc_admin_user,
vc_admin_pwd,
is_enabled,
vc_root_folder=None,
nsx_server_name=None,
nsx_host=None,
nsx_admin_user=None,
nsx_admin_pwd=None):
"""Register (attach) a VirtualCenter server (also known as VimServer).
:param str vc_server_name: vc server name (virtual center name).
:param str vc_server_host: FQDN or IP address of vc host.
:param str vc_admin_user: vc admin user.
:param str vc_admin_pwd: vc admin password.
:param str is_enabled: true if VC is to be enabled.
:param str vc_root_folder: vc root folder.
:param str nsx_server_name: NSX server name.
:param str nsx_host: FQDN or IP address of NSX host.
:param str nsx_admin_user: NSX admin user.
:param str nsx_admin_pwd: NSX admin password.
:return: an object containing REGISTER_VC_SERVER_PARAMS XML data that
represents the newly registered (attached) VimServer.
:rtype: lxml.objectify.ObjectifiedElement
"""
register_vc_server_params = E_VMEXT.RegisterVimServerParams()
vc_server = E_VMEXT.VimServer(name=vc_server_name)
vc_server.append(E_VMEXT.Username(vc_admin_user))
vc_server.append(E_VMEXT.Password(vc_admin_pwd))
vc_server_host_url = urlparse(vc_server_host)
if vc_server_host_url.netloc is not '':
vc_server.append(E_VMEXT.Url(vc_server_host))
else:
vc_server.append(E_VMEXT.Url('https://' + vc_server_host + ':443'))
vc_server.append(E_VMEXT.IsEnabled(is_enabled))
if vc_root_folder is not None:
vc_server.append(E_VMEXT.rootFolder(vc_root_folder))
register_vc_server_params.append(vc_server)
if nsx_server_name is not None:
nsx_manager = E_VMEXT.ShieldManager(name=nsx_server_name)
nsx_manager.append(E_VMEXT.Username(nsx_admin_user))
nsx_manager.append(E_VMEXT.Password(nsx_admin_pwd))
nsx_host_url = urlparse(nsx_host)
if nsx_host_url.netloc is not '':
nsx_manager.append(E_VMEXT.Url(nsx_host))
else:
nsx_manager.append(E_VMEXT.Url('https://' + nsx_host + ':443'))
register_vc_server_params.append(nsx_manager)
return self.client.\
post_linked_resource(resource=self.extension.get_resource(),
rel=RelationType.ADD,
media_type=EntityType.
REGISTER_VC_SERVER_PARAMS.value,
contents=register_vc_server_params)
def enable_disable_vcenter(self, vc_name, enable_flag):
"""Enable or disable a Virtual Center (VC) server.
:param str vc_name: name of VC server.
:param boolean enable_flag: True means enable, False means disable.
:return: an object containing EntityType.TASK XML data which represents
the asynchronous task that is enabling or disabling the VC.
rtype: lxml.objectify.ObjectifiedElement'
"""
vc = self.get_vcenter(vc_name)
if enable_flag:
vc.IsEnabled = E_VMEXT.IsEnabled('true')
else:
vc.IsEnabled = E_VMEXT.IsEnabled('false')
return self.client.\
put_linked_resource(resource=vc,
rel=RelationType.EDIT,
media_type=EntityType.VIRTUAL_CENTER.value,
contents=vc)
def attach_vcenter(self,
vc_server_name,
vc_server_host,
vc_admin_user,
vc_admin_pwd,
vc_root_folder=None,
nsx_server_name=None,
nsx_host=None,
nsx_admin_user=None,
nsx_admin_pwd=None,
is_enabled=None):
"""Register (attach) a VirtualCenter server (also known as VimServer).
:param: vc_server_name: (str): vc server name (virtual center name).
:param: vc_server_host: (str): FQDN or IP address of vc host.
:param: vc_admin_user: (str): vc admin user.
:param: vc_admin_pwd: (str): vc admin password.
:param: vc_root_folder: (str): vc root folder.
:param: nsx_server_name: (str): NSX server name.
:param: nsx_host (str): FQDN or IP address of NSX host.
:param: nsx_admin_user: (str): NSX admin user.
:param: nsx_admin_pwd: (str): NSX admin password.
:return: A :class:lxml.objectify.StringElement object describing the
: newly registered (attached) VimServer.
"""
register_vc_server_params = E_VMEXT.RegisterVimServerParams()
vc_server = E_VMEXT.VimServer(name=vc_server_name)
vc_server.append(E_VMEXT.Username(vc_admin_user))
vc_server.append(E_VMEXT.Password(vc_admin_pwd))
vc_server.append(E_VMEXT.Url('https://' + vc_server_host + ':443'))
if is_enabled is not None:
vc_server.append(E_VMEXT.IsEnabled(is_enabled))
if vc_root_folder is not None:
vc_server.append(E_VMEXT.rootFolder(vc_root_folder))
register_vc_server_params.append(vc_server)
if nsx_server_name is not None:
nsx_manager = E_VMEXT.ShieldManager(name=nsx_server_name)
nsx_manager.append(E_VMEXT.Username(nsx_admin_user))
nsx_manager.append(E_VMEXT.Password(nsx_admin_pwd))
nsx_manager.append(E_VMEXT.Url('https://' + nsx_host + ':443'))
register_vc_server_params.append(nsx_manager)
return self.client.\
post_linked_resource(resource=self.extension.get_resource(),
rel=RelationType.ADD,
media_type=EntityType.
REGISTER_VC_SERVER_PARAMS.value,
contents=register_vc_server_params)
def create_provider_vdc(self,
vim_server_name,
resource_pool_names,
storage_profiles,
pvdc_name,
is_enabled=None,
description=None,
highest_hw_vers=None,
vxlan_network_pool=None,
nsxt_manager_name=None):
"""Create a Provider Virtual Datacenter.
:param str vim_server_name: vim_server_name (VC name).
:param list resource_pool_names: list of resource_pool_names.
:param list storage_profiles: (list): list of storageProfile names.
:param str pvdc_name: name of PVDC to be created.
:param bool is_enabled: flag, True to enable and False to disable.
:param str description: description of pvdc.
:param str highest_hw_vers: highest supported hw version number.
:param str vxlan_network_pool: name of vxlan_network_pool.
:param str nsxt_manager_name: name of nsx-t manager.
:return: an object containing vmext:VMWProviderVdc XML element that
represents the new provider VDC.
:rtype: lxml.objectify.ObjectifiedElement
"""
vc_record = self.get_vcenter(vim_server_name)
vc_href = vc_record.get('href')
rp_morefs = self.get_resource_pool_morefs(vc_href, resource_pool_names)
vmw_prov_vdc_params = E_VMEXT.VMWProviderVdcParams(name=pvdc_name)
if description is not None:
vmw_prov_vdc_params.append(E.Description(description))
resource_pool_refs = E_VMEXT.ResourcePoolRefs()
for rp_moref in rp_morefs:
vim_object_ref = E_VMEXT.VimObjectRef()
vim_object_ref.append(E_VMEXT.VimServerRef(href=vc_href))
vim_object_ref.append(E_VMEXT.MoRef(rp_moref))
vim_object_ref.append(E_VMEXT.VimObjectType('RESOURCE_POOL'))
resource_pool_refs.append(vim_object_ref)
vmw_prov_vdc_params.append(resource_pool_refs)
vmw_prov_vdc_params.append(E_VMEXT.VimServer(href=vc_href))
if vxlan_network_pool is not None:
network_pool_rec = self.get_ref_by_name(ResourceType.NETWORK_POOL,
vxlan_network_pool)
vx_href = network_pool_rec.get('href')
vmw_prov_vdc_params.append(E_VMEXT.VxlanNetworkPool(href=vx_href))
if nsxt_manager_name is not None:
nsxt_manager_rec = self.get_ref_by_name(ResourceType.NSXT_MANAGER,
nsxt_manager_name)
nsxt_href = nsxt_manager_rec.get('href')
vmw_prov_vdc_params.append(
E_VMEXT.NsxTManagerReference(href=nsxt_href))
if highest_hw_vers is not None:
vmw_prov_vdc_params.append(
E_VMEXT.HighestSupportedHardwareVersion(highest_hw_vers))
if is_enabled is not None:
vmw_prov_vdc_params.append(E_VMEXT.IsEnabled(is_enabled))
for storage_profile in storage_profiles:
vmw_prov_vdc_params.append(E_VMEXT.StorageProfile(storage_profile))
random_username_suffix = uuid.uuid4().hex
default_user = '******' + random_username_suffix[:8]
default_pwd = 'PWD' + random_username_suffix[:8]
vmw_prov_vdc_params.append(E_VMEXT.DefaultPassword(default_pwd))
vmw_prov_vdc_params.append(E_VMEXT.DefaultUsername(default_user))
return self.client.post_linked_resource(
self.extension.get_resource(),
rel=RelationType.ADD,
media_type=EntityType.PROVIDER_VDC_PARAMS.value,
contents=vmw_prov_vdc_params)
def create_provider_vdc(self,
vim_server_name,
resource_pool_names,
storage_profiles,
pvdc_name,
is_enabled=None,
description=None,
highest_hw_vers=None,
vxlan_network_pool=None):
"""Create a Provider Virtual Datacenter.
:param: vim_server_name: (str): vim_server_name (VC name).
:param: resource_pool_names: (list): list of resource_pool_names.
:param: storage_profiles: (list): list of storageProfile namespace.
:param: pvdc_name: (str): name of PVDC to be created.
:param: is_enabled: (boolean): enable flag.
:param: description: (str): description of pvdc.
:param: highest_hw_vers: (str): highest supported hw vers number.
:param: vxlan_network_pool: (str): name of vxlan_network_pool.
:return: A :class:lxml.objectify.StringElement object describing the
: new provider VDC.
"""
vc_record = self.get_vcenter(vim_server_name)
vc_href = vc_record.get('href')
rp_morefs = self.get_resource_pool_morefs(vim_server_name,
vc_href,
resource_pool_names)
vmw_prov_vdc_params = E_VMEXT.VMWProviderVdcParams(name=pvdc_name)
if description is not None:
vmw_prov_vdc_params.append(E.Description(description))
resource_pool_refs = E_VMEXT.ResourcePoolRefs()
for rp_moref in rp_morefs:
vim_object_ref = E_VMEXT.VimObjectRef()
vim_object_ref.append(E_VMEXT.VimServerRef(href=vc_href))
vim_object_ref.append(E_VMEXT.MoRef(rp_moref))
vim_object_ref.append(E_VMEXT.VimObjectType('RESOURCE_POOL'))
resource_pool_refs.append(vim_object_ref)
vmw_prov_vdc_params.append(resource_pool_refs)
vmw_prov_vdc_params.append(E_VMEXT.VimServer(href=vc_href))
if vxlan_network_pool is not None:
vxlan_network_pool_record = self.get_vxlan_network_pool(
vxlan_network_pool)
vx_href = vxlan_network_pool_record.get('href')
vmw_prov_vdc_params.append(E_VMEXT.VxlanNetworkPool(
href=vx_href))
if highest_hw_vers is not None:
vmw_prov_vdc_params.append(
E_VMEXT.HighestSupportedHardwareVersion(highest_hw_vers))
if is_enabled is not None:
vmw_prov_vdc_params.append(E_VMEXT.IsEnabled(is_enabled))
for storage_profile in storage_profiles:
vmw_prov_vdc_params.append(E_VMEXT.StorageProfile(
storage_profile))
random_username_suffix = uuid.uuid4().hex
default_user = '******' + random_username_suffix[:8]
default_pwd = 'PWD' + random_username_suffix[:8]
vmw_prov_vdc_params.append(E_VMEXT.DefaultPassword(default_pwd))
vmw_prov_vdc_params.append(E_VMEXT.DefaultUsername(default_user))
return self.client.post_linked_resource(self.extension.get_resource(),
rel=RelationType.ADD,
media_type=EntityType.
PROVIDER_VDC_PARAMS.value,
contents=vmw_prov_vdc_params)
