File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/libcloud/compute/drivers/__pycache__/dimensiondata.cpython-310.pyc
Back
o ;j�� � @ sb d Z ddlZddlmZmZmZmZ ddlmZm Z m Z ddl m Z m Z mZmZmZmZ ddlmZmZ ddlmZ ddlmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7 ej8ej9ej9ej9ej9ej9ej:ej;ej;ej;ej<ej<ej=ej=ej>d �Z?d d d d dd�Z@G dd� de�ZAdS )z Dimension Data Driver � N)�ET� urlencode� basestring� ensure_string)�findall�findtext�fixxpath)�Node�NodeSize� NodeImage� NodeDriver� NodeLocation�NodeAuthPassword)�Provider� NodeState)� BaseHTTPError) � SERVER_NS� TYPES_URN� GENERAL_NS� NETWORK_NS� API_ENDPOINTS�DEFAULT_REGION� LooseVersion�DimensionDataNic�DimensionDataTag�DimensionDataPort�DimensionDataVlan�DimensionDataStatus�DimensionDataTagKey�DimensionDataNatRule�DimensionDataNetwork�DimensionDataPortList�DimensionDataIpAddress�DimensionDataConnection�DimensionDataServerDisk�NetworkDomainServicePlan�DimensionDataAPIException�DimensionDataFirewallRule�DimensionDataChildPortList�DimensionDataIpAddressList�DimensionDataNetworkDomain�DimensionDataPublicIpBlock� DimensionDataFirewallAddress� DimensionDataAntiAffinityRule� DimensionDataServerVMWareTools� DimensionDataChildIpAddressList�#DimensionDataServerCpuSpecification�dd_object_to_id))�NORMAL�falseN)�PENDING_CHANGEr3 N)r4 r3 �CHANGE_NETWORK_ADAPTER)r4 �truer5 )r4 r3 �EXCHANGE_NIC_VLANS)r4 r6 r7 )r2 r6 N)r4 r6 Z START_SERVER)� PENDING_ADDr6 Z DEPLOY_SERVER)r8 r6 Z DEPLOY_SERVER_WITH_DISK_SPEED)r4 r6 ZSHUTDOWN_SERVER)r4 r6 ZPOWER_OFF_SERVER)r4 r6 Z REBOOT_SERVER)r4 r6 Z RESET_SERVER)r4 r6 ZRECONFIGURE_SERVERZSERVERZCUSTOMER_IMAGEZNETWORK_DOMAINZVLANZPUBLIC_IP_BLOCK)r r r* r r+ c sv e Zd ZdZdZeZdZdZe j Z ddgiZ dZ dddddef� fd d � Z� fd d �Z �dLd d�Z �dMdd�Zdd� Zdd� Z �dNdd�Z�dOdd�Z�dOdd�Z�dOdd �Z�dOd d �Z �dPd d �Zd!d"� Zd#d$� Z �dNd%d&�Z d'd(� Z d)d*� Z d+d,� Z d-d.� Z!d/d0� Z"�dQd1d2�Z#d3d4� Z$d5d6� Z% �dPd7d8�Z&�dRd9d:�Z'd;d<� Z(�dOd=d>�Z)�dOd?d@�Z*dAdB� Z+dCdD� Z,dEdF� Z-�dQdGdH�Z.�dOdIdJ�Z/dKdL� Z0dMdN� Z1 O�dSdPdQ�Z2dRdS� Z3dTdU� Z4dVdW� Z5dXdY� Z6 �dTdZd[�Z7d\d]� Z8d^d_� Z9d`da� Z:dbdc� Z;ddde� Z<�dUdhdi�Z= �dOdjdk�Z>�dOdldm�Z?dndo� Z@dpdq� ZAdrds� ZBdtdu� ZCdvdw� ZDdxdy� ZEdzd{� ZFd|d}� ZG�dVd�d��ZH�dWd�d��ZI�dWd�d��ZJd�d�� ZK�dXd�d��ZLd�d�� ZMd�d�� ZNd�d�� ZOd�d�� ZPd�d�� ZQ �dPd�d��ZRd�d�� ZS�dOd�d��ZTd�d�� ZUd�d�� ZVd�d�� ZW �dYd�d��ZX�dQd�d��ZYd�d�� ZZd�d�� Z[ �dQd�d��Z\d�d�� Z]�dOd�d��Z^d�d�� Z_ �dZd�d��Z`d�d�� Zad�d�� Zbd�d�� Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zg �dOd�dÄZh �dOd�dńZid�dDŽ Zjd�dɄ Zkd�d˄ Zl �dOd�d̈́Zm�dOd�dτZnd�dф Zod�dӄ Zpd�dՄ Zq �d[d�dׄZrd�dل Zsetd�dۄ �Zui fd�d݄Zvd�d߄ Zwd�d� Zxd�d� Zy�d\d�d�Zz�d]d�d�Z{�dOd�d�Z|d�d� Z}d�d� Z~d�d� Zd�d� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z�d�d�� Z��d �d� Z��d�d� Z��d�d� Z��d�d� Z��d�d � Z��d �d � Z��d �d � Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d�d� Z��d �d � Z��d �d � Z��d �d!� Z��d"�d#� Z��d$�d%� Z��d&�d'� Z��d(�d)� Z�et�d*�d+� �Z�et�d,�d-� �Z�et�d.�d/� �Z�et�d0�d1� �Z�et�d2�d3� �Z�et�d4�d5� �Z�et�d6�d7� �Z�et�d8�d9� �Z�et�d:�d;� �Z�et�d<�d=� �Z�et�d>�d?� �Z�et�d@�dA� �Z�et�dB�dC� �Z�et�dD�dE� �Z�et�dF�dG� �Z�et�dH�dI� �Z�et�dJ�dK� �Z�� Z�S (^ �DimensionDataNodeDriverzV DimensionData node driver. Default api_version is used unless specified. NZ DimensionDataz http://www.dimensiondata.com/� create_node�passwordg �?Tc sb |t vr|d u rtd| ��|d urt | | _|d ur || _t� jd|||||||d�|�� d S )Nz%Invalid region: %s, no host specified)�key�secret�secure�host�port� api_version�region� )r � ValueError�selected_regionrA �super�__init__) �selfr< r= r> r? r@ rA rB �kwargs�� __class__rC �Z/opt/saltstack/salt/lib/python3.10/site-packages/libcloud/compute/drivers/dimensiondata.pyrG p s" � �z DimensionDataNodeDriver.__init__c s" t � �� }| j|d< | j|d< |S )zT Add the region to the kwargs before the connection is instantiated rB rA )rF �_ex_connection_class_kwargsrE rA )rH rI rJ rC rL rM � s z3DimensionDataNodeDriver._ex_connection_class_kwargsc K s� d} | � |�} | r t|t�rt|d�}|} n| �|�}|j} t�ddti�}|t� |d�_ |t� |d�_ | � |�}|t� |d�_ t |�� � t� |d�_ | durV| t� |d �_ |duryt� |d �}|�d |j� |�d t |j�� |�d t |j�� |dur�t |�t� |d�_ |dur�t� |d�}| �|�}|t� |d�_ | r�t� |d�}| |_ | r�t� |d�}| |_ | jjddt�|�d�j}d}t|dt�D ]}|�d�dkr�|�d�}q�| �|�}| r�t|dd�r�|j|jd< |S ) a$ Create a new DimensionData node :keyword name: String with a name for this new node (required) :type name: ``str`` :keyword image: OS Image to boot on node. (required) :type image: :class:`NodeImage` or ``str`` :keyword auth: Initial authentication information for the node. (If this is a customer LINUX image auth will be ignored) :type auth: :class:`NodeAuthPassword` or ``str`` or ``None`` :keyword ex_description: description for this node (required) :type ex_description: ``str`` :keyword ex_network: Network to create the node within (required unless using ex_network_domain or ex_primary_ipv4) :type ex_network: :class:`DimensionDataNetwork` or ``str`` :keyword ex_memory_gb: The amount of memory in GB for the server :type ex_memory_gb: ``int`` :keyword ex_cpu_specification: The spec of CPU to deploy ( optional) :type ex_cpu_specification: :class:`DimensionDataServerCpuSpecification` :keyword ex_is_started: Start server after creation? default true (required) :type ex_is_started: ``bool`` :keyword ex_primary_dns: The node's primary DNS :type ex_primary_dns: ``str`` :keyword ex_secondary_dns: The node's secondary DNS :type ex_secondary_dns: ``str`` :return: The newly created :class:`Node`. :rtype: :class:`Node` N�r; � deployServer�xmlns�name� description�imageId�start�administratorPassword�cpu�speed�count�coresPerSocket�memoryGb�network� networkId� primaryDns� secondaryDns�server/deployServer�POST��method�data�info�serverId�value� generatedFr; ) �_image_needs_auth� isinstancer r �_get_and_check_authr; r �Elementr � SubElement�text�_image_to_image_id�str�lower�set� performance� cpu_count�cores_per_socket�_network_to_network_id� connection�request_with_orgId_api_2�tostring�objectr �get�ex_get_node_by_id�getattr�extra)rH rQ �image�auth�ex_description� ex_network� ex_memory_gb�ex_cpu_specification� ex_is_started�ex_primary_dns�ex_secondary_dnsrI r; �image_needs_auth�auth_obj� server_elm�image_idrV � network_elmZ network_id�dns_elm�response�node_idrd �noderC rC rL �_create_node_mcp1� s` > �� � z)DimensionDataNodeDriver._create_node_mcp1c , K s4 |du r d|vr t d��|durd|v rt d��t| t�s d} d|v rA| j||||�d�| | | | || |�d�|�d�||d�}|S d |v rJ|�d �}d |v rS|�d �}g }d|v ry|�d�}t|ttf�ru|D ] }t|d �}|�|� qgnt d ��d|v r�|�d�}t|ttf�r�|D ] }t|d �}|�|� q�n|dur�t d��d|v s�d|v r�|}|du r�t d��d}| � |�}|r�t|t �r�t |d�} |}n| � |�} | j}t�ddti�} |t�| d�_| t�| d�_| �|�} | t�| d�_t| ��� t�| d�_|du�r |t�| d�_| du�r.t�| d�} | �d| j� | �dt| j�� | �dt| j�� | du�r<t| �t�| d �_|du �rJ|du �rJt d ��|du�rX|du�rXt d ��t�| d �} | �|�}!| �d |!� t�| d!�}"|du�r{|t�|"d"�_|du�r�| � |�}#|#t�|"d#�_|du�r�|t�|"d$�_t|ttf��r�|D ]X}$t�| d%�}%|$j du �r�|$j du �r�t d&��|$j du�r�|$j du�r�t d'��|$j du�r�|$j t�|%d"�_|$j du�r�| � |$j �}#|#t�|%d#�_|$j du�r�|$j t�|%d$�_�q�n |du�rt d(��|�rt�| d)�}&||&_|�r t�| d*�}&||&_|�r'|t�| d+�_t| ttf��rJ| D ]}'t�| d,�}(|(�d-|'j � |(�d|'j!� �q1n | du�rSt d.��|�r]|t�| d/�_| j"j#d0d1t�$| �d2�j%})d}*t&|)d3t�D ]}+|+�d�d4k�r�|+�d5�}*�qr| �'|*�}|�r�t(| d6d7��r�| j|j)d8< |S )9ae% Create a new DimensionData node in MCP2. However, it is still backward compatible for MCP1 for a limited time. Please consider using MCP2 datacenter as MCP1 will phase out soon. Legacy Create Node for MCP1 datacenter >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.base import NodeAuthPassword >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = False >>> DimensionData = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Password >>> root_pw = NodeAuthPassword('password123') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU1') >>> >>> # Get network by location >>> my_network = driver.list_networks(location=location)[0] >>> pprint(my_network) >>> >>> # Get Image >>> images = driver.list_images(location=location) >>> image = images[0] >>> >>> node = driver.create_node(name='test_blah_2', image=image, >>> auth=root_pw, >>> ex_description='test3 node', >>> ex_network=my_network, >>> ex_is_started=False) >>> pprint(node) Create Node in MCP2 Data Center >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.base import NodeAuthPassword >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Password >>> root_pw = NodeAuthPassword('password123') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> vlan = driver.ex_list_vlans(location=location, >>> network_domain=my_network_domain)[0] >>> pprint(vlan) >>> >>> # Get Image >>> images = driver.list_images(location=location) >>> image = images[0] >>> >>> # Create node using vlan instead of private IPv4 >>> node = driver.create_node(name='test_server_01', image=image, >>> auth=root_pw, >>> ex_description='test2 node', >>> ex_network_domain=my_network_domain, >>> ex_primary_nic_vlan=vlan, >>> ex_is_started=False) >>> >>> # Option: Create node using private IPv4 instead of vlan >>> # node = driver.create_node(name='test_server_02', image=image, >>> # auth=root_pw, >>> # ex_description='test2 node', >>> # ex_network_domain=my_network_domain, >>> # ex_primary_nic_private_ipv4='10.1.1.7', >>> # ex_is_started=False) >>> >>> # Option: Create node using by specifying Network Adapter >>> # node = driver.create_node(name='test_server_03', image=image, >>> # auth=root_pw, >>> # ex_description='test2 node', >>> # ex_network_domain=my_network_domain, >>> # ex_primary_nic_vlan=vlan, >>> # ex_primary_nic_network_adapter='E1000', >>> # ex_is_started=False) >>> :keyword name: (required) String with a name for this new node :type name: ``str`` :keyword image: (required) OS Image to boot on node. :type image: :class:`NodeImage` or ``str`` :keyword auth: Initial authentication information for the node. (If this is a customer LINUX image auth will be ignored) :type auth: :class:`NodeAuthPassword` or ``str`` or ``None`` :keyword ex_description: (optional) description for this node :type ex_description: ``str`` :keyword ex_network_domain: (required) Network Domain or Network Domain ID to create the node :type ex_network_domain: :class:`DimensionDataNetworkDomain` or ``str`` :keyword ex_primary_nic_private_ipv4: Provide private IPv4. Ignore if ex_primary_nic_vlan is provided. Use one or the other. Not both. :type ex_primary_nic_private_ipv4: :``str`` :keyword ex_primary_nic_vlan: Provide VLAN for the node if ex_primary_nic_private_ipv4 NOT provided. One or the other. Not both. :type ex_primary_nic_vlan: :class: DimensionDataVlan or ``str`` :keyword ex_primary_nic_network_adapter: (Optional) Default value for the Operating System will be used if leave empty. Example: "E1000". :type ex_primary_nic_network_adapter: :``str`` :keyword ex_additional_nics: (optional) List :class:'DimensionDataNic' or None :type ex_additional_nics: ``list`` of :class:'DimensionDataNic' or ``str`` :keyword ex_memory_gb: (optional) The amount of memory in GB for the server Can be used to override the memory value inherited from the source Server Image. :type ex_memory_gb: ``int`` :keyword ex_cpu_specification: (optional) The spec of CPU to deploy :type ex_cpu_specification: :class:`DimensionDataServerCpuSpecification` :keyword ex_is_started: (required) Start server after creation. Default is set to true. :type ex_is_started: ``bool`` :keyword ex_primary_dns: (Optional) The node's primary DNS :type ex_primary_dns: ``str`` :keyword ex_secondary_dns: (Optional) The node's secondary DNS :type ex_secondary_dns: ``str`` :keyword ex_ipv4_gateway: (Optional) IPv4 address in dot-decimal notation, which will be used as the Primary NIC gateway instead of the default gateway assigned by the system. If ipv4Gateway is provided it does not have to be on the VLAN of the Primary NIC but MUST be reachable or the Guest OS will not be configured correctly. :type ex_ipv4_gateway: ``str`` :keyword ex_disks: (optional) Dimensiondata disks. Optional disk elements can be used to define the disk speed that each disk on the Server; inherited from the source Server Image will be deployed to. It is not necessary to include a diskelement for every disk; only those that you wish to set a disk speed value for. Note that scsiId 7 cannot be used.Up to 13 disks can be present in addition to the required OS disk on SCSI ID 0. Refer to https://docs.mcp-services.net/x/UwIu for disk :type ex_disks: List or tuple of :class:'DimensionDataServerDisk` :keyword ex_microsoft_time_zone: (optional) For use with Microsoft Windows source Server Images only. For the exact value to use please refer to the table of time zone indexes in the following Microsoft Technet documentation. If none is supplied, the default time zone for the data center geographic region will be used. :type ex_microsoft_time_zone: `str`` :return: The newly created :class:`Node`. :rtype: :class:`Node` Nr� zPYou must provide either ex_network_domain for MCP2 or ex_network for legacy MCP1zSYou can only supply either ex_network_domain for MCP2 or ex_network for legacy MCP1T�ex_additional_nics_vlan�ex_additional_nics_ipv4)rQ r~ r r� r� r� r� r� �ex_primary_ipv4�ex_disksr� r� r� r� �ex_vlanr� ��vlanz4ex_additional_nics_vlan must be None or a tuple/list)� private_ip_v4z4ex_additional_nics_ipv4 must be None or a tuple/listz#ex_network_domain must be specifiedrN rO rP rQ rR rS rT rU rV rW rX rY rZ �^Missing argument. Either ex_primary_nic_private_ipv4 or ex_primary_nic_vlan must be specified.�QEither ex_primary_nic_private_ipv4 or ex_primary_nic_vlan be specified. Not both.� networkInfo�networkDomainId� primaryNic� privateIpv4�vlanId�networkAdapter� additionalNic�IEither a vlan or private_ip_v4 must be specified for each additional nic.�SEither a vlan or private_ip_v4 must be specified for each additional nic. Not both.�-ex_additional_NICs must be None or tuple/listr] r^ Z ipv4Gateway�disk�scsiId�#ex_disks must be None or tuple/listZmicrosoftTimeZoner_ r` ra rd re rf rg Fr; )*rD ri �boolr� rz �list�tupler �append� TypeErrorrh r r rj r; r rk r rl rm rn ro rp rq rr rs rt �$_network_domain_to_network_domain_id�_vlan_to_vlan_idr� r� �network_adapter_name�scsi_idrW rv rw rx ry r r{ r| r} ),rH rQ r~ r �ex_network_domain�ex_primary_nic_private_ipv4�ex_primary_nic_vlan� ex_primary_nic_network_adapter�ex_additional_nicsr� r� r� r� r� r� r� Zex_ipv4_gatewayZex_microsoft_time_zonerI �new_nodeZadditional_nics�vlans�vZadd_nic�ips�ipr; r� r� r� r� rV r� � net_domain_id�pri_nic�vlan_id�nic�additional_nicr� r� �disk_elmr� r� rd rC rC rL r: s6 \�� � 8 �� � � �� �� ��� � �� � z#DimensionDataNodeDriver.create_nodec C �B t �dt|jd��}| jjddt �|�d�j}t|dt�}|dv S )z� Deletes a node, node must be stopped before deletion :keyword node: The node to delete :type node: :class:`Node` :rtype: ``bool`` Z deleteServer�rP �idzserver/deleteServerr` ra � responseCode�� IN_PROGRESS�OK� r rk r r� rv rw rx ry r �rH r� � request_elm�body� response_coderC rC rL � destroy_node� � �� z$DimensionDataNodeDriver.destroy_nodec C r� )z� Reboots a node by requesting the OS restart via the hypervisor :keyword node: The node to reboot :type node: :class:`Node` :rtype: ``bool`` Z rebootServerr� zserver/rebootServerr` ra r� r� r� r� rC rC rL � reboot_node� r� z#DimensionDataNodeDriver.reboot_nodec C s8 g } | j ||||||||| | | d� D ]} | �| � q| S )aG List nodes deployed for your organization. :keyword ex_location: Filters the node list to nodes that are located in this location :type ex_location: :class:`NodeLocation` or ``str`` :keyword ex_name: Filters the node list to nodes that have this name :type ex_name ``str`` :keyword ex_ipv6: Filters the node list to nodes that have this ipv6 address :type ex_ipv6: ``str`` :keyword ex_ipv4: Filters the node list to nodes that have this ipv4 address :type ex_ipv4: ``str`` :keyword ex_vlan: Filters the node list to nodes that are in this VLAN :type ex_vlan: :class:`DimensionDataVlan` or ``str`` :keyword ex_image: Filters the node list to nodes that have this image :type ex_image: :class:`NodeImage` or ``str`` :keyword ex_deployed: Filters the node list to nodes that are deployed or not :type ex_deployed: ``bool`` :keyword ex_started: Filters the node list to nodes that are started or not :type ex_started: ``bool`` :keyword ex_state: Filters the node list by nodes that are in this state :type ex_state: ``str`` :keyword ex_network: Filters the node list to nodes in this network :type ex_network: :class:`DimensionDataNetwork` or ``str`` :keyword ex_network_domain: Filters the node list to nodes in this network domain :type ex_network_domain: :class:`DimensionDataNetworkDomain` or ``str`` :return: a list of `Node` objects :rtype: ``list`` of :class:`Node` ) �locationrQ �ipv6�ipv4r� r~ �deployed�started�stater[ �network_domain)�ex_list_nodes_paginated�extend)rH Z ex_locationZex_nameZex_ipv6Zex_ipv4r� Zex_imageZ ex_deployedZ ex_startedZex_stater� r� � node_list�nodesrC rC rL � list_nodes� s = � z"DimensionDataNodeDriver.list_nodesc C s2 i }|dur | � |�|d< | �| jjd|d�j�S )a� List images available Note: Currently only returns the default 'base OS images' provided by DimensionData. Customer images (snapshots) use ex_list_customer_images :keyword ex_location: Filters the node list to nodes that are located in this location :type ex_location: :class:`NodeLocation` or ``str`` :return: List of images available :rtype: ``list`` of :class:`NodeImage` N� datacenterIdz image/osImage��params��_location_to_location_id� _to_imagesrv rw ry �rH r� r� rC rC rL � list_images) s �z#DimensionDataNodeDriver.list_imagesc C s t dddddd| jjd�gS )z� return a list of available sizes Currently, the size of the node is dictated by the chosen OS base image, they cannot be set explicitly. @inherits: :class:`NodeDriver.list_sizes` � �defaultr )r� rQ Zramr� Z bandwidthZprice�driver)r rv r� �rH r� rC rC rL � list_sizes@ s ��z"DimensionDataNodeDriver.list_sizesc C s, i }|dur ||d< | � | jjd|d�j�S )a List locations (datacenters) available for instantiating servers and networks. :keyword ex_id: Filters the location list to this id :type ex_id: ``str`` :return: List of locations :rtype: ``list`` of :class:`NodeLocation` Nr� zinfrastructure/datacenterr� )� _to_locationsrv rw ry )rH �ex_idr� rC rC rL �list_locationsT s ��z&DimensionDataNodeDriver.list_locationsc C s2 d}|dur d| � |� }| �| j�d| �j�S )av List networks deployed across all data center locations for your organization. The response includes the location of each network. :keyword location: The location :type location: :class:`NodeLocation` or ``str`` :return: a list of DimensionDataNetwork objects :rtype: ``list`` of :class:`DimensionDataNetwork` � N�/znetworkWithLocation%s)r� � _to_networksrv �request_with_orgId_api_1ry )rH r� Zurl_extrC rC rL � list_networksi s �z%DimensionDataNodeDriver.list_networksc C sF t | jj�t d�k rtd��|du r|du rtd��|dur&|dur&td��t�ddti�}|t�|d�_ |t�|d �_ |durG|t�|d �_ |durS|t�|d �_ n|t�|d �_ |dure|t�|d �_ t |�dkr�|� � D ] \} } t�|d�} | t�| d�_ | dur�| t�| d�_ qo| jj ddt� |�d�j} t| dt�} | dv S )aF Import image :param ovf_package_name: Image OVF package name :type ovf_package_name: ``str`` :param name: Image name :type name: ``str`` :param cluster_id: Provide either cluster_id or datacenter_id :type cluster_id: ``str`` :param datacenter_id: Provide either cluster_id or datacenter_id :type datacenter_id: ``str`` :param description: Optional. Description of image :type description: ``str`` :param is_guest_os_customization: Optional. true for NGOC image :type is_guest_os_customization: ``bool`` :param tagkey_name_value_dictionaries: Optional tagkey name value dict :type tagkey_name_value_dictionaries: dictionaries :return: Return true if successful :rtype: ``bool`` �2.4zIimport image is feature is NOT supported in api version earlier than 2.4Nz3Either cluster_id or datacenter_id must be providedzJCannot accept both cluster_id and datacenter_id. Please provide either onezurn:importImage� xmlns:urnzurn:ovfPackagezurn:namezurn:descriptionz urn:clusterIdzurn:datacenterIdzurn:guestOsCustomizationr zurn:tagzurn:tagKeyNamez urn:valuezimage/importImager` ra r� r� )r rv �active_api_version� ExceptionrD r rk r rl rm �len�itemsrw rx ry r )rH Zovf_package_namerQ � cluster_id� datacenter_idrR Zis_guest_os_customizationZ tagkey_name_value_dictionariesZimport_image_elem�kr� �tag_elemr� r� rC rC rL � import_image} sF '�� � � �� z$DimensionDataNodeDriver.import_imagec C r� )z� Powers on an existing deployed server :param node: Node which should be used :type node: :class:`Node` :rtype: ``bool`` Z startServerr� zserver/startServerr` ra r� r� r� r� rC rC rL � start_node� s �� z"DimensionDataNodeDriver.start_nodec C r� )a� This function will attempt to "gracefully" stop a server by initiating a shutdown sequence within the guest operating system. A successful response on this function means the system has successfully passed the request into the operating system. :param node: Node which should be used :type node: :class:`Node` :rtype: ``bool`` ZshutdownServerr� zserver/shutdownServerr` ra r� r� r� r� rC rC rL � stop_node� � �� z!DimensionDataNodeDriver.stop_nodec c sF � i } |dur| � |�| d< |dur|| d< |dur || d< | dur&| | d< |dur.|| d< |dur6|| d< |dur>|| d< | durI| �| �| d < | durT| �| �| d < |dur_| �|�| d < |durj| �|�| d < | �| �} | �| �V | �d �| �d�kr�t| �d��d | d< | �| �} | �| �V | �d �| �d�ksdS dS )a Return a generator which yields node lists in pages :keyword location: Filters the node list to nodes that are located in this location :type location: :class:`NodeLocation` or ``str`` :keyword name: Filters the node list to nodes that have this name :type name ``str`` :keyword ipv6: Filters the node list to nodes that have this ipv6 address :type ipv6: ``str`` :keyword ipv4: Filters the node list to nodes that have this ipv4 address :type ipv4: ``str`` :keyword vlan: Filters the node list to nodes that are in this VLAN :type vlan: :class:`DimensionDataVlan` or ``str`` :keyword image: Filters the node list to nodes that have this image :type image: :class:`NodeImage` or ``str`` :keyword deployed: Filters the node list to nodes that are deployed or not :type deployed: ``bool`` :keyword started: Filters the node list to nodes that are started or not :type started: ``bool`` :keyword state: Filters the node list to nodes that are in this state :type state: ``str`` :keyword network: Filters the node list to nodes in this network :type network: :class:`DimensionDataNetwork` or ``str`` :keyword network_domain: Filters the node list to nodes in this network domain :type network_domain: :class:`DimensionDataNetworkDomain` or ``str`` :return: a list of `Node` objects :rtype: ``generator`` of `list` of :class:`Node` Nr� r� r� r� r� r� rQ r� r\ r� � sourceImageIdZ pageCount�pageSize� pageNumberr� ) r� r� ru r� rn �_list_nodes_single_page� _to_nodesrz �int)rH rQ r� r� r� r� r~ r� r� r� r[ r� r� Z nodes_objrC rC rL r� � s> �> �z/DimensionDataNodeDriver.ex_list_nodes_paginatedc C � | j |d�S �N�r� )r� �rH r� rC rC rL � ex_start_nodeR s z%DimensionDataNodeDriver.ex_start_nodec C r r )r� r rC rC rL �ex_shutdown_gracefulX s z,DimensionDataNodeDriver.ex_shutdown_gracefulc C sz t �dt|jd��}z| jjddt �|�d�j}t|dt�}W |dv S t t t fy< | � |j�}|j �� }Y |dv S w )a� This function will abruptly power-off a server. Unlike ex_shutdown_graceful, success ensures the node will stop but some OS and application configurations may be adversely affected by the equivalent of pulling the power plug out of the machine. :param node: Node which should be used :type node: :class:`Node` :rtype: ``bool`` ZpowerOffServerr� zserver/powerOffServerr` ra r� )r� r� �STOPPED�STOPPING)r rk r r� rv rw rx ry r r& � NameErrorr r{ r� �upper)rH r� r� r� r� �rrC rC rL � ex_power_off[ s ��� �z$DimensionDataNodeDriver.ex_power_offc C r� )a� This function will abruptly reset a server. Unlike reboot_node, success ensures the node will restart but some OS and application configurations may be adversely affected by the equivalent of pulling the power plug out of the machine. :param node: Node which should be used :type node: :class:`Node` :rtype: ``bool`` Z resetServerr� zserver/resetServerr` ra r� r� r� r� rC rC rL �ex_resett r� z DimensionDataNodeDriver.ex_resetc C r� )z� This function triggers an update of the VMware Tools software running on the guest OS of a Server. :param node: Node which should be used :type node: :class:`Node` :rtype: ``bool`` ZupdateVmwareToolsr� zserver/updateVmwareToolsr` ra r� r� r� r� rC rC rL �ex_update_vm_tools� r� z*DimensionDataNodeDriver.ex_update_vm_toolsc C s� i }|dur ||d< |dur||d< |dur t |�|d< |dur&t |�|d< | jjd|j dt|d�d �j}t|d t�}|d v S ) a2 Update the node, the name, CPU or RAM :param node: Node which should be used :type node: :class:`Node` :param name: The new name (optional) :type name: ``str`` :param description: The new description (optional) :type description: ``str`` :param cpu_count: The new CPU count (optional) :type cpu_count: ``int`` :param ram_mb: The new Memory in MB (optional) :type ram_mb: ``int`` :rtype: ``bool`` NrQ rR �cpuCountZmemoryz server/%sr` Tra �result�r� �SUCCESS)ro rv r� r� r ry r r ) rH r� rQ rR rs Zram_mbrc r� r� rC rC rL �ex_update_node� s �� z&DimensionDataNodeDriver.ex_update_nodec C sr t |ttf�s td��t�ddti�}|D ] }| �|�t�|d�_ q| j j ddt� |�d�j }t|dt�}|d v S ) ai Create an anti affinity rule given a list of nodes Anti affinity rules ensure that servers will not reside on the same VMware ESX host :param node_list: The list of nodes to create a rule for :type node_list: ``list`` of :class:`Node` or ``list`` of ``str`` :rtype: ``bool`` z$Node list must be a list or a tuple.ZNewAntiAffinityRulerP re �antiAffinityRuler` ra r r )ri r� r� r� r rk r �_node_to_node_idrl rm rv r� rx ry r r )rH r� Zanti_affinity_xml_requestr� r r� rC rC rL � ex_create_anti_affinity_rule� s �� z4DimensionDataNodeDriver.ex_create_anti_affinity_rulec C s4 | � |�}| jjd| dd�j}t|dt�}|dv S )a Remove anti affinity rule :param anti_affinity_rule: The anti affinity rule to delete :type anti_affinity_rule: :class:`DimensionDataAntiAffinityRule` or ``str`` :rtype: ``bool`` zantiAffinityRule/%s?delete�GET�rb r r )�,_anti_affinity_rule_to_anti_affinity_rule_idrv r� ry r r )rH Zanti_affinity_rule�rule_idr r� rC rC rL � ex_delete_anti_affinity_rule� s �� z4DimensionDataNodeDriver.ex_delete_anti_affinity_rulec C s� dd� |||fD �}t |�dkrtd��i }|dur!| �|�|d< |dur,| �|�|d< |dur7| �|�|d< |dur?||d < |durG||d < | jjd d |d �}g } |D ] } | �| �| �� qT| S )aZ List anti affinity rules for a network, network domain, or node :param network: The network to list anti affinity rules for One of network, network_domain, or node is required :type network: :class:`DimensionDataNetwork` or ``str`` :param network_domain: The network domain to list anti affinity rules One of network, network_domain, or node is required :type network_domain: :class:`DimensionDataNetworkDomain` or ``str`` :param node: The node to list anti affinity rules for One of network, netwok_domain, or node is required :type node: :class:`Node` or ``str`` :param filter_id: This will allow you to filter the rules by this node id :type filter_id: ``str`` :type filter_state: This will allow you to filter rules by node state (i.e. NORMAL) :type filter_state: ``str`` :rtype: ``list`` of :class:`DimensionDataAntiAffinityRule` c S s g | ]}|d ur|�qS �NrC )�.0r< rC rC rL � <listcomp> s zGDimensionDataNodeDriver.ex_list_anti_affinity_rules.<locals>.<listcomp>r� z@One and ONLY one of network, network_domain, or node must be setNr� r\ re r� r� zserver/antiAffinityRuler �rb r� ) r� rD r� ru r rv �"paginated_request_with_orgId_api_2r� �_to_anti_affinity_rules) rH r[ r� r� Z filter_idZ filter_stateZnot_none_argumentsr� � paged_result�rulesr rC rC rL �ex_list_anti_affinity_rules� s* " �z3DimensionDataNodeDriver.ex_list_anti_affinity_rulesc C s� t �ddti�}|jt �|d�_t �|d�}|dur#|jt �|d�_n|dur/|t �|d�_ntd��| jjd d t � |�d �j }t |d t�}|d v S )a Attach a node to a VLAN by adding an additional NIC to the node on the target VLAN. The IP will be automatically assigned based on the VLAN IP network space. Alternatively, provide a private IPv4 address instead of VLAN information, and this will be assigned to the node on corresponding NIC. :param node: Node which should be used :type node: :class:`Node` :param vlan: VLAN to attach the node to (required unless private_ipv4) :type vlan: :class:`DimensionDataVlan` :keyword private_ipv4: Private nic IPv4 Address (required unless vlan) :type private_ipv4: ``str`` :rtype: ``bool`` ZaddNicrP re r� Nr� r� z-One of vlan or primary_ipv4 must be specifiedz server/addNicr` ra r� r� ) r rk r r� rl rm rD rv rw rx ry r )rH r� r� Z private_ipv4�requestr� r� r� rC rC rL �ex_attach_node_to_vlan! s �� z.DimensionDataNodeDriver.ex_attach_node_to_vlanc C s@ t �dt|d��}| jjddt �|�d�j}t|dt�}|dv S )z� Remove a NIC on a node, removing the node from a VLAN :param nic_id: The identifier of the NIC to remove :type nic_id: ``str`` :rtype: ``bool`` Z removeNicr� zserver/removeNicr` ra r� r� )r rk r rv rw rx ry r )rH �nic_idr) r� r� rC rC rL �ex_destroy_nicG s �� z&DimensionDataNodeDriver.ex_destroy_nicc C r )ax List networks deployed across all data center locations for your organization. The response includes the location of each network. :param location: The target location :type location: :class:`NodeLocation` or ``str`` :return: a list of DimensionDataNetwork objects :rtype: ``list`` of :class:`DimensionDataNetwork` �r� )r� r� rC rC rL �ex_list_networksX s z(DimensionDataNodeDriver.ex_list_networksc s� | � |�}t�ddti�}� t�|d�_|dur |t�|d�_|t�|d�_| jjddt�|�d � t t � fd d �| � |���d }|S ) a� Create a new network in an MCP 1.0 location :param location: The target location (MCP1) :type location: :class:`NodeLocation` or ``str`` :param name: The name of the network :type name: ``str`` :param description: Additional description of the network :type description: ``str`` :return: A new instance of `DimensionDataNetwork` :rtype: Instance of :class:`DimensionDataNetwork` ZNewNetworkWithLocationrP rQ NrR r� ZnetworkWithLocationr` ra c � | j � kS r �rQ ��xr0 rC rL �<lambda>� � z;DimensionDataNodeDriver.ex_create_network.<locals>.<lambda>r ) r� r rk r rl rm rv r� rx r� �filterr. )rH r� rQ rR Znetwork_locationr: r[ rC r0 rL �ex_create_networke s � z)DimensionDataNodeDriver.ex_create_networkc C s, | j jd|j dd�j}t|dt�}|dkS )z� Delete a network from an MCP 1 data center :param network: The network to delete :type network: :class:`DimensionDataNetwork` :rtype: ``bool`` znetwork/%s?deleter r r r �rv r� r� ry r r )rH r[ r� r� rC rC rL �ex_delete_network� s �� z)DimensionDataNodeDriver.ex_delete_networkc C s2 | j jd|j dd| d�j}t|dt�}|dkS )a Rename a network in MCP 1 data center :param network: The network to rename :type network: :class:`DimensionDataNetwork` :param new_name: The new name of the network :type new_name: ``str`` :rtype: ``bool`` z network/%sr` zname=%sra r r r7 )rH r[ �new_namer� r� rC rC rL �ex_rename_network� s �� z)DimensionDataNodeDriver.ex_rename_networkc C �& | � � }| j�d| �j}| �||�S )z� Get an individual Network Domain, by identifier :param network_domain_id: The identifier of the network domain :type network_domain_id: ``str`` :rtype: :class:`DimensionDataNetworkDomain` znetwork/networkDomain/%s)r� rv rw ry �_to_network_domain)rH �network_domain_id� locations�netrC rC rL �ex_get_network_domain� s �� z-DimensionDataNodeDriver.ex_get_network_domainc C sf i }|dur | � |�|d< |dur||d< |dur ||d< |dur%||d< | jjd|d�j}| �|�S )a List networks domains deployed across all data center locations domain. for your organization. The response includes the location of each network :param location: Only network domains in the location (optional) :type location: :class:`NodeLocation` or ``str`` :param name: Only network domains of this name (optional) :type name: ``str`` :param service_plan: Only network domains of this type (optional) :type service_plan: ``str`` :param state: Only network domains in this state (optional) :type state: ``str`` :return: a list of `DimensionDataNetwork` objects :rtype: ``list`` of :class:`DimensionDataNetwork` Nr� rQ �typer� znetwork/networkDomainr� )r� rv rw ry �_to_network_domains)rH r� rQ � service_planr� r� r� rC rC rL �ex_list_network_domains� s �� z/DimensionDataNodeDriver.ex_list_network_domainsc C s� t �ddti�}| �|�t �|d�_|t �|d�_|dur$|t �|d�_|t �|d�_| jjdd t �|�d �j }d}t |d t�D ]}|� d�d krN|� d �}q@t ||||t j|d�S )a� Deploy a new network domain to a data center :param location: The data center to list :type location: :class:`NodeLocation` or ``str`` :param name: The name of the network domain to create :type name: ``str`` :param service_plan: The service plan, either "ESSENTIALS" or "ADVANCED" :type service_plan: ``str`` :param description: An additional description of the network domain :type description: ``str`` :return: an instance of `DimensionDataNetworkDomain` :rtype: :class:`DimensionDataNetworkDomain` ZdeployNetworkDomainrP r� rQ NrR rA znetwork/deployNetworkDomainr` ra rd r� rf )r� rQ rR r� �status�plan)r rk r r� rl rm rv rw rx ry r rz r* r �RUNNING) rH r� rQ rC rR r: r� r= rd rC rC rL �ex_create_network_domain� s0 �� ��z0DimensionDataNodeDriver.ex_create_network_domainc C sv t �ddti�}|�d|j� |jt �|d�_|jdur$|jt �|d�_|j t �|d�_| j j dd t � |�d �j |S ) aE Update the properties of a network domain :param network_domain: The network domain with updated properties :type network_domain: :class:`DimensionDataNetworkDomain` :return: an instance of `DimensionDataNetworkDomain` :rtype: :class:`DimensionDataNetworkDomain` ZeditNetworkDomainrP r� rQ NrR rA znetwork/editNetworkDomainr` ra )r rk r rq r� rQ rl rm rR rF rv rw rx ry )rH r� � edit_noderC rC rL �ex_update_network_domain s �z0DimensionDataNodeDriver.ex_update_network_domainc C �L t �ddti�}|�d|j� | jjddt �|�d�j}t |dt�}|dv S ) z� Delete a network domain :param network_domain: The network domain to delete :type network_domain: :class:`DimensionDataNetworkDomain` :rtype: ``bool`` ZdeleteNetworkDomainrP r� znetwork/deleteNetworkDomainr` ra r� r� � r rk r rq r� rv rw rx ry r )rH r� � delete_noder r� rC rC rL �ex_delete_network_domain! � �� z0DimensionDataNodeDriver.ex_delete_network_domain� c C s� t �ddti�}|jt �|d�_|t �|d�_|dur"|t �|d�_|t �|d�_t|�t �|d�_| jjd d t � |�d �j }d}t |d t�D ]} | � d�d krU| � d�}qG| � |�S )a- Deploy a new VLAN to a network domain :param network_domain: The network domain to add the VLAN to :type network_domain: :class:`DimensionDataNetworkDomain` :param name: The name of the VLAN to create :type name: ``str`` :param private_ipv4_base_address: The base IPv4 address e.g. 192.168.1.0 :type private_ipv4_base_address: ``str`` :param description: An additional description of the VLAN :type description: ``str`` :param private_ipv4_prefix_size: The size of the IPv4 address space, e.g 24 :type private_ipv4_prefix_size: ``int`` :return: an instance of `DimensionDataVlan` :rtype: :class:`DimensionDataVlan` Z deployVlanrP r� rQ NrR ZprivateIpv4BaseAddress�privateIpv4PrefixSizeznetwork/deployVlanr` ra rd r� rf )r rk r r� rl rm ro rv rw rx ry r rz � ex_get_vlan) rH r� rQ Zprivate_ipv4_base_addressrR Zprivate_ipv4_prefix_sizer: r� r� rd rC rC rL �ex_create_vlan3 s$ �� � z&DimensionDataNodeDriver.ex_create_vlanc C r; )z� Get a single VLAN, by it's identifier :param vlan_id: The identifier of the VLAN :type vlan_id: ``str`` :return: an instance of `DimensionDataVlan` :rtype: :class:`DimensionDataVlan` znetwork/vlan/%s)r� rv rw ry �_to_vlan)rH r� r> r� rC rC rL rR f s z#DimensionDataNodeDriver.ex_get_vlanc C sf t �ddti�}|�d|j� |jt �|d�_|jdur$|jt �|d�_| j j ddt � |�d �j |S ) a4 Updates the properties of the given VLAN Only name and description are updated :param vlan: The VLAN to update :type vlan: :class:`DimensionDataNetworkDomain` :return: an instance of `DimensionDataVlan` :rtype: :class:`DimensionDataVlan` ZeditVlanrP r� rQ NrR znetwork/editVlanr` ra ) r rk r rq r� rQ rl rm rR rv rw rx ry �rH r� rI rC rC rL �ex_update_vlant s �z&DimensionDataNodeDriver.ex_update_vlanc C sL t �ddti�}|�d|j� |jt �|d�_| jj ddt � |�d�j |S )a� Expands the VLAN to the prefix size in private_ipv4_range_size The expansion will not be permitted if the proposed IP space overlaps with an already deployed VLANs IP space. :param vlan: The VLAN to update :type vlan: :class:`DimensionDataNetworkDomain` :return: an instance of `DimensionDataVlan` :rtype: :class:`DimensionDataVlan` Z expandVlanrP r� rQ znetwork/expandVlanr` ra ) r rk r rq r� �private_ipv4_range_sizerl rm rv rw rx ry rU rC rC rL �ex_expand_vlan� s �z&DimensionDataNodeDriver.ex_expand_vlanc C rK ) z� Deletes an existing VLAN :param vlan: The VLAN to delete :type vlan: :class:`DimensionDataNetworkDomain` :rtype: ``bool`` Z deleteVlanrP r� znetwork/deleteVlanr` ra r� r� rL )rH r� rM r r� rC rC rL �ex_delete_vlan� rO z&DimensionDataNodeDriver.ex_delete_vlanc C s� i }|dur | � |�|d< |dur| �|�|d< |dur ||d< |dur(||d< |dur0||d< |dur8||d< | jjd|d �j}| �|�S ) a� List VLANs available, can filter by location and/or network domain :param location: Only VLANs in this location (optional) :type location: :class:`NodeLocation` or ``str`` :param network_domain: Only VLANs in this domain (optional) :type network_domain: :class:`DimensionDataNetworkDomain` :param name: Only VLANs with this name (optional) :type name: ``str`` :param ipv4_address: Only VLANs with this ipv4 address (optional) :type ipv4_address: ``str`` :param ipv6_address: Only VLANs with this ipv6 address (optional) :type ipv6_address: ``str`` :param state: Only VLANs with this state (optional) :type state: ``str`` :return: a list of DimensionDataVlan objects :rtype: ``list`` of :class:`DimensionDataVlan` Nr� r� rQ ZprivateIpv4AddressZ ipv6Addressr� z network/vlanr� )r� r� rv rw ry � _to_vlans) rH r� r� rQ Z ipv4_addressZ ipv6_addressr� r� r� rC rC rL � ex_list_vlans� s ! z%DimensionDataNodeDriver.ex_list_vlansc C sr t �ddti�}|jt �|d�_| jjddt �|�d�j }d }t |dt�D ]}|� d�d kr3|� d �}q%| � |�S ) NZaddPublicIpBlockrP r� znetwork/addPublicIpBlockr` ra rd rQ Z ipBlockIdrf ) r rk r r� rl rm rv rw rx ry r rz �ex_get_public_ip_block)rH r� Zadd_noder� �block_idrd rC rC rL �(ex_add_public_ip_block_to_network_domain� s �� � z@DimensionDataNodeDriver.ex_add_public_ip_block_to_network_domainc C s* i }|j |d< | jjd|d�j}| �|�S )Nr� znetwork/publicIpBlockr� )r� rv rw ry � _to_ip_blocks�rH r� r� r� rC rC rL �ex_list_public_ip_blocks� s �� z0DimensionDataNodeDriver.ex_list_public_ip_blocksc C r; )Nznetwork/publicIpBlock/%s)r� rv rw ry � _to_ip_block)rH r] r> �blockrC rC rL r\ � s �� z.DimensionDataNodeDriver.ex_get_public_ip_blockc C rK ) NZremovePublicIpBlockrP r� znetwork/removePublicIpBlockr` ra r� r� rL )rH rc rM r r� rC rC rL �ex_delete_public_ip_block s �� z1DimensionDataNodeDriver.ex_delete_public_ip_blockc C � | j �d| �j}| �|�S )Nzserver/server/%s)rv rw ry �_to_node)rH r� r� rC rC rL r{ s z)DimensionDataNodeDriver.ex_get_node_by_id�2 r� c C s6 ||d�}| � |�|d< | jjd|d�j}| �||�S )N)r r r� znetwork/firewallRuler� )r� rv rw ry �_to_firewall_rules)rH r� Z page_sizeZ page_numberr� r� rC rC rL �ex_list_firewall_rules s �� z.DimensionDataNodeDriver.ex_list_firewall_rulesc C s. d}d}t �ddti�}| �|�t �|d�_|jt �|d�_|jt �|d�_|jt �|d�_|j t �|d �_t �|d �}|j j d urNt �|d �} |j j | _n)t �|d �} |j j r_| � dd� n| � d|j j� |j jd urw| � dt|j j�� |j jd ur�t �|d�} |j j| _n"|j jd ur�t �|d�} | � d|j j� |j jd ur�| � d|j j� t �|d�} |jj d ur�t �| d �} |jj | _n't �| d �} |jj r�| � dd� n| � d|jj� |jjd ur�| � d|jj� |jjd ur�t �| d�} |jj| _n$|jjd u�rt �| d�} | � d|jj� |jjd u�r | � d|jj� t|j��� t �|d�_t �|d�}|d u�rX||v�rEtdd�|� ��t|t��rO|j}n|}|� d|� n||v�rftdd�|� ��|� d |� | jj d d t � |�d �j }d }t |d t�D ]}|� d�d!k�r�|� d"�}�q�||_!|S )#a� Creates a firewall rule :param network_domain: The network domain in which to create the firewall rule :type network_domain: :class:`DimensionDataNetworkDomain` or ``str`` :param rule: The rule in which to create :type rule: :class:`DimensionDataFirewallRule` :param position: The position in which to create the rule There are two types of positions with position_relative_to_rule arg and without it With: 'BEFORE' or 'AFTER' Without: 'FIRST' or 'LAST' :type position: ``str`` :param position_relative_to_rule: The rule or rule name in which to decide positioning by :type position_relative_to_rule: :class:`DimensionDataFirewallRule` or ``str`` :rtype: ``bool`` �ZFIRSTZLAST�ZBEFOREZAFTERZcreateFirewallRulerP r� rQ �action� ipVersion�protocol�sourceN�ipAddressListIdr� �address�ANY� prefixSize� portListIdr@ �begin�end� destination�enabled� placement�?When position_relative_to_rule is specified position must be %s�, �relativeToRule�CWhen position_relative_to_rule is not specified position must be %s�positionznetwork/createFirewallRuler` ra rd ZfirewallRuleIdrf )"r rk r r� rl rm rQ rl � ip_versionrn ro �address_list_id�any_iprq � ip_address�ip_prefix_sizero � port_list_id� port_begin�port_endrw rx rp rD �joinri r' rv rw rx ry r rz r� )rH r� �ruler~ Zposition_relative_to_rule�positions_without_rule�positions_with_ruler: ro � source_ip� source_port�dest�dest_ip� dest_portry � rule_namer� r rd rC rC rL �ex_create_firewall_rule s� � �� �� �� �z/DimensionDataNodeDriver.ex_create_firewall_rulec C s� d}d}t �dt|jd��}|jt �|d�_|jt �|d�_t �|d�}|jj dur6t �|d �}|jj |_n)t �|d �}|jj rG|� d d � n|� d |jj � |jj dur_|� d t|jj �� |jjdurqt �|d�} |jj| _n"|jjdur�t �|d�} | � d|jj� |jjdur�| � d|jj� t �|d�} |jj dur�t �| d �} |jj | _n't �| d �} |jj r�| � d d � n| � d |jj � |jj dur�| � d |jj � |jjdur�t �| d�} |jj| _n#|jjdur�t �| d�} | � d|jj� |jjdu�r| � d|jj� t|j��� t �|d�_t �|d�} |du�r?||v�r,tdd�|� ��t|t��r6|j}n|}| � d|� n||v�rMtdd�|� ��| � d|� | jjddt � |�d �j }t |d t�}|d v S ) a� Edit a firewall rule >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> >>> # List firewall rules >>> firewall_rules = driver.ex_list_firewall_rules(my_network_domain) >>> >>> # Get Firewall Rule by name >>> pprint("List specific firewall rule by name") >>> fire_rule_under_test = (list(filter(lambda x: x.name == 'My_New_Firewall_Rule', firewall_rules))[0]) >>> pprint(fire_rule_under_test.source) >>> pprint(fire_rule_under_test.destination) >>> >>> # Edit Firewall >>> fire_rule_under_test.destination.address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> fire_rule_under_test.destination.port_list_id = 'b6557c5a-45fa-4138-89bd-8fe68392691b' >>> result = driver.ex_edit_firewall_rule(fire_rule_under_test, 'LAST') >>> pprint(result) :param rule: (required) The rule in which to create :type rule: :class:`DimensionDataFirewallRule` :param position: (required) There are two types of positions with position_relative_to_rule arg and without it With: 'BEFORE' or 'AFTER' Without: 'FIRST' or 'LAST' :type position: ``str`` :param relative_rule_for_position: (optional) The rule or rule name in which to decide the relative rule for positioning. :type relative_rule_for_position: :class:`DimensionDataFirewallRule` or ``str`` :rtype: ``bool`` rj rk �editFirewallRuler� rl rn ro Nrp r� rq rr rs rt r@ ru rv rw rx ry rz r{ r| r} r~ �network/editFirewallRuler` ra r� r� ) r rk r r� rl rl rm rn ro r� r� rq r� r� ro r� r� r� rw rx rp rD r� ri r' rQ rv rw rx ry r )rH r� r~ Zrelative_rule_for_positionr� r� rI ro r� r� r� r� r� ry r� r� r� rC rC rL �ex_edit_firewall_rule� s� < �� �� �� z-DimensionDataNodeDriver.ex_edit_firewall_rulec C s( | � � }| j�d| �j}| �|||�S )Nznetwork/firewallRule/%s)r� rv rw ry �_to_firewall_rule)rH r� r r> r� rC rC rL �ex_get_firewall_rule s z,DimensionDataNodeDriver.ex_get_firewall_rulec C sb t �ddti�}|�d|j� t|��� t �|d�_| j j ddt � |�d�j }t |dt�}|d v S ) a( Change the state (enabled or disabled) of a rule :param rule: The rule to delete :type rule: :class:`DimensionDataFirewallRule` :param state: The desired state enabled (True) or disabled (False) :type state: ``bool`` :rtype: ``bool`` r� rP r� rx r� r` ra r� r� )r rk r rq r� ro rp rl rm rv rw rx ry r )rH r� r� � update_noder r� rC rC rL �ex_set_firewall_rule_state! s �� z2DimensionDataNodeDriver.ex_set_firewall_rule_statec C rK ) z� Delete a firewall rule :param rule: The rule to delete :type rule: :class:`DimensionDataFirewallRule` :rtype: ``bool`` ZdeleteFirewallRulerP r� znetwork/deleteFirewallRuler` ra r� r� rL �rH r� r� r r� rC rC rL �ex_delete_firewall_rule7 rO z/DimensionDataNodeDriver.ex_delete_firewall_rulec C s� t �ddti�}|jt �|d�_|t �|d�_|t �|d�_| jjddt �|�d�j }d }t |d t�D ]}|� d �d krA|� d �}q3t ||||t jd�S )a� Create a NAT rule :param network_domain: The network domain the rule belongs to :type network_domain: :class:`DimensionDataNetworkDomain` :param internal_ip: The IPv4 address internally :type internal_ip: ``str`` :param external_ip: The IPv4 address externally :type external_ip: ``str`` :rtype: :class:`DimensionDataNatRule` Z createNatRulerP r� � internalIp� externalIpznetwork/createNatRuler` ra Nrd rQ Z natRuleIdrf �r� r� � internal_ip� external_iprE )r rk r r� rl rm rv rw rx ry r rz r r rG )rH r� r� r� r: r r rd rC rC rL �ex_create_nat_ruleI s* �� ��z*DimensionDataNodeDriver.ex_create_nat_rulec C s, i }|j |d< | jjd|d�j}| �||�S )z� Get NAT rules for the network domain :param network_domain: The network domain the rules belongs to :type network_domain: :class:`DimensionDataNetworkDomain` :rtype: ``list`` of :class:`DimensionDataNatRule` r� znetwork/natRuler� )r� rv rw ry � _to_nat_rulesr` rC rC rL �ex_list_nat_rulesm s z)DimensionDataNodeDriver.ex_list_nat_rulesc C s | j �d| �j}| �||�S )a< Get a NAT rule by ID :param network_domain: The network domain the rule belongs to :type network_domain: :class:`DimensionDataNetworkDomain` :param rule_id: The ID of the NAT rule to fetch :type rule_id: ``str`` :rtype: :class:`DimensionDataNatRule` znetwork/natRule/%s)rv rw ry � _to_nat_rule)rH r� r r� rC rC rL �ex_get_nat_rule| s z'DimensionDataNodeDriver.ex_get_nat_rulec C rK ) z� Delete an existing NAT rule :param rule: The rule to delete :type rule: :class:`DimensionDataNatRule` :rtype: ``bool`` Z deleteNatRulerP r� znetwork/deleteNatRuler` ra r� r� rL r� rC rC rL �ex_delete_nat_rule� rO z*DimensionDataNodeDriver.ex_delete_nat_rulec C s d}|dur| j |d�d }|S )z� Get location by ID. :param id: ID of the node location which should be used :type id: ``str`` :rtype: :class:`NodeLocation` N)r� r )r� )rH r� r� rC rC rL �ex_get_location_by_id� s z-DimensionDataNodeDriver.ex_get_location_by_id� �< c O s | j j||||g|�R i |��S )a Wait for the function which returns a instance with field status to match Keep polling func until one of the desired states is matched :param state: Either the desired state (`str`) or a `list` of states :type state: ``str`` or ``list`` :param func: The function to call, e.g. ex_get_vlan :type func: ``function`` :param poll_interval: The number of seconds to wait between checks :type poll_interval: `int` :param timeout: The total number of seconds to wait to reach a state :type timeout: `int` :param args: The arguments for func :type args: Positional arguments :param kwargs: The arguments for func :type kwargs: Keyword arguments )rv Zwait_for_state)rH r� �funcZ poll_interval�timeout�argsrI rC rC rL �ex_wait_for_state� s z)DimensionDataNodeDriver.ex_wait_for_state� ESSENTIALSc C �Z t �ddti�}|�d|j� |t �|d�_| jjddt � |�d�j }t |dt�}|d v S ) a5 Enables cloud monitoring on a node :param node: The node to monitor :type node: :class:`Node` :param service_plan: The service plan, one of ESSENTIALS or ADVANCED :type service_plan: ``str`` :rtype: ``bool`` ZenableServerMonitoringrP r� � servicePlanz server/enableServerMonitoringr` ra r� r� � r rk r rq r� rl rm rv rw rx ry r �rH r� rC r� r r� rC rC rL �ex_enable_monitoring� � �� z,DimensionDataNodeDriver.ex_enable_monitoringc C r� ) aE Updates the service plan on a node with monitoring :param node: The node to monitor :type node: :class:`Node` :param service_plan: The service plan, one of ESSENTIALS or ADVANCED :type service_plan: ``str`` :rtype: ``bool`` ZchangeServerMonitoringPlanrP r� r� z!server/changeServerMonitoringPlanr` ra r� r� r� r� rC rC rL �ex_update_monitoring_plan� r� z1DimensionDataNodeDriver.ex_update_monitoring_planc C rK ) z� Disables cloud monitoring for a node :param node: The node to stop monitoring :type node: :class:`Node` :rtype: ``bool`` ZdisableServerMonitoringrP r� z server/disableServerMonitoringr` ra r� r� rL )rH r� r� r r� rC rC rL �ex_disable_monitoring� s �� z-DimensionDataNodeDriver.ex_disable_monitoring�STANDARDc C s� t �ddti�}|�d|j� t|�t �|d�_|�� t �|d�_|dur.t|�t �|d�_| j j dd t � |�d �j }t |d t�}|d v S ) a� Add storage to the node :param node: The server to add storage to :type node: :class:`Node` :param amount: The amount of storage to add, in GB :type amount: ``int`` :param speed: The disk speed type :type speed: ``str`` :param scsi_id: The target SCSI ID (optional) :type scsi_id: ``int`` :rtype: ``bool`` ZaddDiskrP r� �sizeGbrW Nr� zserver/addDiskr` ra r� r� )r rk r rq r� ro rl rm r rv rw rx ry r )rH r� �amountrW r� r� r r� rC rC rL �ex_add_storage_to_node s �� z.DimensionDataNodeDriver.ex_add_storage_to_nodec s( � fdd�|j d D �d }| �|j�S )z� Remove storage from a node :param node: The server to add storage to :type node: :class:`Node` :param scsi_id: The ID of the disk to remove :type scsi_id: ``str`` :rtype: ``bool`` c � g | ] }|j � kr|�qS rC �r� )r! r� r� rC rL r" 7 � zGDimensionDataNodeDriver.ex_remove_storage_from_node.<locals>.<listcomp>�disksr )r} �ex_remove_storager� )rH r� r� r� rC r� rL �ex_remove_storage_from_node+ s z3DimensionDataNodeDriver.ex_remove_storage_from_nodec C sJ t �ddti�}|�d|� | jjddt �|�d�j}t|dt�}|dv S ) z� Remove storage from a node :param node: The server to add storage to :type node: :class:`Node` :param disk_id: The ID of the disk to remove :type disk_id: ``str`` :rtype: ``bool`` Z removeDiskrP r� zserver/removeDiskr` ra r� r� ) r rk r rq rv rw rx ry r )rH �disk_idZ remove_diskr r� rC rC rL r� : s �� z)DimensionDataNodeDriver.ex_remove_storagec C sV t �ddti�}|t �|d�_| jjd�|j|�dt � |�d�j }t |dt �}|dv S ) ae Change the speed (disk tier) of a disk :param node: The server to change the disk speed of :type node: :class:`Node` :param disk_id: The ID of the disk to change :type disk_id: ``str`` :param speed: The disk speed type e.g. STANDARD :type speed: ``str`` :rtype: ``bool`` ZChangeDiskSpeedrP rW z server/{}/disk/{}/changeSpeedr` ra r r ) r rk r rl rm rv r� �formatr� rx ry r r )rH r� r� rW r: r r� rC rC rL �ex_change_storage_speedN s �� z/DimensionDataNodeDriver.ex_change_storage_speedc C sZ t �ddti�}t|�t �|d�_| jjd�|j |�dt � |�d�j }t |dt �}|dv S ) aB Change the size of a disk :param node: The server to change the disk of :type node: :class:`Node` :param disk_id: The ID of the disk to resize :type disk_id: ``str`` :param size: The disk size in GB :type size: ``int`` :rtype: ``bool`` ZChangeDiskSizerP Z newSizeGbz server/{}/disk/{}/changeSizer` ra r r )r rk r ro rl rm rv r� r� r� rx ry r r )rH r� r� �sizer: r r� rC rC rL �ex_change_storage_sizeg s �� z.DimensionDataNodeDriver.ex_change_storage_sizec C s� t �ddti�}|�d|j� |dur t|�t �|d�_|dur)t|�t �|d�_|dur4|t �|d�_|durAt|�t �|d�_| jj d d t � |�d �j }t |d t�}|d v S )aW Reconfigure the virtual hardware specification of a node :param node: The server to change :type node: :class:`Node` :param memory_gb: The amount of memory in GB (optional) :type memory_gb: ``int`` :param cpu_count: The number of CPU (optional) :type cpu_count: ``int`` :param cores_per_socket: Number of CPU cores per socket (optional) :type cores_per_socket: ``int`` :param cpu_performance: CPU Performance type (optional) :type cpu_performance: ``str`` :rtype: ``bool`` ZreconfigureServerrP r� NrZ r ZcpuSpeedrY zserver/reconfigureServerr` ra r� r� ) r rk r rq r� ro rl rm rv rw rx ry r ) rH r� Z memory_gbrs rt Zcpu_performance�updater r� rC rC rL �ex_reconfigure_node� s" �� z+DimensionDataNodeDriver.ex_reconfigure_nodec C s4 |du rd}| � |�}t| jj�td�k r"| j�d�|||��j} nZt�d|t d��} |t� | d�_ |dur=|t� | d�_ |durH|t� | d �_ |durS|t� | d �_ |durot� | d �} |t� | d �_ |duro|t� | d �_ | jj ddt� | �d�j} t| jj�td�k r�t| dt�} | dv S t| dt �} | dv S )a] Clone a server into a customer image. :param node: The server to clone :type node: :class:`Node` :param image_name: The name of the clone image :type image_name: ``str`` :param description: The description of the image :type description: ``str`` :rtype: ``bool`` Nr� r� zserver/{}?clone={}&desc={}Z cloneServer)r� rP Z imageNamerR Z clusterIdZguestOsCustomization�tagById�tagKeyIdrf zserver/cloneServerr` ra r r� r )r r rv r� r� r� ry r rk r rl rm rw rx r r ) rH r� Z image_nameZimage_descriptionr� Zis_guest_Os_Customization� tag_key_idZ tag_valuer� r� Zclone_server_elemr� r� rC rC rL �ex_clone_node_to_image� sB �� � �� �z.DimensionDataNodeDriver.ex_clone_node_to_imagec C �J | � |�}t�dt|d��}| jjddt�|�d�j}t|dt�}|dv S )z� Removes a node that has failed to deploy :param node: The failed node to clean :type node: :class:`Node` or ``str`` Z cleanServerr� zserver/cleanServerr` ra r� r� ) r r rk r rv rw rx ry r )rH r� r� r� r� r� rC rC rL �ex_clean_failed_deployment� s �� z2DimensionDataNodeDriver.ex_clean_failed_deploymentc C s4 i }|dur | � |�|d< | �| jjd|d�jd�S )z� Return a list of customer imported images :param location: The target location :type location: :class:`NodeLocation` or ``str`` :rtype: ``list`` of :class:`NodeImage` Nr� zimage/customerImager� � customerImager� r� rC rC rL �ex_list_customer_images� s �z/DimensionDataNodeDriver.ex_list_customer_imagesc C re )z� Gets a Base image in the Dimension Data Cloud given the id :param id: The id of the image :type id: ``str`` :rtype: :class:`NodeImage` zimage/osImage/%s�rv rw ry � _to_image�rH r� r~ rC rC rL �ex_get_base_image_by_id � z/DimensionDataNodeDriver.ex_get_base_image_by_idc C re )z� Gets a Customer image in the Dimension Data Cloud given the id :param id: The id of the image :type id: ``str`` :rtype: :class:`NodeImage` zimage/customerImage/%sr� r� rC rC rL �ex_get_customer_image_by_id r� z3DimensionDataNodeDriver.ex_get_customer_image_by_idc C sJ z| � |�W S ty } z |jdkr|�W Y d}~nd}~ww | �|�S )a� Gets a Base/Customer image in the Dimension Data Cloud given the id Note: This first checks the base image If it is not a base image we check if it is a customer image If it is not in either of these a DimensionDataAPIException is thrown :param id: The id of the image :type id: ``str`` :rtype: :class:`NodeImage` ZRESOURCE_NOT_FOUNDN)r� r& �coder� )rH r� �erC rC rL �ex_get_image_by_id% s ��� z*DimensionDataNodeDriver.ex_get_image_by_idc C s� t �ddti�}|t �|d�_|dur|t �|d�_t|��� t �|d�_t|��� t �|d�_| jjdd t � |�d �j }t |d t�}|d v S ) am Creates a tag key in the Dimension Data Cloud :param name: The name of the tag key (required) :type name: ``str`` :param description: The description of the tag key :type description: ``str`` :param value_required: If a value is required for the tag Tags themselves can be just a tag, or be a key/value pair :type value_required: ``bool`` :param display_on_report: Should this key show up on the usage reports :type display_on_report: ``bool`` :rtype: ``bool`` Z createTagKeyrP rQ NrR � valueRequired�displayOnReportztag/createTagKeyr` ra r� r� ) r rk r rl rm ro rp rv rw rx ry r )rH rQ rR �value_required�display_on_reportZcreate_tag_keyr� r� rC rC rL �ex_create_tag_key: s �� z)DimensionDataNodeDriver.ex_create_tag_keyc C s� i }|dur ||d< |dur||d< |dur t |��� |d< |dur*t |��� |d< | jjdd|d�}g }|D ] }|�| �|�� q7|S ) a| List tag keys in the Dimension Data Cloud :param id: Filter the list to the id of the tag key :type id: ``str`` :param name: Filter the list to the name of the tag key :type name: ``str`` :param value_required: Filter the list to if a value is required for a tag key :type value_required: ``bool`` :param display_on_report: Filter the list to if the tag key should show up on usage reports :type display_on_report: ``bool`` :rtype: ``list`` of :class:`DimensionDataTagKey` Nr� rQ r� r� z tag/tagKeyr r# )ro rp rv r$ r� � _to_tag_keys) rH r� rQ r� r� r� r& �tag_keysr rC rC rL �ex_list_tag_keys\ s �z(DimensionDataNodeDriver.ex_list_tag_keysc C re )z� Get a specific tag key by ID :param id: ID of the tag key you want (required) :type id: ``str`` :rtype: :class:`DimensionDataTagKey` z tag/tagKey/%s)rv rw ry � _to_tag_key)rH r� �tag_keyrC rC rL �ex_get_tag_key_by_id� r� z,DimensionDataNodeDriver.ex_get_tag_key_by_idc C s, | j |d�}t|�dkrtd| ��|d S )z� Get a specific tag key by Name :param name: Name of the tag key you want (required) :type name: ``str`` :rtype: :class:`DimensionDataTagKey` r0 r� zNo tags found with name %sr )r� r� rD )rH rQ r� rC rC rL �ex_get_tag_key_by_name� s z.DimensionDataNodeDriver.ex_get_tag_key_by_namec C s� | � |�}t�dt|d��}|dur|t�|d�_|dur$|t�|d�_|dur3t|��� t�|d�_|durBt|��� t�|d�_| jj dd t� |�d �j }t |d t�} | d v S ) a� Modify a specific tag key :param tag_key: The tag key you want to modify (required) :type tag_key: :class:`DimensionDataTagKey` or ``str`` :param name: Set to modify the name of the tag key :type name: ``str`` :param description: Set to modify the description of the tag key :type description: ``str`` :param value_required: Set to modify if a value is required for the tag key :type value_required: ``bool`` :param display_on_report: Set to modify if this tag key should display on the usage reports :type display_on_report: ``bool`` :rtype: ``bool`` Z editTagKeyr� NrQ rR r� r� ztag/editTagKeyr` ra r� r� ) �_tag_key_to_tag_key_idr rk r rl rm ro rp rv rw rx ry r ) rH r� rQ rR r� r� r� Zmodify_tag_keyr� r� rC rC rL �ex_modify_tag_key� s" �� z)DimensionDataNodeDriver.ex_modify_tag_keyc C r� )z� Modify a specific tag key :param tag_key: The tag key you want to remove (required) :type tag_key: :class:`DimensionDataTagKey` or ``str`` :rtype: ``bool`` Z deleteTagKeyr� ztag/deleteTagKeyr` ra r� r� ) r� r rk r rv rw rx ry r )rH r� r� Zremove_tag_keyr� r� rC rC rL �ex_remove_tag_key� s �� z)DimensionDataNodeDriver.ex_remove_tag_keyc C s� | � |�}| �|�}t�ddti�}|t�|d�_|jt�|d�_t�|d�}|t�|d�_|dur9|t�|d�_| jj d d t� |�d �j }t |d t�} | d v S )a� Apply a tag to a Dimension Data Asset :param asset: The asset to apply a tag to. (required) :type asset: :class:`Node` or :class:`NodeImage` or :class:`DimensionDataNewtorkDomain` or :class:`DimensionDataVlan` or :class:`DimensionDataPublicIpBlock` :param tag_key: The tag_key to apply to the asset. (required) :type tag_key: :class:`DimensionDataTagKey` or ``str`` :param value: The value to be assigned to the tag key This is only required if the :class:`DimensionDataTagKey` requires it :type value: ``str`` :rtype: ``bool`` Z applyTagsrP � assetType�assetId�tag� tagKeyNameNrf z tag/applyTagsr` ra r� r� � �_get_tagging_asset_type�_tag_key_to_tag_key_namer rk r rl rm r� rv rw rx ry r ) rH �assetr� rf � asset_type� tag_key_name� apply_tagsZtag_eler� r� rC rC rL �ex_apply_tag_to_asset� s �� z-DimensionDataNodeDriver.ex_apply_tag_to_assetc C s~ | � |�}| �|�}t�ddti�}|t�|d�_|jt�|d�_|t�|d�_| jj ddt� |�d�j }t |d t�}|d v S ) a� Remove a tag from an asset :param asset: The asset to remove a tag from. (required) :type asset: :class:`Node` or :class:`NodeImage` or :class:`DimensionDataNewtorkDomain` or :class:`DimensionDataVlan` or :class:`DimensionDataPublicIpBlock` :param tag_key: The tag key you want to remove (required) :type tag_key: :class:`DimensionDataTagKey` or ``str`` :rtype: ``bool`` Z removeTagsrP r� r� r� ztag/removeTagsr` ra r� r� r� )rH r� r� r� r� r� r� r� rC rC rL �ex_remove_tag_from_asset s �� z0DimensionDataNodeDriver.ex_remove_tag_from_assetc C s� i } |dur || d< |dur|| d< |dur | � |�| d< |dur%|| d< |dur-|| d< |dur5|| d< |durAt|��� | d< |durMt|��� | d < | jjd d | d �} g } | D ] } | �| �| �� qZ| S ) a List tags in the Dimension Data Cloud :param asset_id: Filter the list by asset id :type asset_id: ``str`` :param asset_type: Filter the list by asset type :type asset_type: ``str`` :param location: Filter the list by the assets location :type location: :class:``NodeLocation`` or ``str`` :param tag_key_name: Filter the list by a tag key name :type tag_key_name: ``str`` :param tag_key_id: Filter the list by a tag key id :type tag_key_id: ``str`` :param value: Filter the list by a tag value :type value: ``str`` :param value_required: Filter the list to if a value is required for a tag :type value_required: ``bool`` :param display_on_report: Filter the list to if the tag should show up on usage reports :type display_on_report: ``bool`` :rtype: ``list`` of :class:`DimensionDataTag` Nr� r� r� r� r� rf r� r� ztag/tagr r# )r� ro rp rv r$ r� �_to_tags) rH �asset_idr� r� r� r� rf r� r� r� r& �tagsr rC rC rL � ex_list_tags s0 *�z$DimensionDataNodeDriver.ex_list_tagsc C � | j �d�||��}| �|j�S )a+ Get summary usage information :param start_date: Start date for the report :type start_date: ``str`` in format YYYY-MM-DD :param end_date: End date for the report :type end_date: ``str`` in format YYYY-MM-DD :rtype: ``list`` of ``list`` z$report/usage?startDate={}&endDate={}�rv � raw_request_with_orgId_api_1r� � _format_csvr� �rH � start_date�end_dater rC rC rL �ex_summary_usage_reportd � � z/DimensionDataNodeDriver.ex_summary_usage_reportc C r� )a, Get detailed usage information :param start_date: Start date for the report :type start_date: ``str`` in format YYYY-MM-DD :param end_date: End date for the report :type end_date: ``str`` in format YYYY-MM-DD :rtype: ``list`` of ``list`` z,report/usageDetailed?startDate={}&endDate={}r� r� rC rC rL �ex_detailed_usage_reportu r z0DimensionDataNodeDriver.ex_detailed_usage_reportc C r� )a1 Get detailed software usage reports :param start_date: Start date for the report :type start_date: ``str`` in format YYYY-MM-DD :param end_date: End date for the report :type end_date: ``str`` in format YYYY-MM-DD :rtype: ``list`` of ``list`` z1report/usageSoftwareUnits?startDate={}&endDate={}r� r� rC rC rL �ex_software_usage_report� r z0DimensionDataNodeDriver.ex_software_usage_reportc C r� )a" Get audit log report :param start_date: Start date for the report :type start_date: ``str`` in format YYYY-MM-DD :param end_date: End date for the report :type end_date: ``str`` in format YYYY-MM-DD :rtype: ``list`` of ``list`` z auditlog?startDate={}&endDate={}r� r� rC rC rL �ex_audit_log_report� r z+DimensionDataNodeDriver.ex_audit_log_reportc C s, | � |�}| j�d|||f �}| �|j�S )a� Get audit log report :param start_date: Start date for the report :type start_date: ``str`` in format YYYY-MM-DD :param end_date: End date for the report :type end_date: ``str`` in format YYYY-MM-DD :keyword location: Filters the node list to nodes that are located in this location :type location: :class:`NodeLocation` or ``str`` :rtype: ``list`` of ``list`` z@backup/detailedUsageReport?datacenterId=%s&fromDate=%s&toDate=%s)r� rv r� r� r� )rH r� r� r� r� r rC rC rL �ex_backup_usage_report� s �� z.DimensionDataNodeDriver.ex_backup_usage_reportc C �* d| � |�i}| jjd|d�j}| �|�S )aw List IP Address List by network domain ID specified >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # List IP Address List of network domain >>> ipaddresslist_list = driver.ex_list_ip_address_list( >>> ex_network_domain=my_network_domain) >>> pprint(ipaddresslist_list) :param ex_network_domain: The network domain or network domain ID :type ex_network_domain: :class:`DimensionDataNetworkDomain` or 'str' :return: a list of DimensionDataIpAddressList objects :rtype: ``list`` of :class:`DimensionDataIpAddressList` r� znetwork/ipAddressListr� )r� rv rw ry �_to_ip_address_lists�rH r� r� r� rC rC rL �ex_list_ip_address_list� s "�� z/DimensionDataNodeDriver.ex_list_ip_address_listc s | � |�}tt� fdd�|��S )a� Get IP Address List by name in network domain specified >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # Get IP Address List by Name >>> ipaddresslist_list_by_name = driver.ex_get_ip_address_list( >>> ex_network_domain=my_network_domain, >>> ex_ip_address_list_name='My_IP_AddressList_1') >>> pprint(ipaddresslist_list_by_name) :param ex_network_domain: (required) The network domain or network domain ID in which ipaddresslist resides. :type ex_network_domain: :class:`DimensionDataNetworkDomain` or 'str' :param ex_ip_address_list_name: (required) Get 'IP Address List' by name :type ex_ip_address_list_name: :``str`` :return: a list of DimensionDataIpAddressList objects :rtype: ``list`` of :class:`DimensionDataIpAddressList` c r/ r r0 r1 ��ex_ip_address_list_namerC rL r3 r4 z@DimensionDataNodeDriver.ex_get_ip_address_list.<locals>.<lambda>)r r� r5 )rH r� r �ip_address_listsrC r rL �ex_get_ip_address_list� s *z.DimensionDataNodeDriver.ex_get_ip_address_listc C s� |du r |du r t d��t�ddti�}| �|�t�|d�_|t�|d�_|t�|d�_|t�|d�_|D ]#}t�|d �} | �d |j� |j rN| �d |j � |j rX| �d |j � q5|durg| � |�t�|d �_| j j ddt�|�d�j} t| dt�} | dv S )a� Create IP Address List. IP Address list. >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataIpAddress >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # IP Address collection >>> ipAddress_1 = DimensionDataIpAddress(begin='190.2.2.100') >>> ipAddress_2 = DimensionDataIpAddress(begin='190.2.2.106', end='190.2.2.108') >>> ipAddress_3 = DimensionDataIpAddress(begin='190.2.2.0', prefix_size='24') >>> ip_address_collection = [ipAddress_1, ipAddress_2, ipAddress_3] >>> >>> # Create IPAddressList >>> result = driver.ex_create_ip_address_list( >>> ex_network_domain=my_network_domain, >>> name='My_IP_AddressList_2', >>> ip_version='IPV4', >>> description='Test only', >>> ip_address_collection=ip_address_collection, >>> child_ip_address_list='08468e26-eeb3-4c3d-8ff2-5351fa6d8a04' >>> ) >>> >>> pprint(result) :param ex_network_domain: The network domain or network domain ID :type ex_network_domain: :class:`DimensionDataNetworkDomain` or 'str' :param name: IP Address List Name (required) :type name: :``str`` :param description: IP Address List Description (optional) :type description: :``str`` :param ip_version: IP Version of ip address (required) :type ip_version: :``str`` :param ip_address_collection: List of IP Address. At least one ipAddress element or one childIpAddressListId element must be provided. :type ip_address_collection: :``str`` :param child_ip_address_list: Child IP Address List or id to be included in this IP Address List. At least one ipAddress or one childIpAddressListId must be provided. :type child_ip_address_list: :class:'DimensionDataChildIpAddressList` or `str`` :return: a list of DimensionDataIpAddressList objects :rtype: ``list`` of :class:`DimensionDataIpAddressList` NzTAt least one ipAddress element or one childIpAddressListId element must be provided.ZcreateIpAddressListrP r� rQ rR rm � ipAddressru rv rs �childIpAddressListIdznetwork/createIpAddressListr` ra r� r� )rD r rk r r� rl rm rq ru rv � prefix_size�2_child_ip_address_list_to_child_ip_address_list_idrv rw rx ry r ) rH r� rQ rR r �ip_address_collectionZchild_ip_address_listZcreate_ip_address_listr� r� r� r� rC rC rL �ex_create_ip_address_list sB R� ��� ��� z1DimensionDataNodeDriver.ex_create_ip_address_listc C s� t �dt| �|�dd��}|t �|d�_|D ]#}t �|d�}|�d|j� |jr/|�d|j� |j r9|�d|j � q|d urI| � |�t �|d �_n t �|d d d i� | j j d dt � |�d�j}t|dt�} | dv S )al Edit IP Address List. IP Address list. >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataIpAddress >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # IP Address collection >>> ipAddress_1 = DimensionDataIpAddress(begin='190.2.2.100') >>> ipAddress_2 = DimensionDataIpAddress(begin='190.2.2.106', >>> end='190.2.2.108') >>> ipAddress_3 = DimensionDataIpAddress( >>> begin='190.2.2.0', prefix_size='24') >>> ip_address_collection = [ipAddress_1, ipAddress_2, ipAddress_3] >>> >>> # Edit IP Address List >>> ip_address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> result = driver.ex_edit_ip_address_list( >>> ex_ip_address_list=ip_address_list_id, >>> description="Edit Test", >>> ip_address_collection=ip_address_collection, >>> child_ip_address_lists=None >>> ) >>> pprint(result) :param ex_ip_address_list: (required) IpAddressList object or IpAddressList ID :type ex_ip_address_list: :class:'DimensionDataIpAddressList' or ``str`` :param description: IP Address List Description :type description: :``str`` :param ip_address_collection: List of IP Address :type ip_address_collection: ''list'' of :class:'DimensionDataIpAddressList' :param child_ip_address_lists: Child IP Address List or id to be included in this IP Address List :type child_ip_address_lists: ``list`` of :class:'DimensionDataChildIpAddressList' or ``str`` :return: a list of DimensionDataIpAddressList objects :rtype: ``list`` of :class:`DimensionDataIpAddressList` ZeditIpAddressList�)http://www.w3.org/2001/XMLSchema-instance)rP r� � xmlns:xsirR r ru rv rs Nr �xsi:nilr6 znetwork/editIpAddressListr` ra r� r� )r rk r �&_ip_address_list_to_ip_address_list_idrl rm rq ru rv r r rv rw rx ry r ) rH �ex_ip_address_listrR r �child_ip_address_listsZedit_ip_address_listr� r� r� r� rC rC rL �ex_edit_ip_address_list� s@ <�� ����� z/DimensionDataNodeDriver.ex_edit_ip_address_listc C �F t �dt| �|�d��}| jjddt �|�d�j}t|dt�}|dv S )a� Delete IP Address List by ID >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> ip_address_list_id = '5e7c323f-c885-4e4b-9a27-94c44217dbd3' >>> result = driver.ex_delete_ip_address_list(ip_address_list_id) >>> pprint(result) :param ex_ip_address_list: IP Address List object or IP Address List ID (required) :type ex_ip_address_list: :class:'DimensionDataIpAddressList' or ``str`` :rtype: ``bool`` ZdeleteIpAddressListr� znetwork/deleteIpAddressListr` ra r� r� ) r rk r r rv rw rx ry r )rH r Zdelete_ip_address_listr� r� rC rC rL �ex_delete_ip_address_list� s ���� z1DimensionDataNodeDriver.ex_delete_ip_address_listc C r )a\ List Portlist by network domain ID specified >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == >>> networkDomainName][0] >>> >>> # List portlist >>> portLists = driver.ex_list_portlist( >>> ex_network_domain=my_network_domain) >>> pprint(portLists) >>> :param ex_network_domain: The network domain or network domain ID :type ex_network_domain: :class:`DimensionDataNetworkDomain` or 'str' :return: a list of DimensionDataPortList objects :rtype: ``list`` of :class:`DimensionDataPortList` r� znetwork/portListr� )r� rv rw ry �_to_port_listsr rC rC rL �ex_list_portlist" s #�� z(DimensionDataNodeDriver.ex_list_portlistc C s d| }| j �|�j}| �|�S )a� Get Port List >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get specific portlist by ID >>> portlist_id = '27dd8c66-80ff-496b-9f54-2a3da2fe679e' >>> portlist = driver.ex_get_portlist(portlist_id) >>> pprint(portlist) :param ex_portlist_id: The ex_port_list or ex_port_list ID :type ex_portlist_id: :class:`DimensionDataNetworkDomain` or 'str' :return: DimensionDataPortList object :rtype: :class:`DimensionDataPort` znetwork/portList/%s)rv rw ry � _to_port_list)rH Zex_portlist_idZurl_pathr� rC rC rL �ex_get_portlistK s z'DimensionDataNodeDriver.ex_get_portlistc C s� t �ddti�}| �|�t �|d�_|t �|d�_|t �|d�_|D ]}t �|d�}|�d|j� |jr;|�d|j� q"|d urO|D ] } | � | �t �|d �_qB| j j d d t � |�d �j } t| dt�} | dv S )au Create Port List. >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataPort >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Get location >>> location = driver.ex_get_location_by_id(id='AU9') >>> >>> # Get network domain by location >>> networkDomainName = "Baas QA" >>> network_domains = driver.ex_list_network_domains(location=location) >>> my_network_domain = [d for d in network_domains if d.name == networkDomainName][0] >>> >>> # Port Collection >>> port_1 = DimensionDataPort(begin='1000') >>> port_2 = DimensionDataPort(begin='1001', end='1003') >>> port_collection = [port_1, port_2] >>> >>> # Create Port List >>> new_portlist = driver.ex_create_portlist( >>> ex_network_domain=my_network_domain, >>> name='MyPortListX', >>> description="Test only", >>> port_collection=port_collection, >>> child_portlist_list={'a9cd4984-6ff5-4f93-89ff-8618ab642bb9'} >>> ) >>> pprint(new_portlist) :param ex_network_domain: (required) The network domain in which to create PortList. Provide networkdomain object or its id. :type ex_network_domain: :``str`` :param name: Port List Name :type name: :``str`` :param description: IP Address List Description :type description: :``str`` :param port_collection: List of Port Address :type port_collection: :``str`` :param child_portlist_list: List of Child Portlist to be included in this Port List :type child_portlist_list: :``str`` or ''list of :class:'DimensionDataChildPortList' :return: result of operation :rtype: ``bool`` ZcreatePortListrP r� rQ rR r@ ru rv N�childPortListIdznetwork/createPortListr` ra r� r� )r rk r r� rl rm rq ru rv �&_child_port_list_to_child_port_list_idrv rw rx ry r ) rH r� rQ rR �port_collection�child_portlist_listZ new_port_listr@ �p�childr� r� rC rC rL �ex_create_portlisti s, D � �� �� z*DimensionDataNodeDriver.ex_create_portlistc C s� t �d| �|�tdd��}|t �|d�_|D ]}t �|d�}|�d|j� |jr/|�d|j� q|durD|D ] }| � |�t �|d �_q6n t �|d d d i� | j j d d t � |�d�j } t| dt�} | dv S )a� Edit Port List. >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> from libcloud.common.dimensiondata import DimensionDataPort >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Port Collection >>> port_1 = DimensionDataPort(begin='4200') >>> port_2 = DimensionDataPort(begin='4201', end='4210') >>> port_collection = [port_1, port_2] >>> >>> # Edit Port List >>> editPortlist = driver.ex_get_portlist( '27dd8c66-80ff-496b-9f54-2a3da2fe679e') >>> >>> result = driver.ex_edit_portlist( >>> ex_portlist=editPortlist.id, >>> description="Make Changes in portlist", >>> port_collection=port_collection, >>> child_portlist_list={'a9cd4984-6ff5-4f93-89ff-8618ab642bb9'} >>> ) >>> pprint(result) :param ex_portlist: Port List to be edited (required) :type ex_portlist: :``str`` or :class:'DimensionDataPortList' :param description: Port List Description :type description: :``str`` :param port_collection: List of Ports :type port_collection: :``str`` :param child_portlist_list: Child PortList to be included in this IP Address List :type child_portlist_list: :``list`` of :class'DimensionDataChildPortList' or ''str'' :return: a list of DimensionDataPortList objects :rtype: ``list`` of :class:`DimensionDataPortList` Z editPortListr )r� rP r rR r@ ru rv Nr r r6 znetwork/editPortListr` ra r� r� )r rk �_port_list_to_port_list_idr rl rm rq ru rv r! rv rw rx ry r ) rH � ex_portlistrR r" r# Zexisting_port_address_listr@ r$ r% r� r� rC rC rL �ex_edit_portlist� s: 4�� ����� z(DimensionDataNodeDriver.ex_edit_portlistc C r )a* Delete Port List >>> from pprint import pprint >>> from libcloud.compute.types import Provider >>> from libcloud.compute.providers import get_driver >>> import libcloud.security >>> >>> # Get dimension data driver >>> libcloud.security.VERIFY_SSL_CERT = True >>> cls = get_driver(Provider.DIMENSIONDATA) >>> driver = cls('myusername','mypassword', region='dd-au') >>> >>> # Delete Port List >>> portlist_id = '157531ce-77d4-493c-866b-d3d3fc4a912a' >>> response = driver.ex_delete_portlist(portlist_id) >>> pprint(response) :param ex_portlist: Port List to be deleted :type ex_portlist: :``str`` or :class:'DimensionDataPortList' :rtype: ``bool`` ZdeletePortListr� znetwork/deletePortListr` ra r� r� ) r rk r r' rv rw rx ry r )rH r( Zdelete_port_listr� r� rC rC rL �ex_delete_portlist! s � �� z*DimensionDataNodeDriver.ex_delete_portlistc C sZ t �ddti�}|t �|d�_|t �|d�_| jjddt �|�d�j}t |dt�}|d v S ) z� Exchange NIC Vlans :param nic_id_1: Nic ID 1 :type nic_id_1: :``str`` :param nic_id_2: Nic ID 2 :type nic_id_2: :``str`` :rtype: ``bool`` zurn:exchangeNicVlansr� z urn:nicId1z urn:nicId2zserver/exchangeNicVlansr` ra r� r� � r rk r rl rm rv rw rx ry r )rH Znic_id_1Znic_id_2Z exchange_elemr� r� rC rC rL �ex_exchange_nic_vlansF s �� z-DimensionDataNodeDriver.ex_exchange_nic_vlansc C sN t �d|td��}|t �|d�_| jjddt �|�d�j}t |dt�}|dv S ) a Change network adapter of a NIC on a cloud server :param nic_id: Nic ID :type nic_id: :``str`` :param network_adapter_name: Network adapter name :type network_adapter_name: :``str`` :rtype: ``bool`` ZchangeNetworkAdapter)ZnicIdrP r� zserver/changeNetworkAdapterr` ra r� r� r+ )rH r+ r� Z change_elemr� r� rC rC rL � ex_change_nic_network_adapter_ s �� z5DimensionDataNodeDriver.ex_change_nic_network_adapterc & C sZ t | jj�t d�k rtd��t|t�sd}td� t�ddt i�}|t� |d�_ |t� |d�_ | � |�}|t� |d �_ |rFt� |d �}||_ |d urUt |��� t� |d �_ |d urxt� |d �}|�d|j� |�dt |j�� |�dt |j�� |d ur�t |�t� |d�_ | d u r�| d u r�td��| d ur�| d ur�td��t� |d�}| �|�}|�d|� t� |d�}| d ur�| t� |d�_ | d ur�| �| �}|t� |d�_ | d ur�| t� |d�_ t| ttf��r;| D ]U}t� |d�}|jd u r�|jd u r�td��|jd u�r |jd u�r td ��|jd u�r|jt� |d�_ |jd u�r+| �|j�}|t� |d�_ |jd u�r9|jt� |d�_ q�n | d u�rDtd ��t| ttf��rg| D ]}t� |d �}|�d |j � |�d|j � �qNn | d u�rptd ��|d u�r~|d u�r~td!��|d u�r�t|t ��s�td"��t j d# d$k �r�|�!� } n|�"� } | D ] \} } t� |d%�} | t� | d&�_ | d u�r�| t� | d'�_ �q�|d u�r t|t ��s�td(��t j d# d$k �r�|�!� } n|�"� } | D ] \} } t� |d)�}!| t� |!d*�_ | d u�r�| t� |!d'�_ �q�| jj#d+d,t�$|�d-�j%}"d }#t&|"d.t �D ]}$|$�'d�d/k�r$|$�'d'�}#�q| �(|#�}%|%S )0a^ This MCP 2.0 only function deploys a new Cloud Server from a CloudControl compatible Server Image, which does not utilize VMware Guest OS Customization process. Create Node in MCP2 Data Center :keyword name: (required) String with a name for this new node :type name: ``str`` :keyword image: (UUID of the Server Image being used as the target for the new Server deployment. The source Server Image (OS Image or Customer Image) must have osCustomization set to true. See Get/List OS Image(s) and Get/List Customer Image(s). :type image: :class:`NodeImage` or ``str`` :keyword ex_network_domain: (required) Network Domain or Network Domain ID to create the node :type ex_network_domain: :class:`DimensionDataNetworkDomain` or ``str`` :keyword ex_description: (optional) description for this node :type ex_description: ``str`` :keyword ex_cluster_id: (optional) For multiple cluster environments, it is possible to set a destination cluster for the new Customer Image. Note that performance of this function is optimal when either the Server cluster and destination are the same or when shared data storage is in place for the multiple clusters. :type ex_cluster_id: ``str`` :keyword ex_primary_nic_private_ipv4: Provide private IPv4. Ignore if ex_primary_nic_vlan is provided. Use one or the other. Not both. :type ex_primary_nic_private_ipv4: :``str`` :keyword ex_primary_nic_vlan: Provide VLAN for the node if ex_primary_nic_private_ipv4 NOT provided. One or the other. Not both. :type ex_primary_nic_vlan: :class: DimensionDataVlan or ``str`` :keyword ex_primary_nic_network_adapter: (Optional) Default value for the Operating System will be used if leave empty. Example: "E1000". :type ex_primary_nic_network_adapter: :``str`` :keyword ex_additional_nics: (optional) List :class:'DimensionDataNic' or None :type ex_additional_nics: ``list`` of :class:'DimensionDataNic' or ``str`` :keyword ex_memory_gb: (optional) The amount of memory in GB for the server Can be used to override the memory value inherited from the source Server Image. :type ex_memory_gb: ``int`` :keyword ex_cpu_specification: (optional) The spec of CPU to deploy :type ex_cpu_specification: :class:`DimensionDataServerCpuSpecification` :keyword ex_is_started: (required) Start server after creation. Default is set to true. :type ex_is_started: ``bool`` :keyword ex_disks: (optional) Dimensiondata disks. Optional disk elements can be used to define the disk speed that each disk on the Server; inherited from the source Server Image will be deployed to. It is not necessary to include a diskelement for every disk; only those that you wish to set a disk speed value for. Note that scsiId 7 cannot be used.Up to 13 disks can be present in addition to the required OS disk on SCSI ID 0. Refer to https://docs.mcp-services.net/x/UwIu for disk :type ex_disks: List or tuple of :class:'DimensionDataServerDisk` :keyword ex_tagid_value_pairs: (Optional) up to 10 tag elements may be provided. A combination of tagById and tag name cannot be supplied in the same request. Note: ex_tagid_value_pairs and ex_tagname_value_pairs is mutually exclusive. Use one or other. :type ex_tagname_value_pairs: ``dict``. Value can be None. :keyword ex_tagname_value_pairs: (Optional) up to 10 tag elements may be provided. A combination of tagById and tag name cannot be supplied in the same request. Note: ex_tagid_value_pairs and ex_tagname_value_pairs is mutually exclusive. Use one or other. :type ex_tagname_value_pairs: ``dict```. :return: The newly created :class:`Node`. :rtype: :class:`Node` r� z<This feature is NOT supported in earlier api version of 2.4Tz=Warning: ex_is_started input value is invalid. Defaultto TrueZdeployUncustomizedServerrP rQ rR rS r] NrT rV rW rX rY rZ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� z[ex_tagid_value_pairs and ex_tagname_value_pairsis mutually exclusive. Use one or the other.z*ex_tagid_value_pairs must be a dictionary.r � r� r� rf z+ex_tagname_value_pairs must be a dictionaryr� r� z server/deployUncustomizedServerr` ra rd re ))r rv r� r� ri r� �printr rk r rl rm rn ro rp rq rr rs rt rD r� r� r� r� r� r� r� r� r� rW �dict�sys� version_infoZ iteritemsr� rw rx ry r rz r{ )&rH rQ r~ r� r� r� Z ex_cluster_idr� r� r� r� r� r� r� Zex_tagid_value_pairsZex_tagname_value_pairsZserver_uncustomized_elmr� r� rV r� r� r� r� r� r� r� r� Z tagid_itemsr� r� r� Z tags_itemsZ tag_name_elemr� r� rd r� rC rC rL �ex_create_node_uncustomizedw s� ~ �� �� �� � � � ��� � z3DimensionDataNodeDriver.ex_create_node_uncustomizedc C s$ |� � }t�t|��}dd� |D �S )Nc S s g | ]}|� d ��qS )�,)�split)r! �linerC rC rL r" � � z7DimensionDataNodeDriver._format_csv.<locals>.<listcomp>)�readro � splitlinesr )rH Z http_responserm �linesrC rC rL r� � s z#DimensionDataNodeDriver._format_csvc C s* t | �}|jtv rt|j S td|j ��)Nz Asset type %s cannot be tagged)rA �__name__� OBJECT_TO_TAGGING_ASSET_TYPE_MAPr� )r� Z objecttyperC rC rL r� � s z/DimensionDataNodeDriver._get_tagging_asset_typec C s | j jd|d�j}|S )Nz server/serverr� )rv rw ry )rH r� r� rC rC rL r � s z/DimensionDataNodeDriver._list_nodes_single_pagec C �. g }|� tdt��D ] }|�| �|�� q |S )Nr� )r r r r� �_to_tag)rH ry r� �elementrC rC rL r� � � z DimensionDataNodeDriver._to_tagsc C sJ | j |dd�}tt|dt�t|dt�t|dt�t|dt�|t|dt�d�S ) NT)� from_tag_apir� r� Z assetNamer� rf )r� r� Z asset_name� datacenterr< rf )r� r r r )rH r? r� rC rC rL r> � s �z DimensionDataNodeDriver._to_tagc C r= )NZtagKey)r r r r� r� )rH ry �keysr? rC rC rL r� � r@ z$DimensionDataNodeDriver._to_tag_keysFc C sj |rt |dt�}t |dt�}n |�d�}t |dt�}t||t |dt�| �t |dt��| �t |dt��d�S ) Nr� r� r� rQ rR r� r� )r� rQ rR r� r� )r r rz r � _str2bool)rH r? rA r� rQ rC rC rL r� � s �z#DimensionDataNodeDriver._to_tag_key�osImagec C sX g }| � � }dd� |D �}|�t|t��D ]}|�d�}||v r)|�| �||�� q|S )Nc S s h | ]}|j �qS rC �r� )r! r� rC rC rL � <setcomp>� s z5DimensionDataNodeDriver._to_images.<locals>.<setcomp>r� )r� r r r rz r� r� )rH ry Zel_nameZimagesr> Z location_idsr? � location_idrC rC rL r� � s �z"DimensionDataNodeDriver._to_imagesc s� |� d�� |d u r| �� �}� fdd�|D �d }| �|�tdt���}t| jj�td�kr7|�tdt��}n|�tdt��}|j � d �rHd }nd }t |d t�|� d �|� d�|t |dt�t |dt�t |dt�||d� }t |� d�t t |dt��|| jjd�S )Nr� c r� rC rF )r! �loc�rH rC rL r" � r� z5DimensionDataNodeDriver._to_image.<locals>.<listcomp>r rV z2.3�guest/operatingSystem�operatingSystemr� TFrR �family� displayNamerZ � osImageKey� createTime) rR �OS_type�OS_displayNamerV rZ rO �createdr� �isCustomerImager� rQ )r� rQ r} r� )rz r� � _to_cpu_spec�findr r r rv r� r� �endswithr r ro r� )rH r? r> r� �cpu_specZos_elZis_customer_imager} rC rJ rL r� � s6 � �z!DimensionDataNodeDriver._to_imagec C s, g }t |dt�D ] }|�| �||�� q|S )NZnatRule)r r r� r� )rH ry r� r' r? rC rC rL r� � s z%DimensionDataNodeDriver._to_nat_rulesc C s0 t |�d�|t|dt�t|dt�t|dt�d�S )Nr� r� r� r� r� )r rz r r )rH r? r� rC rC rL r� s �z$DimensionDataNodeDriver._to_nat_rulec C �* g }t |dt�D ] }|�| �|�� q|S )Nr )r r r� �_to_anti_affinity_rule)rH ry r' r? rC rC rL r% s z/DimensionDataNodeDriver._to_anti_affinity_rulesc C s8 g }t |dt�D ] }|�|�d�� qt|�d�|d�S )NZ serverSummaryr� )r� r� )r r r� rz r- )rH r? r� r� rC rC rL rZ s z.DimensionDataNodeDriver._to_anti_affinity_rulec C s6 g }| � � }t|dt�D ] }|�| �|||�� q |S )NZ firewallRule)r� r r r� r� )rH ry r� r' r> r? rC rC rL rh � z*DimensionDataNodeDriver._to_firewall_rulesc s� |� d�� tt� fdd�|��d }t|� d�|t|dt�t|dt�t|dt�t|d t�t|d t�| �|�td t���| �|�td t���|t|d t�d� S )Nr� c r/ r rF r1 rJ rC rL r3 $ r4 z;DimensionDataNodeDriver._to_firewall_rule.<locals>.<lambda>r r� rQ rl rm rn rx ro rw r� ) r� r� rQ rl r rn rx ro rw r� rE ) rz r� r5 r' r r �_to_firewall_addressrV r )rH r? r> r� r� rC rJ rL r� " s �z)DimensionDataNodeDriver._to_firewall_rulec C s |� tdt��}|� tdt��}|� tdt��}|� tdt��}|d u rat|�d�dk|�d�|�d�|d ur<|�d�nd |d urF|�d �nd |d urQ|�d d �nd |d ur]|�d �d �S d d �S td d d d d |d urq|�d d �nd |d ur}|�d �d �S d d �S ) Nr� r@ �portList� ipAddressListrq rr rs ru rv r� )r� r� r� r� r� r� r� F)rV r r r, rz )rH r? r� r@ � port_listZ address_listrC rC rL r\ 4 s6 �� ��z,DimensionDataNodeDriver._to_firewall_addressc C �4 g }| � � }t|dt�D ] }|�| �||�� q |S )NZ publicIpBlock)r� r r r� rb )rH ry �blocksr> r? rC rC rL r_ N � z%DimensionDataNodeDriver._to_ip_blocksc sd |� d�� tt� fdd�|��d }t|� d�| �t|dt��t|dt�t|dt�|t|d t�d �S ) Nr� c r/ r rF r1 rJ rC rL r3 X r4 z6DimensionDataNodeDriver._to_ip_block.<locals>.<lambda>r r� r� ZbaseIpr� r� )r� r� Zbase_ipr� r� rE )rz r� r5 r+ r@ r r )rH r? r> r� rC rJ rL rb V s � �z$DimensionDataNodeDriver._to_ip_blockc C r` )Nr[ )r� r r r� � _to_network)rH ry Znetworksr> r? rC rC rL r� e rb z$DimensionDataNodeDriver._to_networksc s� d}t |dt�dkr d}| �|�tdt���}t |dt�� tt� fdd�|��d }tt |d t�t |d t�t |d t�|t |d t�||d�S )NF� multicastr6 TrE r� c r/ r rF r1 rJ rC rL r3 u r4 z5DimensionDataNodeDriver._to_network.<locals>.<lambda>r r� rQ rR Z privateNet)r� rQ rR r� Z private_netrd rE )r r � _to_statusrV r r� r5 r )rH r? r> rd rE r� rC rJ rL rc m s �z#DimensionDataNodeDriver._to_networkc C r` )N� networkDomain)r� r r r� r< )rH ry Znetwork_domainsr> r? rC rC rL rB � rb z+DimensionDataNodeDriver._to_network_domainsc sx |� d�� tt� fdd�|��d }t|dt�}|dkr tj}ntj}t|� d�t|dt�t|d t�||t|d t�d �S ) Nr� c r/ r rF r1 rJ rC rL r3 � r4 z<DimensionDataNodeDriver._to_network_domain.<locals>.<lambda>r rA r� r� rQ rR r� )r� rQ rR rF r� rE ) rz r� r5 r r r% r� ZADVANCEDr* )rH r? r> r� rF Z plan_typerC rJ rL r< � s �z*DimensionDataNodeDriver._to_network_domainc C s6 g }| � � }t|dt�D ] }|�| j||d�� q |S )Nr� )r> )r� r r r� rT )rH ry r� r> r? rC rC rL rZ � r[ z!DimensionDataNodeDriver._to_vlansc s� |� d�� tt� fdd�|��d }|�tdt��}|�tdt��}|�tdt��}| �|� d��}t|� d�t|d t�t|d t�||� d �t |� d ��|� d �t |� d ��t|d t�t|dt�|t|dt�d� S )Nr� c r/ r rF r1 rJ rC rL r3 � r4 z2DimensionDataNodeDriver._to_vlan.<locals>.<lambda>r ZprivateIpv4RangeZ ipv6Rangerf r� rQ rR rq rs Zipv4GatewayAddressZipv6GatewayAddressr� ) r� rQ rR r� Zprivate_ipv4_range_addressrW Zipv6_range_addressZipv6_range_sizeZ ipv4_gatewayZ ipv6_gatewayr� rE ) rz r� r5 rV r r r@ r r r )rH r? r> r� Zip_rangeZ ip6_rangeZnetwork_domain_elr� rC rJ rL rT � s( �z DimensionDataNodeDriver._to_vlanc C r= )NrB )r r r r� � _to_location)rH ry r> r? rC rC rL r� � s z%DimensionDataNodeDriver._to_locationsc C s* t |�d�t|dt�t|dt�| d�}|S )Nr� rN �country)r� rQ rh r� )r rz r r )rH r? rI rC rC rL rg � s �z$DimensionDataNodeDriver._to_locationc C s( t t|�d��t|�d��|�d�d�S )NrX rY rW )rs rt rr )r0 r rz �rH r? rC rC rL rU � s �z$DimensionDataNodeDriver._to_cpu_specc C sV d }t |d�r |�d�}d }t |d�r|�d�}d }t |d�r$|�d�}t|||d�S )NZ runningStatus�version_statusZ apiVersion�rE rj rA )�hasattrrz r. )rH r? rE rj rA rC rC rL �_to_vmware_tools� s �z(DimensionDataNodeDriver._to_vmware_toolsc �" |� tdt��}� fdd�|D �S )Nr� c � g | ]}� � |��qS rC )�_to_disk�r! �el�rH rC rL r" � r7 z5DimensionDataNodeDriver._to_disks.<locals>.<listcomp>�r r r )rH ry Z disk_elementsrC rs rL � _to_disks� � z!DimensionDataNodeDriver._to_disksc C s8 t |�d�t|�d��t|�d��|�d�|�d�d�S )Nr� r� r� rW r� )r� r� Zsize_gbrW r� )r$ rz r ri rC rC rL rp � s �z DimensionDataNodeDriver._to_diskc rn )NZserverc ro rC )rf rq rs rC rL r" � r7 z5DimensionDataNodeDriver._to_nodes.<locals>.<listcomp>rt )rH ry Z node_elementsrC rs rL r � rv z!DimensionDataNodeDriver._to_nodesc C sP t |dt�}| �|�tdt���}t |dt�}| �|||j�}|�tdt��d u}| �|�tdt���}| �|�}t | j j �t d�k rW| � |�tdt���} |�tdt��} n!|�td t��} | d uri| � | �} nt d d d d �} |�td t��} t |d t�t |d t�t |dt�|r�|�tdt���d�nd |�d�t |dt�|tt |dt��d | �d�| �d�| �d�||| d�} t |dt�} |r�|�tdt���d�n |�tdt���d�}|r�|�tdt���d �n |�tdt���d �| d < t|�d�t |d t�|| d u�r| gng |d u�r|gng | �� d t| d | d | j j�| j j| d � }|S )!Nr� Zprogressr� r� rV r� Z vmwareToolsrL z guest/vmToolsrk rK rR r� r\ r� r� rP rZ i r� rM rN )rR r� r\ r� r� Z deployedTimerV ZmemoryMbZOS_idrQ rR rE r� Z vmWareToolsZpublicIpAddressznetworkInfo/primaryNicr� r� r� rQ r rR ) r� rQ r� Z public_ipsZ private_ipsr� r~ r� r} )r r re rV r �_get_node_staterl rU ru r rv r� rm r. rz r r r� r r� )rH r? r� rE Zdd_stateZ node_stateZhas_network_inforX r� Z vmware_toolsZoperation_systemZ vmtools_elmr} Z public_ipZ private_ip�nrC rC rL rf � sr � � � ���� �� z DimensionDataNodeDriver._to_nodec C sj |d u rt � S t t|dt�t|dt�t|dt�t|dt�t|dt�t|dt�t|dt�t|dt�d �}|S ) Nrl Z requestTimeZuserNameZ numberOfStepsz step/name� step_numberzstep/percentCompleteZ failureReason)rl Z request_timeZ user_nameZnumber_of_stepsZ step_namery Zstep_percent_completeZfailure_reason)r r r )rH r? �srC rC rL re @ s � z"DimensionDataNodeDriver._to_statusc C rY )Nr^ )r r r� �_to_ip_address_list)rH ry r r? rC rC rL r O � z,DimensionDataNodeDriver._to_ip_address_listsc C s� g }t |dt�D ] }|�| �|�� qg }t |dt�D ] }|�| �|�� qt|�d�t|dt�t|dt�t|dt�|t|dt�t|dt�|d �S ) Nr ZchildIpAddressListr� rQ rR rm r� rP )r� rQ rR r r r� � create_timer )r r r� �_to_ip_address�_to_child_ip_listr) rz r )rH r? Z ipAddressesr� r Z child_ip_listrC rC rL r{ V s �z+DimensionDataNodeDriver._to_ip_address_listc C s t |�d�|�d�d�S �Nr� rQ )r� rQ )r/ rz ri rC rC rL r j s z)DimensionDataNodeDriver._to_child_ip_listc C s t |�d�|�d�|�d�d�S )Nru rv rs )ru rv r )r" rz ri rC rC rL r~ m s �z&DimensionDataNodeDriver._to_ip_addressc C rY )Nr] )r r r� r )rH ry Z port_listsr? rC rC rL r t r| z&DimensionDataNodeDriver._to_port_listsc C s� g }t |dt�D ] }|�| j|d�� qg }t |dt�D ] }|�| j|d�� q t|�d�t|dt�t|dt�||t|dt�t|dt�d �S ) Nr@ �r? Z childPortListr� rQ rR r� rP )r� rQ rR r" r# r� r} )r r r� �_to_port�_to_child_port_listr! rz r )rH r? Zportsr@ r# r% rC rC rL r { s �z%DimensionDataNodeDriver._to_port_listc C s4 t |t�s | �|�}|jd r|jd dkrdS dS )NrT rQ ZUNIXFT)ri r r� r} )rH r~ rC rC rL rh � s z)DimensionDataNodeDriver._image_needs_authc C � t | �d�| �d�d�S )Nru rv )ru rv )r rz r� rC rC rL r� � � z DimensionDataNodeDriver._to_portc C r� r� )r( rz r� rC rC rL r� � r� z+DimensionDataNodeDriver._to_child_port_listc C s< zt | ||f W S ty |dkrtj Y S tj Y S w �Nr6 )�NODE_STATE_MAP�KeyErrorr rG Z TERMINATED)r� r� rl rC rC rL rw � s �z'DimensionDataNodeDriver._get_node_statec C � t | t�S r )r1 r r rC rC rL r � � z(DimensionDataNodeDriver._node_to_node_idc C r� r )r1 r r- rC rC rL r� � r� z0DimensionDataNodeDriver._location_to_location_idc C r� r )r1 r r� rC rC rL r� � r� z(DimensionDataNodeDriver._vlan_to_vlan_idc C r� r )r1 r )r~ rC rC rL rn � r� z*DimensionDataNodeDriver._image_to_image_idc C r� r )r1 r )r[ rC rC rL ru � r� z.DimensionDataNodeDriver._network_to_network_idc C r� r )r1 r- )r� rC rC rL r � r� zDDimensionDataNodeDriver._anti_affinity_rule_to_anti_affinity_rule_idc C r� r )r1 r* )r� rC rC rL r� � r� z<DimensionDataNodeDriver._network_domain_to_network_domain_idc C r� r �r1 r �r� rC rC rL r� � r� z.DimensionDataNodeDriver._tag_key_to_tag_key_idc C � t | tdd�S )NrQ �Zid_valuer� r� rC rC rL r� � � z0DimensionDataNodeDriver._tag_key_to_tag_key_namec C r� �Nr� r� )r1 r) )Z ip_addr_listrC rC rL r � r� z>DimensionDataNodeDriver._ip_address_list_to_ip_address_list_idc C r� r� )r1 r/ )Zchild_ip_addr_listrC rC rL r � r� zJDimensionDataNodeDriver._child_ip_address_list_to_child_ip_address_list_idc C r� r� )r1 r! )r_ rC rC rL r' � r� z2DimensionDataNodeDriver._port_list_to_port_list_idc C r� r� )r1 r( )Zchild_port_listrC rC rL r! � r� z>DimensionDataNodeDriver._child_port_list_to_child_port_list_idc C s | � � dv S r� )rp )�stringrC rC rL rD � s z!DimensionDataNodeDriver._str2bool)NNNTNN)NNNNNNNNNTNNNN) NNNNNNNNNNNr )NNNNN)NNNN)NN)NrP )NNNNNN)rg r� )r� r� )r� )r� N)NTT)NNNNNNNN) TNNNNNNNNNNN)F)rE )�r; � __module__� __qualname__�__doc__rE r# Z connectionClsrQ Zwebsiter Z DIMENSIONDATArA ZfeaturesrA r rG rM r� r: r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r r( r* r, r. r6 r8 r: r@ rD rH rJ rN rS rR rV rX rY r[ r^ ra r\ rd r{ ri r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r r r r r& r) r* r, r- r3 r� � staticmethodr� r r� r> r� r� r� r� r� r� r% rZ rh r� r\ r_ rb r� rc rB r< rZ rT r� rg rU rm ru rp r rf re r r{ r r~ r r rh r� r� rw r r� r� rn ru r r� r� r� r r r' r! rD � __classcell__rC rC rJ rL r9 b sF � �} � + � O �T �^ $ � ;& ! $0 �3 �1 � s $ ) �G � "' �/ & �E(4 � �d+)$ � aW% � $ O r9 )Br� r1 Zlibcloud.utils.py3r r r r Zlibcloud.utils.xmlr r r Zlibcloud.compute.baser r r r r r Zlibcloud.compute.typesr r Zlibcloud.common.exceptionsr Z libcloud.common.dimensiondatar r r r r r r r r r r r r r r r! r" r# r$ r% r& r' r( r) r* r+ r, r- r. r/ r0 r1 r ZPENDINGrG ZSTARTINGr Z REBOOTINGZ RECONFIGURINGr� r< r9 rC rC rC rL �<module> s> �'��
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings