B `G~@sZddlZddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZmZmZdd lmZdd lmZdd lmZmZdd lmZejejejZGd ddeZ GdddeZ!GdddeZ"GdddeZ#GdddZ$GdddeZ%GdddeZ&GdddeZ'GdddZ(Gdd d eZ)dS)!N)datetime)Enum)urandom)randint)load_and_validate_keys)UnexpectedResponseError)Base DerivedBaseImagePropertyRegion) MappedObject)FilterableAttribute) IPAddressIPv6Pool) PaginatedListc@sveZdZdZdZdZeddeddeeddeddeeddeeddeeeeedd Zd d Z d S) Backupz*/linode/instances/{linode_id}/backups/{id}backups linode_idT) identifier) is_datetime)volatile)slug_relationship) idcreateddurationupdatedfinishedmessagestatustyperlabelconfigsdisksregioncKsDdtt|tr|jn|i}|||jjdtj ||ddS)Nrz {}/restore)modeldataT) issubclassr rrupdate_clientpostformatr api_endpoint)selfZlinodekwargsdr0I/home/dcms/DCMS/lib/python3.7/site-packages/linode_api4/objects/linode.py restore_to(s  zBackup.restore_toN) __name__ __module__ __qualname__r,derived_url_pathparent_id_namer r propertiesr2r0r0r0r1rs"rc @sxeZdZdZdZdZeddeddedddeddeddd eeddeddd Zd d ZdddZ ddZ d S)Diskz(/linode/instances/{linode_id}/disks/{id}r#rT)r)r)mutable filterable)r;)r;r)rrr!sizer filesystemrrcCsB|jjtj|id}d|kr(td|dt|j|d|j|}|S)N)r%r&rz%Unexpected response duplicating disk!)json)r)r*r9r,rr)r-resultr/r0r0r1 duplicateDs  zDisk.duplicateNcCsZ|}|st}d|i}|jjtj||d}d|kr@td|d|||sVd|fSdS)Npassword)r%r&rz%Unexpected response duplicating disk!)r>T)Instancegenerate_root_passwordr)r*r9r,r _populate)r-Z root_passwordZrpassparamsr?r0r0r1reset_root_passwordNs  zDisk.reset_root_passwordcCs"|jjdtj|d|iddS)a> Resizes this disk. The Linode Instance this disk belongs to must have sufficient space available to accommodate the new size, and must be offline. **NOTE** If resizing a disk down, the filesystem on the disk must still fit on the new disk size. You may need to resize the filesystem on the disk first before performing this action. :param new_size: The intended new size of the disk, in MB :type new_size: int :returns: True if the resize was initiated successfully. :rtype: bool z {}/resizer<)r%r&T)r)r*r+r9r,)r-Znew_sizer0r0r1resizeasz Disk.resize)N) r3r4r5r,r6r7r r8r@rFrGr0r0r0r1r93s   r9c @s^eZdZdZeddeddeeddeddeddeeddeddeddd ZdS)Kernelz/linode/kernels/{id}T)r)r;)r) r deprecated descriptionrkvmr!Zupdatesversion architectureZxenN)r3r4r5r,r r8r0r0r0r1rHvsrHc sveZdZdZeddeddeddeddeeeddeddeddeddd ZfddZedZZ S) Typez/linode/types/{id}T)r;)r) Zdiskrr!Z network_outZpriceZaddonsZmemorytransferZvcpusZgpuscs6t|d|kr&t|d|dn t|dddS)zT Allows changing the name "class" in JSON to "type_class" in python class type_classN)superrDsetattr)r-r>) __class__r0r1rDs zType._populaterP) r3r4r5r,r r8rDrrQ __classcell__r0r0)rTr1rNs rNc@s*eZdZdZd ddZddZddZd S) ConfigInterfacez] This is a helper class used to populate 'interfaces' in the Config calss below. cCs||_||_||_dS)z/ Creates a new ConfigInterface N)r! ipam_addresspurpose)r-rYr!rXr0r0r1__init__szConfigInterface.__init__cCs"|jdkrdSd|j|j|jS)NpubliczPublic Interfacez+Interface {}; purpose: {}; ipam_address: {})rYr+r!rX)r-r0r0r1__repr__s zConfigInterface.__repr__cCs|j|j|jdS)z/ Returns this object as a dict )r!rXrY)r!rXrY)r-r0r0r1 _serializeszConfigInterface._serializeN)rWrW)r3r4r5__doc__rZr\r]r0r0r0r1rVs rVc@seZdZdZdZdZeddeddeeddeddeedddedd eed eeddd eddd eddd eddd eddd eddd Z d dZ ddZ dS)Configz*/linode/instances/{linode_id}/configs/{id}r"rT)r)r)r:) relationshipr:r;)r;)r`)r:r;)rrZhelpersrZ root_devicekerneldevicesZinitrdrcommentsr!Z run_levelZ virt_modeZ memory_limit interfacescCsddlm}t||i}xt|dD]d\}}|s@d||<q*d}d|krn|drntj|d|j|jd}n|j|d|j|jd}|||<q*W| dt f|g}d|krd d |dD}| d|dS) z; Map devices more nicely while populating. )VolumerbNdisk_id)Z parent_id volume_idrdcSs&g|]}t|d|d|ddqS)rYr!rX)r!rX)rV).0cr0r0r1 sz$Config._populate..) volumerfr rDitemsr9Z make_instancer)r_setr )r-r>rfrbZ device_indexZdevicedevrdr0r0r1rDs(      zConfig._populatecCsNt|}g}x2|jD](}t|tr4||q||qW||d<|S)zH Overrides _serialize to transform interfaces into json rd)r r]rd isinstancerVappend)r-partialrdrjr0r0r1r]s   zConfig._serializeN) r3r4r5r,r6r7r rHr9r8rDr]r0r0r0r1r_s(      #r_c@seZdZdZedddedddedddeddeddedddeeddedd eeddeed eed ee d eeeeeedd d Z e d dZ e ddZ e ddZddZddZd?ddZddZddZddZed d!Zddgggfd"d#Zd@d%d&Zd'd(Zd)d*ZdAd+d,ZdBd-d.ZdCd/d0Zd1d2Zd3d4Zd5d6Z d7d8Z!dddggdddfd9d:Z"e d;d<Z#d=d>Z$dS)DrBz/linode/instances/{id}T)rr;)r:r;)r)r)rr)rr;)r:)Z derived_class)r)rr!grouprrrr$Zalertsimager#r"r ripv4ipv6 hypervisorspecstagsc Cst|ds||jjdtj|d}d|kr8td|dg}x0|ddD] }t|j|d|}||qJWg}x0|dd D] }t|j|d|}||qWg}x0|dd D] }t|j|d|}||qWt|j|d d d|d d }t|j|d d d|d d }g} x,|d dD]} | t |j| dq0Wt f|||d||| dd} | d| |j S)z The ips related collection is not normalized like the others, so we have to make an ad-hoc object to return for its response _ipsz{}/ips)r%ruzUnexpected response loading IPs)r>r[addressprivatesharedrvslaac link_localglobalrange)r[r|r})r~rpools)rurv) hasattrr)getr+rBr,rrrqrr rnrz) r-r?Zv4pubrjiZv4priZ shared_ipsr~rrpipsr0r0r1r.s@   z Instance.ipsc Cst|ds|jjdtj|d}d|kr6td|dg}x0|dD]$}t|j|d|j|}| |qDWd}|d d rt|j|d d d|j|d d }d}|d d rt|j|d d d|j|d d }| dt f|||d d |j S)zZ The backups response contains what backups are available to be restored. _avail_backupsz {}/backups)r% automaticz.Unexpected response loading available backups!)r>rNsnapshotcurrent in_progress)rr)rr) rr)rr+rBr,rrrrqrnr r)r-r?racurZsnapZpsnapr0r0r1available_backupscs*     zInstance.available_backupscCsNt|dsH|jjdtj|d}d|kr2tdtf|}t|d||j S)z) Get per-linode transfer _transferz {}/transfer)r%usedz/Unexpected response when getting Transfer Pool!) rr)rr+rBr,rr rSr)r-r?Zmappedr0r0r1rOs   zInstance.transfercCst|dk rdd|kr0d|dkr0|dd|dd<d|krdt|dtrdx|dD]}|d|d<qPWt||dS)Nrur{rrvr)rplistrrD)r-r>jr0r0r1rDszInstance._populatecCs8t|dr|`t|dr|`t|dr*|`t|dS)z Clear out cached properties rrzrN)rrrzrr invalidate)r-r0r0r1rs   zInstance.invalidateNcCs8|jjdtj||r d|jindd}d|kr4dSdS)Nz{}/bootZ config_id)r%r&errorFT)r)r*r+rBr,r)r-configrespr0r0r1boots(z Instance.bootcCs(|jjdtj|d}d|kr$dSdS)Nz {}/shutdown)r%rFT)r)r*r+rBr,)r-rr0r0r1shutdownszInstance.shutdowncCs(|jjdtj|d}d|kr$dSdS)Nz {}/reboot)r%rFT)r)r*r+rBr,)r-rr0r0r1rebootszInstance.rebootcKsTtt|tr|jn|}d|i}|||jjdtj ||d}d|krPdSdS)Nr z {}/resize)r%r&rFT) r'r rrr(r)r*r+rBr,)r-new_typer.rErr0r0r1rGs zInstance.resizecsFdddfddttddD}t|dkrB|dd}|S)NcSs"tjddkrt|dd}|S)Nrhex)sys version_infointencode)valuer0r0r1_funcsz.Instance.generate_root_password.._funcrWcs g|]}t|ttqSr0)PASSWORD_CHARSlen)rirj)rr0r1rksz3Instance.generate_root_password..2n)joinrrr)rAr0)rr1rCs   zInstance.generate_root_passwordc sFddlm}|jdkrdndfddtdd Dfd d tdtD}|rf|s^|rftd |s4t|ts||g}t|ts|g}g}xP|D]H} | d kr|d qt| t r|| q|t |j t | |j qWxP|D]H} | d kr|d qt| |r|| q|||j t | qW|sBtdxjt |D]^\} } | d kr`nHt| t rd| j i|| <n(t| |rd| j i|| <ntdqLWtt|tr|j n||r|nd|jt|j|d} | ||j jdtj|| d} |d| kr,td| dt|j | d|j | }|S)a Creates a Linode Config with the given attributes. :param kernel: The kernel to boot with. :param label: The config label :param disks: The list of disks, starting at sda, to map to this config. :param volumes: The volumes, starting after the last disk, to map to this config :param devices: A list of devices to assign to this config, in device index order. Values must be of type Disk or Volume. If this is given, you may not include disks or volumes. :param **kwargs: Any other arguments accepted by the api. :returns: A new Linode Config re)rfrKsdZxvdcsg|]}tj|qSr0)stringascii_lowercase)rir)hypervisor_prefixr0r1rksz*Instance.config_create..rcsi|]}d|qS)Nr0)rir) device_namesr0r1 sz*Instance.config_create..z[You may not call config_create with "devices" and either of "disks" or "volumes" specified!Nz)Must include at least one disk or volume!rgrhzDisk or Volume expected!z {}_config_{})rar!rbz {}/configs)r%r&rz$Unexpected response creating config!)r>)rlrfrwrr ValueErrorrprrqr9r)rr enumerate TypeErrorr'r rr+r!r"r(r*rBr,rrr_)r-rar!rbr#Zvolumesr.rfZ device_mapr/vrrEr?rjr0)rrr1 config_createsX                   zInstance.config_createFc Ksd} |r|st} | }t|}|r4|s4d|j}||r>|nd|jt|j||||d} |r| tt |t rz|j n||d| r| j | d<| r| | d<|j j dtj|| d } |d | krtd | d t|j | d |j | }| r|| fS|S) a2 Creates a new Disk for this Instance. :param size: The size of the disk, in MB :param label: The label of the disk. If not given, a default label will be generated. :param filesystem: The filesystem type for the disk. If not given, the default for the image deployed the disk will be used. Required if creating a disk without an image. :param read_only: If True, creates a read-only disk :param image: The Image to deploy to the disk. :param root_pass: The password to configure for the root user when deploying an image to this disk. Not used if image is not given. If an image is given and root_pass is not, a password will be generated and returned alongside the new disk. :param authorized_keys: A list of SSH keys to install as trusted for the root user. :param authorized_users: A list of usernames whose keys should be installed as trusted for the root user. These user's keys should already be set up, see :any:`ProfileGroup.ssh_keys` for details. :param stackscript: A StackScript object, or the ID of one, to deploy to this disk. Requires deploying a compatible image. :param **stackscript_args: Any arguments to pass to the StackScript, as defined by its User Defined Fields. Nz My {} Diskz {}_disk_{})r<r! read_onlyr=authorized_keysauthorized_users)rt root_passZstackscript_idZstackscript_dataz{}/disks)r%r&rz"Unexpected response creating disk!)r>)rBrCrr+r!rr#r(r'r rrr)r*r,rrr9)r-r<r!r=rrtrrrZ stackscriptZstackscript_argsZgen_passrEr?r/r0r0r1 disk_create5s:    zInstance.disk_createcCs$|jjdtj|d|dS)aJ Enable Backups for this Instance. When enabled, we will automatically backup your Instance's data so that it can be restored at a later date. For more information on Instance's Backups service and pricing, see our `Backups Page`_ .. _Backups Page: https://www.linode.com/backups z{}/backups/enable)r%T)r)r*r+rBr,r)r-r0r0r1enable_backupszs zInstance.enable_backupscCs$|jjdtj|d|dS)z Cancels Backups for this Instance. All existing Backups will be lost, including any snapshots that have been taken. This cannot be undone, but Backups can be re-enabled at a later date. z{}/backups/cancel)r%T)r)r*r+rBr,r)r-r0r0r1cancel_backupsszInstance.cancel_backupscCsZ|jjdtj|d|id}d|kr2td|dt|dr@|`t|j|d|j |}|S)Nz {}/backupsr!)r%r&rz$Unexpected response taking snapshot!)r>r) r)r*r+rBr,rrrrr)r-r!r?br0r0r1rs   zInstance.snapshotcCsJ|jjdtj|d|dd}d|kr4td|dt|j|d|}|S)a Allocates a new :any:`IPAddress` for this Instance. Additional public IPs require justification, and you may need to open a :any:`SupportTicket` before you can add one. You may only have, at most, one private IP per Instance. :param public: If the new IP should be public or private. Defaults to private. :type public: bool :returns: The new IPAddress :rtype: IPAddress z{}/ipsru)r r[)r%r&r{z"Unexpected response allocating IP!)r>)r)r*r+rBr,rr)r-r[r?rr0r0r1 ip_allocates  zInstance.ip_allocatecKsd}|st}|}t|}tt|tr0|jn|||d}|||jj d tj ||d}d|krtt d|d| ||sdS|SdS) a Rebuilding an Instance deletes all existing Disks and Configs and deploys a new :any:`Image` to it. This can be used to reset an existing Instance or to install an Image on an empty Instance. :param image: The Image to deploy to this Instance :type image: str or Image :param root_pass: The root password for the newly rebuilt Instance. If omitted, a password will be generated and returned. :type root_pass: str :param authorized_keys: The ssh public keys to install in the linode's /root/.ssh/authorized_keys file. Each entry may be a single key, or a path to a file containing the key. :type authorized_keys: list or str :returns: The newly generated password, if one was not provided (otherwise True) :rtype: str or bool N)rtrrz {}/rebuild)r%r&rz$Unexpected response issuing rebuild!)r>T)rBrCrr'r rrr(r)r*r+r,rrD)r-rtrrr.Zret_passrEr?r0r0r1rebuilds    zInstance.rebuildcGs@|rddtd|D}nd}|jjdtj|d|id}|S)NcSsi|]\}}d|i|qS)rgr0)rixyr0r0r1rsz#Instance.rescue..)ZsdaZsdbZsdcZsddZsdeZsdfZsdgz {}/rescuerb)r%r&)zipr)r*r+rBr,)r-r#r?r0r0r1rescues  zInstance.rescuecCs|jjdtj|ddS)z6 Converts this linode to KVM from Xen z {}/kvmify)r%T)r)r*r+rBr,)r-r0r0r1kvmifyszInstance.kvmifycCs|jjdtj|ddS)zF Upgrades this Instance to the latest generation type z {}/mutate)r%T)r)r*r+rBr,)r-r0r0r1mutateszInstance.mutatecCs|jjdtj|ddS)zj Initiates a pending migration that is already scheduled for this Linode Instance z {}/migrate)r%N)r)r*r+rBr,)r-r0r0r1initiate_migrationszInstance.initiate_migrationc  Cs|r|rtd|r |s tdt|ts:t|ts:|g}t|tsTt|tsT|g}dd|D} dd|D} tt|tr|jn|tt|tr|jn|tt|tr|jn|| r| nd| r| nd|||d} |jj d t j || d } d | krt d | d t |j| d | } | S) zO Clones this linode into a new linode or into a new linode in the given region z4You may only specify one of "to_linode" and "region"z0Specifying a region requires a "service" as wellcSs$g|]}tt|tr|jn|qSr0)r'r rr)rirjr0r0r1rksz"Instance.clone..cSs$g|]}tt|tr|jn|qSr0)r'r rr)rir/r0r0r1rksN)rr$r r"r#r!rs with_backupsz{}/clone)r%r&rz%Unexpected response cloning Instance!)r>)rrprrr'r rrr)r*r+rBr,r)r-Z to_linoder$Zservicer"r#r!rsrZcidsZdidsrEr?lr0r0r1clones.    zInstance.clonecCs|jjdtj|dS)z: Returns the JSON stats for this Instance z{}/stats)r%)r)rr+rBr,)r-r0r0r1stats2szInstance.statscCs2t|tstd|jjdtj|d|dS)zK Returns stats for the month containing the given datetime z%stats_for requires a datetime object!z {}/stats/{}z%Y/%m)r%) rprrr)rr+rBr,strftime)r-dtr0r0r1 stats_for:s zInstance.stats_for)N)NNFNNNNN)N)F)NN)%r3r4r5r,r r r r9r_rNr8propertyrrrOrDrrrrrG staticmethodrCrrrrrrrrrrrrrrr0r0r0r1rBs\       5 $     P D    0  # rBc@seZdZdZdZdZdS)UserDefinedFieldTypererN)r3r4r5text select_one select_manyr0r0r0r1rDsrc@seZdZdddZddZdS)UserDefinedFieldNcCs"||_||_||_||_||_dS)N)namer!example field_typechoices)r-rr!rrrr0r0r1rZJs zUserDefinedField.__init__cCsd|j|jj|jS)Nz {}({}): {})r+r!rrr)r-r0r0r1r\QszUserDefinedField.__repr__)N)r3r4r5rZr\r0r0r0r1rIs rc@seZdZdZeedddeddeddeedddeddeeddedddeedddeddd Zdd Zd d Zd S) StackScriptz/linode/stackscripts/{id}T)r:r;)r:)r;)r) user_defined_fieldsr!Zrev_noteusernameZuser_gravatar_idZ is_publicrZdeployments_activescriptimagesZdeployments_totalrJrc st|g}xjD]}tj}d}t|drDtj}|jd}nt|dr`tj }|j d}| t |j t|drz|jndt|dr|jnd||dqWd|fd d jD}d |dS) za Override the populate method to map user_defined_fields to fancy values Noneof,manyofr!r)rrcsg|]}tj|qSr0)r r))rir/)r-r0r1rk~sz)StackScript._populate..r)rrDrrrrrrsplitrrrqrrr!rrnr)r-r>Z mapped_udfsZudftrZndistr0)r-r1rDfs$       zStackScript._populatecCs"t|}dd|jD|d<|S)NcSsg|] }|jqSr0)r)rir/r0r0r1rksz*StackScript._serialize..r)rr]r)r-dctr0r0r1r]s zStackScript._serializeN)r3r4r5r,r r8rDr]r0r0r0r1rTs     r)*rrrenumrosrrandomrZlinode_api4.commonrZlinode_api4.errorsrZlinode_api4.objectsrr r r r Zlinode_api4.objects.baser Zlinode_api4.objects.filteringrZlinode_api4.objects.networkingrrZlinode_api4.paginated_listr ascii_lettersdigits punctuationrrr9rHrNrVr_rBrrrr0r0r0r1s6          C'K1