golden hour
/opt/saltstack/salt/lib/python3.10/site-packages/salt/cloud/clouds/__pycache__
⬆️ Go Up
Upload
File/Folder
Size
Actions
__init__.cpython-310.pyc
171 B
Del
OK
aliyun.cpython-310.pyc
19.81 KB
Del
OK
azurearm.cpython-310.pyc
39.67 KB
Del
OK
clc.cpython-310.pyc
8.91 KB
Del
OK
cloudstack.cpython-310.pyc
10.87 KB
Del
OK
digitalocean.cpython-310.pyc
27.39 KB
Del
OK
dimensiondata.cpython-310.pyc
12.62 KB
Del
OK
ec2.cpython-310.pyc
92.28 KB
Del
OK
gce.cpython-310.pyc
48.78 KB
Del
OK
gogrid.cpython-310.pyc
11.07 KB
Del
OK
hetzner.cpython-310.pyc
11.82 KB
Del
OK
joyent.cpython-310.pyc
22.78 KB
Del
OK
libvirt.cpython-310.pyc
16.69 KB
Del
OK
linode.cpython-310.pyc
59.17 KB
Del
OK
lxc.cpython-310.pyc
10.9 KB
Del
OK
msazure.cpython-310.pyc
71.44 KB
Del
OK
oneandone.cpython-310.pyc
18.39 KB
Del
OK
opennebula.cpython-310.pyc
90.2 KB
Del
OK
openstack.cpython-310.pyc
23.53 KB
Del
OK
packet.cpython-310.pyc
12.06 KB
Del
OK
parallels.cpython-310.pyc
11.89 KB
Del
OK
profitbricks.cpython-310.pyc
25.34 KB
Del
OK
proxmox.cpython-310.pyc
27.25 KB
Del
OK
pyrax.cpython-310.pyc
2.59 KB
Del
OK
qingcloud.cpython-310.pyc
16.64 KB
Del
OK
saltify.cpython-310.pyc
11.91 KB
Del
OK
scaleway.cpython-310.pyc
9.36 KB
Del
OK
softlayer.cpython-310.pyc
13.26 KB
Del
OK
softlayer_hw.cpython-310.pyc
13.5 KB
Del
OK
tencentcloud.cpython-310.pyc
20.55 KB
Del
OK
vagrant.cpython-310.pyc
8.32 KB
Del
OK
virtualbox.cpython-310.pyc
9.57 KB
Del
OK
vmware.cpython-310.pyc
94.14 KB
Del
OK
vultrpy.cpython-310.pyc
12.8 KB
Del
OK
xen.cpython-310.pyc
25.66 KB
Del
OK
Edit: linode.cpython-310.pyc
o �xe�> � @ s� d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZmZmZmZ zddlZdZW n eyO dZY nw e�e�Zdaee�ej� � � � ��a dd d �d d d �dd d �ddd �ddd �ddd �ddd �d�Z dZ dd� Z!dd� 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,d0d1� Z-d2d3� Z.d4d5� Z/d6d7� Z0d8d9� Z1d:d;� Z2d<d=� Z3d>d?� Z4G d@dA� dA�Z5G dBdC� dCe5�Z6G dDdE� dEe5�Z7dndFdG�Z8dndHdI�Z9dndJdK�Z:dodLdM�Z;dpdNdO�Z<dPdQ� Z=dpdRdS�Z>dndTdU�Z?dpdVdW�Z@dpdXdY�ZAdpdZd[�ZBdnd\d]�ZCdnd^d_�ZDdnd`da�ZEdndbdc�ZFdnddde�ZGdndfdg�ZHdpdhdi�ZIdndjdk�ZJdndldm�ZKdS )qa� The Linode Cloud Module ======================= The Linode cloud module is used to interact with the Linode Cloud. You can target a specific version of the Linode API with the ``api_version`` parameter. The default is ``v3``. Provider -------- The following provider parameters are supported: - **apikey**: (required) The key to use to authenticate with the Linode API. - **password**: (required) The default password to set on new VMs. Must be 8 characters with at least one lowercase, uppercase, and numeric. - **api_version**: (optional) The version of the Linode API to interact with. Defaults to ``v3``. - **poll_interval**: (optional) The rate of time in milliseconds to poll the Linode API for changes. Defaults to ``500``. - **ratelimit_sleep**: (optional) The time in seconds to wait before retrying after a ratelimit has been enforced. Defaults to ``0``. .. note:: APIv3 usage is deprecated and will be removed in a future release in favor of APIv4. To move to APIv4 now, set the ``api_version`` parameter in your provider configuration to ``v4``. See the full migration guide here https://docs.saltproject.io/en/latest/topics/cloud/linode.html#migrating-to-apiv4. Set up the provider configuration at ``/etc/salt/cloud.providers`` or ``/etc/salt/cloud.providers.d/linode.conf``: .. code-block:: yaml my-linode-provider: driver: linode api_version: v4 apikey: f4ZsmwtB1c7f85Jdu43RgXVDFlNjuJaeIYV8QMftTqKScEB2vSosFSr... password: F00barbaz For use with APIv3 (deprecated): .. code-block:: yaml my-linode-provider-v3: driver: linode apikey: f4ZsmwtB1c7f85Jdu43RgXVDFlNjuJaeIYV8QMftTqKScEB2vSosFSr... password: F00barbaz Profile ------- The following profile parameters are supported: - **size**: (required) The size of the VM. This should be a Linode instance type ID (i.e. ``g6-standard-2``). For APIv3, this would be a plan ID (i.e. ``Linode 2GB``). Run ``salt-cloud -f avail_sizes my-linode-provider`` for options. - **location**: (required) The location of the VM. This should be a Linode region (e.g. ``us-east``). For APIv3, this would be a datacenter location (i.e. ``Newark, NJ, USA``). Run ``salt-cloud -f avail_locations my-linode-provider`` for options. - **image**: (required) The image to deploy the boot disk from. This should be an image ID (e.g. ``linode/ubuntu16.04``); official images start with ``linode/``. For APIv3, this would be an image label (i.e. Ubuntu 16.04). Run ``salt-cloud -f avail_images my-linode-provider`` for more options. - **password**: (\*required) The default password for the VM. Must be provided at the profile or provider level. - **assign_private_ip**: (optional) Whether or not to assign a private key to the VM. Defaults to ``False``. - **ssh_interface**: (optional) The interface with which to connect over SSH. Valid options are ``private_ips`` or ``public_ips``. Defaults to ``public_ips``. - **ssh_pubkey**: (optional) The public key to authorize for SSH with the VM. - **swap**: (optional) The amount of disk space to allocate for the swap partition. Defaults to ``256``. - **clonefrom**: (optional) The name of the Linode to clone from. - **disk_size**: (deprecated, optional) The amount of disk space to allocate for the OS disk. This has no effect with APIv4; the size of the boot disk will be the remainder of disk space after the swap parition is allocated. Set up a profile configuration in ``/etc/salt/cloud.profiles.d/``: .. code-block:: yaml my-linode-profile: # a minimal configuration provider: my-linode-provider size: g6-standard-1 image: linode/alpine3.12 location: us-east my-linode-profile-advanced: # an advanced configuration provider: my-linode-provider size: g6-standard-3 image: linode/alpine3.10 location: eu-west password: bogus123X assign_private_ip: true ssh_interface: private_ips ssh_pubkey: ssh-rsa AAAAB3NzaC1yc2EAAAADAQAB... swap_size: 512 my-linode-profile-v3: # a legacy configuration provider: my-linode-provider-v3 size: Nanode 1GB image: Alpine 3.12 location: Fremont, CA, USA Migrating to APIv4 ------------------ In order to target APIv4, ensure your provider configuration has ``api_version`` set to ``v4``. You will also need to generate a new token for your account. See https://www.linode.com/docs/platform/api/getting-started-with-the-linode-api/#create-an-api-token There are a few changes to note: - There has been a general move from label references to ID references. The profile configuration parameters ``location``, ``size``, and ``image`` have moved from being label based references to IDs. See the profile section for more information. In addition to these inputs being changed, ``avail_sizes``, ``avail_locations``, and ``avail_images`` now output options sorted by ID instead of label. - The ``disk_size`` profile configuration parameter has been deprecated and will not be taken into account when creating new VMs while targeting APIv4. :maintainer: Charles Kenney <ckenney@linode.com> :maintainer: Phillip Campbell <pcampbell@linode.com> :depends: requests � N)�Path)� ipaddress)�SaltCloudConfigError�SaltCloudException�SaltCloudNotFound�SaltCloudSystemExitTF���zBoot Failed (not in use))�code�descr���z Being Createdz Brand New� �Running� z Powered Off� zShutting Down (not in use)� zSaved to Disk (not in use))Z boot_failedZbeeing_created� brand_new�runningZpoweroff�shutdownZ save_to_disk�linodec C s t � du rdS t� du rdS tS )z# Check for Linode configs. F)�get_configured_provider�_get_dependencies�__virtualname__� r r �L/opt/saltstack/salt/lib/python3.10/site-packages/salt/cloud/clouds/linode.py� __virtual__� s r c C s" zt �� W S ty t Y S w �N)Z__active_provider_name__�value�AttributeErrorr r r r �_get_active_provider_name� s �r c C s t �tt� ptd�S )z/ Return the first configured instance. )�apikey�password)�configZis_provider_configured�__opts__r r r r r r r � s �r c C s dt i} t�t| �S )z* Warn if dependencies aren't met. �requests)� HAS_REQUESTSr! Zcheck_driver_dependenciesr )Zdepsr r r r � s r c C � t jdt� tddd�S )z3 Return the configured Linode API version. � api_versionF�v3�� search_global�default�r! �get_cloud_config_valuer r" r r r r �_get_api_version� � �r- c C s t � dkS )zE Return whether the configured Linode API version is ``v3``. r' )r- r r r r � _is_api_v3� s r/ c C s t � rt� S t� S r )r/ � LinodeAPIv3� LinodeAPIv4r r r r �_get_cloud_interface� s r2 c C s* t jdt� tdt jdt� tdd�d�} | S )z1 Returned the configured Linode API key. �api_keyFr �r) r( r+ )�valr r r � _get_api_key� s �� r6 c C r% )za Return the configured time to wait before retrying after a ratelimit has been enforced. �ratelimit_sleepFr r( r+ r r r r �_get_ratelimit_sleep� r. r8 c C r% )z_ Return the configured interval in milliseconds to poll the Linode API for changes at. � poll_intervalFi� r( r+ r r r r �_get_poll_interval� r. r: c C s" t jd| tt jd| tdd�dd�S )zo Return the password to use for a VM. vm\_ The configuration to obtain the password from. r �passwdFr4 �r* r) �r! r, r" ��vm_r r r � _get_password s ��r@ c C � t jd| tdd�S )z: Return the specified size of the data partition. � disk_sizeFr4 r= r> r r r �_get_root_disk_size � �rC c C rA )z: Return True if a private ip address is requested �assign_private_ipF�r* r= r> r r r �_get_private_ip! rD rG c C s t jd| tdg d�S )z; Return the configured file paths of the SSH keys. Z ssh_key_filesFr( r= r> r r r �_get_ssh_key_files* s �rH c C rA )zc Return the SSH pubkey. vm\_ The configuration to obtain the public key from. Z ssh_pubkeyFr4 r= r> r r r � _get_ssh_key3 s �rI c C rA )z{ Returns the amount of swap space to be used in MB. vm\_ The VM profile to obtain the swap size from. �swap� rF r= r> r r r �_get_swap_size? s rL c C st t � }t| �}|dur|�|� t| �}tdd� |�D ]}|�� s.|�� s.td�t |����|�|� � � qt |�S )zH Return all SSH keys from ``ssh_pubkey`` and ``ssh_key_files``. Nc S s t | ��� S r )r �resolve)�filer r r �<lambda>T � z _get_ssh_keys.<locals>.<lambda>zInvalid SSH key file: {}) �setrI �addrH �map�exists�is_filer �format�str� read_text�list)r? Zssh_keysZ raw_pub_keyZ key_filesrN r r r � _get_ssh_keysI s rZ c C s t jd| tddd�S )zj Return the ssh_interface type to connect to. Either 'public_ips' (default) or 'private_ips'. � ssh_interface� public_ipsFr< r= r> r r r �_get_ssh_interface\ s �r] c C s\ t | �} t| �}t�d�}|dk s|dkrd}n t�|| �s!d}nd}|du r,t�d� |S )z� Checks if the provided name fits Linode's labeling parameters. .. versionadded:: 2015.5.6 name The VM name to validate z&^[a-zA-Z0-9][A-Za-z0-9_-]*[a-zA-Z0-9]$r �0 FTz�A Linode label may only contain ASCII letters or numbers, dashes, and underscores, must begin and end with letters or numbers, and be at least three characters in length.)rW �len�re�compile�match�log�warning)�nameZ name_length�regex�retr r r �_validate_namef s �rh c C s t s t�d� da d S d S )Nz�Linode APIv3 has been deprecated and support will be removed in future releases. Please plan to upgrade to APIv4. For more information, see https://docs.saltproject.io/en/latest/topics/cloud/linode.html#migrating-to-apiv4.T)�HAS_WARNED_FOR_API_V3rc rd r r r r �_warn_for_api_v3� s ��rj c @ s< e Zd Zejdd� �Zejdd� �Zejdd� �Zejd.dd ��Zejd/d d ��Z ejd/d d ��Z ejdd� �Z ejdd� �Z ejd/dd��Z ejdd� �Zejdd� �Zejdd� �Zejdd� �Zejd d � �Zejd/d d ��Zejd d!� �Zejd"d#� �Zejd$d%� �Zejd&d'� �Zd/d(d)�Zd/d*d+�Zd,d-� ZdS )0� LinodeAPIc C � dS )zavail_images implementationNr ��selfr r r � avail_images� � zLinodeAPI.avail_imagesc C rl )z avail_locations implementationNr rm r r r �avail_locations� rp zLinodeAPI.avail_locationsc C rl )zavail_sizes implementationNr rm r r r � avail_sizes� rp zLinodeAPI.avail_sizesNc C rl )zboot implementationNr )rn re �kwargsr r r �boot� rp zLinodeAPI.bootc C rl )zclone implementationNr �rn rs r r r �clone� rp zLinodeAPI.clonec C rl )z create_config implementationNr ru r r r � create_config� rp zLinodeAPI.create_configc C rl )zcreate implementationNr )rn r? r r r �create� rp zLinodeAPI.createc C rl )zdestroy implementationNr �rn re r r r �destroy� rp zLinodeAPI.destroyc C rl )z get_config_id implementationNr ru r r r � get_config_id� rp zLinodeAPI.get_config_idc C rl )zlist_nodes implementationNr rm r r r � list_nodes� rp zLinodeAPI.list_nodesc C rl )z list_nodes_full implementationNr rm r r r �list_nodes_full� rp zLinodeAPI.list_nodes_fullc C rl )z list_nodes_min implementationNr rm r r r �list_nodes_min� rp zLinodeAPI.list_nodes_minc C rl )zreboot implementationNr ry r r r �reboot� rp zLinodeAPI.rebootc C rl )z show_instance implementationNr ry r r r � show_instance� rp zLinodeAPI.show_instancec C rl )zshow_pricing implementationNr ru r r r � show_pricing� rp zLinodeAPI.show_pricingc C rl )zstart implementationNr ry r r r �start� rp zLinodeAPI.startc C rl )zstop implementationNr ry r r r �stop� rp zLinodeAPI.stopc C rl )z"_get_linode_by_name implementationNr ry r r r �_get_linode_by_name� rp z LinodeAPI._get_linode_by_namec C rl )z _get_linode_by_id implementationNr �rn � linode_idr r r �_get_linode_by_id� rp zLinodeAPI._get_linode_by_idc C s t d��)zget_plan_id implementationz5The get_plan_id is not supported by this api_version.)r ru r r r � get_plan_id� s �zLinodeAPI.get_plan_idc C sD |� dd �}|� dd �}|d ur| �|�S |d ur | �|�S td��)Nre r� zBThe get_linode function requires either a 'name' or a 'linode_id'.)�getr� r� r )rn rs re r� r r r � get_linode� s �zLinodeAPI.get_linodec C s t d | �� td |�S )Nzcloud.list_nodes_selectzquery.selection)� __utils__r} r" )rn �callr r r �list_nodes_select� s �zLinodeAPI.list_nodes_select�NNr )�__name__� __module__� __qualname__�abc�abstractmethodro rq rr rt rv rw rx rz r{ r| r} r~ r r� r� r� r� r� r� r� r� r� r r r r rk � sT rk c @ s e Zd Zd@dd�Zdd� Zdd� Zd d � ZdAd d �ZdBd d�ZdBdd�Z dd� Z dd� Z dBdd�Z dd� Z dd� Zdd � Zd d � Zd d � ZdBd!d"�Zd#d$� Zd%d&� Zd'd(� Zd)d*� ZdCd,d-�Zd.d/� Zd0d1� Z dAd2d3�Z dDd6d7�ZdBd8d9�Z d:d;� Z dBd<d=�Z d>d?� Z dS )Er1 N�GETc C s� t � }t� }t� }|du ri }d�|�|d< d|d< d|d< d�||�}|d k} d} t�d ||� |dur;t�d |� d } z tj||||d�} t�d| j � t�d| j � | � � W n~ tj j y� } zp| j} | �| �}| j }|dkr�t�d|� t�|� W Y d} ~ q=|dur�d|v r�td�|d ���d|v r�|d }g }|d D ] }d|v r�|�d�|�d�|�d��� q�|�|�d�� q�td�d�|����td�| j���d} ~ ww | r�| �| �S | S ) z0 Make a call to the Linode API. Nz Bearer {}Z Authorization�application/jsonz Content-Typezsalt-cloud-linodez User-Agentzhttps://api.linode.com/{}{}�DELETEzLinode API request: %s %szLinode API request body: %sr T)�json�headersz#Linode API response status code: %dz Linode API response body: %si� z+received rate limit; retrying in %d seconds�errorz Linode API reported error: {}�errors�fieldzfield '{}': {}�reason� Linode API reported error(s): {}�, z Linode API error occurred: {})r- r6 r8 rV rc �debugZtracer# �request� status_code�textZraise_for_status� exceptions� HTTPError�response�_get_response_json�time�sleepr �appendr� �joinr� )rn �path�method�datar� r& r3 r7 �url�decode�resultZattempt�excZ err_responseZerr_datar� Z api_errorsr� r� r r r �_query� sv � � ��� ���* zLinodeAPIv4._queryc C �. | j dd�}i }|d D ]}|||d < q |S )Nz/images�r� r� �id�r� )rn r� rg �imager r r ro J � zLinodeAPIv4.avail_imagesc C r� )Nz/regionsr� r� r� r� )rn r� rg �regionr r r rq Q r� zLinodeAPIv4.avail_locationsc C r� )Nz /linode/typesr� r� r� r� )rn r� rg � instance_typer r r rr X r� zLinodeAPIv4.avail_sizesc C s� | j |�dd �|d�d�}|�dd �}|�dd�}|�dd �}|�dd �}|r5|d d kr5td �||���| jd �|�d d|id�}| �|d � dS )Nr� )r� re �rs � config_id� check_runningTr� �label�statusr z<Cannot boot Linode {0} ({1}). Linode {0} is already running.�/linode/instances/{}/boot�POST�r� r� )r� r� r rV r� �_wait_for_linode_status)rn re rs �instancer� r� r� r� r r r rt _ s( � �� zLinodeAPIv4.bootc C s� |� dd �}|� dd �}|� dd �}d|v rt�d� d|v r$t�d� |||fD ] }|d u r3td��q)| jd �|�d ||d �d �S ) Nr� �location�size� datacenter_idzwThe 'datacenter_id' argument has been deprecated and will be removed in future releases. Please use 'location' instead.�plan_idzmThe 'plan_id' argument has been deprecated and will be removed in future releases. Please use 'size' instead.zPThe clone function requires a 'linode_id', 'location',and 'size' to be provided.z/linode/instances/{}/cloner� )r� �typer� )r� rc rd r r� rV )rn rs r� r� r� �itemr r r rv x s, �����zLinodeAPIv4.clonec C s� |� dd �}|� dd �}|� dd �}|� dd �}|� dd �}|s&|s&td��||||g}|D ] }|d u r8td��q.dt|�i|d urHdt|�ind dt|�id �} | jd �|�d || d �d �S )Nre r� � root_disk_id� swap_disk_id� data_disk_idzBThe create_config function requires either a 'name' or 'linode_id'�_The create_config functions requires a 'name', 'linode_id', 'root_disk_id', and 'swap_disk_id'.Zdisk_id)ZsdaZsdbZsdc� /linode/instances/{}/configsr� )r� �devicesr� )r� r �intr� rV ) rn rs re r� r� r� r� �required_paramsr� r� r r r rw � s2 � �� ��zLinodeAPIv4.create_configc C s� |d }t |�s dS td ddd�|�td d|g d ��td td d � t�d |� d }t|�}t|�}|dk}t|�p>|}t |�}t |�} |� dd �} |� dd �} |� dd �} | r]dnd} | r�| j d| id�}t |d |d |d d��}|r�| jdddd|d d�d � n| jd d|| |� d d �|d||| | d � d �}|� dd �}| �d d!|d"� t�d#|� | r�| jd$|id� | �|d%� | �|�\}}i }||d< |d& |d< |d |d< |d' |d(< |d |d< |d) |d)< ||d*< ||d< |r�|d+ |d,< n|d+ |d,< td dd-d.�|�td d/|d, itd d0� td1 |t�}|�|� t�d2|� t�d3|t�|�� td dd4d5�|�td d6|g d ��td td d � |S )7Nre F�cloud.fire_event�event�starting create�salt/cloud/{}/creating�cloud.filter_event�creating�re �profile�providerZdriver�sock_dir� transport��argsr� r� �Creating Cloud VM %s� private_ips� clonefromr� r� Tr� r� r� r� )r� r� r� z/networking/ipsr� �ipv4)r� �publicr� r� �/linode/instancesr� ) r� r� r� Z private_ipZbootedZ root_passZauthorized_keysr� � swap_sizeZ linode_creater �finishedz linode '%s' has been createdr� r r� r� �stateZipv6r\ r �ssh_host�waiting for ssh� salt/cloud/{}/waiting_for_ssh� ip_address�r� r� r� �cloud.bootstrap�Created Cloud VM '%s'� '%s' VM creation details: %s�created instance�salt/cloud/{}/created�created)rh r� rV r" rc �inforZ r] rG r@ rL r� r� rv r� �_wait_for_eventr� rt r� �_get_ips�update�pprint�pformat)rn r? re r� Z pub_ssh_keysr[ Zuse_private_iprE r r� �clonefrom_namer� r� Z should_cloneZ clone_linoder� r\ r� r� rg r r r rx � s� �� �� �� �� � �� zLinodeAPIv4.createc C s� t d ddd�|�d|itd td d� t�d d �d u r+t d |t� �d �d t� | �|�}|�dd �}| jd�|�dd� d S )Nr� r� �destroyed instance�salt/cloud/{}/destroyedre r� r� r� �update_cachedirFT� cloud.delete_minion_cachedir�:r r� �/linode/instances/{}r� �r� )r� rV r" r� r �splitr� r� �rn re r� r� r r r rz 5 s � � zLinodeAPIv4.destroyc C sx |� dd �}|� dd �}|d u r|d u rtd��|d u r&| j|d�� dd �}| �d�|��}|� dg �}d|d d iS ) Nre r� �TThe get_config_id function requires either a 'name' or a 'linode_id' to be provided.r� r� r� r� r� r )r� r r� r� rV )rn rs re r� r� Zconfigsr r r r{ I s � zLinodeAPIv4.get_config_idc C sF | � d�}|�dg �}i }|D ]}|d }|d |d d�||< q|S )Nr� r� r� r� r� �r� r� )r� r� )rn r� � instancesrg r� re r r r r~ [ s zLinodeAPIv4.list_nodes_minc C � | j dd�S �NT)�full�� _list_linodesrm r r r r} f � zLinodeAPIv4.list_nodes_fullc C � | � � S r r rm r r r r| i � zLinodeAPIv4.list_nodesc C s6 | � |�}|�dd �}| jd�|�dd� | �|d�S )Nr� z/linode/instances/{}/rebootr� r r �r� r� r� rV r� r r r r r l s zLinodeAPIv4.rebootc C sL | � |�}|�dd �}| �|�\}}|d |d |d |d |d ||d�S )Nr� r� r� r� r� )r� r� re r� r� r\ r� )r� r� r� )rn re r� r� r\ r� r r r r� s s �zLinodeAPIv4.show_instancec C s� t d �|d i �}|std��|�dd�}|�d�}t|�dk s'|d d kr+td ��| �|d �}|�d i �}|d }|d }|d } |d } | d } |d ||| | | d�iS )N�profilesr� �$The requested profile was not found.r� �0:0r� r r r �0The requested profile does not belong to Linode.r� ZpriceZhourly� � Zmonthly� )�per_hour�per_day�per_week� per_month�per_year)r" r� r r r_ r �_get_linode_type) rn rs r� r� �compsr� Zpricingr r r r r r r r r� � s, ��zLinodeAPIv4.show_pricingc C �\ | � |�}|�dd �}|d dkrddddd�S | jd �|�d d � | �|d� dddd �S ) Nr� r� r Tr� r �Machine already running��success�actionr� �msgr� r� r �r! r� r" r r r r r r� � s � �zLinodeAPIv4.startc C r ) Nr� r� ZofflineTr� �Stopped�Machine already stoppedr z /linode/instances/{}/shutdownr� r r$ r r r r r r� � s � zLinodeAPIv4.stopc C � | � d�|��S )Nr �r� rV r� r r r r� � � z LinodeAPIv4._get_linode_by_idc C sB | � d�}|�dg �}|D ] }|d |kr| S q td�|���)Nr� r� r� �+The specified name, {}, could not be found.)r� r� r rV )rn re r� r r� r r r r� � s ��z LinodeAPIv4._get_linode_by_nameFc C s� | � d�}|�dg �}i }|D ]?}i }|d |d< |d |d< |d |d< |d |d< |d |d < | �|d �\}}||d < ||d < |rH||d < |||d < q|S )Nr� r� r� r� r� re r� r� r� r� r\ r� �extra)r� r� r� ) rn r r� r rg r� �noder\ r� r r r r � s" zLinodeAPIv4._list_linodesc C r' )Nz/linode/types/{}r( )rn Z linode_typer r r r � r) z LinodeAPIv4._get_linode_typec C sN | � |�}g }g }|�dg �D ]}t�|�jr |�|� q|�|� q||fS )Nr� )r� r� r r� Z is_privater� )rn r� r� r� Zprivate�addrr r r r� � s zLinodeAPIv4._get_ipsc C sz |du rt � }|du r d}|d | }d} |d7 }|� }||�r#dS ||kr5t�|d � t�d|� ntd�|���q) z< Return true in handler to signal complete. N�x i� r Tr zretrying: polling for %s...ztimed out: polling for {})r: r� r� rc r� r rV ) rn � description�getter� condition�timeoutr9 �times�currr� r r r �_poll� s$ ��zLinodeAPIv4._pollr� �somec s$ | j d�||� �|� fdd�|d�S )Nz {} (id={}) status to be '{}'c s | � d�� kS )Nr� )r� )r� �r� r r rO $ s z5LinodeAPIv4._wait_for_entity_status.<locals>.<lambda>�r2 )r5 rV )rn r0 r� � entity_name� identifierr2 r r7 r �_wait_for_entity_status s �z#LinodeAPIv4._wait_for_entity_statusc s �j � �fdd�|d� |d�S )Nc s �� � �S r )r� r �r� rn r r rO * s z5LinodeAPIv4._wait_for_linode_status.<locals>.<lambda>r )r9 r: r2 )r; )rn r� r� r2 r r< r r� ( s �z#LinodeAPIv4._wait_for_linode_statusc C sH |� d�}|� d�}|� d�}|dkr td�||d |d ���||kS )Nr� r" �entityZfailedz event {} for {} (id={}) failedr� r� )r� r rV )rn r� Zdesired_statusr� r" r= r r r �_check_event_status1 s ��z LinodeAPIv4._check_event_statusc s� ddd|||d�}d }��fdd�} |d ur||d< t j|d d �} �jd d | id �} | �dg �} t| �dkr: dS | D ]@} | �d�� | �dd �} � }| sNq<| d |kra| d |kra| �d�|ksbq<|| �ri dS �jd�� ��� �fdd�||d� S q)Nr� �descF)z +order_byz+order�seenr" z entity.idz entity.typec s � � | ��S r )r> )r� )rn r� r r rO G rP z-LinodeAPIv4._wait_for_event.<locals>.<lambda>Tz+gt)�,r� )� separatorsz/account/eventszX-Filter)r� r� r r� r= r� r" zevent {} to be '{}'c s �� d�� ��S )Nz/account/events/{}r( r )�event_idrn r r rO f s r8 )r� �dumpsr� r� r_ r5 rV )rn r" r= Z entity_idr� r2 Z event_filterZ last_eventr1 Z filter_jsonr� �eventsr� Z event_entityr )rC rn r� r r� = sJ � � ��zLinodeAPIv4._wait_for_eventc C s( d }z|� � }W |S ty Y |S w r )r� � ValueError)rn r� r� r r r r� m s ��z LinodeAPIv4._get_response_json)Nr� NNr� r �F)r� r6 N) r� r� r� r� ro rq rr rt rv rw rx rz r{ r~ r} r| r r� r� r� r� r� r� r r r� r5 r; r� r> r� r� r r r r r1 � sB P �" � 0r1 c @ sn e Zd Zdd� Z dUdd�Zdd � Zd d � Zd d � ZdVdd�ZdWdd�Z dd� Z dWdd�Z dd� Z dWdd�Z dXdd�Zd d � Zd d � Zd d!� ZdWd"d#�Zd$d%� Zd&d'� Zd(d)� ZdWd*d+�ZdWd,d-�ZdYd0d1�ZdZd2d3�Zd[d5d6�Zd7d8� Zd9d:� Z d;d<� Z d=d>� Z dWd?d@�Z dWdAdB�Z dCdD� Z!dEdF� Z"dGdH� Z#dIdJ� Z$dKdL� Z%dMdN� Z&dOdP� Z'dQdR� Z(dSdT� Z)dS )\r0 c C s t � d S r )rj rm r r r �__init__w s zLinodeAPIv3.__init__Nr� �https://api.linode.com/c C s^ t � }t� } t|t�s i }d|�� vr| |d< |r'd|�� vr'd�||�|d< |du r-i }|dkr5d|d< d} |d kr=d } tt�t j � � � � ��} t | krRt� |� td |||||| d dddd gtd� } d| d v r�| d d r�g } | d d D ]}|d }|dkr�td��| �|� qytd�d�| ����tt�t j � � � � ��a t�d| d � | d S )z4 Make a web call to the Linode API. r3 Z api_actionz{}.{}Nr� r� ZAcceptTr� Fz http.queryr� �rootPass) �paramsr� � header_dictr� Z decode_typer� r� Z hide_fields�opts� ERRORARRAY�dict� ERRORMESSAGEzAuthentication failedz$Linode API Key is expired or invalidr� r� z Linode Response Status Code: %sr� )r8 r6 � isinstancerO �keysrV r� r� �mktime�datetime�now� timetuple�LASTCALLr� r� r" r r� r r� rc r� )rn r" Zcommandr� r� rL r� r� r7 r r� rU r� Z error_listr� r# r r r r� z s^ � � �zLinodeAPIv3._queryc C �2 | � dd�}i }|d D ] }|d }|||< q |S )N�avail� distributions�DATA�LABELr� �rn r� rg r� re r r r ro � � zLinodeAPIv3.avail_imagesc C rX )NrY Z datacentersr[ ZLOCATIONr� r] r r r rq � r^ zLinodeAPIv3.avail_locationsc C rX )NrY Z LinodePlansr[ r\ r� r] r r r rr � r^ zLinodeAPIv3.avail_sizesc C s� |� dd �}|� dd �}|� dd�}|d u rtd��|d u r&| �|�}|}n|}|r@td|id�d }|dkr@td d �|� ��| jd d ||d �d�d }|d } | �|| �s_t�d|� dS dS )Nr� r� r� Tz)The boot function requires a 'config_id'.r� �STATUS�1zCannot boot Linode {0}. z Linode {} is already running.r rt )�LinodeID�ConfigID�r� r[ �JobIDzBoot failed for Linode %s.F) r� r �_get_linode_id_from_namer� rV r� � _wait_for_jobrc r� ) rn re rs r� r� r� Z linode_itemr� r� Z boot_job_idr r r rt � s6 �� �� zLinodeAPIv3.bootc C sp |� dd �}|� d|� d��}|� d|� d��}|||g}|D ] }|d u r)td��q |||d�}| jdd |d �S ) Nr� r� r� r� r� zYThe clone function requires a 'linode_id', 'datacenter_id', and 'plan_id' to be provided.)ra Z DatacenterID�PlanIDr rv rc )r� r r� )rn rs r� r� r� r� r� Z clone_argsr r r rv s ���zLinodeAPIv3.clonec C s� |d }t |�s dS td ddd�|�td d|g d ��td td d � t�d |� i }d|i}d }|�d�}|rF||d< | jd|id�}d }|�d�}|rbz| �|�}W n t ya d}Y nw |�d�} | rkdnd} | r�| � | �} t d| id�} | d�| �d�}|d u r�| d }||d< | d }|d u r�| d }z t | ||d�d�} W nN t y� } ztjd | |tjd � W Y d }~dS d }~ww |d |d < z | jd d ||d!�d"�} W n t y� } ztjd#||tjd � W Y d }~dS d }~ww d$| v �r | d$ D ] }t�d%||d& � dS td dd'd(�|�td d)|g d ��td td d � | �| �d* }||d+< | j|| �d,�d-��sFtjd.|tjd � | j|d/|id0� t�d1||� t|�}|�rb| �|� t|�}|d2k�rw|du �rw| �|� d}| �r�td|id�d3 }n"t�d4|� | �||�d5 }| � ||�d5 }t ||||d6�d�d7 }| j ||dd8�d� t d|id�}| � |�}t |d9 �}|d |d < ||d< ||d< | �!|�|d:< |d2 |d2< |d; |d;< |d2k�r�|d2 d< |d=< n|d; d< |d=< t"|�|d>< |d; |d;< |d2 |d2< td dd?d@�|�td dA|d= itd dB� tdC |t�}|�#|� t�dD|� t�dE|t$�%|�� td ddFdG�|�td dH|g d ��td td d � |S )INre Fr� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� Tr� z Clone of {})r� r� �TOTALRAM�PLANID� DATACENTERID)r� r� r� zzError cloning '%s' on Linode. The following exception was thrown by Linode when trying to clone the specified machine: %s)Zexc_info_on_loglevelr� r rx )ri rj rc zwError creating %s on Linode The following exception was thrown by Linode when trying to run the initial deployment: %srN zGError creating %s on Linode The Linode API returned the following: %s rP zrequesting instancezsalt/cloud/{}/requestingZ requestingra r� r r7 zCError creating %s on LINODE while waiting for initial ready status�Label)� update_argsz Set name for %s - was linode%s.r� r� zCreating disks for %sZDiskID)re r� r� r� rb )r� r� r� r_ r� r\ r r� r r� r� r� r� r� r� r� r� r� r� )&rh r� rV r" rc r� r� r� �_get_datacenter_id�KeyErrorre r� rv � Exceptionr� �logging�DEBUGr� � _clean_data�_wait_for_status�_get_status_id_by_name�_update_linoder� rG �_create_private_ipr] r{ �_create_disk_from_distro�_create_swap_diskrw rt r� r� �_get_status_descr_by_idr@ r� r� r� )rn r? re r� rs r� r� r� r� r� Zcloningr� Z clone_sourcer� �errZ error_data�node_idZprivate_ip_assignmentr[ r� r� r� � node_data�ipsr� rg r r r rx sX �� � �� ���� ���� � �� �� ��� �� � �� zLinodeAPIv3.createc C s� |� dd �}|� dd �}|� dd �}|� dd �}|� dd �}|� dd �}|d u r*d}||||g}|D ] } | d u r<td��q2|d u rCd}|sP| �|�} | � d d �}d �||�} |d urad �|||�} t|�t|�|| d �} | jd d| d�} | � dd �S )Nre r� r� r� r� � kernel_id� r� r� z{},{}z{},{},{})ra ZKernelIDrk ZDiskListr z config.createrc r[ )r� r r� rV r� r� )rn rs re r� r� r� r� r~ r� r� r� ZdisklistZ config_argsr� r r r rw � s< �� � zLinodeAPIv3.create_configc C s� i }t |�}t|�}t|�}|r|�d|i� |r!|�d|i� ntd��|�|| �|�|d | �|||�d�� | jdd|d�}| �|�S ) NZ rootSSHKeyrJ z&The Linode driver requires a password.re )ra ZDistributionIDrk �Sizer zdisk.createfromdistributionrc ) rL rI r@ r� r �_get_distribution_id�_get_disk_sizer� rr )rn r? r� rs r� Zpub_keyZ root_passwordr� r r r rw & s$ �� z$LinodeAPIv3._create_disk_from_distroc C sB i }|st |�}|�||d d|d�� | jdd|d�}| �|�S )a Creates the disk for the specified Linode. vm\_ The VM profile to create the swap disk for. linode_id The ID of the Linode to create the swap disk for. swap_size The size of the disk, in MB. re rJ �ra rk ZTyper� r � disk.createrc )rL r� r� rr )rn r? r� r� rs r� r r r rx @ s �� z LinodeAPIv3._create_swap_diskc C s: i }|� ||d d d|d�� | jdd|d�}| �|�S )Nre �_dataZext4r� r r� rc �r� r� rr )rn r? r� � data_sizers r� r r r �_create_data_disk_ s �� z LinodeAPIv3._create_data_diskc C s" d|i}| j dd|d�}| �|�S )z� Creates a private IP for the specified Linode. linode_id The ID of the Linode to create the IP address for. ra r z ip.addprivaterc )r� rr )rn r� rs r� r r r rv n s z LinodeAPIv3._create_private_ipc C s� t d ddd�|�d|itd td d� | �|�}| jd d |d d �d �}t d ddd�|�d|itd td d� t�dd�d u rPt d |t� �d�d t� |S )Nr� r� zdestroying instancezsalt/cloud/{}/destroyingre r� r� r� r �deleteT)ra Z skipChecksrc r� r� r� Fr� r� r )r� rV r" re r� r� r r )rn re r� r� r r r rz z s2 � �� �zLinodeAPIv3.destroyc C s� | � � }||vrjd|v rtd�|���|�� }t|�dkr$td�|���|d }zt|d �}W n tyA d}t�d|� Y nw |dkrL|dkrLd }|d }d �||�}||vratd�|���t� d ||� |}|| d S ) a Attempts to decode a user-supplied Linode plan label into the format in Linode API output label The label, or name, of the plan to decode. Example: `Linode 2048` will decode to `Linode 2GB` ZGBzQInvalid Linode plan ({}) specified - call avail_sizes() for all available optionsr r r z7Failed to decode Linode plan label in Cloud Profile: %sZLinodei ZNanodez{} {}GBz�An outdated Linode plan label was detected in your Cloud Profile (%s). Please update the profile to use the new label format (%s) for the requested Linode plan size.ri ) rr r rV r r_ r� � TypeErrorrc r� rd )rn r� ZsizesZplanZ plan_typeZ plan_sizeZ new_labelr r r �_decode_linode_plan_label� sL � � �� �� z%LinodeAPIv3._decode_linode_plan_labelc C sn |� dd �}|� dd �}|d u r|d u rtd��|d u r!| �|�}| jddd|id�d }d |d d i}|S ) Nre r� r r z config.listra rc r[ r� r rb )r� r re r� )rn rs re r� r� r� r r r r{ � s � �zLinodeAPIv3.get_config_idc C s t � | d S )z� Returns the Linode Datacenter ID. location The location, or name, of the datacenter to get the ID from. rj )rq )rn r� r r r rm � s z LinodeAPIv3._get_datacenter_idc C s( t d|id�d }tjd|t|| d�S )zx Returns the size of of the root disk in MB. vm\_ The VM to get the disk size for. r� r� ZTOTALHDrB rF )r� r! r, r" )rn r? rJ r� rB r r r r� � s �zLinodeAPIv3._get_disk_sizec C sz | � dd�d }t�d|t�}d}|D ]}||d kr#|d }| S q|s;td�||d t�td d � |D ������d S ) zv Returns the distribution ID for a VM vm\_ The VM to get the distribution ID for rY rZ r[ r� � r\ ZDISTRIBUTIONIDz�The DistributionID for the '{}' profile could not be found. The '{}' instance could not be provisioned. The following distributions are available: {}re c s s � | ] }|d � t�V qdS )r\ N)�encodeZ__salt_system_encoding__)�.0�distror r r � <genexpr> s � � �z3LinodeAPIv3._get_distribution_id.<locals>.<genexpr>N)r� r! r, r" r rV r� �sorted)rn r? rZ Z vm_image_nameZ distro_idr� r r r r� � s, ������z LinodeAPIv3._get_distribution_idc C s& |� dd �}|d u rtd��| �|�S )Nr� z,The get_plan_id function requires a 'label'.)r� r r� )rn rs r� r r r r� s zLinodeAPIv3.get_plan_idc C s� |r | j ddd|id�}n| � dd�}|d }i }|D ]/}t|d �}|d dkr,d }nd }|�|�d u r?|�|g g d �i� || | �|d � q|rig g d �}|�t|��}|rg|d |d < |d |d < |}|S )z� Returns public and private IP addresses. linode_id Limits the IP addresses returned to the specified Linode ID. r zip.listra rc r[ �LINODEIDZISPUBLICr r\ r� N)r\ r� Z IPADDRESS)r� rW r� r� r� ) rn r� r} rg r� r{ �keyZ_all_ipsZ matching_idr r r r� % s* zLinodeAPIv3._get_ips�, Tc C s� d}t || �}td|�D ]4}| jddd|id�d }|d d |kr.|d d d kr. d S t�|� t�|s:tjntjd ||� q d S )a` Wait for a Job to return. linode_id The ID of the Linode to wait on. Required. job_id The ID of the job to wait for. timeout The amount of time to wait for a status to update. quiet Log status updates to debug logs when True. Otherwise, logs to info. � r r zjob.listra rc r[ ZJOBIDZ HOST_SUCCESSr Tz&Still waiting on Job %s for Linode %s.F) r� �ranger� r� r� rc rp �INFOrq ) rn r� Zjob_idr2 �quiet�interval� iterations�iZ jobs_resultr r r rf L s& �� �zLinodeAPIv3._wait_for_jobc C s� |du r | � d�}| �|�}d}t|| �}td|�D ]-}td|id�} | d |kr- dS | �| d �} t�|� t�|s@tj ntj d || |� qd S ) aq Wait for a certain status from Linode. linode_id The ID of the Linode to wait on. Required. status The status to look for to update. timeout The amount of time to wait for a status to update. quiet Log status updates to debug logs when False. Otherwise, logs to info. Nr r� r r� r� r_ Tz/Status for Linode %s is '%s', waiting for '%s'.F) rt ry r� r� r� r� r� rc rp r� rq ) rn r� r� r2 r� Zstatus_desc_waitingr� r� r� r� Zstatus_desc_resultr r r rs r s& �z LinodeAPIv3._wait_for_statusFc C s� | � dd�d }| �� }i }|D ]R}i }t|d �}||d< |d |d< |d |d < |d |d < t|d �}| �|�|d < |�� D ]\} } | |krU| d |d< | d |d< qA|r\||d< |||d < q|S )Nr rY r[ r� r� �DISTRIBUTIONVENDORr� r\ re rh r� r_ r� r� r\ r+ )r� r� rW r� ry �items) rn r �nodesr} rg r, Z this_noder� r� r� r5 r r r r � s* �zLinodeAPIv3._list_linodesc C r r r rm r r r r| � r zLinodeAPIv3.list_nodesc C r r r rm r r r r} � r zLinodeAPIv3.list_nodes_fullc C sN i }| � dd�d }|D ]}|d }t|d �| �t|d ��d�||< q |S )Nr rY r[ r\ r� r_ r )r� rW ry r� )rn rg r� r, re r r r r~ � s �zLinodeAPIv3.list_nodes_minc C s` | � |�}td|id�}| �|�}t|d �}|d |d |d |d | �|�|d |d d �S ) Nr� r� r_ r� r� r\ rh r� r\ )r� r� re r� r� r� r\ )re r� r� r� ry )rn re r{ r| r} r� r r r r� � s �zLinodeAPIv3.show_instancec C s� t d �|d i �}|std��|�dd�}|�d�}t|�dk s'|d d kr+td ��| jd |d id �}| jddd|id�d d }i }|d |d< |d d |d< |d d |d< |d |d< |d d |d < |d |iS ) Nr r� r r� r r� r r r r r� r� r� rY Z linodeplansrg rc r[ r ZHOURLYr r r r r ZPRICEr r r )r" r� r r r_ r r� r� )rn rs r� r� r r� r� rg r r r r� � s( �� zLinodeAPIv3.show_pricingc C s( |� d|i� | jdd|d�}| �|�S )Nra r r� rc r� )rn r� rl r� r r r ru � s zLinodeAPIv3._update_linodec C s | � |�}|�dd �S )Nr� )r� r� )rn re r, r r r re � s z$LinodeAPIv3._get_linode_id_from_namec C s< | � dd�d }|D ] }||d kr| S q td�|���)Nr rY r[ r\ r* )r� r rV )rn re r� r, r r r r� � s ��z LinodeAPIv3._get_linode_by_namec C s | j ddd|id�}|d d S )Nr rY ra rc r[ r r� )rn r� r� r r r r� s z LinodeAPIv3._get_linode_by_idc C sp | � |�}td|id�}|d dkrddddd �S | jd d d |id �d }| �||d �r3dddd�S ddd�S )Nr� r� r_ r Tr� r r r r rt ra rc r[ rd �r� r" r! F�r" r! �re r� r� rf �rn re r{ r, r� r r r r� s � zLinodeAPIv3.startc C sn | � |�}td|id�}|d dkrdddd�S | jd d d |id �d }| �||d �r2dddd�S ddd�S )Nr� r� r_ r Tr% r& )r! r� r# r r ra rc r[ rd r� r� Fr� r� r� r r r r� s � zLinodeAPIv3.stopc C sP | � |�}| jddd|id�}| �|�}|d }| �||�s&t�d|� dS |S )Nr r ra rc rd zReboot failed for %s.F)re r� rr rf rc r� )rn re r{ r� r� Z reboot_jidr r r r . s zLinodeAPIv3.rebootc C s, i }|� |d � |s|d }|� |� |S )z� Returns the DATA response from a Linode API query as a single pre-formatted dictionary api_response The query to be cleaned. r[ )r� )rn Z api_responser� Z response_datar r r rr : s zLinodeAPIv3._clean_datac C s: t �� D ]\}}|d t|�kr|d S qt �|d�S )z_ Return linode status by ID status_id linode VM status ID r r N)� LINODE_STATUSr� r� r� )rn Z status_id� status_nameZ status_datar r r ry J s � z#LinodeAPIv3._get_status_descr_by_idc C s t �|i ��dd�S )z� Return linode status description by internalstatus name status_name internal linode VM status name r N)r� r� )rn r� r r r rt V s z"LinodeAPIv3._get_status_id_by_name)NNNr� NNrI r� r �NNN)r� T)Nr� TrG )*r� r� r� rH r� ro rq rr rt rv rx rw rw rx r� rv rz r� r{ rm r� r� r� r� rf rs r r| r} r~ r� r� ru re r� r� r� r� r rr ry rt r r r r r0 v s` �H # g+ = ! ' & + r0 c C � | dkrt d��t� �� S )z� Return available Linode images. CLI Example: .. code-block:: bash salt-cloud --list-images my-linode-config salt-cloud -f avail_images my-linode-config r" z?The avail_images function must be called with -f or --function.)r r2 ro �r� r r r ro ` � � ro c C r� )z� Return available Linode datacenter locations. CLI Example: .. code-block:: bash salt-cloud --list-locations my-linode-config salt-cloud -f avail_locations my-linode-config r" �BThe avail_locations function must be called with -f or --function.)r r2 rq r� r r r rq r r� rq c C r� )z� Return available Linode sizes. CLI Example: .. code-block:: bash salt-cloud --list-sizes my-linode-config salt-cloud -f avail_sizes my-linode-config r" r� )r r2 rr r� r r r rr � r� rr c C sl | du r |dkr t d��|�dd�}|�dd�}|dkr"|�dd�} | du r.|du r.t d��t� j| |d �S ) a3 Boot a Linode. name The name of the Linode to boot. Can be used instead of ``linode_id``. linode_id The ID of the Linode to boot. If provided, will be used as an alternative to ``name`` and reduces the number of API calls to Linode by one. Will be preferred over ``name``. config_id The ID of the Config to boot. Required. check_running Defaults to True. If set to False, overrides the call to check if the VM is running before calling the linode.boot API call. Change ``check_running`` to True is useful during the boot call in the create function, since the new VM will not be running yet. Can be called as an action (which requires a name): .. code-block:: bash salt-cloud -a boot my-instance config_id=10 ...or as a function (which requires either a name or linode_id): .. code-block:: bash salt-cloud -f boot my-linode-config name=my-instance config_id=10 salt-cloud -f boot my-linode-config linode_id=1225876 config_id=10 Nr" z"The boot action requires a 'name'.r� r� �functionre z<The boot function requires either a 'name' or a 'linode_id'.)re rs )r r� r2 rt )re rs r� r� r� r r r rt � s " �rt c C � |dkrt d��t� j| d�S )a� Clone a Linode. linode_id The ID of the Linode to clone. Required. location The location of the new Linode. Required. size The size of the new Linode (must be greater than or equal to the clone source). Required. datacenter_id The ID of the Datacenter where the Linode will be placed. Required for APIv3 usage. Deprecated. Use ``location`` instead. plan_id The ID of the plan (size) of the Linode. Required. Required for APIv3 usage. Deprecated. Use ``size`` instead. CLI Example: .. code-block:: bash salt-cloud -f clone my-linode-config linode_id=1234567 datacenter_id=2 plan_id=5 r" z8The clone function must be called with -f or --function.r� )r r2 rv �rs r� r r r rv � s �rv c C sR z| d rt jtt� p d| d | d�du rW dS W n ty" Y nw t� �| �S )z$ Create a single Linode VM. r� r r> F)r! Zis_profile_configuredr" r r r2 rx r> r r r rx � s" ���� � rx c C r� )a Creates a Linode Configuration Profile. name The name of the VM to create the config for. linode_id The ID of the Linode to create the configuration for. root_disk_id The Root Disk ID to be used for this config. swap_disk_id The Swap Disk ID to be used for this config. data_disk_id The Data Disk ID to be used for this config. .. versionadded:: 2016.3.0 kernel_id The ID of the kernel to use for this configuration profile. r" z@The create_config function must be called with -f or --function.r� )r r2 rw r� r r r rw s �rw c C s |dkrt d��t� �| �S )z� Destroys a Linode by name. name The name of VM to be be destroyed. CLI Example: .. code-block:: bash salt-cloud -d vm_name r� zEThe destroy action must be called with -d, --destroy, -a or --action.)r r2 rz �re r� r r r rz " s � rz c C r� )a� Returns a config_id for a given linode. .. versionadded:: 2015.8.0 name The name of the Linode for which to get the config_id. Can be used instead of ``linode_id``. linode_id The ID of the Linode for which to get the config_id. Can be used instead of ``name``. CLI Example: .. code-block:: bash salt-cloud -f get_config_id my-linode-config name=my-linode salt-cloud -f get_config_id my-linode-config linode_id=1234567 r" z@The get_config_id function must be called with -f or --function.r� )r r2 r{ r� r r r r{ 6 s �r{ c C r� )a Returns data for a single named Linode. name The name of the Linode for which to get data. Can be used instead ``linode_id``. Note this will induce an additional API call compared to using ``linode_id``. linode_id The ID of the Linode for which to get data. Can be used instead of ``name``. CLI Example: .. code-block:: bash salt-cloud -f get_linode my-linode-config name=my-instance salt-cloud -f get_linode my-linode-config linode_id=1234567 r" z=The get_linode function must be called with -f or --function.r� )r r2 r� r� r r r r� R s �r� c C r� )a Returns the Linode Plan ID. label The label, or name, of the plan to get the ID from. CLI Example: .. code-block:: bash salt-cloud -f get_plan_id linode label="Nanode 1GB" salt-cloud -f get_plan_id linode label="Linode 2GB" r" �>The show_instance action must be called with -f or --function.r� )r r2 r� r� r r r r� m s �r� c C r� )a� Returns a list of linodes, keeping only a brief listing. CLI Example: .. code-block:: bash salt-cloud -Q salt-cloud --query salt-cloud -f list_nodes my-linode-config .. note:: The ``image`` label only displays information about the VM's distribution vendor, such as "Debian" or "RHEL" and does not display the actual image name. This is due to a limitation of the Linode API. r" z=The list_nodes function must be called with -f or --function.)r r2 r| r� r r r r| � � � r| c C r� )a� List linodes, with all available information. CLI Example: .. code-block:: bash salt-cloud -F salt-cloud --full-query salt-cloud -f list_nodes_full my-linode-config .. note:: The ``image`` label only displays information about the VM's distribution vendor, such as "Debian" or "RHEL" and does not display the actual image name. This is due to a limitation of the Linode API. r" zBThe list_nodes_full function must be called with -f or --function.)r r2 r} r� r r r r} � r� r} c C r� )a� Return a list of the VMs that are on the provider. Only a list of VM names and their state is returned. This is the minimum amount of information needed to check for existing VMs. .. versionadded:: 2015.8.0 CLI Example: .. code-block:: bash salt-cloud -f list_nodes_min my-linode-config salt-cloud --function list_nodes_min my-linode-config r" zAThe list_nodes_min function must be called with -f or --function.)r r2 r~ r� r r r r~ � s � r~ c C s t � �| �S )zP Return a list of the VMs that are on the provider, with select fields. )r2 r� r� r r r r� � s r� c C � |dkrt d��t� �| �S )z� Reboot a linode. .. versionadded:: 2015.8.0 name The name of the VM to reboot. CLI Example: .. code-block:: bash salt-cloud -a reboot vm_name r" �<The show_instance action must be called with -a or --action.)r r2 r r� r r r r � s � r c C r� )a Displays details about a particular Linode VM. Either a name or a linode_id must be provided. .. versionadded:: 2015.8.0 name The name of the VM for which to display details. CLI Example: .. code-block:: bash salt-cloud -a show_instance vm_name .. note:: The ``image`` label only displays information about the VM's distribution vendor, such as "Debian" or "RHEL" and does not display the actual image name. This is due to a limitation of the Linode API. r" r� )r r2 r� r� r r r r� � s � r� c C s |dkrt d��t� j| d�S )a Show pricing for a particular profile. This is only an estimate, based on unofficial pricing sources. .. versionadded:: 2015.8.0 CLI Example: .. code-block:: bash salt-cloud -f show_pricing my-linode-config profile=my-linode-profile r� r� r� )r r2 r� r� r r r r� s �r� c C r� )z� Start a VM in Linode. name The name of the VM to start. CLI Example: .. code-block:: bash salt-cloud -a stop vm_name r" z4The start action must be called with -a or --action.)r r2 r� r� r r r r� � r� c C r� )z� Stop a VM in Linode. name The name of the VM to stop. CLI Example: .. code-block:: bash salt-cloud -a stop vm_name r" z3The stop action must be called with -a or --action.)r r2 r� r� r r r r� * r� r� r r� r� )L�__doc__r� rT r� rp r� r` r� �pathlibr Z salt.configr! Z salt._compatr Zsalt.exceptionsr r r r r# r$ � ImportErrorZ getLoggerr� rc ri r� rS rU rV rW r� r r r r r r- r/ r2 r6 r8 r: r@ rC rG rH rI rL rZ r] rh rj rk r1 r0 ro rq rr rt rv rx rw rz r{ r� r� r| r} r~ r� r r� r� r� r� r r r r �<module> s� j � � h q 3#
Save