U W+d[@sdZddlZddlmZmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZddlZGd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZdS)z Represents an EC2 Instance N) EC2ObjectTaggedEC2Object) ResultSet)Address)BlockDeviceMapping) ProductCodes)NetworkInterface)Groupc@s2eZdZdZd ddZddZdd Zd d ZdS) InstanceStatea The state of the instance. :ivar code: The low byte represents the state. The high byte is an opaque internal value and should be ignored. Valid values: * 0 (pending) * 16 (running) * 32 (shutting-down) * 48 (terminated) * 64 (stopping) * 80 (stopped) :ivar name: The name of the state of the instance. Valid values: * "pending" * "running" * "shutting-down" * "terminated" * "stopping" * "stopped" rNcCs||_||_dSN)codename)selfr r r5/tmp/pip-unpacked-wheel-dlxw5sjy/boto/ec2/instance.py__init__=szInstanceState.__init__cCsd|j|jfS)Nz%s(%d))r r rrrr__repr__AszInstanceState.__repr__cCsdSr rrr attrs connectionrrr startElementDszInstanceState.startElementcCs4|dkrt||_n|dkr$||_n t|||dS)Nr r )intr r setattrrr valuerrrr endElementGs  zInstanceState.endElement)rN__name__ __module__ __qualname____doc__rrrrrrrrr &s  r c@s2eZdZdZd ddZddZddZd d ZdS) InstancePlacementa The location where the instance launched. :ivar zone: The Availability Zone of the instance. :ivar group_name: The name of the placement group the instance is in (for cluster compute instances). :ivar tenancy: The tenancy of the instance (if the instance is running within a VPC). An instance with a tenancy of dedicated runs on single-tenant hardware. NcCs||_||_||_dSr )zone group_nametenancy)rr#r$r%rrrr[szInstancePlacement.__init__cCs|jSr )r#rrrrr`szInstancePlacement.__repr__cCsdSr rrrrrrcszInstancePlacement.startElementcCs@|dkr||_n,|dkr ||_n|dkr0||_n t|||dS)NZavailabilityZone groupNamer%)r#r$r%rrrrrrfszInstancePlacement.endElement)NNNrrrrrr"Ps  r"csDeZdZdZdfdd ZddZddZd d Zdd d ZZ S) Reservationa Represents a Reservation response object. :ivar id: The unique ID of the Reservation. :ivar owner_id: The unique ID of the owner of the Reservation. :ivar groups: A list of Group objects representing the security groups associated with launched instances. :ivar instances: A list of Instance objects launched in this Reservation. Ncs,tt||d|_d|_g|_g|_dSr )superr'ridowner_idgroups instancesrr __class__rrr|s zReservation.__init__cCs d|jS)NzReservation:%sr)rrrrrszReservation.__repr__cCsD|dkrtdtfg|_|jS|dkrd&d'Zd?d(d)Zd@d*d+ZdAd,d-ZdBd.d/ZdCd0d1ZdDd2d3ZdEd4d5ZdFd6d7ZZS)Gr3a Represents an instance. :ivar id: The unique ID of the Instance. :ivar groups: A list of Group objects representing the security groups associated with the instance. :ivar public_dns_name: The public dns name of the instance. :ivar private_dns_name: The private dns name of the instance. :ivar state: The string representation of the instance's current state. :ivar state_code: An integer representation of the instance's current state. :ivar previous_state: The string representation of the instance's previous state. :ivar previous_state_code: An integer representation of the instance's current state. :ivar key_name: The name of the SSH key associated with the instance. :ivar instance_type: The type of instance (e.g. m1.small). :ivar launch_time: The time the instance was launched. :ivar image_id: The ID of the AMI used to launch this instance. :ivar placement: The availability zone in which the instance is running. :ivar placement_group: The name of the placement group the instance is in (for cluster compute instances). :ivar placement_tenancy: The tenancy of the instance, if the instance is running within a VPC. An instance with a tenancy of dedicated runs on a single-tenant hardware. :ivar kernel: The kernel associated with the instance. :ivar ramdisk: The ramdisk associated with the instance. :ivar architecture: The architecture of the image (i386|x86_64). :ivar hypervisor: The hypervisor used. :ivar virtualization_type: The type of virtualization used. :ivar product_codes: A list of product codes associated with this instance. :ivar ami_launch_index: This instances position within it's launch group. :ivar monitored: A boolean indicating whether monitoring is enabled or not. :ivar monitoring_state: A string value that contains the actual value of the monitoring element returned by EC2. :ivar spot_instance_request_id: The ID of the spot instance request if this is a spot instance. :ivar subnet_id: The VPC Subnet ID, if running in VPC. :ivar vpc_id: The VPC ID, if running in VPC. :ivar private_ip_address: The private IP address of the instance. :ivar ip_address: The public IP address of the instance. :ivar platform: Platform of the instance (e.g. Windows) :ivar root_device_name: The name of the root device. :ivar root_device_type: The root device type (ebs|instance-store). :ivar block_device_mapping: The Block Device Mapping for the instance. :ivar state_reason: The reason for the most recent state transition. :ivar interfaces: List of Elastic Network Interfaces associated with this instance. :ivar ebs_optimized: Whether instance is using optimized EBS volumes or not. :ivar instance_profile: A Python dict containing the instance profile id and arn associated with this instance. Ncstt||d|_d|_d|_d|_d|_d|_d|_ d|_ d|_ d|_ t |_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ g|_!d|_"g|_#d|_$d|_%d|_&d|_'d|_(t)|_*t+|_,dS)NF)-r(r3rr)dns_namepublic_dns_nameprivate_dns_namekey_name instance_type launch_timeimage_idkernelramdiskr product_codesami_launch_index monitoredmonitoring_statespot_instance_request_id subnet_idvpc_idprivate_ip_address ip_address requester_id_in_monitoring_element persistentroot_device_nameroot_device_typeblock_device_mapping state_reasonr$ client_token eventsSetr+platform interfaces hypervisorvirtualization_type architectureinstance_profile_previous_stater _stater" _placementr-r.rrrsPzInstance.__init__cCs d|jS)Nz Instance:%sr0rrrrrszInstance.__repr__cCs|jjSr )r]r rrrrstateszInstance.statecCs|jjSr )r]r rrrr state_codeszInstance.state_codecCs|jr|jjSdSr )r\r rrrrprevious_state szInstance.previous_statecCs|jr|jjSdS)Nr)r\r rrrrprevious_state_codeszInstance.previous_state_codecCs|jjSr )r^r#rrrr placementszInstance.placementcCs|jjSr )r^r$rrrrplacement_groupszInstance.placement_groupcCs|jjSr )r^r%rrrrplacement_tenancyszInstance.placement_tenancycs$tt||||}|dk r |S|dkr2d|_n|dkrHt|_|jS|dkrV|jS|dkrntd|_|jS|dkrt dt fg|_ |j S|dkrtd|_ |j S|d krt dt fg|_|jS|d krtd |_|jS|d kr|jS|d krt|_|jS|d kr|jS|dkr |jSdS)NZ monitoringTblockDeviceMappingZ productCodesZ stateReasonr2r1rUZnetworkInterfaceSetZiamInstanceProfileZ currentState previousStateZ instanceStaterc)r(r3rrNrrRrDSubParserSrr r+rUrrWr[r]r r\r^)rr rrretvalr.rrr!sF       zInstance.startElementcCsl|dkr||_nV|dkr$||_nD|dks4|dkrD||_||_n$|dkrV||_n|dkrh||_n|dkrz||_n|dkr||_n|d kr||_n|d kr||_ n|d kr||_ n|d kr||_ n|d kr||_ n|dkr||_ np|dkr ||_n\|dkr>|jrh||_|dkr4d|_d|_n*|dkrR||_n|dkrf||_n|dkrx||_n|dkr||_n|dkr||_n|dkr||_n|dkr|dkrd|_nd|_n|dkr|jrh||_n||dkr||_nj|dkr||_nX|dkr"||_nF|d kr4||_n4|d!krF||_n"|d"kr\|dk|_n t |||dS)#N instanceIdZimageIdZdnsNameZ publicDnsNameZprivateDnsNameZkeyNameZamiLaunchIndexrg instanceTyperootDeviceNameZrootDeviceTypeZ launchTimerVZkernelIdZ ramdiskIdr_ZenabledTFZspotInstanceRequestIdZsubnetIdZvpcIdZprivateIpAddressZ ipAddressZ requesterIdrOtruer&Z clientTokenrUrXZvirtualizationTyperZZ ebsOptimized)!r)rAr;r<r=r>rErar?rPrQr@rVrBrCrNrGrFrHrIrJrKrLrMrOr$rTeventsrXrYrZZ ebs_optimizedrrrrrrFs                                    zInstance.endElementcCs|j|jdSr )__dict__update)rupdatedrrr_updateszInstance._updateFcCsd|jj|jg|d}t|dkrL|d}|jD]}|j|jkr.||q.n|r^td|j|jS)a Update the instance's state information by making a call to fetch the current instance attributes from the service. :type validate: bool :param validate: By default, if EC2 returns no data about the instance the update method returns quietly. If the validate param is True, however, it will raise a ValueError exception if no data is returned from EC2. r5rz%s is not a valid Instance ID)rZget_all_reservationsr)lenr,rr ValueErrorr_)rvalidater6rsrirrrrps    zInstance.updatecCs2|jj|jg|d}t|dkr.||ddS)z( Terminate the instance r5rN)rZterminate_instancesr)rsrrrr6rvrrr terminates zInstance.terminatecCs4|jj|jg||d}t|dkr0||ddS)z Stop the instance :type force: bool :param force: Forces the instance to stop :rtype: list :return: A list of the instances stopped r5rN)rZstop_instancesr)rsrr)rforcer6rvrrrr7s  z Instance.stopcCs2|jj|jg|d}t|dkr.||ddS)z% Start the instance. r5rN)rZstart_instancesr)rsrrryrrrstarts zInstance.startcCs|jj|jg|dSr4)rZreboot_instancesr)rr6rrrrebootszInstance.rebootcCs|jj|j|dS)z Retrieves the console output for the instance. :rtype: :class:`boto.ec2.instance.ConsoleOutput` :return: The console output as a ConsoleOutput object r5)rget_console_outputr)r}rrrrszInstance.get_console_outputcCs|jj|j||dSr4)rZconfirm_product_instancer))rZ product_coder6rrrconfirm_products zInstance.confirm_productcCs$t|tr|j}|jj|j||dS)a7 Associates an Elastic IP to the instance. :type ip_address: Either an instance of :class:`boto.ec2.address.Address` or a string. :param ip_address: The IP address to associate with the instance. :rtype: bool :return: True if successful r5) isinstancerZ public_iprZassociate_addressr))rrLr6rrruse_ips zInstance.use_ipcCs|jj|j|dSr4)rZmonitor_instancer)r}rrrmonitorszInstance.monitorcCs|jj|j|dSr4)rZunmonitor_instancer)r}rrr unmonitorszInstance.unmonitorcCs|jj|j||dS)a Gets an attribute from this instance. :type attribute: string :param attribute: The attribute you need information about Valid choices are: * instanceType * kernel * ramdisk * userData * disableApiTermination * instanceInitiatedShutdownBehavior * rootDeviceName * blockDeviceMapping * productCodes * sourceDestCheck * groupSet * ebsOptimized :rtype: :class:`boto.ec2.image.InstanceAttribute` :return: An InstanceAttribute object representing the value of the attribute requested r5)rZget_instance_attributer)r attributer6rrr get_attributes zInstance.get_attributecCs|jj|j|||dS)a Changes an attribute of this instance :type attribute: string :param attribute: The attribute you wish to change. * instanceType - A valid instance type (m1.small) * kernel - Kernel ID (None) * ramdisk - Ramdisk ID (None) * userData - Base64 encoded String (None) * disableApiTermination - Boolean (true) * instanceInitiatedShutdownBehavior - stop|terminate * sourceDestCheck - Boolean (true) * groupSet - Set of Security Groups or IDs * ebsOptimized - Boolean (false) :type value: string :param value: The new value for the attribute :rtype: bool :return: Whether the operation succeeded or not r5)rZmodify_instance_attributer))rrrr6rrrmodify_attributes zInstance.modify_attributecCs|jj|j||dS)a( Resets an attribute of this instance to its default value. :type attribute: string :param attribute: The attribute to reset. Valid values are: kernel|ramdisk :rtype: bool :return: Whether the operation succeeded or not r5)rZreset_instance_attributer)rrrrreset_attribute/s zInstance.reset_attributecCs|jj|j||||dS)a Will create an AMI from the instance in the running or stopped state. :type name: string :param name: The name of the new image :type description: string :param description: An optional human-readable string describing the contents and purpose of the AMI. :type no_reboot: bool :param no_reboot: An optional flag indicating that the bundling process should not attempt to shutdown the instance before bundling. If this flag is True, the responsibility of maintaining file system integrity is left to the owner of the instance. :rtype: string :return: The new image id r5)r create_imager))rr descriptionZ no_rebootr6rrrr@szInstance.create_image)N)FF)F)FF)F)F)F)F)F)F)F)F)F)F)NFF) rrr r!rrpropertyr_r`rarbrcrdrerrrrrprzr7r|r~rrrrrrrrrr:rrr.rr3sH6*        %G            r3c@s&eZdZdddZddZddZdS) ConsoleOutputNcCs||_d|_d|_d|_dSr )parent instance_id timestampoutputrrrrrraszConsoleOutput.__init__cCsdSr rrrrrrgszConsoleOutput.startElementcCsF|dkr||_n2|dkr ||_n"|dkr6t||_n t|||dS)Nrjrr)rrbase64 b64decoderrrrrrrjszConsoleOutput.endElement)Nrrr rrrrrrrr`s rc @s>eZdZddddddddd d g Zdd d ZddZddZd S)InstanceAttributerkrBrCZuserDataZdisableApiTerminationZ!instanceInitiatedShutdownBehaviorrlrfZsourceDestCheckr2NcCs t|d|_d|_d|_dSr )dictrr request_id_current_valuerrrrr|s zInstanceAttribute.__init__cCsD|dkrt||<||S|dkr|dkrJ|dkr6d}n |dkrBd}||_n||jkr^|j||<dS)NrjZ requestIdrrmTfalseF)rrr ValidValuesrrrrrs zInstanceAttribute.endElement)N)rrr rrrrrrrrrus  rc@s&eZdZdddZddZddZdS) rhNcCst|||_dSr )rrsection)rrrrrrrs zSubParse.__init__cCsdSr rrrrrrszSubParse.startElementcCs||jkr|||<dSr )rrrrrrs zSubParse.endElement)Nrrrrrrhs rh)r!ZbotoZboto.ec2.ec2objectrrZboto.resultsetrZboto.ec2.addressrZboto.ec2.blockdevicemappingrZboto.ec2.imagerZboto.ec2.networkinterfacerZboto.ec2.groupr robjectr r"r'r3rrrrhrrrrs&      *!,F&