File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/libcloud/compute/drivers/__pycache__/gce.cpython-310.pyc
Back
o ;j�� � @ s� d Z ddlZddlZddlZddlZddlmZ ddlmZ ddl m Z ddl m Z m Z mZmZmZmZmZmZ ddlmZmZmZmZmZmZ ddlm Z dd l m Z dd l m Z d Z!d Z"d d� Z#G dd� de�Z$G dd� de�Z%G dd� d�Z&G dd� dee�Z'G dd� de�Z(G dd� de�Z)G dd � d e�Z*G d d � d e�Z+G d d � d e�Z,G d!d"� d"�Z-G d#d$� d$�Z.G d%d&� d&e�Z/G d'd(� d(e�Z0G d)d*� d*e�Z1G d+d,� d,e�Z2G d-d.� d.e�Z3G d/d0� d0e�Z4G d1d2� d2e�Z5G d3d4� d4e�Z6G d5d6� d6e �Z7G d7d8� d8e�Z8G d9d:� d:e�Z9G d;d<� d<e�Z:G d=d>� d>e�Z;G d?d@� d@e�Z<G dAdB� dBe�Z=G dCdD� dDe�Z>G dEdF� dFe�Z?G dGdH� dHe�Z@G dIdJ� dJe�ZAG dKdL� dLe�ZBG dMdN� dNe�ZCG dOdP� dPe�ZDG dQdR� dRe�ZEdS )Sz* Module for Google Compute Engine Driver. � N)� get_pricing)� LazyObject�� LibcloudError)�Node�NodeSize� NodeImage� UuidMixin� NodeDriver� NodeLocation� StorageVolume�VolumeSnapshot)�GoogleResponse�GoogleBaseError�ResourceExistsError�GoogleBaseConnection�ResourceNotFoundError�GoogleOAuth2Credential)� NodeState)� parse_date)�ProviderZv1� c C s` t j �| dd� d�}t| dd� �}t| dd� �t| dd� d � }t j||d �}|| S ) a Return a datetime object that corresponds to the time in an RFC3339 timestamp. :param timestamp: RFC3339 timestamp string :type timestamp: ``str`` :return: Datetime object corresponding to timestamp :rtype: :class:`datetime.datetime` Ni����z%Y-%m-%dT%H:%M:%S���������i�����1)�hours�minutes)�datetime�strptime�int� timedelta)� timestamp�tsZtz_hoursZtz_minsZtz_delta� r$ �P/opt/saltstack/salt/lib/python3.10/site-packages/libcloud/compute/drivers/gce.py�timestamp_to_datetime6 s $r& c @ s e Zd ZdS )� GCEResponseN)�__name__� __module__� __qualname__r$ r$ r$ r% r' K s r' c sb e Zd ZdZdZeZ d� fdd� Z� fdd�Zdd � Z � fd d �Z dd d �Z dd� Z � Z S )� GCEConnectiona� Connection class for the GCE driver. GCEConnection extends :class:`google.GoogleBaseConnection` for 3 reasons: 1. modify request_path for GCE URI. 2. Implement gce_params functionality described below. 3. Add request_aggregated_items method for making aggregated API calls. If the parameter gce_params is set to a dict prior to calling request(), the URL parameters will be updated to include those key/values FOR A SINGLE REQUEST. If the response contains a nextPageToken, gce_params['pageToken'] will be set to its value. This can be used to implement paging in list: >>> params, more_results = {'maxResults': 2}, True >>> while more_results: ... driver.connection.gce_params=params ... driver.ex_list_urlmaps() ... more_results = 'pageToken' in params ... [<GCEUrlMap id="..." name="cli-map">, <GCEUrlMap id="..." name="lc-map">] [<GCEUrlMap id="..." name="web-map">] zwww.googleapis.comNc s6 t � j||f|||d�|�� d�t|�| _d | _d S )N)�secure� auth_type�credential_file�/compute/{}/projects/{})�super�__init__�format� API_VERSION� request_path� gce_params)�self�user_id�keyr, r- r. �project�kwargs�� __class__r$ r% r1 k s ��� zGCEConnection.__init__c s, t � �||�\}}| jr|�| j� ||fS )z� Update URL parameters with values from self.gce_params. @inherits: :class:`GoogleBaseConnection.pre_connect_hook` )r0 �pre_connect_hookr5 �update)r6 �params�headersr; r$ r% r= � s z GCEConnection.pre_connect_hookc O sf d}g }d|v r |d nd}d|i}|r/|| _ | j|i |��}|�|j�dg �� d|v }|sd|iS )z� Generic function to create a paginated request to any API call not only aggregated or zone ones as request_aggregated_items. @inherits: :class:`GoogleBaseConnection.request` T� max_results�� � maxResults�items� pageToken)r5 �request�extend�object�get)r6 �argsr: � more_resultsrD rA r? �responser$ r$ r% �paginated_request� s �z GCEConnection.paginated_requestc sP t � j|i |��}| jr&d|jv r|jd | jd< n d| jv r#| jd= d| _|S )z� Perform request then do GCE-specific processing of URL params. @inherits: :class:`GoogleBaseConnection.request` Z nextPageTokenrE N)r0 rF r5 rH )r6 rJ r: rL r; r$ r% rF � s zGCEConnection.requestc C s� |r d� |j|�}nd| }g }ddi}d}|rB|| _| j|dd�j}d|v r<|r7|d }d | ||ii|d< |�|� d |v }|s| �||�S ) a� Perform request(s) to obtain all results from 'api_name'. This method will make requests to the aggregated 'api_name' until all results are received. It will then, through a helper function, combine all results and return a single 'items' dictionary. :param api_name: Name of API to call. Consult API docs for valid names. :type api_name: ``str`` :param zone: Optional zone to use. :type zone: :class:`GCEZone` :return: dict in the format of the API response. format: { 'items': {'key': {api_name: []}} } ex: { 'items': {'zones/us-central1-a': {disks: []}} } :rtype: ``dict`` z /zones/{}/{}z/aggregated/%srC rB T�GET��methodrD zzones/%srE )r2 �namer5 rF rH �append�_merge_response_items) r6 �api_name�zoner4 Z api_responsesr? rK rL rD r$ r$ r% �request_aggregated_items� s" � z&GCEConnection.request_aggregated_itemsc C sd i }|D ])}|� di ��� D ] \}}||v r,|�|i ��|g � || | || 7 < qqd|iS )a Take a list of API responses ("item"-portion only) and combine them. Helper function to combine multiple aggregated responses into a single dictionary that resembles an API response. Note: keys that don't have a 'list_name" key (including warnings) are omitted. :param list_name: Name of list in dict. Practically, this is the name of the API called (e.g. 'disks'). :type list_name: ``str`` :param response_list: list of API responses (e.g. resp['items']). Each entry in the list is the result of a single API call. Expected format is: [ { items: { key1: { api_name:[]}, key2: { api_name:[]} }}, ... ] :type response_list: ``dict`` :return: dict in the format of: { items: {key: {api_name:[]}, key2: {api_name:[]}} } ex: { items: { 'us-east1-a': {'disks': []}, 'us-east1-b': {'disks': []} }} :rtype: ``dict`` rD )rI rD � setdefault)r6 Z list_nameZ response_listZ merged_items�resp�k�vr$ r$ r% rS � s ��z#GCEConnection._merge_response_items�NNN�N)r( r) r* �__doc__�hostr' Z responseClsr1 r= rM rF rV rS � __classcell__r$ r$ r; r% r+ O s � .r+ c @ s: e Zd ZdZdd� Zdd� Zdd� Zdd � Zdd d �Zd S )�GCEListae An Iterator that wraps list functions to provide additional features. GCE enforces a limit on the number of objects returned by a list operation, so users with more than 500 objects of a particular type will need to use filter(), page() or both. >>> l=GCEList(driver, driver.ex_list_urlmaps) >>> for sublist in l.filter('name eq ...-map').page(1): ... sublist ... [<GCEUrlMap id="..." name="cli-map">] [<GCEUrlMap id="..." name="web-map">] One can create a GCEList manually, but it's slightly easier to use the ex_list() method of :class:`GCENodeDriver`. c K s || _ || _|| _i | _dS )z� :param driver: An initialized :class:``GCENodeDriver`` :type driver: :class:``GCENodeDriver`` :param list_fn: A bound list method from :class:`GCENodeDriver`. :type list_fn: ``instancemethod`` N)�driver�list_fnr: r? )r6 ra rb r: r$ r$ r% r1 $ s zGCEList.__init__c c sD � | j }d}|r | j| jj_|di | j��V d| jv }|sd S d S )NTrE r$ )rb r? ra � connectionr5 r: )r6 rb rK r$ r$ r% �__iter__1 s � �zGCEList.__iter__c C s d� | jjt| j��S )Nz <GCEList list="{}" params="{}">)r2 rb r( �reprr? �r6 r$ r$ r% �__repr__: s �zGCEList.__repr__c C � || j d< | S )a� Filter results of a list operation. GCE supports server-side filtering of resources returned by a list operation. Syntax of the filter expression is fully described in the GCE API reference doc, but in brief it is:: FIELD_NAME COMPARISON_STRING LITERAL_STRING where FIELD_NAME is the resource's property name, COMPARISON_STRING is 'eq' or 'ne', and LITERAL_STRING is a regular expression in RE2 syntax. >>> for sublist in l.filter('name eq ...-map'): ... sublist ... [<GCEUrlMap id="..." name="cli-map">, <GCEUrlMap id="..." name="web-map">] API reference: https://cloud.google.com/compute/docs/reference/latest/ RE2 syntax: https://github.com/google/re2/blob/master/doc/syntax.txt :param expression: Filter expression described above. :type expression: ``str`` :return: This :class:`GCEList` instance :rtype: :class:`GCEList` �filter�r? )r6 Z expressionr$ r$ r% ri @ s zGCEList.filterrB c C rh )a� Limit the number of results by each iteration. This implements the paging functionality of the GCE list methods and returns this GCEList instance so that results can be chained: >>> for sublist in GCEList(driver, driver.ex_list_urlmaps).page(2): ... sublist ... [<GCEUrlMap id="..." name="cli-map">, <GCEUrlMap id="..." name="lc-map">] [<GCEUrlMap id="..." name="web-map">] :keyword max_results: Maximum number of results to return per iteration. Defaults to the GCE default of 500. :type max_results: ``int`` :return: This :class:`GCEList` instance :rtype: :class:`GCEList` rC rj )r6 rA r$ r$ r% �page` s z GCEList.pageN)rB ) r( r) r* r] r1 rd rg ri rk r$ r$ r$ r% r` s r` c @ s0 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd S ) � GCELicensez8A GCE License used to track software usage in GCE nodes.c C s: t �| � || _|| _|| _|| _d | _d | _| �� d S r\ ) r r1 �idrQ r9 ra �charges_use_fee�extra�_request)r6 rQ r9 ra r$ r$ r% r1 } s zGCELicense.__init__c C s� | j jj}z/z |�| j j| j�}|| j j_d| j }| j jj|dd�j}W n ty- � w W || j j_n|| j j_w |� d�|� d�d�| _ |d | _ d S )Nz/global/licenses/%srN rO �selfLink�kind)rq rr Z chargesUseFee) ra rc r4 �replacer9 rQ rF rH � ExceptionrI ro rn )r6 Zsaved_request_path�new_request_pathrF rL r$ r$ r% rp � s ���zGCELicense._requestc C � t d��)Nz#Can not destroy a License resource.r rf r$ r$ r% �destroy� � zGCELicense.destroyc C � d� | j| j| j�S )Nz3<GCELicense id="{}" name="{}" charges_use_fee="{}">)r2 rm rQ rn rf r$ r$ r% rg � � �zGCELicense.__repr__N)r( r) r* r] r1 rp rw rg r$ r$ r$ r% rl z s rl c @ �* e Zd ZdZd dd�Zdd� Zdd� ZdS ) � GCEDiskTypezA GCE DiskType resource.Nc C �0 t |�| _|| _|| _|| _|| _t�| � d S r\ ��strrm rQ rU ra ro r r1 �r6 rm rQ rU ra ro r$ r$ r% r1 � � zGCEDiskType.__init__c C rv )Nz$Can not destroy a DiskType resource.r rf r$ r$ r% rw � rx zGCEDiskType.destroyc C ry )Nz)<GCEDiskType id="{}" name="{}" zone="{}">�r2 rm rQ rU rf r$ r$ r% rg � rz zGCEDiskType.__repr__r\ �r( r) r* r] r1 rw rg r$ r$ r$ r% r| � � r| c @ r{ ) �GCEAcceleratorTypez A GCE AcceleratorType resource.Nc C r} r\ r~ r� r$ r$ r% r1 � r� zGCEAcceleratorType.__init__c C rv )Nz,Can not destroy an AcceleratorType resource.r rf r$ r$ r% rw � rx zGCEAcceleratorType.destroyc C ry )Nz0<GCEAcceleratorType id="{}" name="{}" zone="{}">r� rf r$ r$ r% rg � rz zGCEAcceleratorType.__repr__r\ r� r$ r$ r$ r% r� � r� r� c @ r{ ) � GCEAddresszA GCE Static address.Nc C �6 t |�| _|| _|| _|| _|| _|| _t�| � d S r\ ) r rm rQ �address�regionra ro r r1 )r6 rm rQ r� r� ra ro r$ r$ r% r1 � � zGCEAddress.__init__c C � | j j| d�S )zf Destroy this address. :return: True if successful :rtype: ``bool`` )r� )ra �ex_destroy_addressrf r$ r$ r% rw � � zGCEAddress.destroyc C s, d� | j| j| jt| jd�r| jjp| j�S )Nz7<GCEAddress id="{}" name="{}" address="{}" region="{}">rQ )r2 rm rQ r� �hasattrr� rf r$ r$ r% rg � s �zGCEAddress.__repr__r\ r� r$ r$ r$ r% r� � s r� c @ s> e Zd ZdZ d dd�Zdd� Zd d � Zd d � ZdS )� GCEBackendz8A GCE Backend. Only used for creating Backend Services.� UTILIZATIONN� c C s~ t |t�r || _nt |t�r|j| _ntd��|| _|| _|| _|| _|| _|| _ | � � | _ | j | _ |p6| j | _ t�| � d S )NzQinstance_group must be of type GCEInstanceGroupor of type GCEInstanceGroupManager)� isinstance�GCEInstanceGroup�instance_group�GCEInstanceGroupManager� ValueError�balancing_mode�max_utilization�max_rate�max_rate_per_instance�capacity_scaler�_gen_idrm rQ � descriptionr r1 �r6 r� r� r� r� r� r� r� r$ r$ r% r1 � s" � zGCEBackend.__init__c C s | j jj}d�|| j j�S )a Use the Instance Group information to fill in name and id fields. :return: id in the format of: ZONE/instanceGroups/INSTANCEGROUPNAME Ex: us-east1-c/instanceGroups/my-instance-group :rtype: ``str`` z{}/instanceGroups/{})r� rU rQ r2 )r6 � zone_namer$ r$ r% r� s zGCEBackend._gen_idc C sh i }| j jd |d< | jr| j|d< | jr| j|d< | jr"| j|d< | jr*| j|d< | jr2| j|d< |S )z� Returns dict formatted for inclusion in Backend Service Request. :return: dict formatted as a list entry for Backend Service 'backend'. :rtype: ``dict`` rq �groupZ balancingModeZmaxUtilizationZmaxRateZmaxRatePerInstanceZcapacityScaler)r� ro r� r� r� r� r� )r6 �dr$ r$ r% �to_backend_dict( s zGCEBackend.to_backend_dictc C � d� | j| j�S )Nz3<GCEBackend instancegroup="{}" balancing_mode="{}">)r2 rm r� rf r$ r$ r% rg C s �zGCEBackend.__repr__�r� NNNr� N)r( r) r* r] r1 r� r� rg r$ r$ r$ r% r� � s �# r� c @ �, e Zd ZdZ d dd�Zdd� Zdd� ZdS ) �GCEBackendServicezA GCE Backend Service.Nc C sZ t |�| _|| _|p g | _|pg | _|| _|| _|| _|| _| | _ | p$i | _ t � | � d S r\ ) r rm rQ �backends� healthchecks�port� port_name�protocol�timeoutra ro r r1 ) r6 rm rQ r� r� r� r� r� r� ra ro r$ r$ r% r1 M s zGCEBackendService.__init__c C r� )Nz%<GCEBackendService id="{}" name="{}">�r2 rm rQ rf r$ r$ r% rg f � zGCEBackendService.__repr__c C r� )zn Destroy this Backend Service. :return: True if successful :rtype: ``bool`` )�backendservice)ra �ex_destroy_backendservicerf r$ r$ r% rw i r� zGCEBackendService.destroyr\ �r( r) r* r] r1 rg rw r$ r$ r$ r% r� J s � r� c @ � e Zd ZdZdd� Zdd� ZdS )� GCEFailedDiskz1Dummy Node object for disks that are not created.c C � || _ || _|| _d S r\ �rQ �error�code�r6 rQ r� r� r$ r$ r% r1 w � zGCEFailedDisk.__init__c C r� )Nz)<GCEFailedDisk name="{}" error_code="{}">�r2 rQ r� rf r$ r$ r% rg | r� zGCEFailedDisk.__repr__N�r( r) r* r] r1 rg r$ r$ r$ r% r� t � r� c @ r� )� GCEFailedNodez1Dummy Node object for nodes that are not created.c C r� r\ r� r� r$ r$ r% r1 � r� zGCEFailedNode.__init__c C r� )Nz)<GCEFailedNode name="{}" error_code="{}">r� rf r$ r$ r% rg � r� zGCEFailedNode.__repr__Nr� r$ r$ r$ r% r� � r� r� c @ �4 e Zd ZdZ d dd�Zdd� Zdd� Zd d � ZdS ) �GCEHealthCheckz A GCE Http Health Check class.Nc C sR t |�| _|| _|| _|| _|| _|| _|| _|| _| | _ | p i | _ t � | � d S r\ ) r rm rQ �pathr� �intervalr� �unhealthy_threshold�healthy_thresholdra ro r r1 ) r6 rm rQ r� r� r� r� r� r� ra ro r$ r$ r% r1 � s zGCEHealthCheck.__init__c C r� )zm Destroy this Health Check. :return: True if successful :rtype: ``bool`` �� healthcheck)ra �ex_destroy_healthcheckrf r$ r$ r% rw � r� zGCEHealthCheck.destroyc C r� )z� Commit updated healthcheck values. :return: Updated Healthcheck object :rtype: :class:`GCEHealthcheck` r� )ra �ex_update_healthcheckrf r$ r$ r% r> � r� zGCEHealthCheck.updatec C � d� | j| j| j| j�S )Nz6<GCEHealthCheck id="{}" name="{}" path="{}" port="{}">)r2 rm rQ r� r� rf r$ r$ r% rg � � �zGCEHealthCheck.__repr__r\ �r( r) r* r] r1 rw r> rg r$ r$ r$ r% r� � s � r� c @ r� ) � GCEFirewallzA GCE Firewall rule class.Nc C sl t |�| _|| _|| _|| _|| _|| _| | _|| _|| _ | | _ | | _ | | _ | | _ || _|| _t�| � d S r\ )r rm rQ �network�allowed�denied� direction�priority� source_ranges� source_tags�source_service_accounts� target_tags�target_service_accounts� target_rangesra ro r r1 )r6 rm rQ r� r� r� r� r� r� r� r� r� r� r� ra ro r$ r$ r% r1 � s zGCEFirewall.__init__c C r� )zg Destroy this firewall. :return: True if successful :rtype: ``bool`` ��firewall)ra �ex_destroy_firewallrf r$ r$ r% rw � r� zGCEFirewall.destroyc C r� )z� Commit updated firewall values. :return: Updated Firewall object :rtype: :class:`GCEFirewall` r� )ra �ex_update_firewallrf r$ r$ r% r> � r� zGCEFirewall.updatec C � d� | j| j| jj�S )Nz,<GCEFirewall id="{}" name="{}" network="{}">)r2 rm rQ r� rf r$ r$ r% rg � � �zGCEFirewall.__repr__r\ r� r$ r$ r$ r% r� � s �# r� c @ �& e Zd Zddd�Zdd� Zdd� ZdS ) �GCEForwardingRuleNc C �B t |�| _|| _|| _|| _|| _|| _|| _|| _t � | � d S r\ ) r rm rQ r� r� r� � targetpoolra ro r r1 ) r6 rm rQ r� r� r� r� ra ro r$ r$ r% r1 s zGCEForwardingRule.__init__c C r� )zo Destroy this Forwarding Rule :return: True if successful :rtype: ``bool`` )�forwarding_rule)ra �ex_destroy_forwarding_rulerf r$ r$ r% rw r� zGCEForwardingRule.destroyc C ry )Nz2<GCEForwardingRule id="{}" name="{}" address="{}">)r2 rm rQ r� rf r$ r$ r% rg rz zGCEForwardingRule.__repr__r\ �r( r) r* r1 rw rg r$ r$ r$ r% r� s r� c s4 e Zd ZdZd � fdd� Zdd� Zd dd�Z� ZS ) � GCENodeImagezA GCE Node Image class.Nc s t � j||||d� d S �N�ro )r0 r1 �r6 rm rQ ra ro r; r$ r% r1 * s zGCENodeImage.__init__c C r� )zb Delete this image :return: True if successful :rtype: ``bool`` )�image)ra �ex_delete_imagerf r$ r$ r% �delete- r� zGCENodeImage.deletec C s | j �| |||||�S )a� Deprecate this image :param replacement: Image to use as a replacement :type replacement: ``str`` or :class: `GCENodeImage` :param state: Deprecation state of this image. Possible values include 'ACTIVE', 'DELETED', 'DEPRECATED' or 'OBSOLETE'. :type state: ``str`` :param deprecated: RFC3339 timestamp to mark DEPRECATED :type deprecated: ``str`` or ``None`` :param obsolete: RFC3339 timestamp to mark OBSOLETE :type obsolete: ``str`` or ``None`` :param deleted: RFC3339 timestamp to mark DELETED :type deleted: ``str`` or ``None`` :return: True if successful :rtype: ``bool`` )ra �ex_deprecate_image)r6 � replacement�state� deprecated�obsolete�deletedr$ r$ r% � deprecate7 s �zGCENodeImage.deprecater\ r[ )r( r) r* r] r1 r� r� r_ r$ r$ r; r% r� ' s r� c @ r{ ) �GCESslCertificatez9GCESslCertificate represents the SslCertificate resource.Nc C s2 || _ || _|| _|| _|| _|| _t�| � dS )av :param name: Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. :type name: ``str`` :param certificate: A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. :type certificate: ``str`` :param private_key: A write-only private key in PEM format. Only insert RPCs will include this field. :type private_key: ``str`` :keyword description: An optional description of this resource. Provide this property when you create the resource. :type description: ``str`` :keyword driver: An initialized :class: `GCENodeDriver` :type driver: :class:`:class: `GCENodeDriver`` :keyword extra: A dictionary of extra information. :type extra: ``:class: ``dict```` N)rQ � certificate� private_keyr� ra ro r r1 )r6 rm rQ r� ra ro r� r� r$ r$ r% r1 W s $zGCESslCertificate.__init__c C � d| j S )Nz <GCESslCertificate name="%s">�rQ rf r$ r$ r% rg � � zGCESslCertificate.__repr__c C r� )zu Destroy this SslCertificate. :return: Return True if successful. :rtype: ``bool`` )�sslcertificate)ra �ex_destroy_sslcertificaterf r$ r$ r% rw � r� zGCESslCertificate.destroy�NNr� r$ r$ r$ r% r� T s , r� c @ r{ ) � GCESubnetworkz A GCE Subnetwork object class.Nc C �< t |�| _|| _|| _|| _|| _|| _|| _t� | � d S r\ ) r rm rQ �cidrr� r� ra ro r r1 )r6 rm rQ r� r� r� ra ro r$ r$ r% r1 � � zGCESubnetwork.__init__c C s | j �| �S )zh Destroy this subnetwork :return: True if successful :rtype: ``bool`` )ra �ex_destroy_subnetworkrf r$ r$ r% rw � s zGCESubnetwork.destroyc C s d| j | j| jj| jj| jf S )NzD<GCESubnetwork id="%s" name="%s" region="%s" network="%s" cidr="%s">)rm rQ r� r� r� rf r$ r$ r% rg � s �zGCESubnetwork.__repr__r\ r� r$ r$ r$ r% r� � � r� c @ r{ ) � GCENetworkzA GCE Network object class.Nc C sd t |�| _|| _|| _|| _|| _d| _g | _d|v r+|d dkr+|d | _|d | _t� | � d S )N�legacy�mode� subnetworks) r rm rQ r� ra ro r r r r1 )r6 rm rQ r� ra ro r$ r$ r% r1 � s zGCENetwork.__init__c C r� )ze Destroy this network :return: True if successful :rtype: ``bool`` )r� )ra �ex_destroy_networkrf r$ r$ r% rw � r� zGCENetwork.destroyc C r� )Nz2<GCENetwork id="{}" name="{}" cidr="{}" mode="{}">)r2 rm rQ r� r rf r$ r$ r% rg � r� zGCENetwork.__repr__r\ r� r$ r$ r$ r% r � s r c @ s2 e Zd ZdZ d dd�Zdd� Zdd � ZdS ) �GCERoutezA GCE Route object class.�defaultNc C r� r\ ) r rm rQ � dest_ranger� r� �tagsra ro r r1 ) r6 rm rQ r r� r� r ra ro r$ r$ r% r1 � s zGCERoute.__init__c C r� )zc Destroy this route :return: True if successful :rtype: ``bool`` )�route)ra �ex_destroy_routerf r$ r$ r% rw � r� zGCERoute.destroyc C s& t | jd| j�}d�| j| j| j|�S )NrQ z9<GCERoute id="{}" name="{}" dest_range="{}" network="{}">)�getattrr� r2 rm rQ r )r6 � network_namer$ r$ r% rg � s �zGCERoute.__repr__)r NNNr� r$ r$ r$ r% r � s � r c s" e Zd ZdZd� fdd� Z� ZS )� GCENodeSizez$A GCE Node Size (MachineType) class.Nc s& || _ t� j||||||||d� d S r� )ro r0 r1 ) r6 rm rQ �ram�disk� bandwidth�pricera ro r; r$ r% r1 s zGCENodeSize.__init__r\ )r( r) r* r] r1 r_ r$ r$ r; r% r s r c @ s6 e Zd ZdZd dd�Zd dd�Zd dd �Zd d � ZdS )� GCEProjectzGCE Project information.Nc C r� r\ ) r rm rQ �metadata�quotasra ro r r1 )r6 rm rQ r r ra ro r$ r$ r% r1 r� zGCEProject.__init__Fc C � | j j||d�S )�^ Set common instance metadata for the project. Common uses are for setting 'sshKeys', or setting a project-wide 'startup-script' for all nodes (instances). Passing in ``None`` for the 'metadata' parameter will clear out all common instance metadata *except* for 'sshKeys'. If you also want to update 'sshKeys', set the 'force' parameter to ``True``. :param metadata: Dictionary of metadata. Can be either a standard python dictionary, or the format expected by GCE (e.g. {'items': [{'key': k1, 'value': v1}, ...}] :type metadata: ``dict`` or ``None`` :param force: Force update of 'sshKeys'. If force is ``False`` (the default), existing sshKeys will be retained. Setting force to ``True`` will either replace sshKeys if a new a new value is supplied, or deleted if no new value is supplied. :type force: ``bool`` :return: True if successful :rtype: ``bool`` )r �force)ra � ex_set_common_instance_metadata)r6 r r r$ r$ r% � set_common_instance_metadata s z'GCEProject.set_common_instance_metadatac C r )�. Used to retain Compute Engine resource usage, storing the CSV data in a Google Cloud Storage bucket. See the `docs <https://cloud.google.com/compute/docs/usage-export>`_ for more information. Please ensure you have followed the necessary setup steps prior to enabling this feature (e.g. bucket exists, ACLs are in place, etc.) :param bucket: Name of the Google Cloud Storage bucket. Specify the name in either 'gs://<bucket_name>' or the full URL 'https://storage.googleapis.com/<bucket_name>'. :type bucket: ``str`` :param prefix: Optional prefix string for all reports. :type prefix: ``str`` or ``None`` :return: True if successful :rtype: ``bool`` )�bucket�prefix)ra �ex_set_usage_export_bucket)r6 r r r$ r$ r% �set_usage_export_bucket2 s z"GCEProject.set_usage_export_bucketc C r� )Nz <GCEProject id="{}" name="{}">r� rf r$ r$ r% rg I r� zGCEProject.__repr__r\ �NF)r( r) r* r] r1 r r rg r$ r$ r$ r% r s r c @ s e Zd Zddd�Zdd� ZdS )� GCERegionNc C r� r\ ) r rm rQ �status�zonesr r� ra ro r r1 ) r6 rm rQ r" r# r r� ra ro r$ r$ r% r1 N s zGCERegion.__init__c C ry )Nz*<GCERegion id="{}" name="{}", status="{}">�r2 rm rQ r" rf r$ r$ r% rg Y rz zGCERegion.__repr__r\ )r( r) r* r1 rg r$ r$ r$ r% r! M s r! c s e Zd Zd� fdd� Z� ZS )� GCESnapshotNc s" || _ t� j||||||d� d S )Nr� )r" r0 r1 )r6 rm rQ �sizer" ra ro �createdr; r$ r% r1 b s zGCESnapshot.__init__r� )r( r) r* r1 r_ r$ r$ r; r% r% a s r% c @ r� ) �GCETargetHttpProxyNc C s4 t |�| _|| _|| _|| _|pi | _t�| � d S r\ )r rm rQ �urlmapra ro r r1 )r6 rm rQ r) ra ro r$ r$ r% r1 h s zGCETargetHttpProxy.__init__c C r� )Nz&<GCETargetHttpProxy id="{}" name="{}">r� rf r$ r$ r% rg p r� zGCETargetHttpProxy.__repr__c C r� )zr Destroy this Target HTTP Proxy. :return: True if successful :rtype: ``bool`` ��targethttpproxy)ra �ex_destroy_targethttpproxyrf r$ r$ r% rw s r� zGCETargetHttpProxy.destroyr\ )r( r) r* r1 rg rw r$ r$ r$ r% r( g s r( c @ sD e Zd ZdZ d dd�Zdd� Zdd� Zd d � Zd d � ZdS )�GCETargetHttpsProxyz=GCETargetHttpsProxy represents the TargetHttpsProxy resource.Nc C s2 || _ || _|| _|| _|| _|| _t�| � dS )a_ :param name: Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. :type name: ``str`` :param description: An optional description of this resource. Provide this property when you create the resource. :type description: ``str`` :param sslcertificates: URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. Currently, exactly one SSL certificate must be specified. :type sslcertificates: ``list`` of :class:`GCESslcertificates` :param urlmap: A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. For example, the following are all valid URLs for specifying a URL map: - ht tps://www.googleapis.compute/v1/projects/project/gl obal/urlMaps/url-map - projects/project/global/urlMaps/url-map - global/urlMaps/url-map :type urlmap: :class:`GCEUrlMap` :keyword driver: An initialized :class: `GCENodeDriver` :type driver: :class:`:class: `GCENodeDriver`` :keyword extra: A dictionary of extra information. :type extra: ``:class: ``dict```` N)rQ r� �sslcertificatesr) ra ro r r1 )r6 rm rQ r� r. r) ra ro r$ r$ r% r1 � s 4z GCETargetHttpsProxy.__init__c C r� )Nz <GCETargetHttpsProxy name="%s">r� rf r$ r$ r% rg � r� z GCETargetHttpsProxy.__repr__c C � | j j| |d�S )a Set the SSL Certificates for this TargetHTTPSProxy :param sslcertificates: SSL Certificates to set. :type sslcertificates: ``list`` of :class:`GCESslCertificate` :return: True if successful :rtype: ``bool`` )�targethttpsproxyr. )ra �'ex_targethttpsproxy_set_sslcertificates)r6 r. r$ r$ r% �set_sslcertificates� � �z'GCETargetHttpsProxy.set_sslcertificatesc C r/ )a Changes the URL map for TargetHttpsProxy. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param targethttpsproxy: Name of the TargetHttpsProxy resource whose URL map is to be set. :type targethttpsproxy: ``str`` :param urlmap: UrlMap to set. :type urlmap: :class:`GCEUrlMap` :return: True :rtype: ``bool`` )r0 r) )ra � ex_targethttpsproxy_set_urlmap)r6 r) r$ r$ r% � set_urlmap� s z GCETargetHttpsProxy.set_urlmapc C r� )zw Destroy this TargetHttpsProxy. :return: Return True if successful. :rtype: ``bool`` )r0 )ra �ex_destroy_targethttpsproxyrf r$ r$ r% rw � r� zGCETargetHttpsProxy.destroy)NNNNN) r( r) r* r] r1 rg r2 r5 rw r$ r$ r$ r% r- ~ s �< r- c @ r� ) �GCETargetInstanceNc C r� r\ ) r rm rQ rU �nodera ro r r1 )r6 rm rQ rU r8 ra ro r$ r$ r% r1 � r� zGCETargetInstance.__init__c C r� )zo Destroy this Target Instance :return: True if successful :rtype: ``bool`` )�targetinstance)ra �ex_destroy_targetinstancerf r$ r$ r% rw � r� zGCETargetInstance.destroyc C s. d� | j| j| jjt| jd�r| jjp| j�S )Nz9<GCETargetInstance id="{}" name="{}" zone="{}" node="{}">rQ )r2 rm rQ rU r� r8 rf r$ r$ r% rg s �zGCETargetInstance.__repr__r\ r� r$ r$ r$ r% r7 � s r7 c @ r{ ) � GCEAutoscalerzERepresents a autoscaling policy object used to scale Instance Groups.Nc C r� r\ ) r rm rQ rU �target�policyra ro r r1 )r6 rm rQ rU r< r= ra ro r$ r$ r% r1 r� zGCEAutoscaler.__init__c C r� )zk Destroy this Autoscaler. :return: True if successful :rtype: ``bool`` )� autoscaler)ra �ex_destroy_autoscalerrf r$ r$ r% rw r� zGCEAutoscaler.destroyc C s d� | j| j| jj| jj�S )Nz7<GCEAutoScaler id="{}" name="{}" zone="{}" target="{}">)r2 rm rQ rU r< rf r$ r$ r% rg # s �zGCEAutoscaler.__repr__r\ r� r$ r$ r$ r% r; r r; c @ r{ ) �GCEInstanceTemplatezDRepresents a machine configuration used in creating Instance Groups.Nc C s* t |�| _|| _|| _|| _t�| � d S r\ )r rm rQ ra ro r r1 r� r$ r$ r% r1 / s z GCEInstanceTemplate.__init__c C s d� | j| j| jd �dd��S )Nz8<GCEInstanceTemplate id="{}" name="{}" machineType="{}">� properties� machineType�UNKNOWN)r2 rm rQ ro rI rf r$ r$ r% rg 6 s �z GCEInstanceTemplate.__repr__c C r� )zw Destroy this InstanceTemplate. :return: Return True if successful. :rtype: ``bool`` )�instancetemplate)ra �ex_destroy_instancetemplaterf r$ r$ r% rw = r� zGCEInstanceTemplate.destroyr\ r� r$ r$ r$ r% r@ , s r@ c @ sR e Zd ZdZ ddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dS )r� z7GCEInstanceGroup represents the InstanceGroup resource.Nc C s8 || _ || _|| _|| _|| _|| _|| _t�| � dS )a( :param name: Required. The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. :type name: ``str`` :param zone: The URL of the zone where the instance group is located. :type zone: :class:`GCEZone` :param network: The URL of the network to which all instances in the instance group belong. :type network: :class:`GCENetwork` :param subnetwork: The URL of the subnetwork to which all instances in the instance group belong. :type subnetwork: :class:`GCESubnetwork` :param named_ports: Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports apply to all instances in this instance group. :type named_ports: ``"<type 'list'>"`` N) rQ rU r� � subnetwork� named_portsra ro r r1 ) r6 rm rQ rU ra ro r� rF rG r$ r$ r% r1 K s (zGCEInstanceGroup.__init__c C s d� | j| jj�S )Nz&<GCEInstanceGroup name="{}" zone="{}">)r2 rQ rU rf r$ r$ r% rg | s zGCEInstanceGroup.__repr__c C r� )zt Destroy this InstanceGroup. :return: Return True if successful. :rtype: ``bool`` �� instancegroup)ra �ex_destroy_instancegrouprf r$ r$ r% rw r� zGCEInstanceGroup.destroyc C r/ )� Adds a list of instances to the specified instance group. All of the instances in the instance group must be in the same network/subnetwork. Read Adding instances for more information. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param instancegroup: The Instance Group where you are adding instances. :type instancegroup: :class:``GCEInstanceGroup`` :param node_list: List of nodes to add. :type node_list: ``list`` of :class:`Node` or ``list`` of :class:`GCENode` :return: Return True if successful. :rtype: ``bool`` �rI � node_list)ra � ex_instancegroup_add_instances�r6 rM r$ r$ r% � add_instances� s z GCEInstanceGroup.add_instancesc C r� )a� Lists the instances in the specified instance group. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :return: List of :class:`GCENode` objects. :rtype: ``list`` of :class:`GCENode` objects. rH )ra � ex_instancegroup_list_instancesrf r$ r$ r% �list_instances� s z GCEInstanceGroup.list_instancesc C r/ )a� Removes one or more instances from the specified instance group, but does not delete those instances. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param instancegroup: The Instance Group where you are removng instances. :type instancegroup: :class:``GCEInstanceGroup`` :param node_list: List of nodes to add. :type node_list: ``list`` of :class:`Node` or ``list`` of :class:`GCENode` :return: Return True if successful. :rtype: ``bool`` rL )ra �!ex_instancegroup_remove_instancesrO r$ r$ r% �remove_instances� s �z!GCEInstanceGroup.remove_instancesc C r/ )a� Sets the named ports for the specified instance group. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param named_ports: Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports apply to all instances in this instance group. :type named_ports: ``list`` of {'name': ``str``, 'port`: ``int``} :return: Return True if successful. :rtype: ``bool`` �rI rG )ra � ex_instancegroup_set_named_ports�r6 rG r$ r$ r% �set_named_ports� s �z GCEInstanceGroup.set_named_ports�NNNN) r( r) r* r] r1 rg rw rP rR rT rX r$ r$ r$ r% r� H s �1 r� c @ sb e Zd ZdZddd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dd� Z dS )r� z� GCE Instance Groups Manager class. Handles 'managed' Instance Groups. For more information on Instance Groups, see: https://cloud.google.com/compute/docs/instance-groups Nc C sF t |�| _|| _|| _|pd| _|| _|| _|| _|| _t � | � dS )a] :param id: Internal identifier of Instance Group. Display only. :type id: ``str`` :param name: The name of this Instance Group. :type name: ``str`` :param zone: Zone in witch the Instance Group belongs :type zone: :class: ``GCEZone`` :param size: Number of instances in this Instance Group. :type size: ``int`` :param template: An initialized :class:``GCEInstanceTemplate`` :type driver: :class:``GCEInstanceTemplate`` :param instance_group: An initialized :class:``GCEInstanceGroup`` :type driver: :class:``GCEInstanceGroup`` :param driver: An initialized :class:``GCENodeDriver`` :type driver: :class:``GCENodeDriver`` :param extra: A dictionary of extra information. :type extra: ``dict`` r N) r rm rQ rU r& �templater� ra ro r r1 ) r6 rm rQ rU r& rZ r� ra ro r$ r$ r% r1 � s z GCEInstanceGroupManager.__init__c C r� )z� Destroy this Instance Group. Destroys all instances managed by the Instance Group. :return: True if successful :rtype: ``bool`` ��manager)ra � ex_destroy_instancegroupmanagerrf r$ r$ r% rw s z GCEInstanceGroupManager.destroyc C r� )a Lists all of the instances in this managed instance group. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :return: ``list`` of ``dict`` containing instance URI and currentAction. See ex_instancegroupmanager_list_managed_instances for more details. :rtype: ``list`` r[ )ra �.ex_instancegroupmanager_list_managed_instancesrf r$ r$ r% �list_managed_instances s z.GCEInstanceGroupManager.list_managed_instancesc C r/ )a Set the Instance Template for this Instance Group. :param instancetemplate: Instance Template to set. :type instancetemplate: :class:`GCEInstanceTemplate` :return: True if successful :rtype: ``bool`` )r\ rD )ra �,ex_instancegroupmanager_set_instancetemplate)r6 rD r$ r$ r% �set_instancetemplate. r3 z,GCEInstanceGroupManager.set_instancetemplatec C r� )a( Recreate instances in a Managed Instance Group. :return: ``list`` of ``dict`` containing instance URI and currentAction. See ex_instancegroupmanager_list_managed_instances for more details. :rtype: ``list`` r[ )ra �*ex_instancegroupmanager_recreate_instancesrf r$ r$ r% �recreate_instances= s z*GCEInstanceGroupManager.recreate_instancesc C r/ )a� Removes one or more instances from the specified instance group, and delete those instances. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param node_list: List of nodes to delete. :type node_list: ``list`` of :class:`Node` or ``list`` of :class:`GCENode` :return: Return True if successful. :rtype: ``bool`` )r\ rM )ra �(ex_instancegroupmanager_delete_instancesrO r$ r$ r% �delete_instancesJ s �z(GCEInstanceGroupManager.delete_instancesc C r/ )a^ Set the number of instances for this Instance Group. An increase in num_instances will result in VMs being created. A decrease will result in VMs being destroyed. :param size: Number to instances to resize to. :type size: ``int`` :return: True if successful :rtype: ``bool`` )r\ r& )ra � ex_instancegroupmanager_resize)r6 r& r$ r$ r% �resize_ s z GCEInstanceGroupManager.resizec C s | j j| j|d�S )a� Sets the named ports for the instance group controlled by this manager. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param named_ports: Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports apply to all instances in this instance group. :type named_ports: ``list`` of {'name': ``str``, 'port`: ``int``} :return: Return True if successful. :rtype: ``bool`` rU )ra rV r� rW r$ r$ r% rX n s �z'GCEInstanceGroupManager.set_named_portsc C � | j j| ||d�S )a Sets the autohealing policies for the instance for the instance group controlled by this manager. :param healthcheck: Healthcheck to add :type healthcheck: :class:`GCEHealthCheck` :param initialdelaysec: The time to allow an instance to boot and applications to fully start before the first health check :type initialdelaysec: ``int`` :return: Return True if successful. :rtype: ``bool`` )r\ r� �initialdelaysec)ra �/ex_instancegroupmanager_set_autohealingpolicies)r6 r� ri r$ r$ r% �set_autohealingpolicies� s �z/GCEInstanceGroupManager.set_autohealingpoliciesc C s d| j | jj | jf S )Nz7<GCEInstanceGroupManager name="%s" zone="%s" size="%d">)rQ rU r& rf r$ r$ r% rg � s �z GCEInstanceGroupManager.__repr__r\ )r( r) r* r] r1 rw r_ ra rc re rg rX rk rg r$ r$ r$ r% r� � s $ r� c @ sZ e Zd Zddd�Zdd� Zdd� Zdd � Zd d � Zdd d�Zddd�Z dd� Z dd� Z dS )� GCETargetPoolNc C r� r\ ) r rm rQ r� r� �nodesra ro r r1 )r6 rm rQ r� r� rm ra ro r$ r$ r% r1 � r� zGCETargetPool.__init__c C r/ )z� Add a node to this target pool. :param node: Node to add :type node: ``str`` or :class:`Node` :return: True if successful :rtype: ``bool`` �r� r8 )ra �ex_targetpool_add_node�r6 r8 r$ r$ r% �add_node� � zGCETargetPool.add_nodec C r/ )z� Remove a node from this target pool. :param node: Node to remove :type node: ``str`` or :class:`Node` :return: True if successful :rtype: ``bool`` rn )ra �ex_targetpool_remove_noderp r$ r$ r% � remove_node� rr zGCETargetPool.remove_nodec C r/ )z� Add a healthcheck to this target pool. :param healthcheck: Healthcheck to add :type healthcheck: ``str`` or :class:`GCEHealthCheck` :return: True if successful :rtype: ``bool`` �r� r� )ra � ex_targetpool_add_healthcheck�r6 r� r$ r$ r% �add_healthcheck� rr z GCETargetPool.add_healthcheckc C r/ )z� Remove a healthcheck from this target pool. :param healthcheck: Healthcheck to remove :type healthcheck: ``str`` or :class:`GCEHealthCheck` :return: True if successful :rtype: ``bool`` ru )ra � ex_targetpool_remove_healthcheckrw r$ r$ r% �remove_healthcheck� r3 z GCETargetPool.remove_healthcheck皙�����?c C rh )a/ Set a backup targetpool. :param backup_targetpool: The existing targetpool to use for failover traffic. :type backup_targetpool: :class:`GCETargetPool` :param failover_ratio: The percentage of healthy VMs must fall at or below this value before traffic will be sent to the backup targetpool (default 0.10) :type failover_ratio: ``float`` :return: True if successful :rtype: ``bool`` )r� �backup_targetpool�failover_ratio)ra �#ex_targetpool_set_backup_targetpool)r6 r| r} r$ r$ r% �set_backup_targetpool� s �z#GCETargetPool.set_backup_targetpoolc C r/ )al Return a hash of target pool instances and their health. :param node: Optional node to specify if only a specific node's health status should be returned :type node: ``str``, ``Node``, or ``None`` :return: List of hashes of nodes and their respective health :rtype: ``list`` of ``dict`` rn )ra �ex_targetpool_get_healthrp r$ r$ r% � get_health� s zGCETargetPool.get_healthc C r� )zk Destroy this Target Pool :return: True if successful :rtype: ``bool`` )r� )ra �ex_destroy_targetpoolrf r$ r$ r% rw r� zGCETargetPool.destroyc C r� )Nz-<GCETargetPool id="{}" name="{}" region="{}">)r2 rm rQ r� rf r$ r$ r% rg r� zGCETargetPool.__repr__r\ �r{ ) r( r) r* r1 rq rt rx rz r r� rw rg r$ r$ r$ r% rl � s rl c @ r� ) � GCEUrlMapzA GCE URL Map.Nc C sR t |�| _|| _|| _|pg | _|pg | _|pg | _|| _|p i | _t � | � d S r\ ) r rm rQ �default_service� host_rules� path_matchers�testsra ro r r1 ) r6 rm rQ r� r� r� r� ra ro r$ r$ r% r1 s zGCEUrlMap.__init__c C r� )Nz <GCEUrlMap id="{}" name="{}">r� rf r$ r$ r% rg 5 r� zGCEUrlMap.__repr__c C r� )zg Destroy this URL Map :return: True if successful :rtype: ``bool`` �r) )ra �ex_destroy_urlmaprf r$ r$ r% rw 8 r� zGCEUrlMap.destroyr\ r� r$ r$ r$ r% r� s � r� c sb e Zd ZdZd� fdd� Zedd� �Zedd� �Zd d � Zd d � Z d d� Z dd� Z dd� Z � Z S )�GCEZonez;Subclass of NodeLocation to provide additional information.Nc sD || _ || _|| _|| _|�d�d }t� jt|�||||d� d S )N�-r )rm rQ �countryra ro )r" �maintenance_windowsr� ro �splitr0 r1 r ) r6 rm rQ r" r� r� ra ro r� r; r$ r% r1 F s zGCEZone.__init__c C � | � � S )zl Returns the time until the next Maintenance Window as a datetime.timedelta object. )�_get_time_until_mwrf r$ r$ r% � time_until_mwN � zGCEZone.time_until_mwc C r� )zm Returns the duration of the next Maintenance Window as a datetime.timedelta object. )�_get_next_mw_durationrf r$ r$ r% �next_mw_durationW r� zGCEZone.next_mw_durationc C s t j �� S )zT Returns current UTC time. Can be overridden in unittests. )r �utcnowrf r$ r$ r% �_now` s z GCEZone._nowc C sZ d}d}| j s dS t| j �dkr| j d S | j D ]}t|d �}|r&||k r*|}|}q|S )a% Returns the next Maintenance Window. :return: A dictionary containing maintenance window info (or None if no maintenance windows are scheduled) The dictionary contains 4 keys with values of type ``str`` - name: The name of the maintenance window - description: Description of the maintenance window - beginTime: RFC3339 Timestamp - endTime: RFC3339 Timestamp :rtype: ``dict`` or ``None`` Nr� r � beginTime)r� �lenr& )r6 �begin� next_windowZmwZ begin_nextr$ r$ r% �_get_next_mainti s �zGCEZone._get_next_maintc C s, | � � }|sdS | �� }t|d �}|| S )z� Returns time until next maintenance window. :return: Time until next maintenance window (or None if no maintenance windows are scheduled) :rtype: :class:`datetime.timedelta` or ``None`` Nr� )r� r� r& )r6 r� �now� next_beginr$ r$ r% r� � s zGCEZone._get_time_until_mwc C s0 | � � }|sdS t|d �}t|d �}|| S )z� Returns the duration of the next maintenance window. :return: Duration of next maintenance window (or None if no maintenance windows are scheduled) :rtype: :class:`datetime.timedelta` or ``None`` Nr� ZendTime)r� r& )r6 r� r� Znext_endr$ r$ r% r� � s z GCEZone._get_next_mw_durationc C ry )Nz'<GCEZone id="{}" name="{}" status="{}">r$ rf r$ r$ r% rg � rz zGCEZone.__repr__r\ )r( r) r* r] r1 �propertyr� r� r� r� r� r� rg r_ r$ r$ r; r% r� C s r� c s� e Zd ZdZeZdZdZej Z dZ ddgiZ e je je je je je je jd�ZdZi d d �d d �d d �d d�dd�dd�dd�dd�dd�dd�dd�dd �d d �d d �d!d"�d#d#�d$d%�d&d'd(��Zg d)�g d*�g d+�g d,�d-gg d.�g d/�g d0�g d1�g d2�g d3�g d4�d5� Zg d6�Z 7 7 7 7 7 7�d � fd8d9� Zed:d;� �Zed<d=� �Zed>d?� �Z ed@dA� �Z �d dBdC�Z dDdE� Z dFdG� Z dHdI� Z!dJdK� Z"dLdM� Z#dNdO� Z$dPdQ� Z%�ddRdS�Z&�ddTdU�Z'�ddWdX�Z(�ddYdZ�Z)d[d\� Z*d]d^� Z+d_d`� Z,�ddadb�Z-�ddcdd�Z.�ddedf�Z/dgdh� Z0didj� Z1dkdl� Z2�ddmdn�Z3dodp� Z4�ddrds�Z5dtdu� Z6�ddvdw�Z7dxdy� Z8dzd{� Z9d|d}� Z:�dd~d�Z;�dd�d��Z<d�d�� Z=d�d�� Z>�dd�d��Z?d�d�� Z@�dd�d��ZA�dd�d��ZBd�d�� ZC 7 7 7 � 7�dd�d��ZD�dd�d��ZE � 7 7 7 � 7�dd�d��ZFg d7d7d7dVd7d7fd�d��ZG 7 7 7 7 7 7 7 7�dd�d��ZH 7 7 � 7 � � 7 7 7 7 7 7�dd�d��ZI 7 7 � 7 7 7 V 7 7�dd�d��ZJ 7 7 7 q q 7 7�dd�d��ZK�dd�d��ZL 7 7 7 7�dd�d��ZM 7�d d�d��ZN � � 7 7 7�dd�d��ZO�dd�d��ZP 7 7 7 7 7 7�d d�d��ZQ�dd�d��ZR 7 � 7 7 7 7 q � 7 � q 7 7 7 7 7 7 7 7 7 7 7 7 7�dd�d��ZS 7 7 � q � 7 7 � 7 7 7 7 7 7 7 7 7 7�d d�d��ZT 7 7 � q � 7 � 7 7 7 7 7 7 7 7 7 7 7 q 7 7 7 7�d d�d��ZU 7 7 7 7 7 q � � q q�d d�dZV�d d�dĄZW 7 7 q 7�d d�dƄZX � �d!d�dȄZY 7 � �d"d�dʄZZ 7�dd�d̄Z[d7d�d7d7d7dqdqd�d�d7d�dqd7e\d7d7d7d7d7d7d7d7d7d7fd�dτZ]d�dф Z^�dd�dӄZ_ Ԑd#d�dքZ` 7 7 7 7 7 7�d d�dZad�dڄ Zb 7 7 7 q � 7�d$d�d܄Zcd�dބ Zdd�d� Zed�d� Zfd�d� Zgd�d� Zhd�d� Zid�d� Zj�dd�d�Zk �d%d�d�Zld�d� Zmd�d� Znd�d�� Zod�d�� Zpd�d�� Zqd�d�� Zrd�d�� Zsg fd�d��Zt�d �d� Zu�d�d� Zv�d�d� Zw�d�d� Zx�d�d�d �Zy�d �d � Zz�d �d � Z{�d�d� Z|�d�d� Z}�d �d�d�Z~ 7 7 V 7 7 7 7 7 7�d&�d�d�Z�d�d� Z��d�d�d�Z��d'�d�d�Z��d �d � Z��d �d � Z��d �d!� Z� 7 7 7 7�d�d"�d#�Z��d$�d%� Z��d&�d'� Z��d(�d)� Z��d*�d+� Z��d,�d-� Z��d(�d/�d0�Z��d'�d1�d2�Z��d'�d3�d4�Z��d'�d5�d6�Z��d'�d7�d8�Z��d9�d:� Z��d;�d<� Z��d=�d>� Z��d)�d?�d@�Z�dqdVd�e\f�dA�dB�Z��dC�dD� Z��dE�dF� Z��dG�dH� Z��dI�dJ� Z��dK�dL� Z��dM�dN� Z��dO�dP� Z��dQ�dR� Z��d�dS�dT�Z��d�dU�dV�Z��d�dW�dX�Z��dY�dZ� Z��d[�d\� Z��d]�d^� Z��d�d_�d`�Z��d�da�db�Z� q�d�dc�dd�Z��de�df� Z��dg�dh� Z��d�di�dj�Z��d�dk�dl�Z��dm�dn� Z��d�do�dp�Z��dq�dr� Z��d�ds�dt�Z��du�dv� Z��d�dw�dx�Z��dy�dz� Z��d{�d|� Z��d}�d~� Z��d�d�� Z��d�d��d��Z��d�d��d��Z��d��d�� Z��d�d��d��Z��d�d��d��Z��d��d�� Z��d�d��d��Z��d��d�� Z��d��d�� Z��d��d�� Z��d�d��d��Z��d��d�� Z��d*�d��d��Z��d��d�� Zd��d�� ZÐd��d�� ZĐd+�d��d��ZŐd��d�� ZƐd��d�� Zǐd��d�� Z� 7 7 7 7 � 7 � q 7 7 7 7 7 7 7 7 7 7 7 7 7�d,�d��d��Zɐd��d�� Zʐd��d�� Zːd��d�� Z̐d��d�� Z� 7 7 7 ��d-�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Ą ZdŐdƄ ZאdǐdȄ Zؐdɐdʄ Zِdːd̄ Zڐd͐d΄ Zېd*�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�d�Z�d�d� Z�d�d� Z�d.�d�d��Z�d��d�� Z�i �d�eѓ�d�eғ�d�e��d�eԓ�d�eՓ�d�eӓ�d�eړ�d�eܓ�d eݓ�deؓ�deޓ�deߓ�de��de֓�de��de��de�e�e�e�d ��Z�d�d �d �Z� Z�S (/ � GCENodeDrivera� GCE Node Driver class. This is the primary driver for interacting with Google Compute Engine. It contains all of the standard libcloud methods, plus additional ex_* methods for more features. Note that many methods allow either objects or strings (or lists of objects/strings). In most cases, passing strings instead of objects will result in additional GCE API calls. ZgooglezGoogle Compute Enginezhttps://cloud.google.com/� create_nodeZssh_key)Z PROVISIONINGZSTAGING�RUNNINGZSTOPPING� SUSPENDEDZ TERMINATEDrC z https://www.googleapis.com/auth/Zbigqueryzcloud-platformz compute-rozcompute.readonlyz compute-rw�computeZ datastorez logging-writez logging.writeZ monitoringzmonitoring-writezmonitoring.writezservice-controlZservicecontrolzservice-managementzservice.managementZsqlZ sqlservicez sql-adminzsqlservice.adminz storage-fullzdevstorage.full_controlz storage-ro�devstorage.read_onlyz storage-rwzdevstorage.read_writeZ taskqueuezuseraccounts-rozcloud.useraccounts.readonlyzcloud.useraccountszuserinfo.email)zuseraccounts-rwzuserinfo-email)zcentos-6zcentos-7zcentos-8)zcos-betazcos-devz cos-stable)z coreos-alphaz coreos-betaz coreos-stable)zdebian-8zdebian-9z debian-10z opensuse-leap)zrhel-6zrhel-7zrhel-8)zsles-11zsles-12zsles-15)z sles-11-byosz sles-12-byoszsles-12-sp2-sap-byoszsles-12-sp3-sap-byoszsuse-manager-proxy-byoszsuse-manager-server-byos)zsles-12-sp2-sapzsles-12-sp3-sapzsles-12-sp4-sapz sles-15-sap)zubuntu-1404-ltszubuntu-1604-ltszubuntu-minimal-1604-ltsz ubuntu-1710zubuntu-1804-ltszubuntu-minimal-1804-ltsz ubuntu-1810zubuntu-minimal-1810z ubuntu-1904zubuntu-minimal-1904z ubuntu-1910zubuntu-minimal-1910zubuntu-2004-ltszubuntu-minimal-2004-lts)z windows-1709-core-for-containerszwindows-1709-corezwindows-2008-r2zwindows-2012-r2-corezwindows-2012-r2zwindows-2016-corez windows-2016)zsql-ent-2012-win-2012-r2zsql-std-2012-win-2012-r2zsql-web-2012-win-2012-r2zsql-ent-2014-win-2012-r2zsql-ent-2014-win-2016zsql-std-2014-win-2012-r2zsql-web-2014-win-2012-r2zsql-ent-2016-win-2012-r2zsql-ent-2016-win-2016zsql-std-2016-win-2012-r2zsql-std-2016-win-2016zsql-web-2016-win-2012-r2zsql-web-2016-win-2016zsql-ent-2017-win-2016zsql-exp-2017-win-2012-r2zsql-exp-2017-win-2016zsql-std-2017-win-2016zsql-web-2017-win-2016) z centos-cloudz cos-cloudz coreos-cloudz debian-cloudzopensuse-cloudz rhel-cloudz suse-cloudzsuse-byos-cloudzsuse-sap-cloudzubuntu-os-cloudz windows-cloudzwindows-sql-cloud)ZHTTPZHTTPSZHTTP2ZTCPZSSLNc s� |st d��|| _|| _|| _|ptjd | j | _t� j||fi |�� d� t | j�| _ d| _ d| _ |r<| �|�| _nd| _d| _d| _| jrP| �| j�| _nd| _i | _dS )a* :param user_id: The email address (for service accounts) or Client ID (for installed apps) to be used for authentication. :type user_id: ``str`` :param key: The RSA Key (for service accounts) or file path containing key or Client Secret (for installed apps) to be used for authentication. :type key: ``str`` :keyword datacenter: The name of the datacenter (zone) used for operations. :type datacenter: ``str`` :keyword project: Your GCE project name. (required) :type project: ``str`` :keyword auth_type: Accepted values are "SA" or "IA" or "GCE" ("Service Account" or "Installed Application" or "GCE" if libcloud is being used on a GCE instance with service account enabled). If not supplied, auth_type will be guessed based on value of user_id or if the code is being executed in a GCE instance. :type auth_type: ``str`` :keyword scopes: List of authorization URLs. Default is empty and grants read/write to Compute, Storage, DNS. :type scopes: ``list`` :keyword credential_file: Path to file for caching authentication information used by GCEConnection. :type credential_file: ``str`` z7Project name must be specified using "project" keyword.�.r/ N)r� r- r9 �scopesr Zdefault_credential_filer. r0 r1 r2 r3 � base_path� _zone_dict� _zone_list� ex_get_zonerU � _region_dict� _region_list�_get_region_from_zoner� �_ex_volume_dict) r6 r7 r8 Z datacenterr9 r- r� r. r: r; r$ r% r1 : s( .� zGCENodeDriver.__init__c C �( | j d u r| �� }dd� |D �| _ | j S )Nc S � i | ]}|j |�qS r$ r� )�.0rU r$ r$ r% � <dictcomp>� � z+GCENodeDriver.zone_dict.<locals>.<dictcomp>)r� � ex_list_zones)r6 r# r$ r$ r% � zone_dict� � zGCENodeDriver.zone_dictc C � | j d u r t| j�� �| _ | j S r\ )r� �listr� �valuesrf r$ r$ r% � zone_list� � zGCENodeDriver.zone_listc C r� )Nc S r� r$ r� )r� r� r$ r$ r% r� � r� z-GCENodeDriver.region_dict.<locals>.<dictcomp>)r� �ex_list_regions)r6 �regionsr$ r$ r% � region_dict� r� zGCENodeDriver.region_dictc C r� r\ )r� r� r� r� rf r$ r$ r% � region_list� r� zGCENodeDriver.region_listc C s| t |t�s td��|j}|jd j}d|i}|du r d}||d< |dur(||d< d|i} d �||�} | jj| d || d � d S ) aL Add a network interface access configuration to a node. :keyword node: The existing target Node (instance) that will receive the new access config. :type node: ``Node`` :keyword name: Name of the new access config. :type node: ``str`` :keyword nat_ip: The external existing static IP Address to use for the access config. If not provided, an ephemeral IP address will be allocated. :type nat_ip: ``str`` or ``None`` :keyword config_type: The type of access config to create. Currently the only supported type is 'ONE_TO_ONE_NAT'. :type config_type: ``str`` or ``None`` :return: True if successful :rtype: ``bool`` �*Must specify a valid libcloud node object.rU rQ N�ONE_TO_ONE_NAT�type�natIP�networkInterfacez&/zones/{}/instances/{}/addAccessConfig�POST�rP �datar? T�r� r r� rQ ro r2 rc � async_request) r6 r8 rQ �nicZnat_ipZ config_type� node_namer� Zconfigr? rF r$ r$ r% �ex_add_access_config� s z"GCENodeDriver.ex_add_access_configc C sP t |t�s td��|j}|jd j}||d�}d�||�}| jj|d|d� dS )a� Delete a network interface access configuration from a node. :keyword node: The existing target Node (instance) for the request. :type node: ``Node`` :keyword name: Name of the access config. :type name: ``str`` :keyword nic: Name of the network interface. :type nic: ``str`` :return: True if successful :rtype: ``bool`` r� rU )Z accessConfigr� z)/zones/{}/instances/{}/deleteAccessConfigr� �rP r? Tr� )r6 r8 rQ r� r� r� r? rF r$ r$ r% �ex_delete_access_config� s z%GCENodeDriver.ex_delete_access_configc C s~ t |t�s td��|j}|jd j}d|jv r&d|jd v r&|jd d }nd}| �||�}d�||�}| jj|d|d� d S ) a� Set metadata for the specified node. :keyword node: The existing target Node (instance) for the request. :type node: ``Node`` :keyword metadata: Set (or clear with None) metadata for this particular node. :type metadata: ``dict`` or ``None`` :return: True if successful :rtype: ``bool`` r� rU r � fingerprintZabsentz"/zones/{}/instances/{}/setMetadatar� �rP r� T) r� r r� rQ ro �_format_metadatar2 rc r� )r6 r8 r r� r� � current_fp�bodyrF r$ r$ r% �ex_set_node_metadata� s z"GCENodeDriver.ex_set_node_metadatac C �Z t |t�s td��|j}|jd j}|jd }||d�}d�||�}| jj|d|d� dS ) a[ Set labels for the specified node. :keyword node: The existing target Node (instance) for the request. :type node: ``Node`` :keyword labels: Set (or clear with None) labels for this node. :type labels: ``dict`` or ``None`` :return: True if successful :rtype: ``bool`` r� rU �labelFingerprint��labelsr� z /zones/{}/instances/{}/setLabelsr� r� Tr� )r6 r8 r� r� r� r� r� rF r$ r$ r% �ex_set_node_labels s z GCENodeDriver.ex_set_node_labelsc C sF t |t�s td��|jd }||d�}d|j }| jj|d|d� dS )aZ Set labels for the specified image. :keyword image: The existing target Image for the request. :type image: ``NodeImage`` :keyword labels: Set (or clear with None) labels for this image. :type labels: ``dict`` or ``None`` :return: True if successful :rtype: ``bool`` z+Must specify a valid libcloud image object.r� r� z/global/images/%s/setLabelsr� r� T)r� r r� ro rQ rc r� )r6 r� r� r� r� rF r$ r$ r% �ex_set_image_labels( s z!GCENodeDriver.ex_set_image_labelsc C r� ) ap Set labels for the specified volume (disk). :keyword volume: The existing target StorageVolume for the request. :type volume: ``StorageVolume`` :keyword labels: Set (or clear with None) labels for this image. :type labels: ``dict`` or ``None`` :return: True if successful :rtype: ``bool`` z,Must specify a valid libcloud volume object.rU r� r� z /zones/{}/disks/{}/setLabelsr� r� T)r� r r� rQ ro r2 rc r� )r6 �volumer� � volume_namer� r� r� rF r$ r$ r% �ex_set_volume_labels? s z"GCENodeDriver.ex_set_volume_labelsc C sJ t |t�s td��|j}|jd j}d�||�}| jj|dd�j}|d S )a Fetch the console/serial port output from the node. :keyword node: The existing target Node (instance) for the request. :type node: ``Node`` :return: A string containing serial port output of the node. :rtype: ``str`` r� rU z!/zones/{}/instances/{}/serialPortrN rO �contents) r� r r� rQ ro r2 rc rF rH )r6 r8 r� r� rF rL r$ r$ r% �ex_get_serial_outputY s z"GCENodeDriver.ex_get_serial_outputc K s t d| |d�|��S )a Wrap a list method in a :class:`GCEList` iterator. >>> for sublist in driver.ex_list(driver.ex_list_urlmaps).page(1): ... sublist ... [<GCEUrlMap id="..." name="cli-map">] [<GCEUrlMap id="..." name="lc-map">] [<GCEUrlMap id="..." name="web-map">] :param list_fn: A bound list method from :class:`GCENodeDriver`. :type list_fn: ``instancemethod`` :return: An iterator that returns sublists from list_fn. :rtype: :class:`GCEList` )ra rb Nr$ )r` )r6 rb r: r$ r$ r% �ex_listm s zGCENodeDriver.ex_listc � g }� � |�}|du rd}nd|j }� jj|dd�j}d|v rL|du rA|d �� D ]}� fdd�|�d g �D �}|�|� q*|S � fd d�|d D �}|S ) a� Return a list of DiskTypes for a zone or all. :keyword zone: The zone to return DiskTypes from. For example: 'us-central1-a'. If None, will return DiskTypes from self.zone. If 'all', will return all DiskTypes. :type zone: ``str`` or ``None`` :return: A list of static DiskType objects. :rtype: ``list`` of :class:`GCEDiskType` N�/aggregated/diskTypesz/zones/%s/diskTypesrN rO rD c � g | ]}� � |��qS r$ �� _to_disktype�r� �arf r$ r% � <listcomp>� � z3GCENodeDriver.ex_list_disktypes.<locals>.<listcomp>� diskTypesc r� r$ r� r� rf r$ r% r� � r� �� _set_zonerQ rc rF rH r� rI rG )r6 rU Zlist_disktypesrF rL rZ Zzone_disktypesr$ rf r% �ex_list_disktypes� s �z GCENodeDriver.ex_list_disktypesc C sP |� d�s |� d�rd|i}ntd| ��|r||d< d}| jj|d|d� d S ) r zhttps://www.googleapis.com/�gs://Z bucketNamezInvalid bucket name: %sZreportNamePrefixz/setUsageExportBucketr� r� T)� startswithr� rc r� )r6 r r r� rF r$ r$ r% r � s z(GCENodeDriver.ex_set_usage_export_bucketFc C s� |r| � d|�}d}| �� }|jd }|d }g }d|v r!|d }d}|D ] } | d dkr1| d }q%| �|||�} || d �} | jj|d | d � d S )r �naz/setCommonInstanceMetadata�commonInstanceMetadatar� rD � r8 �sshKeys�value�r� rD r� r� T)r� �ex_get_projectro �_set_project_metadatarc r� ) r6 r r rF r9 Zcurrent_metadatar� Zmd_items� current_keys�md�new_mdr$ r$ r% r � s$ � z-GCENodeDriver.ex_set_common_instance_metadatac s� g }|dkr � � |�}|du rd}n |dkrd}nd|j }� jj|dd�j}d|v rW|du rL|d �� D ]}� fd d �|�d g �D �}|�|� q5|S � fd d �|d D �}|S ) aH Return a list of static addresses for a region, 'global', or all. :keyword region: The region to return addresses from. For example: 'us-central1'. If None, will return addresses from region of self.zone. If 'all', will return all addresses. If 'global', it will return addresses in the global namespace. :type region: ``str`` or ``None`` :return: A list of static address objects. :rtype: ``list`` of :class:`GCEAddress` �globalNz/aggregated/addresses�/global/addresses�/regions/%s/addressesrN rO rD c r� r$ �� _to_addressr� rf r$ r% r� r� z3GCENodeDriver.ex_list_addresses.<locals>.<listcomp>� addressesc r� r$ r� r� rf r$ r% r� r� �� _set_regionrQ rc rF rH r� rI rG )r6 r� Zlist_addressesrF rL rZ Zregion_addressesr$ rf r% �ex_list_addresses� s" �z GCENodeDriver.ex_list_addressesc s4 g }� j jddd�j}� fdd�|�dg �D �}|S )z� Return a list of backend services. :return: A list of backend service objects. :rtype: ``list`` of :class:`GCEBackendService` �/global/backendServicesrN rO c r� r$ )�_to_backendservice�r� r� rf r$ r% r� ) r� z9GCENodeDriver.ex_list_backendservices.<locals>.<listcomp>rD �rc rF rH rI )r6 Zlist_backendservicesrL r$ rf r% �ex_list_backendservices s z%GCENodeDriver.ex_list_backendservicesc �8 g }d}� j j|dd�j}� fdd�|�dg �D �}|S )z� Return the list of health checks. :return: A list of health check objects. :rtype: ``list`` of :class:`GCEHealthCheck` �/global/httpHealthChecksrN rO c r� r$ )�_to_healthcheck�r� �hrf r$ r% r� 7 r� z6GCENodeDriver.ex_list_healthchecks.<locals>.<listcomp>rD r )r6 Zlist_healthchecksrF rL r$ rf r% �ex_list_healthchecks- � z"GCENodeDriver.ex_list_healthchecksc r )z� Return the list of firewalls. :return: A list of firewall objects. :rtype: ``list`` of :class:`GCEFirewall` �/global/firewallsrN rO c r� r$ )� _to_firewall�r� �frf r$ r% r� E r� z3GCENodeDriver.ex_list_firewalls.<locals>.<listcomp>rD r )r6 Zlist_firewallsrF rL r$ rf r% �ex_list_firewalls; r z GCENodeDriver.ex_list_firewallsc s� g }|r d}d}n� � |�}|du rd}nd|j }� jj|dd�j}d|v rU|sJ|du rJ|d �� D ]}� fdd �|�d g �D �}|�|� q3|S � fd d �|d D �}|S ) a� Return the list of forwarding rules for a region or all. :keyword region: The region to return forwarding rules from. For example: 'us-central1'. If None, will return forwarding rules from the region of self.region (which is based on self.zone). If 'all', will return forwarding rules for all regions, which does not include the global forwarding rules. :type region: ``str`` or :class:`GCERegion` or ``None`` :keyword global_rules: List global forwarding rules instead of per-region rules. Setting True will cause 'region' parameter to be ignored. :type global_rules: ``bool`` :return: A list of forwarding rule objects. :rtype: ``list`` of :class:`GCEForwardingRule` N�/global/forwardingRulesz/aggregated/forwardingRules�/regions/%s/forwardingRulesrN rO rD c r� r$ ��_to_forwarding_ruler rf r$ r% r� p � �z:GCENodeDriver.ex_list_forwarding_rules.<locals>.<listcomp>�forwardingRulesc r� r$ r r rf r$ r% r� u r� r )r6 r� Z global_rulesZlist_forwarding_rulesrF rL rZ Zregion_forwarding_rulesr$ rf r% �ex_list_forwarding_rulesI s& � �z&GCENodeDriver.ex_list_forwarding_rulesc C sj |}|dur | j ||d�S | j d|d�}t| j�� �D ]}z |�| j ||d�� W q ty2 Y qw |S )a Return a list of image objects. If no project is specified, a list of all non-deprecated global and vendor images images is returned. By default, only non-deprecated images are returned. :keyword ex_project: Optional alternate project name. :type ex_project: ``str``, ``list`` of ``str``, or ``None`` :keyword ex_include_deprecated: If True, even DEPRECATED images will be returned. :type ex_include_deprecated: ``bool`` :return: List of GCENodeImage objects :rtype: ``list`` of :class:`GCENodeImage` N�� ex_project�ex_include_deprecated)�ex_list_project_imagesr� �IMAGE_PROJECTS�keysrG rt )r6 r r ZdepZ image_list�img_projr$ r$ r% � list_imagesy s � �zGCENodeDriver.list_imagesc C s" g }d}|du r2| j j|dd�}|�dg �D ]}d|vr%|�| �|�� q|r/|�| �|�� q|S g }| j j}t|t�r@|g}|D ]L}|�| j |�} | | j _zz | j j|dd�}W n t yb � w W || j _n|| j _w |�dg �D ]}d|vr�|�| �|�� qt|r�|�| �|�� qtqB|S )a2 Return a list of image objects for a project. If no project is specified, only a list of 'global' images is returned. :keyword ex_project: Optional alternate project name. :type ex_project: ``str``, ``list`` of ``str``, or ``None`` :keyword ex_include_deprecated: If True, even DEPRECATED images will be returned. :type ex_include_deprecated: ``bool`` :return: List of GCENodeImage objects :rtype: ``list`` of :class:`GCENodeImage` �/global/imagesNrN rO rD r� ) rc rM rI rR �_to_node_imager4 r� r rs r9 rt ) r6 r r r$ rF rL Zimg�save_request_pathZprojru r$ r$ r% r � sB � � ����z$GCENodeDriver.ex_list_project_imagesc �4 g }d}� j j|dd�j}� fdd�|d D �}|S )a Return a list of locations (zones). The :class:`ex_list_zones` method returns more comprehensive results, but this is here for compatibility. :return: List of NodeLocation objects :rtype: ``list`` of :class:`NodeLocation` �/zonesrN rO c r� r$ )�_to_node_location)r� �locrf r$ r% r� � r� z0GCENodeDriver.list_locations.<locals>.<listcomp>rD �rc rF rH )r6 �list_locationsrF rL r$ rf r% r- � s z GCENodeDriver.list_locationsc r )z� Return the list of routes. :return: A list of route objects. :rtype: ``list`` of :class:`GCERoute` �/global/routesrN rO c r� r$ )� _to_route�r� �nrf r$ r% r� � r� z0GCENodeDriver.ex_list_routes.<locals>.<listcomp>rD r )r6 Z list_routesrF rL r$ rf r% �ex_list_routes� r z GCENodeDriver.ex_list_routesc r )a� Retrieves the list of SslCertificate resources available to the specified project. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :return: A list of SSLCertificate objects. :rtype: ``list`` of :class:`GCESslCertificate` �/global/sslCertificatesrN rO c r� r$ )�_to_sslcertificater� rf r$ r% r� r� z9GCENodeDriver.ex_list_sslcertificates.<locals>.<listcomp>rD r )r6 � list_datarF rL r$ rf r% �ex_list_sslcertificates� s z%GCENodeDriver.ex_list_sslcertificatesc C s� | � |�}|du r d}nd|j }g }| jj|dd�j}d|v re|du rK|d �� D ] }|�dg �D ]}z |�| �|�� W q2 t yG Y q2w q*|S |d D ]}z |�| �|�� W qO t yd Y qOw |S )aX Return the list of subnetworks. :keyword region: Region for the subnetwork. Specify 'all' to return the aggregated list of subnetworks. :type region: ``str`` or :class:`GCERegion` :return: A list of subnetwork objects. :rtype: ``list`` of :class:`GCESubnetwork` Nz/aggregated/subnetworks�/regions/%s/subnetworksrN rO rD r ) r rQ rc rF rH r� rI rR �_to_subnetworkr )r6 r� rF Zlist_subnetworksrL rZ �ir$ r$ r% �ex_list_subnetworks s0 �� � �z!GCENodeDriver.ex_list_subnetworksc r )z� Return the list of networks. :return: A list of network objects. :rtype: ``list`` of :class:`GCENetwork` �/global/networksrN rO c r� r$ )� _to_networkr0 rf r$ r% r� 5 r� z2GCENodeDriver.ex_list_networks.<locals>.<listcomp>rD r )r6 Z list_networksrF rL r$ rf r% �ex_list_networks+ r z GCENodeDriver.ex_list_networksTc C s� | � |�}| jjd|d�}|�dg �sg S g }| �� |d �� }dd� |D �}tj|� }|D ]}z | j||d�} W n t yC Y q/w |� | � q/i | _ |S )aZ Return a list of nodes in the current zone or all zones. :keyword ex_zone: Optional zone name or 'all' :type ex_zone: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :keyword ex_use_disk_cache: Disk information for each node will retrieved from a dictionary rather than making a distinct API call for it. :type ex_use_disk_cache: ``bool`` :return: List of Node objects :rtype: ``list`` of :class:`Node` � instances�rU rD c S s g | ]}|� d g ��qS )r> �rI )r� �itemr$ r$ r% r� V � z,GCENodeDriver.list_nodes.<locals>.<listcomp>)�use_disk_cache) r� rc rV rI �_ex_populate_volume_dictr� � itertools�chain�_to_noder rR r� ) r6 �ex_zoneZex_use_disk_cacherU rL � list_nodesrD r> �instancer8 r$ r$ r% rI 9 s$ � zGCENodeDriver.list_nodesc r( )z� Return the list of regions. :return: A list of region objects. :rtype: ``list`` of :class:`GCERegion` z/regionsrN rO c r� r$ )� _to_region)r� �rrf r$ r% r� x r� z1GCENodeDriver.ex_list_regions.<locals>.<listcomp>rD r, )r6 Z list_regionsrF rL r$ rf r% r� n � z GCENodeDriver.ex_list_regionsc s� g }�� |�}|du rd}nd|j }�jj|dd�j}tddd�� d |v rT|du rH|d �� D ]}� �fd d �|�d g �D �}|�|� q0|S � �fd d �|d D �}|S )aU Return a list of sizes (machineTypes) in a zone. :keyword location: Location or Zone for sizes :type location: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :return: List of GCENodeSize objects :rtype: ``list`` of :class:`GCENodeSize` Nz/aggregated/machineTypesz/zones/%s/machineTypesrN rO r� � gce_instances�Z driver_typeZ driver_namerD c � g | ]}�� |� ��qS r$ �� _to_node_size�r� �s��instance_pricesr6 r$ r% r� � � �z,GCENodeDriver.list_sizes.<locals>.<listcomp>Z machineTypesc rP r$ rQ rS rU r$ r% r� � rB ) r� rQ rc rF rH r r� rI rG )r6 �location� list_sizesrU rF rL rZ Z zone_sizesr$ rU r% rY | s" � �zGCENodeDriver.list_sizesc r )z� Return the list of disk snapshots in the project. :return: A list of snapshot objects :rtype: ``list`` of :class:`GCESnapshot` z/global/snapshotsrN rO c r� r$ )� _to_snapshotrS rf r$ r% r� � r� z3GCENodeDriver.ex_list_snapshots.<locals>.<listcomp>rD r )r6 Zlist_snapshotsrF rL r$ rf r% �ex_list_snapshots� r z GCENodeDriver.ex_list_snapshotsc �0 d}� j j|dd�j}� fdd�|�dg �D �S )z� Return the list of target HTTP proxies. :return: A list of target http proxy objects :rtype: ``list`` of :class:`GCETargetHttpProxy` �/global/targetHttpProxiesrN rO c r� r$ )�_to_targethttpproxy�r� �urf r$ r% r� � r� z;GCENodeDriver.ex_list_targethttpproxies.<locals>.<listcomp>rD r �r6 rF rL r$ rf r% �ex_list_targethttpproxies� � z'GCENodeDriver.ex_list_targethttpproxiesc r\ )z� Return the list of target HTTPs proxies. :return: A list of target https proxy objects :rtype: ``list`` of :class:`GCETargetHttpsProxy` �/global/targetHttpsProxiesrN rO c r� r$ )�_to_targethttpsproxy�r� �xrf r$ r% r� � r� z<GCENodeDriver.ex_list_targethttpsproxies.<locals>.<listcomp>rD r ra r$ rf r% �ex_list_targethttpsproxies� rc z(GCENodeDriver.ex_list_targethttpsproxiesc r� ) z� Return the list of target instances. :return: A list of target instance objects :rtype: ``list`` of :class:`GCETargetInstance` Nz/aggregated/targetInstances�/zones/%s/targetInstancesrN rO rD c r� r$ ��_to_targetinstance�r� �trf r$ r% r� � r z9GCENodeDriver.ex_list_targetinstances.<locals>.<listcomp>�targetInstancesc r� r$ rj rl rf r$ r% r� � r� r� )r6 rU Zlist_targetinstancesrF rL rZ Zzone_targetinstancesr$ rf r% �ex_list_targetinstances� s � �z%GCENodeDriver.ex_list_targetinstancesc r� ) z� Return the list of target pools. :return: A list of target pool objects :rtype: ``list`` of :class:`GCETargetPool` Nz/aggregated/targetPools�/regions/%s/targetPoolsrN rO rD c r� r$ ��_to_targetpoolrl rf r$ r% r� � r� z5GCENodeDriver.ex_list_targetpools.<locals>.<listcomp>� targetPoolsc r� r$ rq rl rf r$ r% r� � r� r )r6 r� Zlist_targetpoolsrF rL rZ Zregion_targetpoolsr$ rf r% �ex_list_targetpools� s �z!GCENodeDriver.ex_list_targetpoolsc r\ )z� Return the list of URL Maps in the project. :return: A list of url map objects :rtype: ``list`` of :class:`GCEUrlMap` �/global/urlMapsrN rO c r� r$ )� _to_urlmapr_ rf r$ r% r� r� z1GCENodeDriver.ex_list_urlmaps.<locals>.<listcomp>rD r ra r$ rf r% �ex_list_urlmaps rc z GCENodeDriver.ex_list_urlmapsc r� ) aF Retrieves the list of instance groups that are located in the specified project and zone. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :param zone: The name of the zone where the instance group is located. :type zone: ``str`` :return: A list of instance group mgr objects. :rtype: ``list`` of :class:`GCEInstanceGroupManagers` Nz/aggregated/instanceGroups�/zones/%s/instanceGroupsrN rO rD c r� r$ ��_to_instancegroupr� rf r$ r% r� - r� z8GCENodeDriver.ex_list_instancegroups.<locals>.<listcomp>�instanceGroupsc r� r$ ry r� rf r$ r% r� 0 r� r� )r6 rU r5 rF rL rZ Z zone_datar$ rf r% �ex_list_instancegroups s �z$GCENodeDriver.ex_list_instancegroupsc r� ) a� Return a list of Instance Group Managers. :keyword zone: The zone to return InstanceGroupManagers from. For example: 'us-central1-a'. If None, will return InstanceGroupManagers from self.zone. If 'all', will return all InstanceGroupManagers. :type zone: ``str`` or ``None`` :return: A list of instance group mgr objects. :rtype: ``list`` of :class:`GCEInstanceGroupManagers` Nz!/aggregated/instanceGroupManagers� /zones/%s/instanceGroupManagersrN rO rD c r� r$ ��_to_instancegroupmanagerr� rf r$ r% r� O r z?GCENodeDriver.ex_list_instancegroupmanagers.<locals>.<listcomp>�instanceGroupManagersc r� r$ r~ r� rf r$ r% r� T r� r� )r6 rU Z list_managersrF rL rZ Z zone_managersr$ rf r% � ex_list_instancegroupmanagers4 s � �z+GCENodeDriver.ex_list_instancegroupmanagersc r\ )z� Return the list of Instance Templates. :return: A list of Instance Template Objects :rtype: ``list`` of :class:`GCEInstanceTemplate` �/global/instanceTemplatesrN rO c r� r$ )�_to_instancetemplater_ rf r$ r% r� b r� z;GCENodeDriver.ex_list_instancetemplates.<locals>.<listcomp>rD r ra r$ rf r% �ex_list_instancetemplatesX rc z'GCENodeDriver.ex_list_instancetemplatesc r� ) a� Return the list of AutoScalers. :keyword zone: The zone to return InstanceGroupManagers from. For example: 'us-central1-a'. If None, will return InstanceGroupManagers from self.zone. If 'all', will return all InstanceGroupManagers. :type zone: ``str`` or ``None`` :return: A list of AutoScaler Objects :rtype: ``list`` of :class:`GCEAutoScaler` Nz/aggregated/autoscalers�/zones/%s/autoscalersrN rO rD c r� r$ ��_to_autoscalerr� rf r$ r% r� � r� z5GCENodeDriver.ex_list_autoscalers.<locals>.<listcomp>Z autoscalersc r� r$ r� r� rf r$ r% r� � r� r� )r6 rU Zlist_autoscalersrF rL rZ Zzone_asr$ rf r% �ex_list_autoscalersd s �z!GCENodeDriver.ex_list_autoscalersc s� g }� � |�}|du rd}nd|j }� jj|dd�j}d|v rL|du rA|d �� D ]}� fdd�|�d g �D �}|�|� q*|S � fd d�|d D �}|S ) a� Return a list of volumes for a zone or all. Will return list from provided zone, or from the default zone unless given the value of 'all'. :keyword ex_zone: The zone to return volumes from. :type ex_zone: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :return: A list of volume objects. :rtype: ``list`` of :class:`StorageVolume` Nz/aggregated/disks�/zones/%s/disksrN rO rD c r� r$ ��_to_storage_volumer rf r$ r% r� � r� z.GCENodeDriver.list_volumes.<locals>.<listcomp>�disksc r� r$ r� r rf r$ r% r� � r� r� )r6 rH � list_volumesrU rF rL rZ Z zone_volumesr$ rf r% r� � s �zGCENodeDriver.list_volumesc r( )z� Return the list of zones. :return: A list of zone objects. :rtype: ``list`` of :class:`GCEZone` r) rN rO c r� r$ )�_to_zone�r� �zrf r$ r% r� � r� z/GCENodeDriver.ex_list_zones.<locals>.<listcomp>rD r, )r6 Z list_zonesrF rL r$ rf r% r� � rM zGCENodeDriver.ex_list_zones�EXTERNALc C s� |p| j }|du rtdd��|dkr t|d�s | �|�}d|i}|r&||d< |r,||d< |r;|dvr7td d ��||d < |rF|d krFtd d��|rSt|d�sS| �||�}|dkrZd}nd|j }| jj|d|d� | j||d�S )a� Create a static address in a region, or a global address. :param name: Name of static address :type name: ``str`` :keyword region: Name of region for the address (e.g. 'us-central1') Use 'global' to create a global address. :type region: ``str`` or :class:`GCERegion` :keyword address: Ephemeral IP address to promote to a static one (e.g. 'xxx.xxx.xxx.xxx') :type address: ``str`` or ``None`` :keyword description: Optional descriptive comment. :type description: ``str`` or ``None`` :keyword address_type: Optional The type of address to reserve, either INTERNAL or EXTERNAL. If unspecified, defaults to EXTERNAL. :type description: ``str`` :keyword subnetwork: Optional The URL of the subnetwork in which to reserve the address. If an IP address is specified, it must be within the subnetwork's IP range. This field can only be used with INTERNAL type with GCE_ENDPOINT/DNS_RESOLVER purposes. :type description: ``str`` :return: Static Address object :rtype: :class:`GCEAddress` NZREGION_NOT_SPECIFIEDz&Region must be provided for an addressr� rQ r� r� )r� �INTERNALZADDRESS_TYPE_WRONGzQAddress type must be either EXTERNAL or INTERNALZ addressTyper� Z INVALID_ARGUMENT_COMBINATIONzQAddress type must be internal if subnetwork providedr� r� r� r� �r� ) r� r� r� � ex_get_region�ex_get_subnetworkrQ rc r� �ex_get_address) r6 rQ r� r� r� Z address_typerF Z address_datarF r$ r$ r% �ex_create_address� s: * � � z GCENodeDriver.ex_create_addressc C sv |p| j }i }d|i}t|d�s| �|�}|jd |d< ||d< d|j }|jd |d< | jj|d|d� | �||�S ) a{ Create an Autoscaler for an Instance Group. :param name: The name of the Autoscaler :type name: ``str`` :param zone: The zone to which the Instance Group belongs :type zone: ``str`` or :class:`GCEZone` :param instance_group: An Instance Group Manager object. :type: :class:`GCEInstanceGroupManager` :param policy: A dict containing policy configuration. See the API documentation for Autoscalers for more details. :type: ``dict`` :return: An Autoscaler object. :rtype: :class:`GCEAutoscaler` rQ rq rU �autoscalingPolicyr� r< r� r� )rU r� r� ro rQ rc r� �ex_get_autoscaler)r6 rQ rU r� r= r� Zautoscaler_datarF r$ r$ r% �ex_create_autoscaler s z"GCENodeDriver.ex_create_autoscalerr� r� c C s t |||||||d�S )a Helper Object to create a backend. :param instance_group: The Instance Group for this Backend. :type instance_group: :class: `GCEInstanceGroup` :param balancing_mode: Specifies the balancing mode for this backend. For global HTTP(S) load balancing, the valid values are UTILIZATION (default) and RATE. For global SSL load balancing, the valid values are UTILIZATION (default) and CONNECTION. :type balancing_mode: ``str`` :param max_utilization: Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0]. :type max_utilization: ``float`` :param max_rate: The max requests per second (RPS) of the group. Can be used with either RATE or UTILIZATION balancing modes, but required if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set. :type max_rate: ``int`` :param max_rate_per_instance: The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set. :type max_rate_per_instance: ``float`` :param capacity_scaler: A multiplier applied to the group's maximum servicing capacity (based on UTILIZATION, RATE, or CONNECTION). Default value is 1, which means the group will serve up to 100% of its configured capacity (depending on balancingMode). A setting of 0 means the group is completely drained, offering 0% of its available capacity. Valid range is [0.0,1.0]. :type capacity_scaler: ``float`` :param description: An optional description of this resource. Provide this property when you create the resource. :type description: ``str`` :return: A GCEBackend object. :rtype: :class: `GCEBackend` )r� r� r� r� r� r� r� )r� r� r$ r$ r% �ex_create_backend2 s A�z GCENodeDriver.ex_create_backendc C s� |g g |d�} |D ]} t | d�s| j| d�} | d �| jd � q |D ]} t| t�r4| d �| �� � q#| d �| � q#|rB|| d< | rH| | d< |rN|| d < |rd|| jv rZ|| d < n td d � | j� ��|rj|| d < d} | j j | d| d� | � |�S )aQ Create a global Backend Service. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param name: Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. :type name: ``str`` :param healthchecks: A list of HTTP Health Checks to use for this service. There must be at least one. :type healthchecks: ``list`` of (``str`` or :class:`GCEHealthCheck`) :keyword backends: The list of backends that serve this BackendService. :type backends: ``list`` of :class `GCEBackend` or list of ``dict`` :keyword timeout_sec: How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds. :type timeout_sec: ``integer`` :keyword enable_cdn: If true, enable Cloud CDN for this BackendService. When the load balancing scheme is INTERNAL, this field is not used. :type enable_cdn: ``bool`` :keyword port: Deprecated in favor of port_name. The TCP port to connect on the backend. The default value is 80. This cannot be used for internal load balancing. :type port: ``integer`` :keyword port_name: Name of backend port. The same name should appear in the instance groups referenced by this service. :type port_name: ``str`` :keyword protocol: The protocol this Backend Service uses to communicate with backends. Possible values are HTTP, HTTPS, HTTP2, TCP and SSL. :type protocol: ``str`` :return: A Backend Service object. :rtype: :class:`GCEBackendService` )rQ � healthChecksr� Z enableCDNro r� r� rq r� r� �portName� timeoutSecr� zProtocol must be one of %s�,r� r r� r� ) r� �ex_get_healthcheckrR ro r� r� r� �BACKEND_SERVICE_PROTOCOLSr� �joinrc r� �ex_get_backendservice)r6 rQ r� r� r� r� Z timeout_secZ enable_cdnr� r� Zbackendservice_data�hc�berF r$ r$ r% �ex_create_backendservice} s< D� � z&GCENodeDriver.ex_create_backendservicec C s� i } || d< |r || d< | r| | d< |pd| d< |pd| d< |p!d| d < |p'd| d < |p-d | d < |p3d | d < d} | j j| d| d� | �|�S )a Create an Http Health Check. :param name: Name of health check :type name: ``str`` :keyword host: Hostname of health check request. Defaults to empty and public IP is used instead. :type host: ``str`` :keyword path: The request path for the check. Defaults to /. :type path: ``str`` :keyword port: The TCP port number for the check. Defaults to 80. :type port: ``int`` :keyword interval: How often (in seconds) to check. Defaults to 5. :type interval: ``int`` :keyword timeout: How long to wait before failing. Defaults to 5. :type timeout: ``int`` :keyword unhealthy_threshold: How many failures before marking unhealthy. Defaults to 2. :type unhealthy_threshold: ``int`` :keyword healthy_threshold: How many successes before marking as healthy. Defaults to 2. :type healthy_threshold: ``int`` :keyword description: The description of the check. Defaults to None. :type description: ``str`` or ``None`` :return: Health Check object :rtype: :class:`GCEHealthCheck` rQ r^ r� �/� requestPath�P r� � �checkIntervalSecr� � �unhealthyThreshold�healthyThresholdr r� r� )rc r� r� ) r6 rQ r^ r� r� r� r� r� r� r� �hc_datarF r$ r$ r% �ex_create_healthcheck� s 0 z#GCENodeDriver.ex_create_healthcheckr �INGRESS�� c C s i }t |d�s | �|�}n|}||d< ||d< ||d< | |d< |dkr(||d< n|dkr0||d< |jd |d < | d u rF| d u rF|d u rFd g} | d urN| |d < | d urV| |d< |d ur^||d< | d urf| |d< | d urn| |d< |d urv||d< d}| jj|d|d� | �|�S )a� Create a firewall rule on a network. Rules can be for Ingress or Egress, and they may Allow or Deny traffic. They are also applied in order based on action (Deny, Allow) and Priority. Rules can be applied using various Source and Target filters. Firewall rules should be supplied in the "allowed" or "denied" field. This is a list of dictionaries formatted like so ("ports" is optional): [{"IPProtocol": "<protocol string or number>", "ports": "<port_numbers or ranges>"}] For example, to allow tcp on port 8080 and udp on all ports, 'allowed' would be:: [{"IPProtocol": "tcp", "ports": ["8080"]}, {"IPProtocol": "udp"}] Note that valid inputs vary by direction (INGRESS vs EGRESS), action (allow/deny), and source/target filters (tag vs range etc). See `Firewall Reference <https://developers.google.com/compute/docs/ reference/latest/firewalls/insert>`_ for more information. :param name: Name of the firewall to be created :type name: ``str`` :param description: Optional description of the rule. :type description: ``str`` :param direction: Direction of the FW rule - "INGRESS" or "EGRESS" Defaults to 'INGRESS'. :type direction: ``str`` :param priority: Priority integer of the rule - lower is applied first. Defaults to 1000 :type priority: ``int`` :param allowed: List of dictionaries with rules for type INGRESS :type allowed: ``list`` of ``dict`` :param denied: List of dictionaries with rules for type EGRESS :type denied: ``list`` of ``dict`` :keyword network: The network that the firewall applies to. :type network: ``str`` or :class:`GCENetwork` :keyword source_ranges: A list of IP ranges in CIDR format that the firewall should apply to. Defaults to ['0.0.0.0/0'] :type source_ranges: ``list`` of ``str`` :keyword source_service_accounts: A list of source service accounts the rules apply to. :type source_service_accounts: ``list`` of ``str`` :keyword source_tags: A list of source instance tags the rules apply to. :type source_tags: ``list`` of ``str`` :keyword target_tags: A list of target instance tags the rules apply to. :type target_tags: ``list`` of ``str`` :keyword target_service_accounts: A list of target service accounts the rules apply to. :type target_service_accounts: ``list`` of ``str`` :keyword target_ranges: A list of IP ranges in CIDR format that the EGRESS type rule should apply to. Defaults to ['0.0.0.0/0'] :type target_ranges: ``list`` of ``str`` :return: Firewall object :rtype: :class:`GCEFirewall` rQ r� r� r� r� r� ZEGRESSr� rq r� Nz 0.0.0.0/0� sourceRanges� sourceTags�sourceServiceAccounts� targetTags�targetServiceAccounts�destinationRangesr r� r� )r� �ex_get_networkro rc r� �ex_get_firewall)r6 rQ r� r� r� r� r� r� r� r� r� r� r� r� � firewall_dataZnwrF r$ r$ r% �ex_create_firewall2 s< ^ z GCENodeDriver.ex_create_firewall�tcpc C s d|i} |rt |d�s| �|�}n%|p| j}t |d�s | �|�}|jd | d< |s+| }t |d�s6| �||�}|jd | d< |�� | d< |rYt |d�sT| �||rQdn|�}|j| d< |r_|| d< |re|| d < | rk| | d < |rpd } nd |j } | j j | d | d� | j ||d�S )a� Create a forwarding rule. :param name: Name of forwarding rule to be created :type name: ``str`` :keyword target: The target of this forwarding rule. For global forwarding rules this must be a global TargetHttpProxy. For regional rules this may be either a TargetPool or TargetInstance. If passed a string instead of the object, it will be the name of a TargetHttpProxy for global rules or a TargetPool for regional rules. A TargetInstance must be passed by object. (required) :type target: ``str`` or :class:`GCETargetHttpProxy` or :class:`GCETargetInstance` or :class:`GCETargetPool` :keyword region: Region to create the forwarding rule in. Defaults to self.region. Ignored if global_rule is True. :type region: ``str`` or :class:`GCERegion` :keyword protocol: Should be 'tcp' or 'udp' :type protocol: ``str`` :keyword port_range: Single port number or range separated by a dash. Examples: '80', '5000-5999'. Required for global forwarding rules, optional for regional rules. :type port_range: ``str`` :keyword address: Optional static address for forwarding rule. Must be in same region. :type address: ``str`` or :class:`GCEAddress` :keyword description: The description of the forwarding rule. Defaults to None. :type description: ``str`` or ``None`` :keyword targetpool: Deprecated parameter for backwards compatibility. Use target instead. :type targetpool: ``str`` or :class:`GCETargetPool` :keyword lb_scheme: Load balancing scheme, can be 'EXTERNAL' or 'INTERNAL'. Defaults to 'EXTERNAL'. :type lb_scheme: ``str`` or ``None`` :return: Forwarding Rule object :rtype: :class:`GCEForwardingRule` rQ rq r� r< � IPProtocolr� � IPAddress� portRanger� ZloadBalancingSchemer r r� r� )� global_rule) r� �ex_get_targethttpproxyr� r� ro �ex_get_targetpool�upperr� r� rQ rc r� �ex_get_forwarding_rule) r6 rQ r< r� r� Z port_ranger� r� r� r� Z lb_schemeZforwarding_rule_datarF r$ r$ r% �ex_create_forwarding_rule� s< = � z'GCENodeDriver.ex_create_forwarding_rulec C sF i } || d< || d< || d< t |t�r#|jd | d< |jd j| d< nt |t�r:|�d�r:|�d�r:|d d �| d < ntd ��|rLt |t�rH|g}|| d < | rR| | d< |rng | d< t |t�r`|g}|D ] } | d �d| i� qbd} z|r}| j j | d| d� n | j j | d| d� W n t y� } z |s�| �W Y d} ~ nd} ~ ww | � |�S )a` Create an image from the provided volume. :param name: The name of the image to create. :type name: ``str`` :param volume: The volume to use to create the image, or the Google Cloud Storage URI :type volume: ``str`` or :class:`StorageVolume` :keyword description: Description of the new Image :type description: ``str`` :keyword family: The name of the image family to which this image belongs. If you create resources by specifying an image family instead of a specific image name, the resource uses the latest non-deprecated image that is set with that family name. :type family: ``str`` :keyword guest_os_features: Features of the guest operating system, valid for bootable images only. :type guest_os_features: ``list`` of ``str`` or ``None`` :keyword ex_licenses: List of strings representing licenses to be associated with the image. :type ex_licenses: ``list`` of ``str`` :keyword ex_labels: Labels dictionary for image. :type ex_labels: ``dict`` or ``None`` :keyword use_existing: If True and an image with the given name already exists, return an object for that image instead of attempting to create a new image. :type use_existing: ``bool`` :keyword wait_for_completion: If True, wait until the new image is created before returning a new NodeImage Otherwise, return a new NodeImage instance, and let the user track the creation progress :type wait_for_completion: ``bool`` :return: A GCENodeImage object for the new image :rtype: :class:`GCENodeImage` rQ r� �familyrq � sourceDiskrU �https://ztar.gzZTAR)�sourceZ containerType�rawDiskz/Source must be instance of StorageVolume or URI�licensesr� �guestOsFeaturesr� r% r� r� N)r� r ro rQ r r� �endswithr� rR rc r� rF r � ex_get_image)r6 rQ r� r� r� �guest_os_features� use_existingZwait_for_completion� ex_licenses� ex_labels� image_data�featurerF �er$ r$ r% �ex_create_image& sP < ��� � ��� z GCENodeDriver.ex_create_imagec C s� |� d�r |�ddd�}|||dd|id�}|r2g |d< t|t�r$|g}|D ] }|d �d|i� q&d }| jj|d |d � | �|�S ) a� Copy an image to your image collection. :param name: The name of the image :type name: ``str`` :param url: The URL to the image. The URL can start with `gs://` :type url: ``str`` :param description: The description of the image :type description: ``str`` :param family: The family of the image :type family: ``str`` :param guest_os_features: The features of the guest operating system. :type guest_os_features: ``list`` of ``str`` or ``None`` :return: NodeImage object based on provided information or None if an image with that name is not found. :rtype: :class:`NodeImage` or ``None`` r� z https://storage.googleapis.com/r� ZRAWr� )rQ r� r� � sourceTyper� r� r� r% r� r� )r� rs r� r rR rc r� r� ) r6 rQ �urlr� r� r� r� r� rF r$ r$ r% � ex_copy_image� s" � zGCENodeDriver.ex_copy_imagec C s� |p| j }t|d�s| �|�}d|j }i }||d< |jd |d< |r'||d< |r0|jd |d< |r9|jd |d< |r?||d< | jj|d |d � | �||�S ) a� Creates an instance group in the specified project using the parameters that are included in the request. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param name: Required. The name of the instance group. The name must be 1-63 characters long, and comply with RFC1035. :type name: ``str`` :param zone: The URL of the zone where the instance group is located. :type zone: :class:`GCEZone` :keyword description: An optional description of this resource. Provide this property when you create the resource. :type description: ``str`` :keyword network: The URL of the network to which all instances in the instance group belong. :type network: :class:`GCENetwork` :keyword subnetwork: The URL of the subnetwork to which all instances in the instance group belong. :type subnetwork: :class:`GCESubnetwork` :keyword named_ports: Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports apply to all instances in this instance group. :type named_ports: ``list`` of {'name': ``str``, 'port`: ``int``} :return: `GCEInstanceGroup` object. :rtype: :class:`GCEInstanceGroup` rQ rx rq rU r� r� rF � namedPortsr� r� )rU r� r� rQ ro rc r� �ex_get_instancegroup) r6 rQ rU r� r� rF rG rF � request_datar$ r$ r% �ex_create_instancegroup� s" 3 z%GCENodeDriver.ex_create_instancegroupc C s� |p| j }t|d�s| �|�}d|j }i }t|d�s | �|�}|jd |d< ||d< |dur3||d< ||d< ||d< ||d< | jj|d |d � | �||�S ) ar Create a Managed Instance Group. :param name: Name of the Instance Group. :type name: ``str`` :param zone: The zone to which the Instance Group belongs :type zone: ``str`` or :class:`GCEZone` or ``None`` :param template: The Instance Template. Should be an instance of GCEInstanceTemplate or a string. :type template: ``str`` or :class:`GCEInstanceTemplate` :param base_instance_name: The prefix for each instance created. If None, Instance Group name will be used. :type base_instance_name: ``str`` :param description: User-supplied text about the Instance Group. :type description: ``str`` :return: An Instance Group Manager object. :rtype: :class:`GCEInstanceGroupManager` rQ r} rq �instanceTemplate�baseInstanceNameN� targetSizer� r� r� ) rU r� r� rQ �ex_get_instancetemplatero rc r� �ex_get_instancegroupmanager) r6 rQ rU rZ r& Zbase_instance_namer� rF Z manager_datar$ r$ r% � ex_create_instancegroupmanager s z,GCENodeDriver.ex_create_instancegroupmanagerrB c C s� i }||d< ||d< ||d< ||d< t |t�r |�d�r |} nt |t�r/| �|�}|jd } n|jd } | |d< ||d< |d u rMd �t| jd �} | |d < nt |t�rW||d < n|jd |d< d} | jj | d|d� | � |�S )ag Create a route. :param name: Name of route to be created :type name: ``str`` :param dest_range: Address range of route in CIDR format. :type dest_range: ``str`` :param priority: Priority value, lower values take precedence :type priority: ``int`` :param network: The network the route belongs to. Can be either the full URL of the network, the name of the network or a libcloud object. :type network: ``str`` or ``GCENetwork`` :param tags: List of instance-tags for routing, empty for all nodes :type tags: ``list`` of ``str`` or ``None`` :param next_hop: Next traffic hop. Use ``None`` for the default Internet gateway, or specify an instance or IP address. :type next_hop: ``str``, ``Node``, or ``None`` :param description: Custom description for the route. :type description: ``str`` or ``None`` :return: Route object :rtype: :class:`GCERoute` rQ � destRanger� r� r� rq r� r Nz4https://www.googleapis.com/compute/{}/projects/{}/{}z(global/gateways/default-internet-gateway�nextHopGateway� nextHopIp�nextHopInstancer. r� r� ) r� r r� r� ro r2 r3 r9 rc r� � ex_get_route) r6 rQ r r� r� r Znext_hopr� Z route_dataZ network_urir� rF r$ r$ r% �ex_create_routeE s4 ) � z GCENodeDriver.ex_create_routec C sD d}i }||d< ||d< ||d< ||d< | j j|d|d� | �|�S )aD Creates a SslCertificate resource in the specified project using the data included in the request. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param name: Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. :type name: ``str`` :param certificate: A string containing local certificate file in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert. :type certificate: ``str`` :param private_key: A string containing a write-only private key in PEM format. Only insert RPCs will include this field. :type private_key: ``str`` :keyword description: An optional description of this resource. Provide this property when you create the resource. :type description: ``str`` :return: `GCESslCertificate` object. :rtype: :class:`GCESslCertificate` r3 rQ r� Z privateKeyr� r� r� )rc r� �ex_get_sslcertificate)r6 rQ r� r� r� rF r� r$ r$ r% �ex_create_sslcertificate� s ) z&GCENodeDriver.ex_create_sslcertificatec C s |st d��|s t d��t|t�r|jd }n|�d�r |}n | �|�} | jd }|s/t d��t|t�r:|jd } n|�d�rB|} n | �|�} | jd } i } || d< || d< || d< || d < | | d < || d < || d < | �d �d } d| }| j j |d| d� | � || �S )a� Create a subnetwork. :param name: Name of subnetwork to be created :type name: ``str`` :param cidr: Address range of network in CIDR format. :type cidr: ``str`` :param network: The network name or object this subnet belongs to. :type network: ``str`` or :class:`GCENetwork` :param region: The region the subnetwork belongs to. :type region: ``str`` or :class:`GCERegion` :param description: Custom description for the network. :type description: ``str`` or ``None`` :param privateipgoogleaccess: Allow access to Google services without assigned external IP addresses. :type privateipgoogleaccess: ``bool` or ``None`` :param secondaryipranges: List of dicts of secondary or "alias" IP ranges for this subnetwork in [{"rangeName": "second1", "ipCidrRange": "192.168.168.0/24"}, {k:v, k:v}] format. :type secondaryipranges: ``list`` of ``dict`` or ``None`` :return: Subnetwork object :rtype: :class:`GCESubnetwork` z,Must provide an IP network in CIDR notation.z*Must provide a network for the subnetwork.rq r� z)Must provide a region for the subnetwork.rQ r� � ipCidrRanger� r� �privateIpGoogleAccess�secondaryIpRangesr� ���r7 r� r� ) r� r� r ro r� r� r! r� r� rc r� r� )r6 rQ r� r� r� r� ZprivateipgoogleaccessZsecondaryiprangesZ network_urlZ network_objZ region_urlZ region_objZ subnet_data� region_namerF r$ r$ r% �ex_create_subnetwork� s< + z"GCENodeDriver.ex_create_subnetworkr c C s� i }||d< ||d< |� � dvrtd| ��|r |dv r td��|dkr/|s*td��||d < n|� � d k|d < |rM|� � d vrEtd | ��d|�� i|d< d}| jj|d|d� | �|�S )a� Create a network. In November 2015, Google introduced Subnetworks and suggests using networks with 'auto' generated subnetworks. See, the `subnet docs <https://cloud.google.com/compute/docs/subnetworks>`_ for more details. Note that libcloud follows the usability pattern from the Cloud SDK (e.g. 'gcloud compute' command-line utility) and uses 'mode' to specify 'auto', 'custom', or 'legacy'. :param name: Name of network to be created :type name: ``str`` :param cidr: Address range of network in CIDR format. :type cidr: ``str`` or ``None`` :param description: Custom description for the network. :type description: ``str`` or ``None`` :param mode: Create a 'auto', 'custom', or 'legacy' network. :type mode: ``str`` :param routing_mode: Create network with 'Global' or 'Regional' routing mode for BGP advertisements. Defaults to 'Regional' :type routing_mode: ``str`` or ``None`` :return: Network object :rtype: :class:`GCENetwork` rQ r� )�auto�customr zBInvalid network mode: '%s'. Must be 'auto', 'custom', or 'legacy'.)r� r� z.Can only specify IPv4Range with 'legacy' mode.r z*Must specify IPv4Range with 'legacy' mode.� IPv4Ranger� �autoCreateSubnetworks)Zregionalr� z<Invalid Routing Mode: '%s'. Must be 'REGIONAL', or 'GLOBAL'.Z routingMode� routingConfigr; r� r� )�lowerr� r� rc r� r� )r6 rQ r� r� r Z routing_modeZ network_datarF r$ r$ r% �ex_create_network s. � � z GCENodeDriver.ex_create_network� ephemeral� pd-standardc C s: | r|rt d��|r|rt d��|s |s | s |s t d��|p | j}|r-t|d�s-| �|�}t|d�s8| �||�}t|d�sB| �|�}|rSt|d�sS| j|| �|�d�}|rZ| �|�}|rft|d�sf| � |�}| rtt| d�st| j | |d�} | r�t| d�s�| j | |d�} |r�t|d�s�|du r�t d��| j ||d�}|s�| s�|d d d |||| j d |j d d �d�g}|s�|j �dd�r�|j d }| j|d� | j||||fi d|�d|�d|�d| �d| �d| �d| �d|�d|�d|�d|�d|�d |�d |�d |�d |�d |�d!|�d"|�d#|��\} } | jj| d$| d%� | �||j�S )&a7 Create a new node and return a node object for the node. :param name: The name of the node to create. :type name: ``str`` :param size: The machine type to use. :type size: ``str`` or :class:`GCENodeSize` :param image: The image to use to create the node (or, if attaching a persistent disk, the image used to create the disk) :type image: ``str`` or :class:`GCENodeImage` or ``None`` :keyword location: The location (zone) to create the node in. :type location: ``str`` or :class:`NodeLocation` or :class:`GCEZone` or ``None`` :keyword ex_network: The network to associate with the node. :type ex_network: ``str`` or :class:`GCENetwork` :keyword ex_subnetwork: The subnetwork to associate with the node. :type ex_subnetwork: ``str`` or :class:`GCESubnetwork` :keyword ex_tags: A list of tags to associate with the node. :type ex_tags: ``list`` of ``str`` or ``None`` :keyword ex_metadata: Metadata dictionary for instance. :type ex_metadata: ``dict`` or ``None`` :keyword ex_boot_disk: The boot disk to attach to the instance. :type ex_boot_disk: :class:`StorageVolume` or ``str`` or ``None`` :keyword use_existing_disk: If True and if an existing disk with the same name/location is found, use that disk instead of creating a new one. :type use_existing_disk: ``bool`` :keyword external_ip: The external IP address to use. If 'ephemeral' (default), a new non-static address will be used. If 'None', then no external address will be used. To use an existing static IP address, a GCEAddress object should be passed in. :type external_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword internal_ip: The private IP address to use. :type internal_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword ex_disk_type: Specify a pd-standard (default) disk or pd-ssd for an SSD disk. :type ex_disk_type: ``str`` or :class:`GCEDiskType` :keyword ex_disk_auto_delete: Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. :type ex_disk_auto_delete: ``bool`` :keyword ex_service_accounts: Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type ex_service_accounts: ``list`` :keyword description: The description of the node (instance). :type description: ``str`` or ``None`` :keyword ex_can_ip_forward: Set to ``True`` to allow this node to send/receive non-matching src/dst packets. :type ex_can_ip_forward: ``bool`` or ``None`` :keyword ex_disks_gce_struct: Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like 'ex_boot_disk', etc. See the GCE docs for specific details. :type ex_disks_gce_struct: ``list`` or ``None`` :keyword ex_nic_gce_struct: Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using 'external_ip' and 'ex_network'. See the GCE docs for details. :type ex_nic_gce_struct: ``list`` or ``None`` :keyword ex_on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type ex_on_host_maintenance: ``str`` or ``None`` :keyword ex_automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type ex_automatic_restart: ``bool`` or ``None`` :keyword ex_preemptible: Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) :type ex_preemptible: ``bool`` or ``None`` :keyword ex_image_family: Determine image from an 'Image Family' instead of by name. 'image' should be None to use this keyword. :type ex_image_family: ``str`` or ``None`` :keyword ex_labels: Labels dictionary for instance. :type ex_labels: ``dict`` or ``None`` :keyword ex_accelerator_type: Defines the accelerator to use with this node. Must set 'ex_on_host_maintenance' to 'TERMINATE'. Must include a count of accelerators to use in 'ex_accelerator_count'. :type ex_accelerator_type: ``str`` or ``None`` :keyword ex_accelerator_count: The number of 'ex_accelerator_type' accelerators to attach to the node. :type ex_accelerator_count: ``int`` or ``None`` :keyword ex_disk_size: Defines size of the boot disk. Integer in gigabytes. :type ex_disk_size: ``int`` or ``None`` :return: A Node object for the new node. :rtype: :class:`Node` z<Cannot specify both 'ex_boot_disk' and 'ex_disks_gce_struct'�1Cannot specify both 'image' and 'ex_image_family'z�Missing root device or image. Must specify an 'image', 'ex_image_family', existing 'ex_boot_disk', or use the 'ex_disks_gce_struct'.rQ r� r? NzcMissing accelerator count. Must specify an 'ex_accelerator_count' when using 'ex_accelerator_type'.T� PERSISTENT� READ_WRITErq )�diskName� diskSizeGb�diskType� sourceImage)� autoDelete�bootr� r � deviceName�initializeParamsrU r� r r � boot_disk� external_ip� internal_ip� ex_disk_type�ex_disk_auto_delete�ex_service_accountsr� �ex_can_ip_forward�ex_disks_gce_struct�ex_nic_gce_struct�ex_on_host_maintenance�ex_automatic_restart�ex_preemptible� ex_subnetworkr� �ex_accelerator_type�ex_accelerator_countr� r� )r� rU r� r� � ex_get_sizer� r� r� �ex_get_image_from_familyr� �ex_get_disktype� ex_get_volume�ex_get_accelerator_typero rI �_verify_zone_is_set�_create_node_reqrc r� � ex_get_noderQ ) r6 rQ r& r� rX � ex_networkr �ex_tags� ex_metadataZ ex_boot_disk�use_existing_diskr r r r r r� r r r r r r �ex_image_familyr� r r � ex_disk_sizerF � node_datar$ r$ r% r� V s� 0� � ���� ����� � � � � ������������zGCENodeDriver.create_nodec C s� d}| j |fi d|�d|�d|�d|�dd�d| �d |�d |�d | �d | �d | �d| �d|�d|�d|�d|�d|�d|�d|�dd��}|||d�}| jj|d|d� | �|�S )a� Creates an instance template in the specified project using the data that is included in the request. If you are creating a new template to update an existing instance group, your new instance template must use the same network or, if applicable, the same subnetwork as the original template. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param name: The name of the node to create. :type name: ``str`` :param size: The machine type to use. :type size: ``str`` or :class:`GCENodeSize` :param image: The image to use to create the node (or, if attaching a persistent disk, the image used to create the disk) :type image: ``str`` or :class:`GCENodeImage` or ``None`` :keyword network: The network to associate with the template. :type network: ``str`` or :class:`GCENetwork` :keyword subnetwork: The subnetwork to associate with the node. :type subnetwork: ``str`` or :class:`GCESubnetwork` :keyword tags: A list of tags to associate with the node. :type tags: ``list`` of ``str`` or ``None`` :keyword metadata: Metadata dictionary for instance. :type metadata: ``dict`` or ``None`` :keyword external_ip: The external IP address to use. If 'ephemeral' (default), a new non-static address will be used. If 'None', then no external address will be used. To use an existing static IP address, a GCEAddress object should be passed in. :type external_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword internal_ip: The private IP address to use. :type internal_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword disk_type: Specify a pd-standard (default) disk or pd-ssd for an SSD disk. :type disk_type: ``str`` or :class:`GCEDiskType` :keyword disk_auto_delete: Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. :type disk_auto_delete: ``bool`` :keyword service_accounts: Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type service_accounts: ``list`` :keyword description: The description of the node (instance). :type description: ``str`` or ``None`` :keyword can_ip_forward: Set to ``True`` to allow this node to send/receive non-matching src/dst packets. :type can_ip_forward: ``bool`` or ``None`` :keyword disks_gce_struct: Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like 'ex_boot_disk', etc. See the GCE docs for specific details. :type disks_gce_struct: ``list`` or ``None`` :keyword nic_gce_struct: Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using 'external_ip' and 'ex_network'. See the GCE docs for details. :type nic_gce_struct: ``list`` or ``None`` :keyword on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type ex_on_host_maintenance: ``str`` or ``None`` :keyword automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type automatic_restart: ``bool`` or ``None`` :keyword preemptible: Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) :type preemptible: ``bool`` or ``None`` :return: An Instance Template object. :rtype: :class:`GCEInstanceTemplate` r� � node_sizer� r� � disk_type�disk_auto_deleteTr r� rF �can_ip_forward�service_accounts�on_host_maintenancer �automatic_restart� preemptibler r r� �disks_gce_struct�nic_gce_struct� use_selflinksF)rQ r� rA r� r� )�_create_instance_propertiesrc r� r� )r6 rQ r& r� r� r& r' r� rF r( r r r) r* r+ r, r r r� r- r. rF rA r� r$ r$ r% �ex_create_instancetemplates sf �������� � � � � ���������� z(GCENodeDriver.ex_create_instancetemplatec C s~ i }|s |s |s t d��|r|rt d��|r||d< n!d}d} |r)|j}|j} d}| j| ||||dd|d||d� g|d< |dur_t| d �rIt d ��t|d �rZ|jd krVd}nt d ��||d< n | j||| d| d�g|d< | �| ||�} | ry| |d< | �| �|d< |dur�| �||�|d< |r�t|�|d< |r�d|i|d< |r�| j d|d�|d< |r�||d< | r�d|d< | j ||dd �|d < |S ) a� Create the GCE instance properties needed for instance templates. :param node_size: The machine type to use. :type node_size: ``str`` or :class:`GCENodeSize` :keyword source: A source disk to attach to the instance. Cannot specify both 'image' and 'source'. :type source: :class:`StorageVolume` or ``str`` or ``None`` :param image: The image to use to create the node. Cannot specify both 'image' and 'source'. :type image: ``str`` or :class:`GCENodeImage` or ``None`` :keyword disk_type: Specify a pd-standard (default) disk or pd-ssd for an SSD disk. :type disk_type: ``str`` or :class:`GCEDiskType` :keyword disk_auto_delete: Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. :type disk_auto_delete: ``bool`` :keyword network: The network to associate with the node. :type network: ``str`` or :class:`GCENetwork` :keyword subnetwork: The Subnetwork resource for this instance. If the network resource is in legacy mode, do not provide this property. If the network is in auto subnet mode, providing the subnetwork is optional. If the network is in custom subnet mode, then this field should be specified. :type subnetwork: :class: `GCESubnetwork` or None :keyword external_ip: The external IP address to use. If 'ephemeral' (default), a new non-static address will be used. If 'None', then no external address will be used. To use an existing static IP address, a GCEAddress object should be passed in. :type external_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword internal_ip: The private IP address to use. :type internal_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword can_ip_forward: Set to ``True`` to allow this node to send/receive non-matching src/dst packets. :type can_ip_forward: ``bool`` or ``None`` :keyword service_accounts: Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type service_accounts: ``list`` :keyword on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type on_host_maintenance: ``str`` or ``None`` :keyword automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type automatic_restart: ``bool`` or ``None`` :keyword preemptible: Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) :type preemptible: ``bool`` or ``None`` :keyword tags: A list of tags to associate with the node. :type tags: ``list`` of ``str`` or ``None`` :keyword metadata: Metadata dictionary for instance. :type metadata: ``dict`` or ``None`` :keyword description: The description of the node (instance). :type description: ``str`` or ``None`` :keyword disks_gce_struct: Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like 'boot_disk', etc. See the GCE docs for specific details. :type disks_gce_struct: ``list`` or ``None`` :keyword nic_gce_struct: Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using 'external_ip' and 'network'. See the GCE docs for details. :type nic_gce_struct: ``list`` or ``None`` :type labels: Labels dict for instance :type labels: ``dict`` or ``None`` :keyword accelerator_type: Support for passing in the GCE-specifc accelerator type to request for the VM. :type accelerator_type: :class:`GCEAcceleratorType` or ``None`` :keyword accelerator_count: Support for passing in the number of requested 'accelerator_type' accelerators attached to the VM. Will only pay attention to this field if 'accelerator_type' is not None. :type accelerator_count: ``int`` or ``None`` :keyword disk_size: Specify size of the boot disk. Integer in gigabytes. :type disk_size: ``int`` or ``None`` :return: A dictionary formatted for use with the GCE API. :rtype: ``dict`` z]Missing root device or image. Must specify an 'image', source, or use the 'disks_gce_struct'.zJCannot specify both 'source' and 'disks_gce_struct'. Use one or the other.r� Nr� r� T) r� r& r� � disk_name� usage_type� mount_mode� auto_delete�is_bootr/ � disk_sizer� zSCannot specify both a static IP address and 'nic_gce_struct'. Use one or the other.rQ r zICannot specify both 'network' and 'nic_gce_struct'. Use one or the other.�networkInterfaces)r� rF r r/ r � scheduling�serviceAccountsZguestAcceleratorsr� rD r r� )r� r r r� � canIpForwardr& ��obj� get_selflinks�objnamerB ) r� rQ �_build_disk_gce_structr� �_build_network_gce_struct� _build_scheduling_gce_struct� _build_service_accounts_gce_list�_format_guest_acceleratorsr r� �_get_selflink_or_name) r6 rQ r% r� r� r& r' r� rF r r r( r) r* r+ r, r r r� r- r. r/ r� �accelerator_type�accelerator_countr7 Zinstance_propertiesr2 � device_namer9 r$ r$ r% r0 # s� " �� �� � � �� ��� � �z)GCENodeDriver._create_instance_propertiesr� r� c C s |du r |du r t d��t| t�st d��|dur*t|t�s*|�� s*t dt|� ��ddg} || vr;t dd�| � ��d d g} | | vrLt d d�| � ��i }|sR|}|dura| j|| d d �|d< n"| j|ddd �}| j|| dd �}|||d�|d< |dur�||d d< |�|| ||| d�� |S )a� Generates the GCP dict for a disk. :param device_name: Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance. Defaults to disk_name. :type device_name: ``str`` :keyword source: The disk to attach to the instance. :type source: ``str`` of selfLink, :class:`StorageVolume` or None :keyword disk_type: Specify a URL or DiskType object. :type disk_type: ``str`` or :class:`GCEDiskType` or ``None`` :keyword image: The image to use to create the disk. :type image: :class:`GCENodeImage` or ``None`` :keyword disk_size: Integer in gigabytes. :type disk_size: ``int`` :param disk_name: Specifies the disk name. If not specified, the default is to use the device_name. :type disk_name: ``str`` :keyword mount_mode: The mode in which to attach this disk, either READ_WRITE or READ_ONLY. If not specified, the default is to attach the disk in READ_WRITE mode. :type mount_mode: ``str`` :keyword usage_type: Specifies the type of the disk, either SCRATCH or PERSISTENT. If not specified, the default is PERSISTENT. :type usage_type: ``str`` :keyword auto_delete: Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. :type auto_delete: ``bool`` :return: Dictionary to be used in disk-portion of instance API call. :rtype: ``dict`` Nz:Either the 'source' or 'image' argument must be specified.z auto_delete field is not a bool.z)disk_size must be a digit, '%s' provided.r� Z READ_ONLYz mount mode must be one of: %s.r� r� ZSCRATCHz usage type must be one of: %s.r� r< r� Tr� �disktype)r� r r r r )r r� r r r ) r� r� �boolr �isdigitr r� rE r> )r6 rH r� r& r7 r� r2 r6 r4 r3 r5 r/ Z mount_modesZ usage_typesr r$ r$ r% r@ ? sL @ �� � �� z$GCENodeDriver._build_disk_gce_structc C sP |r t |d�s|rt| d| �}||�}ntd��|jd S t |d�s%|S |jS )a� Return the selflink or name, given a name or object. Will try to fetch the appropriate object if necessary (assumes we only need one parameter to fetch the object, no introspection is performed). :param obj: object to test. :type obj: ``str`` or ``object`` :param get_selflinks: Inform if we should return selfLinks or just the name. Default is True. :param get_selflinks: ``bool`` :param objname: string to use in constructing method call :type objname: ``str`` or None :return: URL from extra['selfLink'] or name :rtype: ``str`` rQ � ex_get_%sz)objname must be set if selflinks is True.rq )r� r r� ro rQ )r6 r= r> r? Zgetobjr$ r$ r% rE � s z#GCENodeDriver._get_selflink_or_namec C s� i }ddi}|du r d}| j ||dd�|d< |r"| j ||dd�|d< |r:dd d �g}t|d �r6|j|d d < ||d< |r@||d< |S )a� Build network interface dict for use in the GCE API. Note: Must be wrapped in a list before passing to the GCE API. :param network: The network to associate with the node. :type network: :class:`GCENetwork` :keyword subnetwork: The subnetwork to include. :type subnetwork: :class:`GCESubNetwork` :keyword external_ip: The external IP address to use. If 'ephemeral' (default), a new non-static address will be used. If 'None', then no external address will be used. To use an existing static IP address, a GCEAddress object should be passed in. :type external_ip: :class:`GCEAddress` :keyword internal_ip: The private IP address to use. :type internal_ip: :class:`GCEAddress` or ``str`` :return: network interface dict :rtype: ``dict`` rr z compute#instanceNetworkInterfaceNr r� r< rF z External NATr� )rQ r� r� r r� � accessConfigs� networkIP)rE r� r� )r6 r� rF r r/ r ZniZaccess_configsr$ r$ r% rA � s& � � z'GCENodeDriver._build_network_gce_structc C s� t |t�stdtt|��t|�f ��i }d|vr ||d< n|d |d< d|vr2| j| g|d< |S g }|d D ]'}|�| j�rF|�|� q8|| jv rW|�| j| j| � q8|�| j| � q8||d< |S )a� Helper to create Service Account dict. Use _build_service_accounts_gce_list to create a list ready for the GCE API. :param: service_account: dictionarie containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type service_account: ``dict`` or None :return: dict usable in GCE API call. :rtype: ``dict`` z3service_account not in the correct format,'%s - %s'�emailr� ) r� �dictr� r r� �AUTH_URLr� rR � SA_SCOPES_MAP)r6 �service_account� default_email� default_scope�saZpsZscoper$ r$ r% �!_build_service_account_gce_struct s, �� � z/GCENodeDriver._build_service_account_gce_structc C sV g }|du r|| j | gd�g}|S t|t�std��|D ] }|�| j|d�� q |S )a" Helper to create service account list for GCE API. :keyword service_accounts: Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type service_accounts: ``list`` of ``dict``, ``None`` or an empty list. ``None` means use a default service account and an empty list indicates no service account. :return: list of dictionaries usable in the GCE API. :rtype: ``list`` of ``dict`` N)rO r� z%service_accounts field is not a list.)rS )rQ r� r� r� rR rW )r6 r) rT rU Zgce_service_accountsrV r$ r$ r% rC P s � � �z.GCENodeDriver._build_service_accounts_gce_listc C s� i }|durt |t�r||d< ntd��|dur?ddg}t |t�r6||v r6|du r1|dkr1td��||d< n td d �|� ��|dur^t |t�rZ|du rT|du rTtd ��||d < |S td ��|S )a� Build the scheduling dict suitable for use with the GCE API. :param on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type on_host_maintenance: ``str`` or ``None`` :param automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type automatic_restart: ``bool`` or ``None`` :param preemptible: Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) :type preemptible: ``bool`` or ``None`` :return: A dictionary of scheduling options for the GCE API. :rtype: ``dict`` Nr, z boolean expected for preemptible�MIGRATE� TERMINATETz@host maintenance cannot be 'MIGRATE' if instance is preemptible.�onHostMaintenancez"host maintenance must be one of %sr� z2instance cannot be restarted if it is preemptible.�automaticRestartz boolean expected for automatic)r� rJ r� r r� )r6 r* r+ r, r9 Z maint_optsr$ r$ r% rB ~ s, � �z*GCENodeDriver._build_scheduling_gce_structr� c % C s |r|rt d��|r|rt d��|p| j}t|d�s | �|�}t|d�s*| �||�}t|d�s4| �|�}|rEt|d�sE| j|| �|�d�}|rL| �|�}|rXt|d�sX| � |�}t|d�sd| j ||d�}i d|�d|�d|�d |�d |�d |�d | �d | �d| �d| �d|�d|�d|�d|�d|�d|�d|�|||||| d��} g } t |�D ]} d|| f } | ddd�}!| � |!� q�t � � }"d}#|#s�t � � |" |kr�td ��d }#t �| � | D ] }!|!d s�|!d s�| �|!| � n| �|!| � |!d s�d}#q�|#r�g }$| D ] }!|$� |!d � q�|$S ) a' Create multiple nodes and return a list of Node objects. Nodes will be named with the base name and a number. For example, if the base name is 'libcloud' and you create 3 nodes, they will be named:: libcloud-000 libcloud-001 libcloud-002 :param base_name: The base name of the nodes to create. :type base_name: ``str`` :param size: The machine type to use. :type size: ``str`` or :class:`GCENodeSize` :param image: The image to use to create the nodes. :type image: ``str`` or :class:`GCENodeImage` :param number: The number of nodes to create. :type number: ``int`` :keyword location: The location (zone) to create the nodes in. :type location: ``str`` or :class:`NodeLocation` or :class:`GCEZone` or ``None`` :keyword ex_network: The network to associate with the nodes. :type ex_network: ``str`` or :class:`GCENetwork` :keyword ex_tags: A list of tags to associate with the nodes. :type ex_tags: ``list`` of ``str`` or ``None`` :keyword ex_metadata: Metadata dictionary for instances. :type ex_metadata: ``dict`` or ``None`` :keyword ignore_errors: If True, don't raise Exceptions if one or more nodes fails. :type ignore_errors: ``bool`` :keyword use_existing_disk: If True and if an existing disk with the same name/location is found, use that disk instead of creating a new one. :type use_existing_disk: ``bool`` :keyword poll_interval: Number of seconds between status checks. :type poll_interval: ``int`` :keyword external_ip: The external IP address to use. If 'ephemeral' (default), a new non-static address will be used. If 'None', then no external address will be used. (Static addresses are not supported for multiple node creation.) :type external_ip: ``str`` or None :keyword internal_ip: The private IP address to use. :type internal_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword ex_disk_type: Specify a pd-standard (default) disk or pd-ssd for an SSD disk. :type ex_disk_type: ``str`` or :class:`GCEDiskType` :keyword ex_disk_auto_delete: Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. :type ex_disk_auto_delete: ``bool`` :keyword ex_service_accounts: Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type ex_service_accounts: ``list`` :keyword timeout: The number of seconds to wait for all nodes to be created before timing out. :type timeout: ``int`` :keyword description: The description of the node (instance). :type description: ``str`` or ``None`` :keyword ex_can_ip_forward: Set to ``True`` to allow this node to send/receive non-matching src/dst packets. :type ex_can_ip_forward: ``bool`` or ``None`` :keyword ex_preemptible: Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) :type ex_preemptible: ``bool`` or ``None`` :keyword ex_disks_gce_struct: Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like 'ex_boot_disk', etc. See the GCE docs for specific details. :type ex_disks_gce_struct: ``list`` or ``None`` :keyword ex_nic_gce_struct: Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using 'external_ip' and 'ex_network'. See the GCE docs for details. :type ex_nic_gce_struct: ``list`` or ``None`` :keyword ex_on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type ex_on_host_maintenance: ``str`` or ``None`` :keyword ex_automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type ex_automatic_restart: ``bool`` or ``None`` :keyword ex_image_family: Determine image from an 'Image Family' instead of by name. 'image' should be None to use this keyword. :type ex_image_family: ``str`` or ``None`` :param ex_labels: Label dict for node. :type ex_labels: ``dict`` :keyword ex_disk_size: Defines size of the boot disk. Integer in gigabytes. :type ex_disk_size: ``int`` or ``None`` :return: A list of Node objects for the new nodes. :rtype: ``list`` of :class:`Node` z6Cannot specify both 'image' and 'ex_disks_gce_struct'.r� rQ r� r? r& r� rX r� rF r r � ignore_errorsr! r r r r r r� r r )r r r r r� r# z%s-%03dN)rQ � node_responser8 Fz5Timeout (%s sec) while waiting for multiple instancesTr8 r] )r� rU r� r� r r� r� r� r r� r �rangerR �timert �sleep�_multi_create_node�_multi_check_node)%r6 � base_namer& r� �numberrX r r r r r\ r! � poll_intervalr r r r r r� r� r r r r r r" r r� r# � node_attrs� status_listr9 rQ r" � start_time�completerM r$ r$ r% �ex_create_multiple_nodes� s� 7 � �������� � � � � ������ ��z&GCENodeDriver.ex_create_multiple_nodesc C �J d|i}t |d�s| �|�}|jd |d< d}| jj|d|d� | �|�S )a| Create a target HTTP proxy. :param name: Name of target HTTP proxy :type name: ``str`` :keyword urlmap: URL map defining the mapping from URl to the backendservice. :type healthchecks: ``str`` or :class:`GCEUrlMap` :return: Target Pool object :rtype: :class:`GCETargetPool` rQ rq �urlMapr] r� r� )r� � ex_get_urlmapro rc r� r� )r6 rQ r) Ztargetproxy_datarF r$ r$ r% �ex_create_targethttpproxy� s z'GCENodeDriver.ex_create_targethttpproxyc C sT d}i }||d< ||d< dd� |D �|d< |j d |d< | jj|d |d � | �|�S ) a� Creates a TargetHttpsProxy resource in the specified project using the data included in the request. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param name: Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. :type name: ``str`` :param sslcertificates: URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer. Currently, exactly one SSL certificate must be specified. :type sslcertificates: ``list`` of :class:`GCESslcertificates` :param urlmap: A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService. :type urlmap: :class:`GCEUrlMap` :keyword description: An optional description of this resource. Provide this property when you create the resource. :type description: ``str`` :return: `GCETargetHttpsProxy` object. :rtype: :class:`GCETargetHttpsProxy` rd rQ r� c S � g | ]}|j d �qS �rq r� rf r$ r$ r% r� r� z<GCENodeDriver.ex_create_targethttpsproxy.<locals>.<listcomp>�sslCertificatesrq rl r� r� )ro rc r� �ex_get_targethttpsproxy)r6 rQ r) r. r� rF r� r$ r$ r% �ex_create_targethttpsproxy� s ( z(GCENodeDriver.ex_create_targethttpsproxy�NO_NATc C s� |p| j }i }||d< t|d�s| �|�}|jd |d< |dur2t|d�s+| �||�}|jd |d< ||d< |r<||d< d|j }| jj|d |d � | �||�S ) a� Create a target instance. :param name: Name of target instance :type name: ``str`` :keyword region: Zone to create the target pool in. Defaults to self.zone :type region: ``str`` or :class:`GCEZone` or ``None`` :keyword node: The actual instance to be used as the traffic target. :type node: ``str`` or :class:`Node` :keyword description: A text description for the target instance :type description: ``str`` or ``None`` :keyword nat_policy: The NAT option for how IPs are NAT'd to the node. :type nat_policy: ``str`` :return: Target Instance object :rtype: :class:`GCETargetInstance` rQ rq rU NrJ � natPolicyr� ri r� r� ) rU r� r� ro r rQ rc r� �ex_get_targetinstance)r6 rQ rU r8 r� Z nat_policyZtargetinstance_datarF r$ r$ r% �ex_create_targetinstance s z&GCENodeDriver.ex_create_targetinstancec s i }|p� j }|r|sd}||d< |jd |d< |r"|s"d} t| ��||d< t|d�s0� �|�}|jd |d< |rUt|d d�sJ� fd d �|D �} nd d � |D �} | |d < |rst|d d�sh� fd d �|D �} ndd � |D �} | |d< |ry||d< d|j } � jj| d|d� � �||�S )a' Create a target pool. :param name: Name of target pool :type name: ``str`` :keyword region: Region to create the target pool in. Defaults to self.region :type region: ``str`` or :class:`GCERegion` or ``None`` :keyword healthchecks: Optional list of health checks to attach :type healthchecks: ``list`` of ``str`` or :class:`GCEHealthCheck` :keyword nodes: Optional list of nodes to attach to the pool :type nodes: ``list`` of ``str`` or :class:`Node` :keyword session_affinity: Optional algorithm to use for session affinity. :type session_affinity: ``str`` :keyword backup_pool: Optional backup targetpool to take over traffic if the failover_ratio is exceeded. :type backup_pool: ``GCETargetPool`` or ``None`` :keyword failover_ratio: The percentage of healthy VMs must fall at or below this value before traffic will be sent to the backup_pool. :type failover_ratio: :class:`GCETargetPool` or ``None`` :return: Target Pool object :rtype: :class:`GCETargetPool` r{ � failoverRatiorq � backupPoolz;Must supply a backup targetPool when setting failover_ratiorQ r� r c s g | ] }� � |�jd �qS rp )r� ro r rf r$ r% r� � s z6GCENodeDriver.ex_create_targetpool.<locals>.<listcomp>c S ro rp r� r r$ r$ r% r� � r� r� c s g | ] }� � |d �jd �qS )�allrq )r ro r0 rf r$ r% r� � s c S ro rp r� r0 r$ r$ r% r� � r� r> �sessionAffinityrp r� r� ) r� ro r� r� r� rQ rc r� r� ) r6 rQ r� r� rm Zsession_affinityZ backup_poolr} �targetpool_datar� Zhc_listrM rF r$ rf r% �ex_create_targetpoolK s8 * z"GCENodeDriver.ex_create_targetpoolc C rk )aF Create a URL Map. :param name: Name of the URL Map. :type name: ``str`` :keyword default_service: Default backend service for the map. :type default_service: ``str`` or :class:`GCEBackendService` :return: URL Map object :rtype: :class:`GCEUrlMap` rQ rq �defaultServiceru r� r� )r� r� ro rc r� rm )r6 rQ r� Z urlmap_datarF r$ r$ r% �ex_create_urlmap� s z GCENodeDriver.ex_create_urlmapc C s� |r|rt d��|r| �|�}| �||||||�\} } } z | jj| d| | d� W n ty> } z |s4| �W Y d} ~ nd} ~ ww | �||�S )a Create a volume (disk). :param size: Size of volume to create (in GB). Can be None if image or snapshot is supplied. :type size: ``int`` or ``str`` or ``None`` :param name: Name of volume to create :type name: ``str`` :keyword location: Location (zone) to create the volume in :type location: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :keyword snapshot: Snapshot to create image from :type snapshot: :class:`GCESnapshot` or ``str`` or ``None`` :keyword image: Image to create disk from. :type image: :class:`GCENodeImage` or ``str`` or ``None`` :keyword use_existing: If True and a disk with the given name already exists, return an object for that disk instead of attempting to create a new disk. :type use_existing: ``bool`` :keyword ex_disk_type: Specify a pd-standard (default) disk or pd-ssd for an SSD disk. :type ex_disk_type: ``str`` or :class:`GCEDiskType` :keyword ex_image_family: Determine image from an 'Image Family' instead of by name. 'image' should be None to use this keyword. :type ex_image_family: ``str`` or ``None`` :return: Storage Volume object :rtype: :class:`StorageVolume` r� r� r� N)r� r �_create_vol_reqrc r� r r ) r6 r& rQ rX �snapshotr� r� r r" rF � volume_datar? r� r$ r$ r% � create_volume� s 1 � ��� zGCENodeDriver.create_volumec C s> i }||d< d� |jd j|j�}| jj|d|d� | �|�S )z� Create a snapshot of the provided Volume. :param volume: A StorageVolume object :type volume: :class:`StorageVolume` :return: A GCE Snapshot object :rtype: :class:`GCESnapshot` rQ z!/zones/{}/disks/{}/createSnapshotrU r� r� )r2 ro rQ rc r� �ex_get_snapshot)r6 r� rQ Z snapshot_datarF r$ r$ r% �create_volume_snapshot� s � z$GCENodeDriver.create_volume_snapshotc C s< g }|j d }| �� }|D ]}|j d |kr|�|� q |S )a� List snapshots created from the provided volume. For GCE, snapshots are global, but while the volume they were created from still exists, the source disk for the snapshot is tracked. :param volume: A StorageVolume object :type volume: :class:`StorageVolume` :return: A list of Snapshot objects :rtype: ``list`` of :class:`GCESnapshot` rq r� )ro r[ rR )r6 r� Zvolume_snapshotsZ volume_linkZ all_snapshotsr� r$ r$ r% �list_volume_snapshots s �z#GCENodeDriver.list_volume_snapshotsc C sV d|j j }i }|j|d< |j|d< |jjd |d< | jj|d|d� | �|j|j �S )a� Update an autoscaler with new values. To update, change the attributes of the autoscaler object and pass the updated object to the method. :param autoscaler: An Autoscaler object with updated values. :type autoscaler: :class:`GCEAutoscaler` :return: An Autoscaler object representing the new state. :rtype: :class:`GCEAutoscaler`` r� rQ r� rq r< �PUTr� )rU rQ r= r< ro rc r� r� )r6 r> rF Zas_datar$ r$ r% �ex_update_autoscaler% s z"GCENodeDriver.ex_update_autoscalerc C s� i }|j |d< |j|d< |j|d< |j|d< |j|d< |j|d< |j|d< |jd r1|jd |d< |jd r=|jd |d < d |j }| jj |d |d � | � |j �S ) a� Update a health check with new values. To update, change the attributes of the health check object and pass the updated object to the method. :param healthcheck: A healthcheck object with updated values. :type healthcheck: :class:`GCEHealthCheck` :return: An object representing the new state of the health check. :rtype: :class:`GCEHealthCheck` rQ r� r� r� r� r� r� r^ r� �/global/httpHealthChecks/%sr� r� ) rQ r� r� r� r� r� r� ro rc r� r� )r6 r� r� rF r$ r$ r% r� < s z#GCENodeDriver.ex_update_healthcheckc C s� i }|j |d< |j|d< |j|d< |jjd |d< |jr!|j|d< |jr)|j|d< |jr1|j|d< |jr9|j|d < |j rA|j |d < |j rI|j |d < |jd rU|jd |d < d |j }| j j |d|d� | � |j �S )a� Update a firewall with new values. To update, change the attributes of the firewall object and pass the updated object to the method. :param firewall: A firewall object with updated values. :type firewall: :class:`GCEFirewall` :return: An object representing the new state of the firewall. :rtype: :class:`GCEFirewall` rQ r� r� rq r� r� r� r� r� r� r� r� �/global/firewalls/%sr� r� )rQ r� r� r� ro r� r� r� r� r� r� rc r� r� )r6 r� r� rF r$ r$ r% r� ^ s, z GCENodeDriver.ex_update_firewallc C s2 d|j }ddd� |D �i}| jj|d|d� dS )aN Replaces SslCertificates for TargetHttpsProxy. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param targethttpsproxy: Name of the TargetHttpsProxy resource to set an SslCertificates resource for. :type targethttpsproxy: ``str`` :param sslcertificates: sslcertificates to set. :type sslcertificates: ``list`` of :class:`GCESslCertificates` :return: True :rtype: ``bool`` z)/targetHttpsProxies/%s/setSslCertificatesrq c S ro rp r� rf r$ r$ r% r� � r� zIGCENodeDriver.ex_targethttpsproxy_set_sslcertificates.<locals>.<listcomp>r� r� T�rQ rc r� )r6 r0 r. rF r� r$ r$ r% r1 � s z5GCENodeDriver.ex_targethttpsproxy_set_sslcertificatesc C s. d|j }d|jd i}| jj|d|d� dS )a Changes the URL map for TargetHttpsProxy. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param targethttpsproxy: Name of the TargetHttpsProxy resource whose URL map is to be set. :type targethttpsproxy: ``str`` :param urlmap: urlmap to set. :type urlmap: :class:`GCEUrlMap` :return: True :rtype: ``bool`` z /targetHttpsProxies/%s/setUrlMaprl rq r� r� T)rQ ro rc r� )r6 r0 r) rF r� r$ r$ r% r4 � s z,GCENodeDriver.ex_targethttpsproxy_set_urlmapc C s� g }|j j}d�||j�}|dur t|d�r|j}n|}nd}|j}|D ]L}|rO||jkrNd|jd i} | jj|d| d�j} | d d d } |� || d �� q$d|jd i} | jj|d| d�j} | d d d } |� || d �� q$|S ) a7 Return a hash of target pool instances and their health. :param targetpool: Targetpool containing healthchecked instances. :type targetpool: :class:`GCETargetPool` :param node: Optional node to specify if only a specific node's health status should be returned :type node: ``str``, ``Node``, or ``None`` :return: List of hashes of instances and their respective health, e.g. [{'node': ``Node``, 'health': 'UNHEALTHY'}, ...] :rtype: ``list`` of ``dict`` z$/regions/{}/targetPools/{}/getHealthNrQ rJ rq r� r� Z healthStatusr Z healthState)r8 �health) r� rQ r2 r� rm ro rc rF rH rR ) r6 r� r8 r� r� rF r� rm Z node_objectr� rX r" r$ r$ r% r� � s2 � �z&GCENodeDriver.ex_targetpool_get_healthr{ c C sH |j j}|j}d|jd i}d|i}d�||�}| jj|d||d� dS )a� Set a backup targetpool. :param targetpool: The existing primary targetpool :type targetpool: :class:`GCETargetPool` :param backup_targetpool: The existing targetpool to use for failover traffic. :type backup_targetpool: :class:`GCETargetPool` :param failover_ratio: The percentage of healthy VMs must fall at or below this value before traffic will be sent to the backup targetpool (default 0.10) :type failover_ratio: ``float`` :return: True if successful :rtype: ``bool`` r< rq rx z$/regions/{}/targetPools/{}/setBackupr� r� T)r� rQ ro r2 rc r� ) r6 r� r| r} r� rQ �req_datar? rF r$ r$ r% r~ � s z1GCENodeDriver.ex_targetpool_set_backup_targetpoolc s� t |d�s | �|�}t |d�r|jd � n|�d�r |� n | �|d�}|jd � dd� igi}d�|jj|j�}| jj |d|d � t � fd d �|j D ��rS|j � |� d S ) a< Add a node to a target pool. :param targetpool: The targetpool to add node to :type targetpool: ``str`` or :class:`GCETargetPool` :param node: The node to add :type node: ``str`` or :class:`Node` :return: True if successful :rtype: ``bool`` rQ rq r� rz r> rJ z&/regions/{}/targetPools/{}/addInstancer� r� c 3 s2 � | ]}� |kot |d � p|jd � kV qdS )ro rq N)r� ro r0 ��node_urir$ r% � <genexpr>/ s � � �z7GCENodeDriver.ex_targetpool_add_node.<locals>.<genexpr>T) r� r� ro r� r r2 r� rQ rc r� rz rm rR )r6 r� r8 r| rF r$ r� r% ro s& � � z$GCENodeDriver.ex_targetpool_add_nodec C sp t |d�s | �|�}t |d�s| �|�}dd|jd igi}d�|jj|j�}| jj|d|d� |j � |� dS ) ak Add a health check to a target pool. :param targetpool: The targetpool to add health check to :type targetpool: ``str`` or :class:`GCETargetPool` :param healthcheck: The healthcheck to add :type healthcheck: ``str`` or :class:`GCEHealthCheck` :return: True if successful :rtype: ``bool`` rQ r� � healthCheckrq z)/regions/{}/targetPools/{}/addHealthCheckr� r� T) r� r� r� ro r2 r� rQ rc r� r� rR )r6 r� r� r| rF r$ r$ r% rv 7 s � z+GCENodeDriver.ex_targetpool_add_healthcheckc C s� t |d�s | �|�}t |d�r|jd }n|�d�r |}n | �|d�}|jd }dd|igi}d�|jj|j�}| jj |d|d � d }t |j �D ]\}}||ks\t |d �r`|jd |kr`|} nqH|d urk|j � |� d S ) aI Remove a node from a target pool. :param targetpool: The targetpool to remove node from :type targetpool: ``str`` or :class:`GCETargetPool` :param node: The node to remove :type node: ``str`` or :class:`Node` :return: True if successful :rtype: ``bool`` rQ rq r� rz r> rJ z)/regions/{}/targetPools/{}/removeInstancer� r� Nro T) r� r� ro r� r r2 r� rQ rc r� � enumeraterm �pop) r6 r� r8 r� r| rF �indexr9 Zndr$ r$ r% rs V s. � � z'GCENodeDriver.ex_targetpool_remove_nodec C s� t |d�s | �|�}t |d�s| �|�}dd|jd igi}d�|jj|j�}| jj|d|d� d}t |j �D ] \}}|j|jkrC|}q7|durN|j � |� d S ) ax Remove a health check from a target pool. :param targetpool: The targetpool to remove health check from :type targetpool: ``str`` or :class:`GCETargetPool` :param healthcheck: The healthcheck to remove :type healthcheck: ``str`` or :class:`GCEHealthCheck` :return: True if successful :rtype: ``bool`` rQ r� r� rq z,/regions/{}/targetPools/{}/removeHealthCheckr� r� NT) r� r� r� ro r2 r� rQ rc r� r� r� r� )r6 r� r� r| rF r� r9 r� r$ r$ r% ry � s$ � � z.GCENodeDriver.ex_targetpool_remove_healthcheckc C �: d� |jj|j�}ddd� |D �i}| jj|d|d� dS )rK z(/zones/{}/instanceGroups/{}/addInstancesr> c S � g | ] }d |j d i�qS �rJ rq r� rf r$ r$ r% r� � � z@GCENodeDriver.ex_instancegroup_add_instances.<locals>.<listcomp>r� r� T�r2 rU rQ rc r� �r6 rI rM rF r� r$ r$ r% rN � s �z,GCENodeDriver.ex_instancegroup_add_instancesc C r� )a� Removes one or more instances from the specified instance group, but does not delete those instances. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param instancegroup: The Instance Group where the specified instances will be removed. :type instancegroup: :class:``GCEInstanceGroup`` :param node_list: List of nodes to add. :type node_list: ``list`` of :class:`Node` or ``list`` of :class:`GCENode` :return: True if successful. :rtype: ``bool`` z+/zones/{}/instanceGroups/{}/removeInstancesr> c S r� r� r� rf r$ r$ r% r� � r� zCGCENodeDriver.ex_instancegroup_remove_instances.<locals>.<listcomp>r� r� Tr� r� r$ r$ r% rS � s �z/GCENodeDriver.ex_instancegroup_remove_instancesc C sj d� |jj|j�}| jj|dd�j}g }d|v r3|d D ]}| �|d �}|�| �|d |d �� q |S )aw Lists the instances in the specified instance group. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :param instancegroup: The Instance Group where from which you want to generate a list of included instances. :type instancegroup: :class:`GCEInstanceGroup` :return: List of :class:`GCENode` objects. :rtype: ``list`` of :class:`GCENode` objects. z)/zones/{}/instanceGroups/{}/listInstancesr� rO rD rJ rQ rU ) r2 rU rQ rc rF rH �_get_components_from_pathrR r )r6 rI rF rL r5 rZ Z instance_infor$ r$ r% rQ � s � z-GCENodeDriver.ex_instancegroup_list_instancesc C sJ t |t�s td��d�|jj|j�}||jd d�}| jj|d|d� dS )ah Sets the named ports for the specified instance group. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param instancegroup: The Instance Group where where the named ports are updated. :type instancegroup: :class:`GCEInstanceGroup` :param named_ports: Assigns a name to a port number. For example: {name: "http", port: 80} This allows the system to reference ports by the assigned name instead of a port number. Named ports can also contain multiple ports. For example: [{name: "http", port: 80},{name: "http", port: 8080}] Named ports apply to all instances in this instance group. :type named_ports: ``list`` of {'name': ``str``, 'port`: ``int``} :return: Return True if successful. :rtype: ``bool`` z7'named_ports' must be a list of name/port dictionaries.z)/zones/{}/instanceGroups/{}/setNamedPortsr� )r� r� r� r� T) r� r� r� r2 rU rQ ro rc r� )r6 rI rG rF r� r$ r$ r% rV s ��z.GCENodeDriver.ex_instancegroup_set_named_portsc C s, d� |jj|j�}i }| jj|d|d� dS )aN Deletes the specified instance group. The instances in the group are not deleted. Note that instance group must not belong to a backend service. Read Deleting an instance group for more information. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param instancegroup: The name of the instance group to delete. :type instancegroup: :class:`GCEInstanceGroup` :return: Return True if successful. :rtype: ``bool`` �/zones/{}/instanceGroups/{}�DELETEr� Tr� )r6 rI rF r� r$ r$ r% rJ 2 s �z&GCENodeDriver.ex_destroy_instancegroupc C sn d� |jj|j�}| jj|dd�j}g }d|v r5|d D ]}| �|d �d |d< |jj|d< |�|� q |S )a� Lists all of the instances in the Managed Instance Group. Each instance in the list has a currentAction, which indicates the action that the managed instance group is performing on the instance. For example, if the group is still creating an instance, the currentAction is 'CREATING'. Note that 'instanceStatus' might not be available, for example, if currentAction is 'CREATING' or 'RECREATING'. If a previous action failed, the list displays the errors for that failed action. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly 'currentAction' values are one of: 'ABANDONING', 'CREATING', 'DELETING', 'NONE', 'RECREATING', 'REFRESHING', 'RESTARTING' :param manager: Instance Group Manager to operate on. :type manager: :class:`GCEInstanceGroupManager` :return: ``list`` of ``dict`` containing 'name', 'zone', 'lastAttempt', 'currentAction', 'instance' and 'instanceStatus'. :rtype: ``list`` z7/zones/{}/instanceGroupManagers/{}/listManagedInstancesr� rO ZmanagedInstancesrJ rQ rU )r2 rU rQ rc rF rH r� rR )r6 r\ rF rL Z instance_datar9 r$ r$ r% r^ L s � z<GCENodeDriver.ex_instancegroupmanager_list_managed_instancesc C s> i }|j |d�g|d< d�|jj|j�}| jj|d|d� dS )a� Set the Autohealing Policies for this Instance Group. :param healthcheck: Healthcheck to add :type healthcheck: :class:`GCEHealthCheck` :param initialdelaysec: The time to allow an instance to boot and applications to fully start before the first health check :type initialdelaysec: ``int`` :return: True if successful :rtype: ``bool`` )r� ZinitialDelaySec�autoHealingPoliciesz#/zones/{}/instanceGroupManagers/{}/�PATCHr� T)r� r2 rU rQ rc r� )r6 r\ r� ri r� rF r$ r$ r% rj z s ��z=GCENodeDriver.ex_instancegroupmanager_set_autohealingpoliciesc C s6 d|j d i}d|jj|jf }| jj|d|d� dS )a� Set the Instance Template for this Instance Group. Existing VMs are not recreated by setting a new InstanceTemplate. :param manager: Instance Group Manager to operate on. :type manager: :class:`GCEInstanceGroupManager` :param instancetemplate: Instance Template to set. :type instancetemplate: :class:`GCEInstanceTemplate` :return: True if successful :rtype: ``bool`` r� rq z6/zones/%s/instanceGroupManagers/%s/setInstanceTemplater� r� T)ro rU rQ rc r� )r6 r\ rD r� rF r$ r$ r% r` � s �z:GCENodeDriver.ex_instancegroupmanager_set_instancetemplatec C s� g }t |t�st |t�stdt|� ��t |t�r | �|�}|du r/| �|�}dd� |D �}n't |t�rR|D ]}|�d�rC|� |� q6|� | � ||j �j d � q6ntd��d� |j j|j�}d |i}| jj|d |d �j | �|�S ) a� Schedules a group action to recreate the specified instances in the managed instance group. The instances are deleted and recreated using the current instance template for the managed instance group. This operation is marked as DONE when the action is scheduled even if the instances have not yet been recreated. You must separately verify the status of the recreating action with the listmanagedinstances method or querying the managed instance group directly. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param manager: Required. The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. :type manager: ``str`` or :class: `GCEInstanceGroupManager` :keyword instances: list of Node objects to be recreated. If equal to None, all instances in the managed instance group are recreated. :type instances: ``list`` of :class: `Node`, ``list`` of instance names (only), ``list`` of instance URIs, or None. :return: Dictionary containing instance URI and currentAction. See ex_instancegroupmanager_list_managed_instances for more details. :rtype: ``dict`` zWInstanceGroupManager must be of type str or GCEInstanceGroupManager. Type '%s' providedNc S s g | ]}|d �qS )rJ r$ rf r$ r$ r% r� � r� zLGCENodeDriver.ex_instancegroupmanager_recreate_instances.<locals>.<listcomp>r� rq zRinstances must be 'None or a list of instance URIs, instance names, orNode objectsz4/zones/{}/instanceGroupManagers/{}/recreateInstancesr> r� r� )r� r� r r� r� r� r^ r� r� rR r rU ro r2 rQ rc rF rH )r6 r\ r> Z instance_urisZilr9 rF r� r$ r$ r% rb � s8 �� ��� z8GCENodeDriver.ex_instancegroupmanager_recreate_instancesc C s< d� |jj|j�}ddd� |D �i}| jj|d|d�j dS )a� Remove instances from GCEInstanceGroupManager and destroy the instance Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param manager: Required. The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035. :type manager: ``str`` or :class: `GCEInstanceGroupManager` :param node_list: list of Node objects to delete. :type node_list: ``list`` of :class:`Node` :return: True if successful :rtype: ``bool`` z2/zones/{}/instanceGroupManagers/{}/deleteInstancesr> c S ro rp r� rf r$ r$ r% r� r� zJGCENodeDriver.ex_instancegroupmanager_delete_instances.<locals>.<listcomp>r� r� T)r2 rU rQ rc rF rH )r6 r\ rM rF r� r$ r$ r% rd � s �z6GCENodeDriver.ex_instancegroupmanager_delete_instancesc C s0 d|i}d� |jj|j�}| jj|d|d� dS )aX Set the Instance Template for this Instance Group. :param manager: Instance Group Manager to operate on. :type manager: :class:`GCEInstanceGroupManager` :param size: New size of Managed Instance Group. :type size: ``int`` :return: True if successful :rtype: ``bool`` r& z)/zones/{}/instanceGroupManagers/{}/resizer� r� Tr� )r6 r\ r& Z req_paramsrF r$ r$ r% rf s �z,GCENodeDriver.ex_instancegroupmanager_resizec C s, d� |jd j|j�}| jj|ddd� dS )z� Reboot a node. :param node: Node to be rebooted :type node: :class:`Node` :return: True if successful, False if not :rtype: ``bool`` z /zones/{}/instances/{}/resetrU r� �ignoredr� T�r2 ro rQ rc r� )r6 r8 rF r$ r$ r% � reboot_node' s zGCENodeDriver.reboot_nodec C sz d� |jd j|j�}i }||d< |jd |d< | jj|d|d� | �|j|jd �}|jd |jd< |jd |jd< d S ) aY Set the tags on a Node instance. Note that this updates the node object directly. :param node: Node object :type node: :class:`Node` :param tags: List of tags to apply to the object :type tags: ``list`` of ``str`` :return: True if successful :rtype: ``bool`` z /zones/{}/instances/{}/setTagsrU rD �tags_fingerprintr� r� r� r T)r2 ro rQ rc r� r )r6 r8 r rF Z tags_data�new_noder$ r$ r% �ex_set_node_tags6 s �z GCENodeDriver.ex_set_node_tagsc C s t |d�s | �|d�}|dur$|�� }ddg}||vr$tdd�|� ��d�|jd j|j�}i }|dur9||d < |durA||d < | jj |d |d � | �|j|jd �}|jd |jd< |jd � d �}|jd � d �} d} |d|fvrvd} |d| fvr~d} | S )a� Set the maintenance behavior for the node. See `Scheduling <https://developers.google.com/compute/ docs/instances#onhostmaintenance>`_ documentation for more info. :param node: Node object :type node: :class:`Node` :keyword on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type on_host_maintenance: ``str`` :keyword automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type automatic_restart: ``bool`` :return: True if successful. :rtype: ``bool`` rQ rz NrX rY z%on_host_maintenance must be one of %sr� z$/zones/{}/instances/{}/setSchedulingrU rZ r[ r� r� r9 TF) r� r r� r� r� r2 ro rQ rc r� rI ) r6 r8 r* r+ Z ohm_valuesrF Zscheduling_datar� Zohm�ar�successr$ r$ r% �ex_set_node_schedulingU s6 � z$GCENodeDriver.ex_set_node_schedulingc C s� |du r |du r t d��|du r|du rt d��i } |r || d< | r&| | d< | r,| | d< | r2| | d< |r8|| d< |r>|| d < |pD|jd | d< |pJd | d < |rT|| d < n|j| d < || d< d�|jd j|j�} | jj| d| d� dS )a_ Attach a volume to a node. If volume is None, an ex_source URL must be provided. :param node: The node to attach the volume to :type node: :class:`Node` or ``None`` :param volume: The volume to attach. :type volume: :class:`StorageVolume` or ``None`` :keyword device: The device name to attach the volume as. Defaults to volume name. :type device: ``str`` :keyword ex_mode: Either 'READ_WRITE' or 'READ_ONLY' :type ex_mode: ``str`` :keyword ex_boot: If true, disk will be attached as a boot disk :type ex_boot: ``bool`` :keyword ex_type: Specify either 'PERSISTENT' (default) or 'SCRATCH'. :type ex_type: ``str`` :keyword ex_source: URL (full or partial) of disk source. Must be present if not using an existing StorageVolume. :type ex_source: ``str`` or ``None`` :keyword ex_auto_delete: If set, the disk will be auto-deleted if the parent node/instance is deleted. :type ex_auto_delete: ``bool`` or ``None`` :keyword ex_initialize_params: Allow user to pass in full JSON struct of `initializeParams` as documented in GCE's API. :type ex_initialize_params: ``dict`` or ``None`` :keyword ex_licenses: List of strings representing licenses associated with the volume/disk. :type ex_licenses: ``list`` of ``str`` :keyword ex_interface: User can specify either 'SCSI' (default) or 'NVME'. :type ex_interface: ``str`` or ``None`` :return: True if successful :rtype: ``bool`` NzOMust supply either a StorageVolume or set `ex_source` URL for an existing disk.z8Must supply either a StorageVolume or set `device` name.r� ZinitialzeParamsr� Z interfacer� r rq r� r r r z!/zones/{}/instances/{}/attachDiskrU r� r� T)r� ro rQ r2 rc r� )r6 r8 r� ZdeviceZex_modeZex_bootZex_typeZ ex_sourceZex_auto_deleteZex_initialize_paramsr� Z ex_interfacer� rF r$ r$ r% � attach_volume� s> ?� �zGCENodeDriver.attach_volumec C s8 d� |jd j|j�}dt|�i}| jj|d|d� dS )a4 Resize a volume to the specified size. :param volume: Volume object to resize :type volume: :class:`StorageVolume` :param size: The size in GB of the volume to resize to. :type size: ``int`` :return: True if successful :rtype: ``bool`` z/zones/{}/disks/{}/resizerU �sizeGbr� r� T)r2 ro rQ r rc r� )r6 r� r& rF r� r$ r$ r% �ex_resize_volume s z GCENodeDriver.ex_resize_volumec C s8 |sdS d� |jd j|j|j�}| jj|ddd� dS )aA Detach a volume from a node. :param volume: Volume object to detach :type volume: :class:`StorageVolume` :keyword ex_node: Node object to detach volume from (required) :type ex_node: :class:`Node` :return: True if successful :rtype: ``bool`` Fz//zones/{}/instances/{}/detachDisk?deviceName={}rU r� r� r� Tr� )r6 r� Zex_noderF r$ r$ r% � detach_volume s �zGCENodeDriver.detach_volumec C s8 d� |jd j|j�}|j|d�}| jj|d|d� dS )a� Sets the auto-delete flag for a volume attached to a node. :param volume: Volume object to auto-delete :type volume: :class:`StorageVolume` :param ex_node: Node object to auto-delete volume from :type ex_node: :class:`Node` :keyword auto_delete: Flag to set for the auto-delete value :type auto_delete: ``bool`` (default True) :return: True if successful :rtype: ``bool`` z(/zones/{}/instances/{}/setDiskAutoDeleterU )r r r� r� Tr� )r6 r� r8 r5 rF Z delete_paramsr$ r$ r% �ex_set_volume_auto_delete5 s ��z'GCENodeDriver.ex_set_volume_auto_deletec C sR t |d�s | �|�}t |jd�rd�|jj|j�}nd|j }| jj|dd� dS )z� Destroy a static address. :param address: Address object to destroy :type address: ``str`` or :class:`GCEAddress` :return: True if successful :rtype: ``bool`` rQ �/regions/{}/addresses/{}�/global/addresses/%sr� rO T)r� r� r� r2 rQ rc r� )r6 r� rF r$ r$ r% r� Q s z GCENodeDriver.ex_destroy_addressc C � d|j }| jj|dd� dS )z� Destroy a Backend Service. :param backendservice: BackendService object to destroy :type backendservice: :class:`GCEBackendService` :return: True if successful :rtype: ``bool`` �/global/backendServices/%sr� rO Tr� )r6 r� rF r$ r$ r% r� h � z'GCENodeDriver.ex_destroy_backendservicec C s2 t |d�s | �|�}d|j }| jj|dd� dS )z� Delete a specific image resource. :param image: Image object to delete :type image: ``str`` or :class:`GCENodeImage` :return: True if successful :rtype: ``bool`` rQ z/global/images/%sr� rO T)r� r� rQ rc r� )r6 r� rF r$ r$ r% r� x s z GCENodeDriver.ex_delete_imagec C s� t |d�s | �|�}t |d�s| �|�}|du rd}g d�}||vr+tdd�|� ��|dkr2i }n5||jd d �}d |fd |fd |ffD ]!\} } | du rNqEzt| � W n tya td | ��w | || < qEd|j } | jj | d|d�j dS )a� Deprecate a specific image resource. :param image: Image object to deprecate :type image: ``str`` or :class: `GCENodeImage` :param replacement: Image object to use as a replacement :type replacement: ``str`` or :class: `GCENodeImage` :param state: State of the image :type state: ``str`` :param deprecated: RFC3339 timestamp to mark DEPRECATED :type deprecated: ``str`` or ``None`` :param obsolete: RFC3339 timestamp to mark OBSOLETE :type obsolete: ``str`` or ``None`` :param deleted: RFC3339 timestamp to mark DELETED :type deleted: ``str`` or ``None`` :return: True if successful :rtype: ``bool`` rQ N� DEPRECATED)�ACTIVEZDELETEDr� ZOBSOLETEzstate must be one of %sr� r� rq )r� r� r� r� r� z %s must be an RFC3339 timestampz/global/images/%s/deprecater� r� T) r� r� r� r� ro r& rt rQ rc rF rH ) r6 r� r� r� r� r� r� Zpossible_statesr� Z attributer� rF r$ r$ r% r� � s: " � � � z GCENodeDriver.ex_deprecate_imagec C r� )z� Destroy a healthcheck. :param healthcheck: Health check object to destroy :type healthcheck: :class:`GCEHealthCheck` :return: True if successful :rtype: ``bool`` r� r� rO Tr� )r6 r� rF r$ r$ r% r� � � z$GCENodeDriver.ex_destroy_healthcheckc C r� )z� Destroy a firewall. :param firewall: Firewall object to destroy :type firewall: :class:`GCEFirewall` :return: True if successful :rtype: ``bool`` r� r� rO Tr� )r6 r� rF r$ r$ r% r� � r� z!GCENodeDriver.ex_destroy_firewallc C s8 |j r d�|j j|j�}nd|j }| jj|dd� dS )z� Destroy a forwarding rule. :param forwarding_rule: Forwarding Rule object to destroy :type forwarding_rule: :class:`GCEForwardingRule` :return: True if successful :rtype: ``bool`` � /regions/{}/forwardingRules/{}�/global/forwardingRules/%sr� rO T)r� r2 rQ rc r� )r6 r� rF r$ r$ r% r� � s � z(GCENodeDriver.ex_destroy_forwarding_rulec C r� )z� Destroy a route. :param route: Route object to destroy :type route: :class:`GCERoute` :return: True if successful :rtype: ``bool`` �/global/routes/%sr� rO Tr� )r6 r rF r$ r$ r% r r� z GCENodeDriver.ex_destroy_routec C r� )z� Destroy a network. :param network: Network object to destroy :type network: :class:`GCENetwork` :return: True if successful :rtype: ``bool`` �/global/networks/%sr� rO Tr� )r6 r� rF r$ r$ r% r r� z GCENodeDriver.ex_destroy_network� n1-standard-1c C sZ d|j d j }}|�d�d }d�||�}d�||j�}d|i}| jj|d|d � d S ) ai Set the machine type of the stopped instance. Can be the short-name, a full, or partial URL. :param node: Target node object to change :type node: :class:`Node` :param machine_type: Desired machine type :type machine_type: ``str`` :return: True if successful :rtype: ``bool`` � /zones/%srU r� r� z{}/machineTypes/{}z {}/instances/{}/setMachineTyperB r� r� T)ro rQ r� r2 rc r� )r6 r8 � machine_typerF Zmt_url�mtr� r$ r$ r% �ex_set_machine_type) s z!GCENodeDriver.ex_set_machine_typec C �B d� |jd j|j�}|r| jj|dd� dS | jj|dd� dS )aD Start a node that is stopped and in TERMINATED state. :param node: Node object to start :type node: :class:`Node` :keyword sync: If true, do not return until destroyed or timeout :type sync: ``bool`` :return: True if successful :rtype: ``bool`` z /zones/{}/instances/{}/startrU r� rO T�r2 ro rQ rc r� rF �r6 r8 �ex_syncrF r$ r$ r% � start_nodeB � �zGCENodeDriver.start_nodec C r� )a" Stop a running node. :param node: Node object to stop :type node: :class:`Node` :keyword sync: If true, do not return until destroyed or timeout :type sync: ``bool`` :return: True if successful :rtype: ``bool`` z/zones/{}/instances/{}/stoprU r� rO Tr� r� r$ r$ r% � stop_nodeX r� zGCENodeDriver.stop_nodec C � | j ||d�S �N)r8 r� )r� �r6 r8 �syncr$ r$ r% � ex_start_noden � zGCENodeDriver.ex_start_nodec C r� r� )r� r� r$ r$ r% � ex_stop_nodeu r� zGCENodeDriver.ex_stop_nodec C �& d� |jj|j�}| jj|dd� dS )a. Destroy a managed instance group. This will destroy all instances that belong to the instance group. :param manager: InstanceGroup object to destroy. :type manager: :class:`GCEInstanceGroup` :return: True if successful :rtype: ``bool`` �"/zones/{}/instanceGroupManagers/{}r� rO Tr� )r6 r\ rF r$ r$ r% r] | s �z-GCENodeDriver.ex_destroy_instancegroupmanagerc C �$ d|j }i }| jj|d|d� dS )a� Deletes the specified instance template. If you delete an instance template that is being referenced from another instance group, the instance group will not be able to create or recreate virtual machine instances. Deleting an instance template is permanent and cannot be undone. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param instancetemplate: The name of the instance template to delete. :type instancetemplate: ``str`` :return instanceTemplate: Return True if successful. :rtype instanceTemplate: ````bool```` � /global/instanceTemplates/%sr� r� Tr� )r6 rD rF r� r$ r$ r% rE � s z)GCENodeDriver.ex_destroy_instancetemplatec C r� )z� Destroy an Autoscaler. :param autoscaler: Autoscaler object to destroy. :type autoscaler: :class:`GCEAutoscaler` :return: True if successful :rtype: ``bool`` �/zones/{}/autoscalers/{}r� rO Tr� )r6 r> rF r$ r$ r% r? � s z#GCENodeDriver.ex_destroy_autoscalerc C s\ d� |jd j|j�}|r| jj|dd� n| jj|dd� |r,|jd r,|jd �� dS )ac Destroy a node. :param node: Node object to destroy :type node: :class:`Node` :keyword destroy_boot_disk: If true, also destroy the node's boot disk. (Note that this keyword is not accessible from the node's .destroy() method.) :type destroy_boot_disk: ``bool`` :keyword ex_sync: If true, do not return until destroyed or timeout :type ex_sync: ``bool`` :return: True if successful :rtype: ``bool`` �/zones/{}/instances/{}rU r� rO r T)r2 ro rQ rc r� rF rw )r6 r8 �destroy_boot_diskr� rF r$ r$ r% � destroy_node� s zGCENodeDriver.destroy_nodec C s g }d}t � � }|D ]8} d�| jd j| j�} z | jj| dd�j} W n ty3 | j|d� d} Y nw | d| | dd�} |� | � q |s�t � � | |krQt d ��d }|D ]�} | d p^| d } d}| r�d }z | j�| d �j} W n ty� | j|d� d}ddi} Y nw | d dkr�| d r�d| d < || d< d }nd| d < || d< |r�|r�| d jd }|r�d�|jd j|j�} z | jj| dd�j} W n ty� | j|d� d}d} Y nw | | d < nd | d< | d p�| d } | r�t � |� d}qU|rEg }|D ]} | d �o| d }|� |� q�|S )a� Destroy multiple nodes at once. :param node_list: List of nodes to destroy :type node_list: ``list`` of :class:`Node` :keyword ignore_errors: If true, don't raise an exception if one or more nodes fails to be destroyed. :type ignore_errors: ``bool`` :keyword destroy_boot_disk: If true, also destroy the nodes' boot disks. :type destroy_boot_disk: ``bool`` :keyword poll_interval: Number of seconds between status checks. :type poll_interval: ``int`` :keyword timeout: Number of seconds to wait for all nodes to be destroyed. :type timeout: ``int`` :return: A list of boolean values. One for each node. True means that the node was successfully destroyed. :rtype: ``list`` of ``bool`` Fr� rU r� rO �r\ N)r8 � node_successr] � disk_success� disk_responsez;Timeout (%s sec) while waiting to delete multiple instancesTr] r� rq r" �DONEr� r� r8 r �/zones/{}/disks/{}) r_ r2 ro rQ rc rF rH r � _catch_errorrR rt r` )r6 rM r\ r� re r� rg ri rh r8 rF rL r" Z operationZ delete_diskZ no_errorsr r� rT r$ r$ r% �ex_destroy_multiple_nodes� s� ! �� � � � ��8 z'GCENodeDriver.ex_destroy_multiple_nodesc C r� )z� Destroy a target HTTP proxy. :param targethttpproxy: TargetHttpProxy object to destroy :type targethttpproxy: :class:`GCETargetHttpProxy` :return: True if successful :rtype: ``bool`` � /global/targetHttpProxies/%sr� rO Tr� )r6 r+ rF r$ r$ r% r, P r� z(GCENodeDriver.ex_destroy_targethttpproxyc C r� )a� Deletes the specified TargetHttpsProxy resource. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param targethttpsproxy: Name of the TargetHttpsProxy resource to delete. :type targethttpsproxy: ``str`` :return targetHttpsProxy: Return True if successful. :rtype targetHttpsProxy: ````bool```` � /global/targetHttpsProxies/%sr� r� Tr� )r6 r0 rF r� r$ r$ r% r6 _ � z)GCENodeDriver.ex_destroy_targethttpsproxyc C r� )z� Destroy a target instance. :param targetinstance: TargetInstance object to destroy :type targetinstance: :class:`GCETargetInstance` :return: True if successful :rtype: ``bool`` � /zones/{}/targetInstances/{}r� rO Tr� )r6 r9 rF r$ r$ r% r: u s �z'GCENodeDriver.ex_destroy_targetinstancec C r� )z� Destroy a target pool. :param targetpool: TargetPool object to destroy :type targetpool: :class:`GCETargetPool` :return: True if successful :rtype: ``bool`` �/regions/{}/targetPools/{}r� rO T)r2 r� rQ rc r� )r6 r� rF r$ r$ r% r� � s �z#GCENodeDriver.ex_destroy_targetpoolc C r� )z� Destroy a URL map. :param urlmap: UrlMap object to destroy :type urlmap: :class:`GCEUrlMap` :return: True if successful :rtype: ``bool`` �/global/urlMaps/%sr� rO Tr� )r6 r) rF r$ r$ r% r� � r� z GCENodeDriver.ex_destroy_urlmapc C s* d� |jd j|j�}| jj|dd� dS )z� Destroy a volume. :param volume: Volume object to destroy :type volume: :class:`StorageVolume` :return: True if successful :rtype: ``bool`` r� rU r� rO Tr� )r6 r� rF r$ r$ r% �destroy_volume� s z GCENodeDriver.destroy_volumec C r� )z� Destroy a snapshot. :param snapshot: Snapshot object to destroy :type snapshot: :class:`GCESnapshot` :return: True if successful :rtype: ``bool`` �/global/snapshots/%sr� rO Tr� )r6 r� rF r$ r$ r% �destroy_volume_snapshot� r� z%GCENodeDriver.destroy_volume_snapshotc C s t �||| �S )a^ Return a License object for specified project and name. :param project: The project to reference when looking up the license. :type project: ``str`` :param name: The name of the License :type name: ``str`` :return: A License object for the name :rtype: :class:`GCELicense` )rl Zlazy)r6 r9 rQ r$ r$ r% �ex_get_license� s z GCENodeDriver.ex_get_licensec C s� | � |�}|rd�|j|�}nd}| jj|dd�}d|jv r<d}|jd �� D ]}|d D ] }|d |kr9|} nq-q'n|j}|sGtd | ��| �|�S ) a� Return a DiskType object based on a name and optional zone. :param name: The name of the DiskType :type name: ``str`` :keyword zone: The zone to search for the DiskType in (set to 'all' to search all zones) :type zone: ``str`` :class:`GCEZone` or ``None`` :return: A DiskType object for the name :rtype: :class:`GCEDiskType` z/zones/{}/diskTypes/{}r� rN rO rD Nr� rQ z"Disk type with name "%s" not found) r� r2 rQ rc rF rH r� r� r� )r6 rQ rU r4 rL r� Z zone_itemrA r$ r$ r% r � s& ��� z GCENodeDriver.ex_get_disktypec C s4 | � |�}d�|j|�}| jj|dd�j}| �|�S )av Return an AcceleratorType object based on a name and zone. :param name: The name of the AcceleratorType :type name: ``str`` :param zone: The zone to search for the AcceleratorType in. :type zone: :class:`GCEZone` :return: An AcceleratorType object for the name :rtype: :class:`GCEAcceleratorType` z /zones/{}/acceleratorTypes/{}rN rO )r� r2 rQ rc rF rH �_to_accelerator_type�r6 rQ rU rF rL r$ r$ r% r s z%GCENodeDriver.ex_get_accelerator_typec C sX |dkr d| }n| � |�p| j|dddd�}d�|j|�}| jj|dd �j}| �|�S ) a� Return an Address object based on an address name and optional region. :param name: The name of the address :type name: ``str`` :keyword region: The region to search for the address in (set to 'all' to search all regions) :type region: ``str`` :class:`GCERegion` or ``None`` :return: An Address object for the address :rtype: :class:`GCEAddress` r� r� r TZAddress�r� �res_namer� rN rO )r �_find_zone_or_regionr2 rQ rc rF rH r �r6 rQ r� rF rL r$ r$ r% r� s � z GCENodeDriver.ex_get_addressc C �$ d| }| j j|dd�j}| �|�S )a Return a Backend Service object based on name :param name: The name of the backend service :type name: ``str`` :return: A BackendService object for the backend service :rtype: :class:`GCEBackendService` r� rN rO )rc rF rH r �r6 rQ rF rL r$ r$ r% r� . � z#GCENodeDriver.ex_get_backendservicec C r� )z� Return a HealthCheck object based on the healthcheck name. :param name: The name of the healthcheck :type name: ``str`` :return: A GCEHealthCheck object :rtype: :class:`GCEHealthCheck` r� rN rO )rc rF rH r r� r$ r$ r% r� = r� z GCENodeDriver.ex_get_healthcheckc C r� )z� Return a Firewall object based on the firewall name. :param name: The name of the firewall :type name: ``str`` :return: A GCEFirewall object :rtype: :class:`GCEFirewall` r� rN rO )rc rF rH r r� r$ r$ r% r� L r� z GCENodeDriver.ex_get_firewallc C sT |rd| }n| � |�p| j|dddd�}d�|j|�}| jj|dd�j}| �|�S ) ag Return a Forwarding Rule object based on the forwarding rule name. :param name: The name of the forwarding rule :type name: ``str`` :keyword region: The region to search for the rule in (set to 'all' to search all regions). :type region: ``str`` or ``None`` :keyword global_rule: Set to True to get a global forwarding rule. Region will be ignored if True. :type global_rule: ``bool`` :return: A GCEForwardingRule object :rtype: :class:`GCEForwardingRule` r� r TZForwardingRuler� r� rN rO )r r� r2 rQ rc rF rH r )r6 rQ r� r� rF rL r$ r$ r% r� [ s � z$GCENodeDriver.ex_get_forwarding_rulec C s� |� d�r| jj|dd�}| �|j�S | �||�}|s7|r7| j�� D ]\}}|D ] }|� |�r5| �||�}q(q"|sAtd| dd��|S )aV Return an GCENodeImage object based on the name or link provided. :param partial_name: The name, partial name, or full path of a GCE image. :type partial_name: ``str`` :param ex_project_list: The name of the project to list for images. Examples include: 'debian-cloud'. :type ex_project_list: ``str`` or ``list`` of ``str`` or ``None`` :param ex_standard_projects: If true, check in standard projects if the image is not found. :type ex_standard_projects: ``bool`` :return: GCENodeImage object based on provided information or None if an image with that name is not found. :rtype: :class:`GCENodeImage` or raise ``ResourceNotFoundError`` r� rN rO zCould not find image '%s'N) r� rc rF r& rH � _match_imagesr! rD r ) r6 � partial_name�ex_project_list�ex_standard_projectsrL r� r# � short_list� short_namer$ r$ r% r� z s ��zGCENodeDriver.ex_get_imagec s� d � fdd� }d}|� d�r � jj|dd�}� �|j�S |s#||�}n|D ] }|||d�}|r1 nq%|sT|rT� j�� D ]\}}|D ]} |� | �rR|||d�}|rR nqAq;|s^td| dd��|S ) a\ Return an GCENodeImage object based on an image family name. :param image_family: The name of the 'Image Family' to return the latest image from. :type image_family: ``str`` :param ex_project_list: The name of the project to list for images. Examples include: 'debian-cloud'. :type ex_project_list: ``list`` of ``str``, or ``None`` :param ex_standard_projects: If true, check in standard projects if the image is not found. :type ex_standard_projects: ``bool`` :return: GCENodeImage object based on provided information or ResourceNotFoundError if the image family is not found. :rtype: :class:`GCENodeImage` or raise ``ResourceNotFoundError`` Nc s� d| }� j j}|r|�� j|�}|� j _z*z� j j|dd�}� �|j�}W n ty1 d }Y nw W |� j _|S W |� j _|S |� j _w )Nz/global/images/family/%srN rO )rc r4 rs r9 rF r& rH r )� image_familyr9 rF r' ru rL r� rf r$ r% �_try_image_family� s$ ��� �zAGCENodeDriver.ex_get_image_from_family.<locals>._try_image_familyr� rN rO )r9 z$Could not find image for family '%s'r\ )r� rc rF r& rH r! rD r ) r6 r� r� r� r� r� rL r# r� r� r$ rf r% r � s2 � � �z&GCENodeDriver.ex_get_image_from_familyc C r� )z� Return a Route object based on a route name. :param name: The name of the route :type name: ``str`` :return: A Route object for the named route :rtype: :class:`GCERoute` r� rN rO )rc rF rH r/ r� r$ r$ r% r� � r� zGCENodeDriver.ex_get_routec C r� )a� Deletes the specified SslCertificate resource. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute :param sslcertificate: Name of the SslCertificate resource to delete. :type sslcertificate: ``str`` :return sslCertificate: Return True if successful. :rtype sslCertificate: ````bool```` �/global/sslCertificates/%sr� r� Tr� )r6 r� rF r� r$ r$ r% r� � r� z'GCENodeDriver.ex_destroy_sslcertificatec C s� d}d}|r t |t�r|j}n|�d�r |�d�d }n|}t |t�r-|j}|s,|jj}n|�d�rB| �|�}|d }|sA|d }n|}|sT| �|�}|sQt d��|j}d� ||�}| j j |d d �j d S ) a� Delete a Subnetwork object based on name and region. :param name: The name, URL or object of the subnetwork :type name: ``str`` or :class:`GCESubnetwork` :keyword region: The region object, name, or URL of the subnetwork :type region: ``str`` or :class:`GCERegion` or ``None`` :return: True if successful :rtype: ``bool`` Nr� r� r� rQ r� �*Could not determine region for subnetwork.�/regions/{}/subnetworks/{}r� rO T)r� r! rQ r� r� r� r� r� r r� r2 rc r� rH )r6 rQ r� r� Z subnet_nameZ url_partsrF r$ r$ r% r� s8 � � z#GCENodeDriver.ex_destroy_subnetworkc C s� d}|� d�r |}n3t|t�r|j}nt|t�r'|� d�r%|�d�d }n|}|s7| �|�}|s4td��|j}d�||�}| j j |dd�j }| � |�S ) af Return a Subnetwork object based on name and region. :param name: The name or URL of the subnetwork :type name: ``str`` :keyword region: The region of the subnetwork :type region: ``str`` or :class:`GCERegion` or ``None`` :return: A Subnetwork object :rtype: :class:`GCESubnetwork` Nr� r� r� r� r� rN rO ) r� r� r! rQ r r� r r� r2 rc rF rH r8 )r6 rQ r� r� rF rL r$ r$ r% r� B s" z GCENodeDriver.ex_get_subnetworkc C s4 |� d�r|}nd| }| jj|dd�j}| �|�S )z� Return a Network object based on a network name. :param name: The name or URL of the network :type name: ``str`` :return: A Network object for the network :rtype: :class:`GCENetwork` r� r� rN rO )r� rc rF rH r< r� r$ r$ r% r� j s z GCENodeDriver.ex_get_networkc C �D | � |�p | j|ddd�}d�|j|�}| jj|dd�j}| �|�S )a� Return a Node object based on a node name and optional zone. :param name: The name of the node :type name: ``str`` :keyword zone: The zone to search for the node in. If set to 'all', search all zones for the instance. :type zone: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :return: A Node object for the node :rtype: :class:`Node` r> r �r� r� rN rO )r� r� r2 rQ rc rF rH rG r� r$ r$ r% r } s zGCENodeDriver.ex_get_nodec C s | j jddd�j}| �|�S )z� Return a Project object with project-wide information. :return: A GCEProject object :rtype: :class:`GCEProject` r� rN rO )rc rF rH � _to_project)r6 rL r$ r$ r% r� � s z GCENodeDriver.ex_get_projectc C sV |p| j }t|d�s| �|�}d�|j|�}| jj|dd�j}tddd�}| � ||�S )a� Return a size object based on a machine type name and zone. :param name: The name of the node :type name: ``str`` :keyword zone: The zone to search for the machine type in :type zone: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :return: A GCENodeSize object for the machine type :rtype: :class:`GCENodeSize` rQ z/zones/{}/machineTypes/{}rN rO r� rN rO ) rU r� r� r2 rQ rc rF rH r rR )r6 rQ rU rF rL rV r$ r$ r% r � s zGCENodeDriver.ex_get_sizec C r� )z� Return a Snapshot object based on snapshot name. :param name: The name of the snapshot :type name: ``str`` :return: A GCESnapshot object for the snapshot :rtype: :class:`GCESnapshot` r� rN rO )rc rF rH rZ r� r$ r$ r% r� � r� z GCENodeDriver.ex_get_snapshotc C s@ | j r|du r | �� z|j}W n ty Y nw | �||�S )a Return a Volume object based on a volume name and optional zone. To improve performance, we request all disks and allow the user to consult the cache dictionary rather than making an API call. :param name: The name of the volume :type name: ``str`` :keyword zone: The zone to search for the volume in (set to 'all' to search all zones) :type zone: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :keyword use_cache: Search for the volume in the existing cache of volumes. If True, we omit the API call and search self.volumes_dict. If False, a call to disks/aggregatedList is made prior to searching self._ex_volume_dict. :type use_cache: ``bool`` :return: A StorageVolume object for the volume :rtype: :class:`StorageVolume` F)r� rD rQ �AttributeError�_ex_lookup_volume)r6 rQ rU � use_cacher$ r$ r% r � s � zGCENodeDriver.ex_get_volumec C sZ |� d�r| �|�d }|}n|}d| }|| jv r | j| S | jj|dd�j}| �|�S )z� Return a Region object based on the region name. :param name: The name of the region. :type name: ``str`` :return: A GCERegion object for the region :rtype: :class:`GCERegion` r� rQ z /regions/%srN rO )r� r� r� rc rF rH rK �r6 rQ r� rF rL r$ r$ r% r� � s zGCENodeDriver.ex_get_regionc C r� )aB Returns the specified SslCertificate resource. Get a list of available SSL certificates by making a list() request. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :param name: Name of the SslCertificate resource to return. :type name: ``str`` :return: `GCESslCertificate` object. :rtype: :class:`GCESslCertificate` r� rN rO )rc rF rH r4 r� r$ r$ r% r� ! � z#GCENodeDriver.ex_get_sslcertificatec C r� )a Return a Target HTTP Proxy object based on its name. :param name: The name of the target HTTP proxy. :type name: ``str`` :return: A Target HTTP Proxy object for the pool :rtype: :class:`GCETargetHttpProxy` r� rN rO )rc rF rH r^ r� r$ r$ r% r� ! r� z$GCENodeDriver.ex_get_targethttpproxyc C r� )aP Returns the specified TargetHttpsProxy resource. Get a list of available target HTTPS proxies by making a list() request. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :param name: Name of the TargetHttpsProxy resource to return. :type name: ``str`` :return: `GCETargetHttpsProxy` object. :rtype: :class:`GCETargetHttpsProxy` r� rN rO )rc rF rH re r� r$ r$ r% rr *! r z%GCENodeDriver.ex_get_targethttpsproxyc C r� )a� Return a TargetInstance object based on a name and optional zone. :param name: The name of the target instance :type name: ``str`` :keyword zone: The zone to search for the target instance in (set to 'all' to search all zones). :type zone: ``str`` or :class:`GCEZone` or ``None`` :return: A TargetInstance object for the instance :rtype: :class:`GCETargetInstance` rn ZTargetInstancer� r� rN rO )r� r� r2 rQ rc rF rH rk r� r$ r$ r% rv A! s � z#GCENodeDriver.ex_get_targetinstancec C �F | � |�p | j|dddd�}d�|j|�}| jj|dd�j}| �|�S )a� Return a TargetPool object based on a name and optional region. :param name: The name of the target pool :type name: ``str`` :keyword region: The region to search for the target pool in (set to 'all' to search all regions). :type region: ``str`` or :class:`GCERegion` or ``None`` :return: A TargetPool object for the pool :rtype: :class:`GCETargetPool` rs TZ TargetPoolr� r� rN rO )r r� r2 rQ rc rF rH rr r� r$ r$ r% r� W! � � z GCENodeDriver.ex_get_targetpoolc C r� )z� Return a URL Map object based on name :param name: The name of the url map :type name: ``str`` :return: A URL Map object for the backend service :rtype: :class:`GCEUrlMap` r� rN rO )rc rF rH rv r� r$ r$ r% rm m! r� zGCENodeDriver.ex_get_urlmapc C r )a� Returns the specified Instance Group. Get a list of available instance groups by making a list() request. Scopes needed - one of the following: * https://www.googleapis.com/auth/cloud-platform * https://www.googleapis.com/auth/compute * https://www.googleapis.com/auth/compute.readonly :param name: The name of the instance group. :type name: ``str`` :param zone: The name of the zone where the instance group is located. :type zone: ``str`` :return: `GCEInstanceGroup` object. :rtype: :class:`GCEInstanceGroup` r{ FZ Instancegroupr� r� rN rO )r� r� r2 rQ rc rF rH rz r� r$ r$ r% r� |! s � z"GCENodeDriver.ex_get_instancegroupc C r )a� Return a InstanceGroupManager object based on a name and optional zone. :param name: The name of the Instance Group Manager. :type name: ``str`` :keyword zone: The zone to search for the Instance Group Manager. Set to 'all' to search all zones. :type zone: ``str`` or :class:`GCEZone` or ``None`` :return: An Instance Group Manager object. :rtype: :class:`GCEInstanceGroupManager` r� FZInstancegroupmanagerr� r� rN rO )r� r� r2 rQ rc rF rH r r� r$ r$ r% r� �! r z)GCENodeDriver.ex_get_instancegroupmanagerc C r� )a Return an InstanceTemplate object based on a name and optional zone. :param name: The name of the Instance Template. :type name: ``str`` :return: An Instance Template object. :rtype: :class:`GCEInstanceTemplate` r� rN rO )rc rF rH r� r� r$ r$ r% r� �! r� z%GCENodeDriver.ex_get_instancetemplatec C sF | � |�p | j|dddd�}d�|j|�}| jj|dd�j}| �|�S )a� Return an Autoscaler object based on a name and optional zone. :param name: The name of the Autoscaler. :type name: ``str`` :keyword zone: The zone to search for the Autoscaler. Set to 'all' to search all zones. :type zone: ``str`` or :class:`GCEZone` or ``None`` :return: An Autoscaler object. :rtype: :class:`GCEAutoscaler` Z AutoscalersFr� r� rN rO )r� r� r2 rQ rc rF rH r� r� r$ r$ r% r� �! r z GCENodeDriver.ex_get_autoscalerc C st |� d�r| �|�d }|}n|}d| }|| jv r | j| S z | jj|dd�j}W n ty4 Y dS w | �|�S )z� Return a Zone object based on the zone name. :param name: The name of the zone. :type name: ``str`` :return: A GCEZone object for the zone or None if not found :rtype: :class:`GCEZone` or ``None`` r� rQ r� rN rO N)r� r� r� rc rF rH r r� r r$ r$ r% r� �! s � zGCENodeDriver.ex_get_zonec C s | j | j| j| jd�S )N�r- r9 r� r. r rf r$ r$ r% �_ex_connection_class_kwargs�! s �z)GCENodeDriver._ex_connection_class_kwargsc C sb i }|� � D ](\}}|�dd�}|�dg �}|D ]}|d }|�|i � || �||i� qq|S )a� Build a dictionary in [name][zone]=disk format. :param zone_dict: dict in the format of: { items: {key: {api_name:[], key2: api_name:[]}} } :type zone_dict: ``dict`` :return: dict of volumes, organized by name, then zone Format: { 'disk_name': {'zone_name1': disk_info, 'zone_name2': disk_info} } :rtype: ``dict`` zzones/r� r� rQ )rD rs rI rW r> ) r6 r� Zname_zone_dictrY rZ r� r� r r1 r$ r$ r% �_build_volume_dict�! s �z GCENodeDriver._build_volume_dictc C s� || j vr| �� || j vrtd�||�dd��|du s |dkr)t| j | �d }| j | �|d�}|s>td�||�dd��| �|�S )aM Look up volume by name and zone in volume dict. If zone isn't specified or equals 'all', we return the volume for the first zone, as determined alphabetically. :param volume_name: The name of the volume. :type volume_name: ``str`` :keyword zone: The zone to search for the volume in (set to 'all' to search all zones) :type zone: ``str`` or ``None`` :return: A StorageVolume object for the volume. :rtype: :class:`StorageVolume` or raise ``ResourceNotFoundError``. z%Volume name: '{}' not found. Zone: {}Nrz r z"Volume '{}' not found for zone {}.)r� rD r r2 �sortedrI r� )r6 r� rU r� r$ r$ r% r� " s � � z GCENodeDriver._ex_lookup_volumec C s | j �d�}| �|d �| _dS )z� Fetch the volume information using disks/aggregatedList and store it in _ex_volume_dict. return: ``None`` r� rD N)rc rV r r� )r6 Zaggregated_itemsr$ r$ r% rD ?" s z&GCENodeDriver._ex_populate_volume_dictc C s t �� d }|r |S |�)aM Catch an exception and raise it unless asked to ignore it. :keyword ignore_errors: If true, just return the error. Otherwise, raise the error. :type ignore_errors: ``bool`` :return: The exception that was raised. :rtype: :class:`Exception` r� )�sys�exc_info)r6 r\ r� r$ r$ r% r� O" s zGCENodeDriver._catch_errorc C sh d}d}d}|� d�}|d }|d dkr|d }n|d dkr%|d }n|d d kr-d }||||d �S ) aZ Return a dictionary containing name & zone/region from a request path. :param path: HTTP request path (e.g. '/project/pjt-name/zones/us-central1-a/instances/mynode') :type path: ``str`` :return: Dictionary containing name and zone/region of resource :rtype: ``dict`` NFr� r� ���r� r r# r� T)rQ r� rU r� )r� )r6 r� r� rU �glob� componentsrQ r$ r$ r% r� a" s z'GCENodeDriver._get_components_from_pathc C s. |sdS | j j|dd�j}tj|d | |�S )a� Fetch a resource and return its object representation by mapping its 'kind' parameter to the appropriate class. Returns ``None`` if url is ``None`` :param url: fully qualified URL of the resource to request from GCE :type url: ``str`` :return: Object representation of the requested resource. "rtype: :class:`object` or ``None`` NrN rO rr )rc rF rH r� �KIND_METHOD_MAP)r6 r� rL r$ r$ r% �_get_object_by_kind{" s z!GCENodeDriver._get_object_by_kindc C s2 | j D ]}dd� |jD �}|j|v r| S qdS )z� Return the Region object that contains the given Zone object. :param zone: Zone object :type zone: :class:`GCEZone` :return: Region object that contains the zone :rtype: :class:`GCERegion` c S s g | ]}|j �qS r$ r� r� r$ r$ r% r� �" s z7GCENodeDriver._get_region_from_zone.<locals>.<listcomp>N)r� r# rQ )r6 rU r� r# r$ r$ r% r� �" s ��z#GCENodeDriver._get_region_from_zonec C s� |rd}nd}d}|p |}| j �|�}|d �� D ] \}} | �|g �D ]} | d |kr5|�d| d�} nq#q|sDtd�|||�dd��t| d | �} | |�S ) a� Find the zone or region for a named resource. :param name: Name of resource to find :type name: ``str`` :param res_type: Type of resource to find. Examples include: 'disks', 'instances' or 'addresses' :type res_type: ``str`` :keyword region: If True, search regions instead of zones :type region: ``bool`` :keyword res_name: The name of the resource type for error messages. Examples: 'Volume', 'Node', 'Address' :keyword res_name: ``str`` :return: Zone/Region object for the zone/region for the resource. :rtype: :class:`GCEZone` or :class:`GCERegion` r� rU NrD rQ z%ss/r� z {} '{}' not found in any {}.rL )rc rV rD rI rs r r2 r ) r6 rQ Zres_typer� r� ZrzZrz_nameZres_listrY rZ �resZgetrzr$ r$ r% r� �" s& ���z"GCENodeDriver._find_zone_or_regionc C s� | j | j|dd�}g }|�� D ]+}|D ]&}|j|kr | S |j�|�r9t|jd �}|r5|d |k r9||g}qq|rA|d S dS )aX Find the latest image, given a partial name. For example, providing 'debian-7' will return the image object for the most recent image with a name that starts with 'debian-7' in the supplied project. If no project is given, it will search your own project. :param project: The name of the project to search for images. Examples include: 'debian-cloud' and 'centos-cloud'. :type project: ``str``, ``list`` of ``str``, or ``None`` :param partial_name: The full name or beginning of a name for an image. :type partial_name: ``str`` :return: The latest image object that matches the partial name or None if no matching image is found. :rtype: :class:`GCENodeImage` or ``None`` Tr �creationTimestampr r� N)r� r$ rk rQ r� r& ro )r6 r9 r� Zproject_images_listZ partial_matchrk r� r# r$ r$ r% r� �" s" � �� �zGCENodeDriver._match_imagesc C �6 |p| j }|dks |du rdS t|d�s| �|�}|S )aB Return the region to use for listing resources. :param region: A name, region object, None, or 'all' :type region: ``str`` or :class:`GCERegion` or ``None`` :return: A region object or None if all regions should be considered :rtype: :class:`GCERegion` or ``None`` rz NrQ )r� r� r� )r6 r� r$ r$ r% r �" � zGCENodeDriver._set_regionc C r )a2 Return the zone to use for listing resources. :param zone: A name, zone object, None, or 'all' :type zone: ``str`` or :class:`GCEZone` or ``None`` :return: A zone object or None if all zones should be considered :rtype: :class:`GCEZone` or ``None`` rz NrQ )rU r� r� )r6 rU r$ r$ r% r� # r zGCENodeDriver._set_zonec C s� |s |s |s t d��|r|rt d��d}d}|r|}| j|fi d|�d|�d|�d| �d | �d | �d |�d |�d |�d| �d| �d|�d|�d|�d|�d|�d|�d|�d|�d|�d|�d|�d|�d |��} || d < d |j } | | fS ) a2 Returns a request and body to create a new node. This is a helper method to support both :class:`create_node` and :class:`ex_create_multiple_nodes`. :param name: The name of the node to create. :type name: ``str`` :param size: The machine type to use. :type size: :class:`GCENodeSize` :param image: The image to use to create the node (or, if using a persistent disk, the image the disk was created from). :type image: :class:`GCENodeImage` or ``None`` :param location: The location (zone) to create the node in. :type location: :class:`NodeLocation` or :class:`GCEZone` :param network: The network to associate with the node. :type network: :class:`GCENetwork` :keyword tags: A list of tags to associate with the node. :type tags: ``list`` of ``str`` :keyword metadata: Metadata dictionary for instance. :type metadata: ``dict`` :keyword boot_disk: Persistent boot disk to attach. :type :class:`StorageVolume` or ``None`` :keyword external_ip: The external IP address to use. If 'ephemeral' (default), a new non-static address will be used. If 'None', then no external address will be used. To use an existing static IP address, a GCEAddress object should be passed in. This param will be ignored if also using the ex_nic_gce_struct param. :type external_ip: :class:`GCEAddress` or ``str`` or None :keyword internal_ip: The private IP address to use. :type internal_ip: :class:`GCEAddress` or ``str`` or ``None`` :keyword ex_disk_type: Specify a pd-standard (default) disk or pd-ssd for an SSD disk. :type ex_disk_type: ``str`` or :class:`GCEDiskType` or ``None`` :keyword ex_disk_auto_delete: Indicate that the boot disk should be deleted when the Node is deleted. Set to True by default. :type ex_disk_auto_delete: ``bool`` :keyword ex_service_accounts: Specify a list of serviceAccounts when creating the instance. The format is a list of dictionaries containing email and list of scopes, e.g. [{'email':'default', 'scopes':['compute', ...]}, ...] Scopes can either be full URLs or short names. If not provided, use the 'default' service account email and a scope of 'devstorage.read_only'. Also accepts the aliases defined in 'gcloud compute'. :type ex_service_accounts: ``list`` :keyword description: The description of the node (instance). :type description: ``str`` or ``None`` :keyword ex_can_ip_forward: Set to ``True`` to allow this node to send/receive non-matching src/dst packets. :type ex_can_ip_forward: ``bool`` or ``None`` :keyword ex_disks_gce_struct: Support for passing in the GCE-specific formatted disks[] structure. No attempt is made to ensure proper formatting of the disks[] structure. Using this structure obviates the need of using other disk params like 'boot_disk', etc. See the GCE docs for specific details. :type ex_disks_gce_struct: ``list`` or ``None`` :keyword ex_nic_gce_struct: Support passing in the GCE-specific formatted networkInterfaces[] structure. No attempt is made to ensure proper formatting of the networkInterfaces[] data. Using this structure obviates the need of using 'external_ip' and 'ex_network'. See the GCE docs for details. :type ex_nic_gce_struct: ``list`` or ``None`` :keyword ex_on_host_maintenance: Defines whether node should be terminated or migrated when host machine goes down. Acceptable values are: 'MIGRATE' or 'TERMINATE' (If not supplied, value will be reset to GCE default value for the instance type.) :type ex_on_host_maintenance: ``str`` or ``None`` :keyword ex_automatic_restart: Defines whether the instance should be automatically restarted when it is terminated by Compute Engine. (If not supplied, value will be set to the GCE default value for the instance type.) :type ex_automatic_restart: ``bool`` or ``None`` :keyword ex_preemptible: Defines whether the instance is preemptible. (If not supplied, the instance will not be preemptible) :type ex_preemptible: ``bool`` or ``None`` :param ex_subnetwork: The network to associate with the node. :type ex_subnetwork: :class:`GCESubnetwork` :keyword ex_disk_size: Specify the size of boot disk. Integer in gigabytes. :type ex_disk_size: ``int`` or ``None`` :param ex_labels: Label dict for node. :type ex_labels: ``dict`` or ``None`` :param ex_accelerator_type: The accelerator to associate with the node. :type ex_accelerator_type: :class:`GCEAcceleratorType` or ``None`` :param ex_accelerator_count: The number of accelerators to associate with the node. :type ex_accelerator_count: ``int`` or ``None`` :keyword ex_disk_size: Specify size of the boot disk. Integer in gigabytes. :type ex_disk_size: ``int`` or ``None`` :return: A tuple containing a request string and a node_data dict. :rtype: ``tuple`` of ``str`` and ``dict`` znMissing root device or image. Must specify an 'image', existing 'boot_disk', or use the 'ex_disks_gce_struct'.zPCannot specify both 'boot_disk' and 'ex_disks_gce_struct'. Use one or the other.TNr% r� r� r& r' r r� rF r( r r) r* r+ r, r r r� r� r- r. rF rG r/ r7 rQ z/zones/%s/instances)r� r0 rQ ) r6 rQ r& r� rX r� r r r r r r r r r� r r r r r r r r� r r r# r/ r� r$ rF r$ r$ r% r # s� +���������� � � � � ������������� z GCENodeDriver._create_node_reqc C s� d}|d r z | � |d |d �}W n ty Y nw |r$||d< dS | jd|d |d |d |d d�\}}}z | jj|d ||d �j}W n# tyi | j|d d �}|j} |j } d}t |d | | �|d< Y nw ||d < dS )a� Create disk for ex_create_multiple_nodes. :param status: Dictionary for holding node/disk creation status. (This dictionary is modified by this method) :type status: ``dict`` :param node_attrs: Dictionary for holding node attribute information. (size, image, location, ex_disk_type, etc.) :type node_attrs: ``dict`` Nr! rQ rX r r� r )rX r� r r� r� r\ r� r� ) r r r� rc rF rH r r� r� r� r� ) r6 r" rf r Zdisk_reqZ disk_dataZ disk_paramsZdisk_resr� r� r� r$ r$ r% �_multi_create_disk�# s< � ��� � z GCENodeDriver._multi_create_diskc C � d}d}z | j �|d d �j}W n ty, | j|d d�}|j}|j}ddi}Y nw |d dkrSd|d< |rEt|d ||�|d < dS | �|d |d �|d < dS dS ) a� Check disk status for ex_create_multiple_nodes. :param status: Dictionary for holding node/disk creation status. (This dictionary is modified by this method) :type status: ``dict`` :param node_attrs: Dictionary for holding node attribute information. (size, image, location, etc.) :type node_attrs: ``dict`` Nr� rq r\ r� r" r� rQ r rX ) rc rF rH r r� r� r� r� r �r6 r" rf r� r� rL r� r$ r$ r% �_multi_check_disk*$ � � �z GCENodeDriver._multi_check_diskc C s� | j |d |d |d |d |d |d |d f|d |d |d |d |d |d |d |d |d |d |d |d |d |d d��\}}z | jj|d|d�j}W n# tyw | j|d d�}|j}|j}d}t|d ||�|d < Y nw ||d < dS ) a� Create node for ex_create_multiple_nodes. :param status: Dictionary for holding node creation status. (This dictionary is modified by this method) :type status: ``dict`` :param node_attrs: Dictionary for holding node attribute information. (size, image, location, etc.) :type node_attrs: ``dict`` rQ r& r� rX r� r r r r r r� r r r r r r rF r r� r# )r r r r� r r r r r r r r r� r# r� r� r\ r� Nr8 r] ) r rc rF rH r r� r� r� r� ) r6 r" rf rF r$ Znode_resr� r� r� r$ r$ r% ra G$ sD � � � z GCENodeDriver._multi_create_nodec C r ) a� Check node status for ex_create_multiple_nodes. :param status: Dictionary for holding node/disk creation status. (This dictionary is modified by this method) :type status: ``dict`` :param node_attrs: Dictionary for holding node attribute information. (size, image, location, etc.) :type node_attrs: ``dict`` Nr] rq r\ r� r" r� rQ r8 rX ) rc rF rH r r� r� r� r� r r r$ r$ r% rb w$ r z GCENodeDriver._multi_check_nodec C s. i }d}||d< |rt |�|d< |r,t|d�s | �|�}d|jd i}d|jd |d< |rSt|d�sD|�d�r?| �|�d }| �|�}|jd } | |d < d | |d< |pW| j}t|d�sb| �|�}t|d�ro|jd |d < n |�d�ry||d < nd |d < |d d � t | j |j |�7 < d|j } | ||fS )aT Assemble the request/data for creating a volume. Used by create_volume and ex_create_multiple_nodes :param size: Size of volume to create (in GB). Can be None if image or snapshot is supplied. :type size: ``int`` or ``str`` or ``None`` :param name: Name of volume to create :type name: ``str`` :keyword location: Location (zone) to create the volume in :type location: ``str`` or :class:`GCEZone` or :class:`NodeLocation` or ``None`` :keyword snapshot: Snapshot to create image from :type snapshot: :class:`GCESnapshot` or ``str`` or ``None`` :keyword image: Image to create disk from. :type image: :class:`GCENodeImage` or ``str`` or ``None`` :keyword ex_disk_type: Specify pd-standard (default) or pd-ssd :type ex_disk_type: ``str`` or :class:`GCEDiskType` :return: Tuple containing the request string, the data dictionary and the URL parameters :rtype: ``tuple`` NrQ r� r rq z Image: %sr� �https�sourceSnapshotz Snapshot: %sr� z#https://www.googleapis.com/compute/z${}/projects/{}/zones/{}/diskTypes/{}r� ) r r� r� ro r� r� r� rU r� r2 r3 r9 rQ ) r6 r& rQ rX r� r� r r� r? Z snapshot_linkrF r$ r$ r% r� �$ sD & � z GCENodeDriver._create_vol_reqc C s� i }| � |d �}|�d�|d< |�d�|d< |�d�|d< |�d�|d< |�d�|d< d �|j|d �}t||d || |d �S ) z� Return a DiskType object from the JSON-response dictionary. :param disktype: The dictionary describing the disktype. :type disktype: ``dict`` :return: DiskType object :rtype: :class:`GCEDiskType` rU rq r r� Z validDiskSizeZvalid_disk_size�defaultDiskSizeGb�default_disk_size_gb�{}:{}rQ �rm rQ rU ra ro )r� rI r2 rQ r| )r6 rI ro rU �type_idr$ r$ r% r� �$ s zGCENodeDriver._to_disktypec C s� i }| � |d �}|�d�|d< |�d�|d< |�d�|d< |�d�|d< |�d�|d< d�|j|d �}t||d || |d �S ) aK Return an AcceleratorType object from the JSON-response dictionary. :param accelerator_type: The dictionary describing the accelerator_type. :type accelerator_type: ``dict`` :return: AcceleratorType object :rtype: :class:`GCEAcceleratorType` rU rq r r� ZmaximumCardsPerInstancer r r rQ r )r� rI r2 rQ r� )r6 rF ro rU r r$ r$ r% r� �$ s �z"GCENodeDriver._to_accelerator_typec C s� i }d|v r| � |d �}nd}|�d�|d< |�d�|d< |�dd�|d< |�dd�dur5|�d�|d< |�d�|d< t|d |d |d || |d �S ) z� Return an Address object from the JSON-response dictionary. :param address: The dictionary describing the address. :type address: ``dict`` :return: Address object :rtype: :class:`GCEAddress` r� r� rq r" r� N�usersr rm rQ r� )rm rQ r� r� ra ro )r� rI r� )r6 r� ro r� r$ r$ r% r % s$ �zGCENodeDriver._to_addressc sv i }dD ] }|� |�||< q|� dg �}� fdd�|� dg �D �}t|d |d |||d |d |d |d � |d � S ) a Return a Backend Service object from the JSON-response dictionary. :param backendservice: The dictionary describing the backend service. :type backendservice: ``dict`` :return: BackendService object :rtype: :class:`GCEBackendService` )rq r r� r� r� c r� r$ �r r rf r$ r% r� S% r� z4GCENodeDriver._to_backendservice.<locals>.<listcomp>r� rm rQ r� r� r� r� ) rm rQ r� r� r� r� r� r� ra ro )rI r� )r6 r� ro Z extra_keyr� r� r$ rf r% r >% s" �z GCENodeDriver._to_backendservicec C s� i }|� d�|d< |� d�|d< |� d�|d< |� d�|d< t|d |d |� d�|� d�|� d �|� d �|� d �|� d �| |d � S )a Return a HealthCheck object from the JSON-response dictionary. :param healthcheck: The dictionary describing the healthcheck. :type healthcheck: ``dict`` :return: HealthCheck object :rtype: :class:`GCEHealthCheck` rq r r� r^ rm rQ r� r� r� r� r� r� ) rm rQ r� r� r� r� r� r� ra ro )rI r� )r6 r� ro r$ r$ r% r b% s" �z GCENodeDriver._to_healthcheckc C s� i }|� d�|d< |� d�|d< |� d�|d< | �|d �d |d< | �|d �}|� d�}|� d�}|� d �}|� d �}|� d �}|� d �} |� d �} |� d�} |� d�} |� d�} t|d |d |||| ||| | | | || |d�S )z� Return a Firewall object from the JSON-response dictionary. :param firewall: The dictionary describing the firewall. :type firewall: ``dict`` :return: Firewall object :rtype: :class:`GCEFirewall` rq r r� r� rQ r r� r� r� r� r� r� r� r� r� Z targetRangesrm )rm rQ r� r� r� r� r� r� r� r� r� r� r� ra ro )rI r� r� r� )r6 r� ro r� r� r� r� r� r� r� r� r� r� r� r$ r$ r% r % sB �zGCENodeDriver._to_firewallc C s� i }|� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�}|r*| �|�}| �|d �}t|d |d ||� d �|� d �|| |d �S ) a Return a Forwarding Rule object from the JSON-response dictionary. :param forwarding_rule: The dictionary describing the rule. :type forwarding_rule: ``dict`` :return: ForwardingRule object :rtype: :class:`GCEForwardingRule` rq r� r r� r� r< rm rQ r� r� )rm rQ r� r� r� r� ra ro )rI r� r r� )r6 r� ro r� r< r$ r$ r% r �% s& �z!GCENodeDriver._to_forwarding_rulec C sB i }d|v r |d |d< |d |d< t |d |d |d | |d�S )a Return the SslCertificate object from the JSON-response. :param sslcertificate: Dictionary describing SslCertificate :type sslcertificate: ``dict`` :return: Return SslCertificate object. :rtype: :class:`GCESslCertificate` r� rq rm rQ r� )rm rQ r� ra ro )r� )r6 r� ro r$ r$ r% r4 �% s �z GCENodeDriver._to_sslcertificatec C s� i }|� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d �|d < | �|� d��}| �|� d��}t|d |d |� d�||| |d �S ) a Return a Subnetwork object from the JSON-response dictionary. :param subnetwork: The dictionary describing the subnetwork. :type subnetwork: ``dict`` :return: Subnetwork object :rtype: :class:`GCESubnetwork` r r� ZgatewayAddressr� r� r� rq r� r� rm rQ )rm rQ r� r� r� ra ro )rI r r� )r6 rF ro r� r� r$ r$ r% r8 �% s* �z GCENodeDriver._to_subnetworkc C s� i }|� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< d|v rL|d rGd |d < n d |d < nd |d < t|d |d |� d�| |d�S )z� Return a Network object from the JSON-response dictionary. :param network: The dictionary describing the network. :type network: ``dict`` :return: Network object :rtype: :class:`GCENetwork` rq r� r Z gatewayIPv4r� r� r r� r� r r� r rm rQ )rm rQ r� ra ro )rI r )r6 r� ro r$ r$ r% r< & s* �zGCENodeDriver._to_networkc C s� i }|� d�|d< |� d�|d< |� d�|d< |� d�}|� d�}d|v r+|d |d< d|v r5|d |d< d|v r?|d |d< d |v rI|d |d < d |v rS|d |d < t|d |d |� d �|||� d�| |d�S )z� Return a Route object from the JSON-response dictionary. :param route: The dictionary describing the route. :type route: ``dict`` :return: Route object :rtype: :class:`GCERoute` rq r� r r� r� r� r� ZnextHopNetworkr� �warningsrm rQ r� r )rm rQ r r� r� r ra ro )rI r )r6 r ro r� r� r$ r$ r% r/ 2& s4 �zGCENodeDriver._to_routec C s` i }d|v r|� dd�|d< |� dd�|d< |� dd�|d< |� d�|d< |� d�|d< d|v r8|� dd�|d< |� dd�|d< |� d d�|d < |� d d�|d < |� d d�|d < |� d d�|d < d |v rl|� d g �|d < d|v rx|� dd�|d< d|v r�|� dd�|d< d|v r�| j|d d�}||d< |� dd�|d< |� dd�|d< t|d |d | |d�S )z� Return an Image object from the JSON-response dictionary. :param image: The dictionary describing the image. :type image: ``dict`` :return: Image object :rtype: :class:`GCENodeImage` ZpreferredKernelNr� r� r rq r� r� r� r" ZarchiveSizeBytesr r� r� � sourceDiskIdr� �r� r� r� rm rQ �rm rQ ra ro )rI �_licenses_from_urlsr� )r6 r� ro �lic_objsr$ r$ r% r& ^& s4 z GCENodeDriver._to_node_imagec C s& t |d |d |d �d�d | d�S )z� Return a Location object from the JSON-response dictionary. :param location: The dictionary describing the location. :type location: ``dict`` :return: Location object :rtype: :class:`NodeLocation` rm rQ r� r )rm rQ r� ra )r r� )r6 rX r$ r$ r% r* �& s �z GCENodeDriver._to_node_locationc C s g }g }i }|� dd�|d< |� d�|d< |� d�|d< | �|d �|d< |� d�|d< |� d�|d< |� d�|d< |� d �|d < |� d g �|d < |� d �|d < |d |d < |� d �|d < |� d�|d< |� d�|d< |d |d< |� di �|d< |d d |d< |� di �|d< |� dd�r�dnd|d< |� d�|d< |� dg �|d< |� di �|d< d|d < |� d �|d < |� d �|d < |d D ]#}|� d �r�|� d �d!kr�| �|d" �}| j|d |d |d#�|d < q�d$|d v r�|d d$ }ng }||d< |� d g �D ] } |�| � d%�� | � d&g �D ] } |�| � d'�� �qq�d} |d �r-| �|d �d } n1|d �rZt|d d(��rZd)|d jv �rZ|d jd) du�rZ|d jd) } | �| �d } | |d< | �|d �d } | j� |d tj �}t |d |d |||| | | |d*� S )+a` Return a Node object from the JSON-response dictionary. :param node: The dictionary describing the node. :type node: ``dict`` :keyword use_disk_cache: If true, ex_get_volume call will use cache. :type use_disk_cache: ``bool`` :return: Node object :rtype: :class:`Node` r" rC Z statusMessager� rU r� rB Z cpuPlatformZminCpuPlatformr� r8 rm rq rr r rQ r r r� r� r9 r� NTFr; r: r r� r� r r� r� r� )r rD rN rM r� ro r ) rm rQ r� � public_ips� private_ipsra r& r� ro ) rI r� r� r rR r� ro �NODE_STATE_MAPr rC r )r6 r8 rC r( r) ro r Zbdr Znetwork_interfaceZ access_configr� Z src_imager& r� r$ r$ r% rG �& s� �� � � ��zGCENodeDriver._to_nodec C sL i }|� d�|d< | �|d �|d< |� d�|d< |� d�|d< |� d�|d< |� dg �|d< zK|d dd � }|d j}d �|�d �dd � �}t|� d d ��d }t|d �}|| d d | d }|| d d | d } || || } W n ty� d} Y n ty� d} Y nw t|d |d |� d �|� d�d | | |d�S )z� Return a Size object from the JSON-response dictionary. :param machine_type: The dictionary describing the machine. :type machine_type: ``dict`` :return: Size object :rtype: :class:`GCENodeSize` rq rU r� Z guestCpusr Z acceleratorsrQ Nr� r� ZmemoryMbr i ZcpuZ on_demandr r rm Z imageSpaceGb)rm rQ r r r r ra ro ) rI r� rQ r� r� �float�KeyErrorr� r ) r6 r� rV ro Z size_namerX Z machine_ramZ machine_cpusZ cpu_priceZ ram_pricer r$ r$ r% rR �& s> ��zGCENodeDriver._to_node_sizec C s� i }|� d�|d< |� d�|d< |� d�|d< |d � d�}d|v r(|d |d< d|v r2|d |d< t|d |d ||� d �| |d �S ) z� Return a Project object from the JSON-response dictionary. :param project: The dictionary describing the project. :type project: ``dict`` :return: Project object :rtype: :class:`GCEProject` rq r r� r� rD ZusageExportLocationrm rQ r )rm rQ r r ra ro )rI r )r6 r9 ro r r$ r$ r% r� $' s" �zGCENodeDriver._to_projectc s� i }|� d�|d< |� d�|d< |� d�|d< |� d�}� fdd�|� dg �D �}dd� |D �}|� d �}t|d |d |� d �|||� |d �S )z� Return a Region object from the JSON-response dictionary. :param region: The dictionary describing the region. :type region: ``dict`` :return: Region object :rtype: :class:`GCERegion` rq r r� r c r� r$ )r� r� rf r$ r% r� T' r� z,GCENodeDriver._to_region.<locals>.<listcomp>r# c S s g | ]}|d ur|�qS r\ r$ r� r$ r$ r% r� W' rB r� rm rQ r" )rm rQ r" r# r r� ra ro )rI r! )r6 r� ro r r# r� r$ rf r% rK D' s$ �zGCENodeDriver._to_regionc C s� i }|� d�|d< |� d�|d< |� d�|d< d|v r!|d |d< d|v r+|d |d< d|v r5|d |d< d|v r?|d |d< d|v rO| j|d d �}||d< z t|� d��}W n tyc d }Y nw t|d |d |d |� d�| ||d�S )z� Return a Snapshot object from the JSON-response dictionary. :param snapshot: The dictionary describing the snapshot :type snapshot: ``dict`` :return: Snapshot object :rtype: :class:`VolumeSnapshot` rq r r� r� r# Z storageBytesZstorageBytesStatusr� r$ Nrm rQ r r" )rm rQ r& r" ra ro r' )rI r& r r� r% )r6 r� ro r' r' r$ r$ r% rZ e' s: ��zGCENodeDriver._to_snapshotc C s i }|� d�|d< | �|d �|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d �|d < |� d �|d < |� d i �|d < |� d �|d < |� d g �|d < d|v rq| j|d d�}||d< |� dd��d�d |d< t|d |d |d | |d�S )z� Return a Volume object from the JSON-response dictionary. :param volume: The dictionary describing the volume. :type volume: ``dict`` :return: Volume object :rtype: :class:`StorageVolume` rq rU r" r r� r Z sourceImageIdr ZsourceSnapshotId�optionsr� r� r r� r$ r� r� r� r� rm rQ r� )rm rQ r& ra ro )rI r� r& r� r )r6 r� ro r' r$ r$ r% r� �' s2 �z GCENodeDriver._to_storage_volumec s< � fdd�dD �}| � � �d��}t� d � d || |d�S )a Return a Target HTTP Proxy object from the JSON-response dictionary. :param targethttpproxy: The dictionary describing the proxy. :type targethttpproxy: ``dict`` :return: Target HTTP Proxy object :rtype: :class:`GCETargetHttpProxy` c � i | ]}|� � |��qS r$ r@ �r� rY r* r$ r% r� �' rW z5GCENodeDriver._to_targethttpproxy.<locals>.<dictcomp>)r r� rq rl rm rQ )rm rQ r) ra ro )r rI r( )r6 r+ ro r) r$ r* r% r^ �' s ��z!GCENodeDriver._to_targethttpproxyc sv i }d|v r |d |d< |d |d< � fdd�|� dg �D �}� �|d �d }� �|�}t|d |d ||� |d �S ) a" Return the TargetHttpsProxy object from the JSON-response. :param targethttpsproxy: Dictionary describing TargetHttpsProxy :type targethttpsproxy: ``dict`` :return: Return TargetHttpsProxy object. :rtype: :class:`GCETargetHttpsProxy` r� rq c r� r$ r! rf rf r$ r% r� �' r z6GCENodeDriver._to_targethttpsproxy.<locals>.<listcomp>rq rl rQ rm )rm rQ r. r) ra ro )rI r� rm r- )r6 r0 ro r. Zobj_namer) r$ rf r% re �' s" � �z"GCENodeDriver._to_targethttpsproxyc C s� d}i }|� d�|d< |� d�|d< |� d�|d< | �|d �}d|v rC|d �d�d }z| �||�}W n tyB |d }Y nw t|d |d ||| |d �S ) a" Return a Target Instance object from the JSON-response dictionary. :param targetinstance: The dictionary describing the target instance. :type targetinstance: ``dict`` :return: Target Instance object :rtype: :class:`GCETargetInstance` Nrq r� ru rU rJ r� r� rm rQ )rm rQ rU r8 ra ro )rI r� r� r r r7 )r6 r9 r8 ro rU r� r$ r$ r% rk �' s* ��z GCENodeDriver._to_targetinstancec s i }|� d�|d< |� d�|d< |� d�|d< � �|d �}� fdd�|� dg �D �}g }|� dg �D ]$}� �|�}z � �|d |d �}W n tyQ |}Y nw |�|� q3d |v rb|d |d < d |v ry|d �d �} � �| d | d �|d < t|d |d |||� |d�S )a Return a Target Pool object from the JSON-response dictionary. :param targetpool: The dictionary describing the volume. :type targetpool: ``dict`` :return: Target Pool object :rtype: :class:`GCETargetPool` rq r� r{ r� c s g | ] }� � |�d �d ��qS )r� r� )r� r� r rf r$ r% r� !( s �z0GCENodeDriver._to_targetpool.<locals>.<listcomp>r� r> rQ rU rx ry r� � � rm )rm rQ r� r� rm ra ro ) rI r� r� r r rR r� r� rl ) r6 r� ro r� Zhealthcheck_listrM r1 �compr8 Ztp_splitr$ rf r% rr ( s> � � �z GCENodeDriver._to_targetpoolc C s� i }|� dd�|d< |d |d< |� dg �|d< |� dd�|d< |� dd�}|r-| �|�}|� dd�}|r:| �|�}|� dd�}|rG| �|�}t|d |d ||||� dg �| |d �S ) a Return the InstanceGroup object from the JSON-response. :param instancegroup: Dictionary describing InstanceGroup :type instancegroup: ``dict`` :return: InstanceGroup object. :rtype: :class:`GCEInstanceGroup` r� Nrq r� r� rU r� rF rm rQ )rm rQ rU r� rF rG ra ro )rI r� r� r� r� )r6 rI ro rU r� rF r$ r$ r% rz B( s0 �z GCENodeDriver._to_instancegroupc C s� | � |d �}i }|�d�|d< |�d�|d< |�d�|d< |�d�|d< |�dg �|d< |�dg �|d< | �|d �d }| �|�}| �|d �d }| �||�}t|d |d ||d ||| |d �S )a] Return a Instance Group Manager object from the JSON-response. :param instancegroupmanager: dictionary describing the Instance Group Manager. :type instancegroupmanager: ``dict`` :return: Instance Group Manager object. :rtype: :class:`GCEInstanceGroupManager` rU rq r� ZcurrentActionsr� r� r� r� rQ Z instanceGrouprm r� )rm rQ rU r& r� rZ ra ro )r� rI r� r� r� r� )r6 r\ rU ro Z template_namerZ �ig_namer� r$ r$ r% r p( s, �z&GCENodeDriver._to_instancegroupmanagerc C sF i }|� d�|d< |� d�|d< |� d�|d< t|d |d | |d�S )aB Return a Instance Template object from the JSON-response. :param instancetemplate: dictionary describing the Instance Template. :type instancetemplate: ``dict`` :return: Instance Template object. :rtype: :class:`GCEInstanceTemplate` rq r� rA rm rQ r% )rI r@ )r6 rD ro r$ r$ r% r� �( s �z"GCENodeDriver._to_instancetemplatec C sr i }|� d�|d< |� d�|d< | �|� d��}| �|� d��d }| �||�}t|d |d |||d | |d�S ) z� Return an Autoscaler object from the JSON-response. :param autoscaler: dictionary describing the Autoscaler. :type autoscaler: ``dict`` :return: Autoscaler object. :rtype: :class:`GCEAutoscaler` rq r� rU r< rQ rm r� )rm rQ rU r< r= ra ro )rI r� r� r� r; )r6 r> ro rU r3 r< r$ r$ r% r� �( s �z GCENodeDriver._to_autoscalerc C s | j |ddd�}||d�gS )a5 Formats a GCE-friendly guestAccelerators request. Accepts an accelerator_type and accelerator_count that is wrapped up into a list of dictionaries for GCE to consume for a node creation request. :param accelerator_type: Accelerator type to request. :type accelerator_type: :class:`GCEAcceleratorType` :param accelerator_count: Number of accelerators to request. :type accelerator_count: ``int`` :return: GCE-friendly guestAccelerators list of dictionaries. :rtype: ``list`` TrF r< )ZacceleratorTypeZacceleratorCount)rE )r6 rF rG r$ r$ r% rD �( s � z(GCENodeDriver._format_guest_acceleratorsc C s� |s|g d�S d|i}t |t�rVg }|D ]=}t |t�rNd|v r/d|v r/t|�dkr/|�|� qt|�dkrJ|�t|�� �d t|�� �d d�� qtd ��td ��||d < t |t�r�d|v rod|v rot|�dkro|g|d < nHt|�dkr�d |v r�t |d t�r�|d |d < n0td ��t|�� �d t|�� �d d�g|d < ng |d < |�� D ]\}}|d �||d�� q�d |vr�td ��|S ) a� Convert various data formats into the metadata format expected by Google Compute Engine and suitable for passing along to the API. Can accept the following formats: (a) [{'key': 'k1', 'value': 'v1'}, ...] (b) [{'k1': 'v1'}, ...] (c) {'key': 'k1', 'value': 'v1'} (d) {'k1': 'v1', 'k2': v2', ...} (e) {'items': [...]} # does not check for valid list contents The return value is a 'dict' that GCE expects, e.g. {'fingerprint': 'xx...', 'items': [{'key': 'key1', 'value': 'val1'}, {'key': 'key2', 'value': 'val2'}, ..., ] } :param fingerprint: Current metadata fingerprint :type fingerprint: ``str`` :param metadata: Variety of input formats. :type metadata: ``list``, ``dict``, or ``None`` :return: GCE-friendly metadata dict :rtype: ``dict`` r� r� r8 r� r� r� r �r8 r� z Unsupported metadata format.rD ) r� r� rP r� rR r" r� r� rD )r6 r� r r� Z item_listr9 rY rZ r$ r$ r% r� �( s@ * � �z GCENodeDriver._format_metadatac sf � fdd�dD �}| � � �d��}� �dg �}� �dg �}� �dg �}t� d � d ||||| |d �S ) z� Return a UrlMap object from the JSON-response dictionary. :param zone: The dictionary describing the url-map. :type zone: ``dict`` :return: UrlMap object :rtype: :class:`GCEUrlMap` c r. r$ r@ r/ r� r$ r% r� D) s ��z,GCENodeDriver._to_urlmap.<locals>.<dictcomp>)r r� r� rq r~ Z hostRulesZ pathMatchersr� rm rQ )rm rQ r� r� r� r� ra ro )r rI r� )r6 r) ro r� r� r� r� r$ r� r% rv :) s" � �zGCENodeDriver._to_urlmapc C sn i }|� d�|d< |� d�|d< |� d�|d< |� d�|d< |� d�}t|d |d |d |� d �|| |d �S ) z� Return a Zone object from the JSON-response dictionary. :param zone: The dictionary describing the zone. :type zone: ``dict`` :return: Zone object :rtype: :class:`GCEZone` rq r r� r� r� rm rQ r" ZmaintenanceWindows)rm rQ r" r� r� ra ro )rI r� )r6 rU ro r� r$ r$ r% r� Z) s �zGCENodeDriver._to_zoner� c C s� |du r|s|rd|d�g}|S g }|S |d }|s?|r?g }|D ]}|d dkr4|� |d |d d�� q |}|� d|d�� |S )a� Return the GCE-friendly dictionary of metadata with/without an entry for 'sshKeys' based on params for 'force' and 'current_keys'. This method was added to simplify the set_common_instance_metadata method and make it easier to test. :param metadata: The GCE-formatted dict (e.g. 'items' list of dicts) :type metadata: ``dict`` or ``None`` :param force: Flag to specify user preference for keeping current_keys :type force: ``bool`` :param current_keys: The value, if any, of existing 'sshKeys' :type current_keys: ``str`` :return: GCE-friendly metadata dict :rtype: ``dict`` Nr� r4 rD r8 r� )rR )r6 r r r� r� Z updated_mdr� r$ r$ r% r� v) s �� �z#GCENodeDriver._set_project_metadatac C s@ g }|D ]}|� d�}|d }|d }|�| j||d�� q|S )a( Convert a list of license selfLinks into a list of :class:`GCELicense` objects. :param licenses: A list of GCE license selfLink URLs. :type licenses: ``list`` of ``str`` :return: List of :class:`GCELicense` objects. :rtype: ``list`` r� � r� )r9 rQ )r� rR r� )r6 r� Z return_list�licenseZselfLink_partsZlic_projZlic_namer$ r$ r% r& �) s z!GCENodeDriver._licenses_from_urlszcompute#addresszcompute#backendServicez compute#diskzcompute#firewallzcompute#forwardingRulezcompute#httpHealthCheckz compute#imagezcompute#instancezcompute#machineTypezcompute#networkzcompute#projectzcompute#regionzcompute#snapshotzcompute#sslCertificatezcompute#targetHttpProxyzcompute#targetHttpsProxyzcompute#targetInstance)zcompute#targetPoolzcompute#urlMapz compute#zonec C s | j rdS |s d}t|��dS )a_ Verify that the zone / location is set for a particular operation - either via "datacenter" driver constructor argument or via "location" / "zone" keyword argument passed to the specific method call. This check is mandatory for methods which rely on the location being set - e.g. create_node. Tz�Zone not provided. Zone needs to be specified for thisoperation. This can be done by passing "datacenter" argument to the driver constructor or by passing location / zone argument to this method.)rU r� )r6 rU �msgr$ r$ r% r �) s �z!GCENodeDriver._verify_zone_is_set)NNNNNNr� r\ r )NT)NNNr� Nr� )NNNNNNNN) NNr Nr� r� NNNNNN) NNr� NNNFNN)NNNTTNNr[ rY )rB r NNN)Nr N)Nr NNNNTr� Nr� TNNNNNNNNNNNNN)NNr� Tr NNr� NNNNNNNNNN)NNr� Tr Nr� NNNNNNNNNNNTNNNN) NNNNNTr� r� TT)TN)NNTN)r r� )Nr r� )NNNrt )NNNTr� Nr� ) NNFNNNNNN)T)r� )FT)F)FN)NNNNr� Nr� TNNNNNNNNNNNNN)NNNr� )NFr� )�r( r) r* r] r+ Z connectionClsrT rQ r ZGCEr� ZwebsiteZfeaturesr ZPENDINGr� r� ZSTOPPEDrC r* rQ rR r! r� r1 r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r$ r r- r2 r6 r: r= rI r� rY r[ rb rh ro rt rw r| r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r1 r0 r@ rE rA rW rC rB � DEFAULT_TASK_COMPLETION_TIMEOUTrj rn rs rw r} r r� r� r� r� r� r� r1 r4 r� r~ ro rv rs ry rN rS rQ rV rJ r^ rj r` rb rd rf r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r� r� r� r� r� r] rE r? r� r� r, r6 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� rr rv r� rm r� r� r� r� r� r r r� rD r� r� r r� r� r� r r� r r r ra rb r� r� r� r r r r r r4 r8 r< r/ r& r* rG rR r� rK rZ r� r^ re rk rr rz r r� r� rD r� rv r� r� r& r r r_ r$ r$ r; r% r� � s� � ������� � � � � ������� �E�R + ! " 4' 0 !8 & 5 % '$ #$ � U' �O �q �J � �m � i7 �M �; � J7 � UC � # � 5 � ! � z( �> �9 �/ �C � 4 �2 �R �B"/ 0 � * /' " ) . B I� m � L "� w ) '� H 5 ( & - . ( � _ , 0!� S " $ / ! " ) , , ^ * ! . ' ! 0 . $ _ 0�������� � � � � ����� �r� )Fr] r r_ r rE Zlibcloud.pricingr Zlibcloud.common.baser Zlibcloud.common.typesr Zlibcloud.compute.baser r r r r r r r Zlibcloud.common.googler r r r r r Zlibcloud.compute.typesr Zlibcloud.utils.iso8601r Zlibcloud.compute.providersr r3 r8 r& r' r+ r` rl r| r� r� r� r� r� r� r� r� r� r� r� r� r r r r r! r% r( r- r7 r; r@ r� r� rl r� r� r� r$ r$ r$ r% �<module> sj ( Ci0 U* 9B -=!$-Bq Bx&o
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0.01 |
proxy
|
phpinfo
|
Settings