U W+d@sdZddlZddlZddlmZddlmZddlZddlmZddlm Z ddl m Z ddl m Z mZmZdd lmZmZdd lmZmZdd lmZdd lmZdd lmZmZddlmZddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl'm)Z)ddl'm*Z*ddl'm+Z+ddl'm,Z,ddl'm-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7ddl8m9Z9dd l:m;Z;dd!lm?Z?dd#l@mAZAdd$lBmCZCmDZDdd%lEmFZFmGZGdd&lHmIZIdd'lJmKZKGd(d)d)e ZLdS)*z- Represents a connection to the EC2 service. N)datetime) timedelta)detect_potential_sigv4)AWSQueryConnection) ResultSet)ImageImageAttribute CopyImage) ReservationInstance) ConsoleOutputInstanceAttribute)KeyPair)Address)VolumeVolumeAttribute)Snapshot)SnapshotAttribute)Zone) SecurityGroup) RegionInfo) InstanceInfo)ReservedInstancesOffering)ReservedInstance)ReservedInstanceListing)ReservedInstancesConfiguration)ModifyReservedInstancesResult)ReservedInstancesModification)SpotInstanceRequest)SpotPriceHistory)SpotDatafeedSubscription)BundleInstanceTask)PlacementGroup)Tag) InstanceType)InstanceStatusSet)VolumeStatusSet)NetworkInterface)AccountAttribute VPCAttribute)BlockDeviceMappingBlockDeviceType)EC2ResponseError)sixcs\eZdZejdddZejdddZejdddZe Z dfd d Z ddZ ddZ ddZdddZdddZdddZdddZdddZddd Zdd!d"Zdd$d%Zdd'd(Zdd)d*Zdd+d,Zdd-d.Zdd/d0Zdd1d2Zdd5d6Zdd7d8Zd d9d:Zd d;d<Z d d=d>Z!d d?d@Z"d dAdBZ#ddCdDZ$ddEdFZ%ddGdHZ&ddIdJZ'ddKdLZ(ddMdNZ)ddPdQZ*ddRdSZ+ddTdUZ,ddVdWZ-ddXdYZ.ddZd[Z/dd\d]Z0dd^d_Z1dd`daZ2ddbdcZ3ddddeZ4ddfdgZ5d dhdiZ6d!djdkZ7d"dldmZ8d#dndoZ9d$dpdqZ:d%drdsZ;d&dudvZ<d'dwdxZ=d(dydzZ>d)d{d|Z?d*d}d~Z@d+ddZAd,ddZBd-ddZCd.ddZDd/ddZEd0ddZFd1ddZGd2ddZHd3ddZId4ddZJd5ddZKd6ddZLd7ddZMd8ddZNd9ddZOd:ddZPd;ddZQdddZTd?ddZUd@ddZVdAddZWdBddZXdCddZYdDddZZdEddZ[dFddZ\dGddZ]ddZ^ddZ_dHdd„Z`dIddĄZadJddƄZbdKddȄZcdLddʄZddMdd̄ZedNdd΄ZfdOddЄZgdPdd҄ZhdQddԄZidRddׄZjdSddلZkddۄZldTdd݄ZmdUdd߄ZndVddZodWddZpdXddZqdYddZrdZddZsd[ddZtddZud\ddZvd]ddZwd^ddZxd_ddZyd`ddZzZ{S(a EC2ConnectionZBotoZ ec2_versionz 2014-10-01Zec2_region_namez us-east-1Zec2_region_endpointzec2.us-east-1.amazonaws.comNTr/csZ| st||j|j} | |_tt|j|||||||| |jj| | | |||d|rV||_dS)z@ Init method to create a new connection to EC2. )validate_certs profile_nameN) rDefaultRegionNameDefaultRegionEndpointregionsuperr.__init__Zendpoint APIVersion)selfaws_access_key_idaws_secret_access_key is_securehostportproxy proxy_port proxy_user proxy_passdebughttps_connection_factoryr4path api_versionZsecurity_tokenr0r1 __class__7/tmp/pip-unpacked-wheel-dlxw5sjy/boto/ec2/connection.pyr6Qs.   zEC2Connection.__init__cCsdgS)Nzhmac-v4rH)r8rHrHrI_required_auth_capabilityksz'EC2Connection._required_auth_capabilityc Cs8ddddddddd d g }i}|D]}t||||<q |S) z Returns a dictionary containing the value of all of the keyword arguments passed when constructing this connection. r9r:r;r=r>r?r@rArBrC)getattr)r8Z param_namesparamsnamerHrHrI get_paramsnszEC2Connection.get_paramsc Cst|tst|}d}|D]p}|}|ds8|dd}||d|<||}t|ts\|g}d}|D]}||d||f<|d7}qd|d7}qdS)Nztag:_-zFilter.%d.NamezFilter.%d.Value.%d) isinstancedict startswithreplacelist) r8rLfiltersirMZaws_namevaluejvrHrHrIbuild_filter_params|s       z!EC2Connection.build_filter_paramsFcCsni}|r|||d|r(|||d|r:|||d|rJ||||rVd|d<|jd|dtfgdd S) a Retrieve all the EC2 images available on your account. :type image_ids: list :param image_ids: A list of strings with the image IDs wanted :type owners: list :param owners: A list of owner IDs, the special strings 'self', 'amazon', and 'aws-marketplace', may be used to describe images owned by you, Amazon or AWS Marketplace respectively :type executable_by: list :param executable_by: Returns AMIs for which the specified user ID has explicit launch permissions :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.image.Image` ImageIdOwnerZ ExecutableBytrueDryRunDescribeImagesitemPOSTZverbbuild_list_paramsr\get_listr)r8 image_idsownersZ executable_byrWdry_runrLrHrHrIget_all_imagess  zEC2Connection.get_all_imagescCs`i}|r|||d|r(|||dddi}||||rHd|d<|jd|dtfgd d S) a Retrieve all the EC2 kernels available on your account. Constructs a filter to allow the processing to happen server side. :type kernel_ids: list :param kernel_ids: A list of strings with the image IDs wanted :type owners: list :param owners: A list of owner IDs :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.image.Image` r]r^ image-typekernelr_r`rarbrcrdre)r8Z kernel_idsrirjrLfilterrHrHrIget_all_kernelss zEC2Connection.get_all_kernelscCs`i}|r|||d|r(|||dddi}||||rHd|d<|jd|dtfgd d S) a Retrieve all the EC2 ramdisks available on your account. Constructs a filter to allow the processing to happen server side. :type ramdisk_ids: list :param ramdisk_ids: A list of strings with the image IDs wanted :type owners: list :param owners: A list of owner IDs :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.image.Image` r]r^rlZramdiskr_r`rarbrcrdre)r8Z ramdisk_idsrirjrLrnrHrHrIget_all_ramdiskss zEC2Connection.get_all_ramdiskscCs2z|j|g|ddWStk r,YdSXdS)a Shortcut method to retrieve a specific image (AMI). :type image_id: string :param image_id: the ID of the Image to retrieve :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.image.Image` :return: The EC2 Image specified or None if the image is not found )rhrjrN)rk IndexError)r8image_idrjrHrHrI get_images zEC2Connection.get_imagecCsi}|r||d<|r||d<|r(||d<|r4||d<|r@||d<|rL||d<|rX||d<| rvt| | d}t}|||<|r||| rd |d <| r| |d <| r| |d <|jd |tdd}t|dd}|S)a? Register an image. :type name: string :param name: The name of the AMI. Valid only for EBS-based images. :type description: string :param description: The description of the AMI. :type image_location: string :param image_location: Full path to your AMI manifest in Amazon S3 storage. Only used for S3-based AMI's. :type architecture: string :param architecture: The architecture of the AMI. Valid choices are: * i386 * x86_64 :type kernel_id: string :param kernel_id: The ID of the kernel with which to launch the instances :type root_device_name: string :param root_device_name: The root device name (e.g. /dev/sdh) :type block_device_map: :class:`boto.ec2.blockdevicemapping.BlockDeviceMapping` :param block_device_map: A BlockDeviceMapping data structure describing the EBS volumes associated with the Image. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type virtualization_type: string :param virtualization_type: The virutalization_type of the image. Valid choices are: * paravirtual * hvm :type sriov_net_support: string :param sriov_net_support: Advanced networking support. Valid choices are: * simple :type snapshot_id: string :param snapshot_id: A snapshot ID for the snapshot to be used as root device for the image. Mutually exclusive with block_device_map, requires root_device_name :type delete_root_volume_on_termination: bool :param delete_root_volume_on_termination: Whether to delete the root volume of the image after instance termination. Only applies when creating image from snapshot_id. Defaults to False. Note that leaving volumes behind after instance termination is not free. :rtype: string :return: The new image id Name DescriptionZ ArchitectureKernelId RamdiskIdZ ImageLocationZRootDeviceName) snapshot_idZdelete_on_terminationr_r`ZVirtualizationTypeZSriovNetSupportZ RegisterImagercrdZimageIdN)r+r*ec2_build_list_params get_objectrrK)r8rM descriptionZimage_location architecture kernel_id ramdisk_idZroot_device_nameblock_device_maprjZvirtualization_typeZsriov_net_supportrxZ!delete_root_volume_on_terminationrLZroot_volrsrrrHrHrIregister_image s@@  zEC2Connection.register_imagec Cstd}|r6||}|jD]}|dkr|j|j}q6qd|i}|rJd|d<|jd|dd}|rp|rp|on||S|S) a Unregister an AMI. :type image_id: string :param image_id: the ID of the Image to unregister :type delete_snapshot: bool :param delete_snapshot: Set to True if we should delete the snapshot associated with an EBS volume mounted at /dev/sda1 :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful Nz /dev/sda1r]r_r`ZDeregisterImagercrd)rsblock_device_mappingrx get_statusdelete_snapshot) r8rrrrjrximagekeyrLresultrHrHrIderegister_imagels&   zEC2Connection.deregister_imagec CsT||d}|r||d<|r"d|d<|r0|||rq|S)a Retrieve all the instances associated with your account. :type instance_ids: list :param instance_ids: A list of strings of instance IDs :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type max_results: int :param max_results: The maximum number of paginated instance items per response. :rtype: list :return: A list of :class:`boto.ec2.instance.Instance` N)rrWrjr next_tokencSsg|]}|jD]}|qqSrH)Z instances).0Z reservationinstancerHrHrI osz4EC2Connection.get_only_instances..)rextendr)r8rrWrjrrretvalZ reservationsrHrHrIget_only_instancesKsz EC2Connection.get_only_instancescCsi}|r|||d|rZd|krN|d}|drBt|dkrNtdt||||rfd|d<|dk rv||d <|r||d <|jd |d t fgd dS)a- Retrieve all the instance reservations associated with your account. :type instance_ids: list :param instance_ids: A list of strings of instance IDs :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type max_results: int :param max_results: The maximum number of paginated instance items per response. :type next_token: str :param next_token: A string specifying the next paginated set of results to return. :rtype: list :return: A list of :class:`boto.ec2.instance.Reservation` rzgroup-idsg- zThe group-id filter now requires a security group identifier (sg-*) instead of a group name. To filter by group name use the 'group-name' filter instead.r_r`N MaxResults NextTokenZDescribeInstancesrbrcrd) rfgetrTlenrr UserWarningr\rgr )r8rrWrjrrrLgidrHrHrIrws,  z"EC2Connection.get_all_reservationscCshi}|r|||d|r"||d<|r.||d<|r>||||rJd|d<|rVd|d<|jd|tdd S) a Retrieve all the instances in your account scheduled for maintenance. :type instance_ids: list :param instance_ids: A list of strings of instance IDs :type max_results: int :param max_results: The maximum number of paginated instance items per response. :type next_token: str :param next_token: A string specifying the next paginated set of results to return. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type include_all_instances: bool :param include_all_instances: Set to True if all instances should be returned. (Only running instances are included by default.) :rtype: list :return: A list of instances that have maintenance scheduled. rrrr_r`ZIncludeAllInstancesZDescribeInstanceStatusrcrd)rfr\rzr%)r8rrrrWrjZinclude_all_instancesrLrHrHrIget_all_instance_statuss"' z%EC2Connection.get_all_instance_statusrOm1.smallc Cs|||d}|r||d<|rZg}|D]&}t|tr@||jq$||q$|||d|rg}|D]&}t|tr||jqf||qf|||d|rt|tjr|d}t | d|d<|r||d<|r||d<| r| |d <|r||d <|r||d <| r| |d <| r$| |d <| r2d|d<| r@| |d<|rN||d<|r^| ||rld|d<|r~|}||d<|r||d<|r||d<|r||d<|r||d<|rd|d<|r|||rd|d<|j d|tddS)a  Runs an image on EC2. :type image_id: string :param image_id: The ID of the image to run. :type min_count: int :param min_count: The minimum number of instances to launch. :type max_count: int :param max_count: The maximum number of instances to launch. :type key_name: string :param key_name: The name of the key pair with which to launch instances. :type security_groups: list of strings :param security_groups: The names of the EC2 classic security groups with which to associate instances :type user_data: string :param user_data: The user data passed to the launched instances :type instance_type: string :param instance_type: The type of instance to run: * t1.micro * m1.small * m1.medium * m1.large * m1.xlarge * m3.medium * m3.large * m3.xlarge * m3.2xlarge * c1.medium * c1.xlarge * m2.xlarge * m2.2xlarge * m2.4xlarge * cr1.8xlarge * hi1.4xlarge * hs1.8xlarge * cc1.4xlarge * cg1.4xlarge * cc2.8xlarge * g2.2xlarge * c3.large * c3.xlarge * c3.2xlarge * c3.4xlarge * c3.8xlarge * c4.large * c4.xlarge * c4.2xlarge * c4.4xlarge * c4.8xlarge * i2.xlarge * i2.2xlarge * i2.4xlarge * i2.8xlarge * t2.micro * t2.small * t2.medium :type placement: string :param placement: The Availability Zone to launch the instance into. :type kernel_id: string :param kernel_id: The ID of the kernel with which to launch the instances. :type ramdisk_id: string :param ramdisk_id: The ID of the RAM disk with which to launch the instances. :type monitoring_enabled: bool :param monitoring_enabled: Enable detailed CloudWatch monitoring on the instance. :type subnet_id: string :param subnet_id: The subnet ID within which to launch the instances for VPC. :type private_ip_address: string :param private_ip_address: If you're using VPC, you can optionally use this parameter to assign the instance a specific available IP address from the subnet (e.g., 10.0.0.25). :type block_device_map: :class:`boto.ec2.blockdevicemapping.BlockDeviceMapping` :param block_device_map: A BlockDeviceMapping data structure describing the EBS volumes associated with the Image. :type disable_api_termination: bool :param disable_api_termination: If True, the instances will be locked and will not be able to be terminated via the API. :type instance_initiated_shutdown_behavior: string :param instance_initiated_shutdown_behavior: Specifies whether the instance stops or terminates on instance-initiated shutdown. Valid values are: * stop * terminate :type placement_group: string :param placement_group: If specified, this is the name of the placement group in which the instance(s) will be launched. :type client_token: string :param client_token: Unique, case-sensitive identifier you provide to ensure idempotency of the request. Maximum 64 ASCII characters. :type security_group_ids: list of strings :param security_group_ids: The ID of the VPC security groups with which to associate instances. :type additional_info: string :param additional_info: Specifies additional information to make available to the instance(s). :type tenancy: string :param tenancy: The tenancy of the instance you want to launch. An instance with a tenancy of 'dedicated' runs on single-tenant hardware and can only be launched into a VPC. Valid values are:"default" or "dedicated". NOTE: To use dedicated tenancy you MUST specify a VPC subnet-ID as well. :type instance_profile_arn: string :param instance_profile_arn: The Amazon resource name (ARN) of the IAM Instance Profile (IIP) to associate with the instances. :type instance_profile_name: string :param instance_profile_name: The name of the IAM Instance Profile (IIP) to associate with the instances. :type ebs_optimized: bool :param ebs_optimized: Whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. :type network_interfaces: :class:`boto.ec2.networkinterface.NetworkInterfaceCollection` :param network_interfaces: A NetworkInterfaceCollection data structure containing the ENI specifications for the instance. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: Reservation :return: The :class:`boto.ec2.instance.Reservation` associated with the request for machines )r]ZMinCountZMaxCountKeyNameSecurityGroupIdrzutf-8ZUserDataZAddressingTyper$zPlacement.AvailabilityZonezPlacement.GroupNamezPlacement.Tenancyrvrwr_zMonitoring.EnabledSubnetIdPrivateIpAddressZDisableApiTerminationZ!InstanceInitiatedShutdownBehavior ClientTokenZAdditionalInfozIamInstanceProfile.NamezIamInstanceProfile.ArnZ EbsOptimizedr`Z RunInstancesrcrd)rRrappendrrfrMr- text_typeencodebase64 b64encodedecoderyrzr ) r8rrZ min_count max_countkey_namesecurity_groups user_dataaddressing_type instance_type placementr}r~monitoring_enabled subnet_idrZdisable_api_terminationZ$instance_initiated_shutdown_behaviorprivate_ip_addressplacement_group client_tokensecurity_group_idsZadditional_infoinstance_profile_nameinstance_profile_arnZtenancy ebs_optimizednetwork_interfacesrjrLlgroupvalrHrHrI run_instancess-         zEC2Connection.run_instancescCs:i}|r|||d|r"d|d<|jd|dtfgddS)aZ Terminate the instances specified :type instance_ids: list :param instance_ids: A list of strings of the Instance IDs to terminate :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of the instances terminated rr_r`ZTerminateInstancesrbrcrdrfrgr r8rrjrLrHrHrIterminate_instancess z!EC2Connection.terminate_instancescCsFi}|rd|d<|r"|||d|r.d|d<|jd|dtfgddS) a Stop the instances specified :type instance_ids: list :param instance_ids: A list of strings of the Instance IDs to stop :type force: bool :param force: Forces the instance to stop :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of the instances stopped r_Forcerr`Z StopInstancesrbrcrdr)r8rforcerjrLrHrHrIstop_instancesszEC2Connection.stop_instancescCs:i}|r|||d|r"d|d<|jd|dtfgddS)aO Start the instances specified :type instance_ids: list :param instance_ids: A list of strings of the Instance IDs to start :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of the instances started rr_r`ZStartInstancesrbrcrdrrrHrHrIstart_instancess zEC2Connection.start_instancescCs2i}|||gd|r d|d<|jd|tddS)a Retrieves the console output for the specified instance. :type instance_id: string :param instance_id: The instance ID of a running instance on the cloud. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.instance.ConsoleOutput` :return: The console output as a ConsoleOutput object rr_r`ZGetConsoleOutputrcrd)rfrzr )r8rrjrLrHrHrIget_console_outputs z EC2Connection.get_console_outputcCs.i}|r|||d|r"d|d<|d|S)a Reboot the specified instances. :type instance_ids: list :param instance_ids: The instances to terminate and reboot :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rr_r`ZRebootInstancesrrrHrHrIreboot_instances+s zEC2Connection.reboot_instancescCs4||d}|rd|d<|jd|tdd}|j|jfS)t :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. )rrr_r`ZConfirmProductInstancercrd)rzrstatusZownerId)r8Z product_coderrjrLrrHrHrIconfirm_product_instance=sz&EC2Connection.confirm_product_instancecCs2d|i}|r||d<|r d|d<|jd|tddS)a Gets an attribute from an instance. :type instance_id: string :param instance_id: The Amazon id of the 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 * sriovNetSupport :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.image.InstanceAttribute` :return: An InstanceAttribute object representing the value of the attribute requested rrr_r`ZDescribeInstanceAttributercrd)rzr r8rrrjrLrHrHrIget_instance_attributeNs z$EC2Connection.get_instance_attributec Csd}||kr>t|tr*|r$d}q>d}n|dkr>td|d|i}|dkrt|D](\}} t| trr| j} | |d|d <qZnd|d kr||d <nN|d kr||d <n8|dkr||d<|std||d<ntd|f|rd|d<|jd|ddS)a3 Changes an attribute of a network interface. :type interface_id: string :param interface_id: The interface id. Looks like 'eni-xxxxxxxx' :type attr: string :param attr: The attribute you wish to change. Learn more at http://docs.aws.amazon.com/AWSEC2/latest/API Reference/ApiReference-query-ModifyNetworkInterfaceAttribute.html * description - Textual description of interface * groupSet - List of security group ids or group objects * sourceDestCheck - Boolean * deleteOnTermination - Boolean. Must also specify attachment_id :type value: string :param value: The new value for the attribute :rtype: bool :return: Whether the operation succeeded or not :type attachment_id: string :param attachment_id: If you're modifying DeleteOnTermination you must specify the attachment_id. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. )deleteonterminationsourcedestcheckr_false)r_rz)%s must be a boolean, "true", or "false"!NetworkInterfaceIdgroupsetzSecurityGroupId.%srOr{zDescription.ValuerzSourceDestCheck.ValuerzAttachment.DeleteOnTerminationz&You must also specify an attachment_idzAttachment.AttachmentIdzUnknown attribute "%s"r`ZModifyNetworkInterfaceAttributercrd)lowerrRbool ValueError enumeraterrr) r8Z interface_idattrrY attachment_idrj bool_reqsrLidxsgrHrHrI"modify_network_interface_attributevsB!          z0EC2Connection.modify_network_interface_attributecCsd}||kr(t|tr(|r$d}nd}d|i}|dkrpt|D](\}}t|tr\|j}||d|d<qDn||dkrt|D]@\}} | d \} } } d |d} | |d | <| pd|d | <qn$|d |dd}||d|<|rd|d<|jd|ddS)aR Changes an attribute of an instance :type instance_id: string :param instance_id: The instance id you wish to change :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 * blockDeviceMapping - List of strings - ie: ['/dev/sda=false'] * sourceDestCheck - Boolean (true) * groupSet - Set of Security Groups or IDs * ebsOptimized - Boolean (false) * sriovNetSupport - String - ie: 'simple' :type value: string :param value: The new value for the attribute :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: Whether the operation succeeded or not )ZdisableapiterminationrZ ebsoptimizedr_rrrz GroupId.%srOZblockdevicemapping=zBlockDeviceMapping.%dz %s.DeviceNamez%s.Ebs.DeleteOnTerminationrNz%s.Valuer`ZModifyInstanceAttributercrd) rrRrrrr partitionupperr)r8rrrYrjrrLrrkvZdev_namerPflagprerHrHrImodify_instance_attributes.!        z'EC2Connection.modify_instance_attributecCs&||d}|rd|d<|jd|ddS)a Resets an attribute of an instance to its default value. :type instance_id: string :param instance_id: ID of the instance :type attribute: string :param attribute: The attribute to reset. Valid values are: kernel|ramdisk :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: Whether the operation succeeded or not )rrr_r`ZResetInstanceAttributercrdrrrHrHrIreset_instance_attributes z&EC2Connection.reset_instance_attributecCs~i}|r|||d|rZd|krN|d}|drBt|dkrNtdt||||rfd|d<|jd|d t fgd d S) aQ Retrieve all the spot instances requests associated with your account. :type request_ids: list :param request_ids: A list of strings of spot instance request IDs :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.spotinstancerequest.SpotInstanceRequest` SpotInstanceRequestIdzlaunch.group-idrrzThe 'launch.group-id' filter now requires a security group id (sg-*) and no longer supports filtering by group name. Please update your filters accordingly.r_r`ZDescribeSpotInstanceRequestsrbrcrd) rfrrTrrrrr\rgr)r8 request_idsrWrjrLZlgidrHrHrIget_all_spot_instance_requestss$  z,EC2Connection.get_all_spot_instance_requestsc Csi} |r|| d<|r|| d<|r(|| d<|r4|| d<|r@|| d<|rLd| d<|dk r\|| d <|rh|| d <| rx|| | |jd | d tfgd dS)a Retrieve the recent history of spot instances pricing. :type start_time: str :param start_time: An indication of how far back to provide price changes for. An ISO8601 DateTime string. :type end_time: str :param end_time: An indication of how far forward to provide price changes for. An ISO8601 DateTime string. :type instance_type: str :param instance_type: Filter responses to a particular instance type. :type product_description: str :param product_description: Filter responses to a particular platform. Valid values are currently: * Linux/UNIX * SUSE Linux * Windows * Linux/UNIX (Amazon VPC) * SUSE Linux (Amazon VPC) * Windows (Amazon VPC) :type availability_zone: str :param availability_zone: The availability zone for which prices should be returned. If not specified, data for all availability zones will be returned. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type max_results: int :param max_results: The maximum number of paginated items per response. :type next_token: str :param next_token: The next set of rows to return. This should be the value of the ``next_token`` attribute from a previous call to ``get_spot_price_history``. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :rtype: list :return: A list tuples containing price and timestamp. Z StartTimeZEndTimer$ProductDescriptionAvailabilityZoner_r`NrrZDescribeSpotPriceHistoryrbrcrd)r\rgr) r8 start_timeZend_timerproduct_descriptionavailability_zonerjrrrWrLrHrHrIget_spot_price_historyBs.: z$EC2Connection.get_spot_price_historyone-timecCs"d}d||d|d|i}|r$||d<|r0||d<|r<||d<|rH||d<|rT||d <| rd| |d |<|rg}|D]&}t|tr||jqp||qp|||d || rg}| D]&}t|tr||jq||q|||d || rt| |d |<| r| |d|<| r,| |d|<|r>||d|<|rP||d|<|rb||d|<|rtd|d|<|r||d|<|r||d|<|r||d||r||d|<|r||d|<|rd|d|<|r|j||dd|r d|d<|j d|dt fgd d!S)"a Request instances on the spot market at a particular price. :type price: str :param price: The maximum price of your bid :type image_id: string :param image_id: The ID of the image to run :type count: int :param count: The of instances to requested :type type: str :param type: Type of request. Can be 'one-time' or 'persistent'. Default is one-time. :type valid_from: str :param valid_from: Start date of the request. An ISO8601 time string. :type valid_until: str :param valid_until: End date of the request. An ISO8601 time string. :type launch_group: str :param launch_group: If supplied, all requests will be fulfilled as a group. :type availability_zone_group: str :param availability_zone_group: If supplied, all requests will be fulfilled within a single availability zone. :type key_name: string :param key_name: The name of the key pair with which to launch instances :type security_groups: list of strings :param security_groups: The names of the security groups with which to associate instances :type user_data: string :param user_data: The user data passed to the launched instances :type instance_type: string :param instance_type: The type of instance to run: * t1.micro * m1.small * m1.medium * m1.large * m1.xlarge * m3.medium * m3.large * m3.xlarge * m3.2xlarge * c1.medium * c1.xlarge * m2.xlarge * m2.2xlarge * m2.4xlarge * cr1.8xlarge * hi1.4xlarge * hs1.8xlarge * cc1.4xlarge * cg1.4xlarge * cc2.8xlarge * g2.2xlarge * c3.large * c3.xlarge * c3.2xlarge * c3.4xlarge * c3.8xlarge * c4.large * c4.xlarge * c4.2xlarge * c4.4xlarge * c4.8xlarge * i2.xlarge * i2.2xlarge * i2.4xlarge * i2.8xlarge * t2.micro * t2.small * t2.medium :type placement: string :param placement: The availability zone in which to launch the instances :type kernel_id: string :param kernel_id: The ID of the kernel with which to launch the instances :type ramdisk_id: string :param ramdisk_id: The ID of the RAM disk with which to launch the instances :type monitoring_enabled: bool :param monitoring_enabled: Enable detailed CloudWatch monitoring on the instance. :type subnet_id: string :param subnet_id: The subnet ID within which to launch the instances for VPC. :type placement_group: string :param placement_group: If specified, this is the name of the placement group in which the instance(s) will be launched. :type block_device_map: :class:`boto.ec2.blockdevicemapping.BlockDeviceMapping` :param block_device_map: A BlockDeviceMapping data structure describing the EBS volumes associated with the Image. :type security_group_ids: list of strings :param security_group_ids: The ID of the VPC security groups with which to associate instances. :type instance_profile_arn: string :param instance_profile_arn: The Amazon resource name (ARN) of the IAM Instance Profile (IIP) to associate with the instances. :type instance_profile_name: string :param instance_profile_name: The name of the IAM Instance Profile (IIP) to associate with the instances. :type ebs_optimized: bool :param ebs_optimized: Whether the instance is optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. :type network_interfaces: list :param network_interfaces: A list of :class:`boto.ec2.networkinterface.NetworkInterfaceSpecification` :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: Reservation :return: The :class:`boto.ec2.spotinstancerequest.SpotInstanceRequest` associated with the request for machines ZLaunchSpecificationz %s.ImageIdTypeZ SpotPrice InstanceCountZ ValidFromZ ValidUntilZ LaunchGroupZAvailabilityZoneGroupz %s.KeyNamez%s.SecurityGroupIdz%s.SecurityGroupz %s.UserDataz%s.AddressingTypez%s.InstanceTypez%s.Placement.AvailabilityZonez %s.KernelIdz %s.RamdiskIdr_z%s.Monitoring.Enabledz %s.SubnetIdz%s.Placement.GroupNamez%s.z%s.IamInstanceProfile.Namez%s.IamInstanceProfile.Arnz%s.EbsOptimized.)prefixr`ZRequestSpotInstancesrbrcrd) rRrrrrfrMrrryrgr)r8pricerrcounttypeZ valid_fromZ valid_untilZ launch_groupZavailability_zone_grouprrrrrrr}r~rrrrrrrrrrjZlsrLrrrHrHrIrequest_spot_instancess                z$EC2Connection.request_spot_instancescCs:i}|r|||d|r"d|d<|jd|dtfgddS)ab Cancel the specified Spot Instance Requests. :type request_ids: list :param request_ids: A list of strings of the Request IDs to terminate :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of the instances terminated rr_r`ZCancelSpotInstanceRequestsrbrcrd)rfrgr)r8rrjrLrHrHrIcancel_spot_instance_requestsqs z+EC2Connection.cancel_spot_instance_requestscCs"i}|rd|d<|jd|tddS)aq Return the current spot instance data feed subscription associated with this account, if any. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.spotdatafeedsubscription.SpotDatafeedSubscription` :return: The datafeed subscription object or None r_r`Z DescribeSpotDatafeedSubscriptionrcrdrzr r8rjrLrHrHrIget_spot_datafeed_subscriptions z,EC2Connection.get_spot_datafeed_subscriptioncCs2d|i}|r||d<|r d|d<|jd|tddS)a Create a spot instance datafeed subscription for this account. :type bucket: str or unicode :param bucket: The name of the bucket where spot instance data will be written. The account issuing this request must have FULL_CONTROL access to the bucket specified in the request. :type prefix: str or unicode :param prefix: An optional prefix that will be pre-pended to all data files written to the bucket. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.spotdatafeedsubscription.SpotDatafeedSubscription` :return: The datafeed subscription object or None ZBucketZPrefixr_r`ZCreateSpotDatafeedSubscriptionrcrdr)r8Zbucketr rjrLrHrHrI!create_spot_datafeed_subscriptionsz/EC2Connection.create_spot_datafeed_subscriptioncCs i}|rd|d<|jd|ddS)a Delete the current spot instance data feed subscription associated with this account :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful r_r`ZDeleteSpotDatafeedSubscriptionrcrdrrrHrHrI!delete_spot_datafeed_subscriptions z/EC2Connection.delete_spot_datafeed_subscriptioncCsJi}|r|||d|r&||||r2d|d<|jd|dtfgddS)a Get all Availability Zones associated with the current region. :type zones: list :param zones: Optional list of zones. If this list is present, only the Zones associated with these zone names will be returned. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list of :class:`boto.ec2.zone.Zone` :return: The requested Zone objects ZZoneNamer_r`ZDescribeAvailabilityZonesrbrcrd)rfr\rgr)r8ZzonesrWrjrLrHrHrI get_all_zoness zEC2Connection.get_all_zonescCs\i}|r|||d|r(|||d|r8||||rDd|d<|jd|dtfgddS) a Get all EIP's associated with the current credentials. :type addresses: list :param addresses: Optional list of addresses. If this list is present, only the Addresses associated with these addresses will be returned. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type allocation_ids: list :param allocation_ids: Optional list of allocation IDs. If this list is present, only the Addresses associated with the given allocation IDs will be returned. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list of :class:`boto.ec2.address.Address` :return: The requested Address objects PublicIp AllocationIdr_r`ZDescribeAddressesrbrcrd)rfr\rgr)r8 addressesrWZallocation_idsrjrLrHrHrIget_all_addressess zEC2Connection.get_all_addressescCs2i}|dk r||d<|r d|d<|jd|tddS)a Allocate a new Elastic IP address and associate it with your account. :type domain: string :param domain: Optional string. If domain is set to "vpc" the address will be allocated to VPC . Will return address object with allocation_id. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.address.Address` :return: The newly allocated Address NDomainr_r`ZAllocateAddressrcrd)rzr)r8domainrjrLrHrHrIallocate_addresss zEC2Connection.allocate_addresscCsdi}|dk r||d<|dk r,|||dn|dk r<||d<|rHd|d<|rTd|d<|jd|d d S) a Assigns one or more secondary private IP addresses to a network interface in Amazon VPC. :type network_interface_id: string :param network_interface_id: The network interface to which the IP address will be assigned. :type private_ip_addresses: list :param private_ip_addresses: Assigns the specified IP addresses as secondary IP addresses to the network interface. :type secondary_private_ip_address_count: int :param secondary_private_ip_address_count: The number of secondary IP addresses to assign to the network interface. You cannot specify this parameter when also specifying private_ip_addresses. :type allow_reassignment: bool :param allow_reassignment: Specifies whether to allow an IP address that is already assigned to another network interface or instance to be reassigned to the specified network interface. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful NrrZSecondaryPrivateIpAddressCountr_ZAllowReassignmentr`ZAssignPrivateIpAddressesrcrdr)r8network_interface_idprivate_ip_addressesZ"secondary_private_ip_address_countZallow_reassignmentrjrLrHrHrIassign_private_ip_addresses.s z)EC2Connection.assign_private_ip_addressesc Csi} |dk r|| d<n|dk r&|| d<|dk r8|| d<n|dk rH|| d<|dk rX|| d<|rdd| d<|rpd| d<|r|jd | d d S|jd | td d SdS) Nrrrrrr_ZAllowReassociationr`ZAssociateAddressrcrd)rrzr) r8rr public_ip allocation_idrrallow_reassociationrjrLrHrHrI_associate_addressbs(   z EC2Connection._associate_addressc Cs|jd|||||||dS)a Associate an Elastic IP address with a currently running instance. This requires one of ``public_ip`` or ``allocation_id`` depending on if you're associating a VPC address or a plain EC2 address. When using an Allocation ID, make sure to pass ``None`` for ``public_ip`` as EC2 expects a single parameter and if ``public_ip`` is passed boto will preference that instead of ``allocation_id``. :type instance_id: string :param instance_id: The ID of the instance :type public_ip: string :param public_ip: The public IP address for EC2 based allocations. :type allocation_id: string :param allocation_id: The allocation ID for a VPC-based elastic IP. :type network_interface_id: string :param network_interface_id: The network interface ID to which elastic IP is to be assigned to :type private_ip_address: string :param private_ip_address: The primary or secondary private IP address to associate with the Elastic IP address. :type allow_reassociation: bool :param allow_reassociation: Specify this option to allow an Elastic IP address that is already associated with another network interface or instance to be re-associated with the specified instance or interface. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful Trr r!rrr"rjr#r8rr r!rrr"rjrHrHrIassociate_addresss*zEC2Connection.associate_addressc Cs|jd|||||||dS)a8 Associate an Elastic IP address with a currently running instance. This requires one of ``public_ip`` or ``allocation_id`` depending on if you're associating a VPC address or a plain EC2 address. When using an Allocation ID, make sure to pass ``None`` for ``public_ip`` as EC2 expects a single parameter and if ``public_ip`` is passed boto will preference that instead of ``allocation_id``. :type instance_id: string :param instance_id: The ID of the instance :type public_ip: string :param public_ip: The public IP address for EC2 based allocations. :type allocation_id: string :param allocation_id: The allocation ID for a VPC-based elastic IP. :type network_interface_id: string :param network_interface_id: The network interface ID to which elastic IP is to be assigned to :type private_ip_address: string :param private_ip_address: The primary or secondary private IP address to associate with the Elastic IP address. :type allow_reassociation: bool :param allow_reassociation: Specify this option to allow an Elastic IP address that is already associated with another network interface or instance to be re-associated with the specified instance or interface. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: class:`boto.ec2.address.Address` :return: The associated address instance Fr$r%r&rHrHrIassociate_address_objects*z&EC2Connection.associate_address_objectcCsBi}|dk r||d<n|dk r&||d<|r2d|d<|jd|ddS) a Disassociate an Elastic IP address from a currently running instance. :type public_ip: string :param public_ip: The public IP address for EC2 elastic IPs. :type association_id: string :param association_id: The association ID for a VPC based elastic ip. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful NZ AssociationIdrr_r`ZDisassociateAddressrcrdr)r8r Zassociation_idrjrLrHrHrIdisassociate_addresss z"EC2Connection.disassociate_addresscCsBi}|dk r||d<n|dk r&||d<|r2d|d<|jd|ddS) a Free up an Elastic IP address. Pass a public IP address to release an EC2 Elastic IP address and an AllocationId to release a VPC Elastic IP address. You should only pass one value. This requires one of ``public_ip`` or ``allocation_id`` depending on if you're associating a VPC address or a plain EC2 address. When using an Allocation ID, make sure to pass ``None`` for ``public_ip`` as EC2 expects a single parameter and if ``public_ip`` is passed boto will preference that instead of ``allocation_id``. :type public_ip: string :param public_ip: The public IP address for EC2 elastic IPs. :type allocation_id: string :param allocation_id: The Allocation ID for VPC elastic IPs. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful Nrrr_r`ZReleaseAddressrcrdr)r8r r!rjrLrHrHrIrelease_addresss zEC2Connection.release_addresscCsFi}|dk r||d<|dk r*|||d|r6d|d<|jd|ddS) a Unassigns one or more secondary private IP addresses from a network interface in Amazon VPC. :type network_interface_id: string :param network_interface_id: The network interface from which the secondary private IP address will be unassigned. :type private_ip_addresses: list :param private_ip_addresses: Specifies the secondary private IP addresses that you want to unassign from the network interface. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful Nrrr_r`ZUnassignPrivateIpAddressesrcrdr)r8rrrjrLrHrHrIunassign_private_ip_addresses'sz+EC2Connection.unassign_private_ip_addressescCsJi}|r|||d|r&||||r2d|d<|jd|dtfgddS)a Get all Volumes associated with the current credentials. :type volume_ids: list :param volume_ids: Optional list of volume ids. If this list is present, only the volumes associated with these volume ids will be returned. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list of :class:`boto.ec2.volume.Volume` :return: The requested Volume objects VolumeIdr_r`ZDescribeVolumesrbrcrd)rfr\rgr)r8 volume_idsrWrjrLrHrHrIget_all_volumesLs zEC2Connection.get_all_volumescCs\i}|r|||d|r"||d<|r.||d<|r>||||rJd|d<|jd|tddS) a Retrieve the status of one or more volumes. :type volume_ids: list :param volume_ids: A list of strings of volume IDs :type max_results: int :param max_results: The maximum number of paginated instance items per response. :type next_token: str :param next_token: A string specifying the next paginated set of results to return. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of volume status. r,rrr_r`ZDescribeVolumeStatusrcrd)rfr\rzr&)r8r-rrrWrjrLrHrHrIget_all_volume_statusos! z#EC2Connection.get_all_volume_statuscCs$d|i}|rd|d<|jd|ddS)a Enables I/O operations for a volume that had I/O operations disabled because the data on the volume was potentially inconsistent. :type volume_id: str :param volume_id: The ID of the volume. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful r,r_r`ZEnableVolumeIOrcrdrr8 volume_idrjrLrHrHrIenable_volume_ioszEC2Connection.enable_volume_io autoEnableIOcCs(||d}|rd|d<|jd|tddS)a Describes attribute of the volume. :type volume_id: str :param volume_id: The ID of the volume. :type attribute: str :param attribute: The requested attribute. Valid values are: * autoEnableIO :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list of :class:`boto.ec2.volume.VolumeAttribute` :return: The requested Volume attribute )r,rr_r`ZDescribeVolumeAttributercrd)rzr)r8r1rrjrLrHrHrIget_volume_attributes z"EC2Connection.get_volume_attributecCs4d|i}|dkr||d<|r$d|d<|jd|ddS) a Changes an attribute of an Volume. :type volume_id: string :param volume_id: The volume id you wish to change :type attribute: string :param attribute: The attribute you wish to change. Valid values are: AutoEnableIO. :type new_value: string :param new_value: The new value of the attribute. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. r,Z AutoEnableIOzAutoEnableIO.Valuer_r`ZModifyVolumeAttributercrdr)r8r1r new_valuerjrLrHrHrImodify_volume_attributes z%EC2Connection.modify_volume_attributec Cst|tr|j}d|i} |r$|| d<|r@t|tr8|j}|| d<|rL|| d<|r\t|| d<|rtd| d<|rt|| d<|rd| d <|jd | td d S) a Create a new EBS Volume. :type size: int :param size: The size of the new volume, in GiB :type zone: string or :class:`boto.ec2.zone.Zone` :param zone: The availability zone in which the Volume will be created. :type snapshot: string or :class:`boto.ec2.snapshot.Snapshot` :param snapshot: The snapshot from which the new Volume will be created. :type volume_type: string :param volume_type: The type of the volume. (optional). Valid values are: standard | io1 | gp2. :type iops: int :param iops: The provisioned IOPS you want to associate with this volume. (optional) :type encrypted: bool :param encrypted: Specifies whether the volume should be encrypted. (optional) :type kms_key_id: string :params kms_key_id: If encrypted is True, this KMS Key ID may be specified to encrypt volume with this key (optional) e.g.: arn:aws:kms:us-east-1:012345678910:key/abcd1234-a123-456a-a12b-a123b4cd56ef :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rSize SnapshotIdZ VolumeTypeZIopsr_ EncryptedKmsKeyIdr`Z CreateVolumercrd)rRrrMrrstrrzr) r8sizezonesnapshotZ volume_typeZiops encrypted kms_key_idrjrLrHrHrI create_volumes($   zEC2Connection.create_volumecCs$d|i}|rd|d<|jd|ddS)a' Delete an EBS volume. :type volume_id: str :param volume_id: The ID of the volume to be delete. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful r,r_r`Z DeleteVolumercrdrr0rHrHrI delete_volume s zEC2Connection.delete_volumecCs(|||d}|rd|d<|jd|ddS)ao Attach an EBS volume to an EC2 instance. :type volume_id: str :param volume_id: The ID of the EBS volume to be attached. :type instance_id: str :param instance_id: The ID of the EC2 instance to which it will be attached. :type device: str :param device: The device on the instance through which the volume will be exposted (e.g. /dev/sdh) :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful )rr,Devicer_r`Z AttachVolumercrdr)r8r1rdevicerjrLrHrHrI attach_volume/ szEC2Connection.attach_volumecCsHd|i}|r||d<|r ||d<|r,d|d<|r8d|d<|jd|dd S) ag Detach an EBS volume from an EC2 instance. :type volume_id: str :param volume_id: The ID of the EBS volume to be attached. :type instance_id: str :param instance_id: The ID of the EC2 instance from which it will be detached. :type device: str :param device: The device on the instance through which the volume is exposted (e.g. /dev/sdh) :type force: bool :param force: Forces detachment if the previous detachment attempt did not occur cleanly. This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach a volume from a failed instance. The instance will not have an opportunity to flush file system caches nor file system meta data. If you use this option, you must perform file system check and repair procedures. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful r,rrCr_rr`Z DetachVolumercrdr)r8r1rrDrrjrLrHrHrI detach_volumeK s zEC2Connection.detach_volumecCsni}|r|||d|r(|||d|r:|||d|rJ||||rVd|d<|jd|dtfgdd S) a Get all EBS Snapshots associated with the current credentials. :type snapshot_ids: list :param snapshot_ids: Optional list of snapshot ids. If this list is present, only the Snapshots associated with these snapshot ids will be returned. :type owner: str or list :param owner: If present, only the snapshots owned by the specified user(s) will be returned. Valid values are: * self * amazon * AWS Account ID :type restorable_by: str or list :param restorable_by: If present, only the snapshots that are restorable by the specified account id(s) will be returned. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list of :class:`boto.ec2.snapshot.Snapshot` :return: The requested Snapshot objects r8r^Z RestorableByr_r`ZDescribeSnapshotsrbrcrd)rfr\rgr)r8Z snapshot_idsownerZ restorable_byrWrjrLrHrHrIget_all_snapshotsx s' zEC2Connection.get_all_snapshotscCsnd|i}|r|dd|d<|r(d|d<|jd|tdd }|j|g|d d}|jd }|rj|d ||S) a Create a snapshot of an existing EBS Volume. :type volume_id: str :param volume_id: The ID of the volume to be snapshot'ed :type description: str :param description: A description of the snapshot. Limited to 255 characters. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.snapshot.Snapshot` :return: The created Snapshot object r,rrur_r`ZCreateSnapshotrcrdrjrt)rzrr.tagsrZadd_tag)r8r1r{rjrLr>volume volume_namerHrHrIcreate_snapshot s  zEC2Connection.create_snapshotcCs$d|i}|rd|d<|jd|ddS)rr8r_r`ZDeleteSnapshotrcrdr)r8rxrjrLrHrHrIr szEC2Connection.delete_snapshotcCs>||d}|dk r||d<|r&d|d<|jd|tdd}|jS) a Copies a point-in-time snapshot of an Amazon Elastic Block Store (Amazon EBS) volume and stores it in Amazon Simple Storage Service (Amazon S3). You can copy the snapshot within the same region or from one region to another. You can use the snapshot to create new Amazon EBS volumes or Amazon Machine Images (AMIs). :type source_region: str :param source_region: The ID of the AWS region that contains the snapshot to be copied (e.g 'us-east-1', 'us-west-2', etc.). :type source_snapshot_id: str :param source_snapshot_id: The ID of the Amazon EBS snapshot to copy :type description: str :param description: A description of the new Amazon EBS snapshot. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: str :return: The snapshot ID ) SourceRegionZSourceSnapshotIdNrur_r`Z CopySnapshotrcrd)rzrr)r8 source_regionZsource_snapshot_idr{rjrLr>rHrHrI copy_snapshot s zEC2Connection.copy_snapshotc Cst}t|j|j|j|j}t|j|j|j}t|j|j|jt|ddd}t|j|jd} g} tddd} td|D]} | |t| dqtd|D]} | |t| dqtd|D]}| |t|dqtdd}d}| | kr<|dks||kr<| | |d7}| |8} t| j| jd} qg}| D] }| |d krD| |qDt |} |j d d }|j d d di}|D]>}|jd}|r||}|sg}|||<| |q|D]}||}|dd}d}d }|D]}d}|r|| krt|jd}|| |kr|dkr|jdsz,||jtjd|jd|jfWn2tk rtjd|jd|jfYnXnd}d }n |d7}d }qqqdS)a Trim excess snapshots, based on when they were taken. More current snapshots are retained, with the number retained decreasing as you move back in time. If ebs volumes have a 'Name' tag with a value, their snapshots will be assigned the same tag when they are created. The values of the 'Name' tags for snapshots are used by this function to group snapshots taken from the same volume (or from a series of like-named volumes over time) for trimming. For every group of like-named snapshots, this function retains the newest and oldest snapshots, as well as, by default, the first snapshots taken in each of the last eight hours, the first snapshots taken in each of the last seven days, the first snapshots taken in the last 4 weeks (counting Midnight Sunday morning as the start of the week), and the first snapshot from the first day of each month forever. :type hourly_backups: int :param hourly_backups: How many recent hourly backups should be saved. :type daily_backups: int :param daily_backups: How many recent daily backups should be saved. :type weekly_backups: int :param weekly_backups: How many recent weekly backups should be saved. :type monthly_backups: int :param monthly_backups: How many monthly backups should be saved. Use True for no limit. rOrS)daysir)hours)weeksTFr8)rGcSs|jS)N)r)xrHrHrI] z.EC2Connection.trim_snapshots..)rrtNz%Y-%m-%dT%H:%M:%S.000ZZpreserve_snapshotzTrimmed snapshot %s (%s)zmAttempt to trim snapshot %s (%s) failed. Possible result of a race condition with trimming on another server?)rutcnowyearmonthdayhourrweekdayranger __contains__sortedrHsortrKr__len__strptimerrrbotologinfor,error)r8Zhourly_backupsZ daily_backupsZweekly_backupsZmonthly_backupsnowZ last_hourZ last_midnightZ last_sundayZstart_of_monthZtarget_backup_timesZoldest_snapshot_dater`r_weekZone_dayZmonthly_snapshots_addedtemptZ all_snapshotsZsnaps_for_each_volumeZsnaprMZsnaps_for_volumeZsnapsZtime_period_numberZsnap_found_for_this_time_periodZcheck_this_snapZ snap_daterHrHrItrim_snapshots s-(           $zEC2Connection.trim_snapshotscreateVolumePermissioncCs2d|i}|r||d<|r d|d<|jd|tddS)aR Get information about an attribute of a snapshot. Only one attribute can be specified per call. :type snapshot_id: str :param snapshot_id: The ID of the snapshot. :type attribute: str :param attribute: The requested attribute. Valid values are: * createVolumePermission :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list of :class:`boto.ec2.snapshotattribute.SnapshotAttribute` :return: The requested Snapshot attribute rr8r_r`ZDescribeSnapshotAttributercrd)rzrr8rxrrjrLrHrHrIget_snapshot_attribute sz$EC2Connection.get_snapshot_attributecCsL|||d}|r|||d|r0|||d|rWY dSW5d}~XYnXdS)a Convenience method to retrieve a specific keypair (KeyPair). :type keyname: string :param keyname: The name of the keypair to retrieve :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.keypair.KeyPair` :return: The KeyPair specified or None if it is not found )rvrjrzInvalidKeyPair.NotFoundN)rw ResponseErrorcode)r8keynamerjerHrHrI get_key_pair s   zEC2Connection.get_key_paircCs&d|i}|rd|d<|jd|tddS)ac Create a new key pair for your account. This will create the key pair within the region you are currently connected to. :type key_name: string :param key_name: The name of the new keypair :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.keypair.KeyPair` :return: The newly created :class:`boto.ec2.keypair.KeyPair`. The material attribute of the new KeyPair object will contain the the unencrypted PEM encoded RSA private key. rr_r`Z CreateKeyPairrcrd)rzrr8rrjrLrHrHrIcreate_key_pair. szEC2Connection.create_key_paircCs$d|i}|rd|d<|jd|ddS)z Delete a key pair from your account. :type key_name: string :param key_name: The name of the keypair to delete :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rr_r`Z DeleteKeyPairrcrdrr}rHrHrIdelete_key_pairD s zEC2Connection.delete_key_paircCs2t|}||d}|r d|d<|jd|tddS)a imports the public key from an RSA key pair that you created with a third-party tool. Supported formats: * OpenSSH public key format (e.g., the format in ~/.ssh/authorized_keys) * Base64 encoded DER format * SSH public key file format as specified in RFC4716 DSA keys are not supported. Make sure your key generator is set up to create RSA keys. Supported lengths: 1024, 2048, and 4096. :type key_name: string :param key_name: The name of the new keypair :type public_key_material: string :param public_key_material: The public key. You must base64 encode the public key material before sending it to AWS. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.keypair.KeyPair` :return: A :class:`boto.ec2.keypair.KeyPair` object representing the newly imported key pair. This object will contain only the key name and the fingerprint. )rZPublicKeyMaterialr_r`Z ImportKeyPairrcrd)rrrzr)r8rZpublic_key_materialrjrLrHrHrIimport_key_pairT s# zEC2Connection.import_key_paircCshi}|dk r|||d|dk r0|||d|dk rD||||rPd|d<|jd|dtfgdd S) a Get all security groups associated with your account in a region. :type groupnames: list :param groupnames: A list of the names of security groups to retrieve. If not provided, all security groups will be returned. :type group_ids: list :param group_ids: A list of IDs of security groups to retrieve for security groups within a VPC. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.securitygroup.SecurityGroup` N GroupNameGroupIdr_r`ZDescribeSecurityGroupsrbrcrd)rfr\rgr)r8 groupnamesZ group_idsrWrjrLrHrHrIget_all_security_groups s z%EC2Connection.get_all_security_groupscCsV||d}|dk r||d<|r&d|d<|jd|tdd}||_||_|dk rR||_|S) a Create a new security group for your account. This will create the security group within the region you are currently connected to. :type name: string :param name: The name of the new security group :type description: string :param description: The description of the new security group :type vpc_id: string :param vpc_id: The ID of the VPC to create the security group in, if any. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.securitygroup.SecurityGroup` :return: The newly created :class:`boto.ec2.securitygroup.SecurityGroup`. )rZGroupDescriptionNVpcIdr_r`ZCreateSecurityGrouprcrd)rzrrMr{vpc_id)r8rMr{rrjrLrrHrHrIcreate_security_group s z#EC2Connection.create_security_groupcCsBi}|dk r||d<n|dk r&||d<|r2d|d<|jd|ddS) a Delete a security group from your account. :type name: string :param name: The name of the security group to delete. :type group_id: string :param group_id: The ID of the security group to delete within a VPC. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful. Nrrr_r`ZDeleteSecurityGrouprcrdr)r8rMgroup_idrjrLrHrHrIdelete_security_group s z#EC2Connection.delete_security_groupc Cshd|i} |r|| d<|r || d<|r,|| d<|r8|| d<|rD|| d<|rP|| d<|r\d| d <|d | S) a NOTE: This method uses the old-style request parameters that did not allow a port to be specified when authorizing a group. :type group_name: string :param group_name: The name of the security group you are adding the rule to. :type src_security_group_name: string :param src_security_group_name: The name of the security group you are granting access to. :type src_security_group_owner_id: string :param src_security_group_owner_id: The ID of the owner of the security group you are granting access to. :type ip_protocol: string :param ip_protocol: Either tcp | udp | icmp :type from_port: int :param from_port: The beginning port number you are enabling :type to_port: int :param to_port: The ending port number you are enabling :type to_port: string :param to_port: The CIDR block you are providing access to. See http://goo.gl/Yj5QC :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful. rSourceSecurityGroupNameSourceSecurityGroupOwnerId IpProtocolFromPortToPortCidrIpr_r`AuthorizeSecurityGroupIngressr r8 group_namesrc_security_group_namesrc_security_group_owner_id ip_protocol from_portto_portcidr_iprjrLrHrHrI#authorize_security_group_deprecated s *z1EC2Connection.authorize_security_group_deprecatedc Cs|r*|dkr*|dkr*|dkr*||||Si} |r:|| d<|rF|| d<|rVd} || | <|rfd} || | <| rvd} | | | <|r|| d<|dk r|| d<|dk r|| d <|rt|ts|g}t|D]\} }|| d | d <q| rd | d <|jd| ddS)a: Add a new rule to an existing security group. You need to pass in either src_security_group_name and src_security_group_owner_id OR ip_protocol, from_port, to_port, and cidr_ip. In other words, either you are authorizing another group or you are authorizing some ip-based rule. :type group_name: string :param group_name: The name of the security group you are adding the rule to. :type src_security_group_name: string :param src_security_group_name: The name of the security group you are granting access to. :type src_security_group_owner_id: string :param src_security_group_owner_id: The ID of the owner of the security group you are granting access to. :type ip_protocol: string :param ip_protocol: Either tcp | udp | icmp :type from_port: int :param from_port: The beginning port number you are enabling :type to_port: int :param to_port: The ending port number you are enabling :type cidr_ip: string or list of strings :param cidr_ip: The CIDR block you are providing access to. See http://goo.gl/Yj5QC :type group_id: string :param group_id: ID of the EC2 or VPC security group to modify. This is required for VPC security groups and can be used instead of group_name for EC2 security groups. :type src_security_group_group_id: string :param src_security_group_group_id: The ID of the security group you are granting access to. Can be used instead of src_security_group_name :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful. Nrr"IpPermissions.1.Groups.1.GroupNameIpPermissions.1.Groups.1.UserId IpPermissions.1.Groups.1.GroupIdIpPermissions.1.IpProtocolIpPermissions.1.FromPortIpPermissions.1.ToPortz"IpPermissions.1.IpRanges.%d.CidrIprOr_r`rrcrd)rrRrVrr)r8rrrrrrrrsrc_security_group_group_idrjrL param_namerXZsingle_cidr_iprHrHrIauthorize_security_group* sN8 z&EC2Connection.authorize_security_groupc Csf||d}|dk r||d<|dk r*||d<|dk r:||d<|dk rJ||d<|rVd|d<|jd |d d S) a The action adds one or more egress rules to a VPC security group. Specifically, this action permits instances in a security group to send traffic to one or more destination CIDR IP address ranges, or to one or more destination security groups in the same VPC. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. )rrNrrr!IpPermissions.1.IpRanges.1.CidrIpr_r`ZAuthorizeSecurityGroupEgressrcrdr r8rrrrZ src_group_idrrjrLrHrHrIauthorize_security_group_egress s"z-EC2Connection.authorize_security_group_egressc Cshd|i} |r|| d<|r || d<|r,|| d<|r8|| d<|rD|| d<|rP|| d<|r\d| d <|d | S) a\ NOTE: This method uses the old-style request parameters that did not allow a port to be specified when authorizing a group. Remove an existing rule from an existing security group. You need to pass in either src_security_group_name and src_security_group_owner_id OR ip_protocol, from_port, to_port, and cidr_ip. In other words, either you are revoking another group or you are revoking some ip-based rule. :type group_name: string :param group_name: The name of the security group you are removing the rule from. :type src_security_group_name: string :param src_security_group_name: The name of the security group you are revoking access to. :type src_security_group_owner_id: string :param src_security_group_owner_id: The ID of the owner of the security group you are revoking access to. :type ip_protocol: string :param ip_protocol: Either tcp | udp | icmp :type from_port: int :param from_port: The beginning port number you are disabling :type to_port: int :param to_port: The ending port number you are disabling :type to_port: string :param to_port: The CIDR block you are revoking access to. http://goo.gl/Yj5QC :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful. rrrrrrrr_r`RevokeSecurityGroupIngressrrrHrHrI revoke_security_group_deprecated s 0z.EC2Connection.revoke_security_group_deprecatedc Cs|r*|dkr*|dkr*|dkr*||||Si} |dk r>|| d<|dk rN|| d<|r^d} || | <| rnd} | | | <|r~d} || | <|r|| d<|dk r|| d<|dk r|| d <|r|| d <| rd | d <|jd | ddS)a8 Remove an existing rule from an existing security group. You need to pass in either src_security_group_name and src_security_group_owner_id OR ip_protocol, from_port, to_port, and cidr_ip. In other words, either you are revoking another group or you are revoking some ip-based rule. :type group_name: string :param group_name: The name of the security group you are removing the rule from. :type src_security_group_name: string :param src_security_group_name: The name of the security group you are revoking access to. :type src_security_group_owner_id: string :param src_security_group_owner_id: The ID of the owner of the security group you are revoking access to. :type ip_protocol: string :param ip_protocol: Either tcp | udp | icmp :type from_port: int :param from_port: The beginning port number you are disabling :type to_port: int :param to_port: The ending port number you are disabling :type cidr_ip: string :param cidr_ip: The CIDR block you are revoking access to. See http://goo.gl/Yj5QC :type group_id: string :param group_id: ID of the EC2 or VPC security group to modify. This is required for VPC security groups and can be used instead of group_name for EC2 security groups. :type src_security_group_group_id: string :param src_security_group_group_id: The ID of the security group for which you are revoking access. Can be used instead of src_security_group_name :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful. Nrrrrrrrrrr_r`rrcrd)rr) r8rrrrrrrrrrjrLrrHrHrIrevoke_security_group sF6z#EC2Connection.revoke_security_groupc Csti}|r||d<|r||d<|dk r,||d<|dk r<||d<|dk rL||d<|rX||d<|rdd|d <|jd |d d S) a| Remove an existing egress rule from an existing VPC security group. You need to pass in an ip_protocol, from_port and to_port range only if the protocol you are using is port-based. You also need to pass in either a src_group_id or cidr_ip. :type group_name: string :param group_id: The name of the security group you are removing the rule from. :type ip_protocol: string :param ip_protocol: Either tcp | udp | icmp | -1 :type from_port: int :param from_port: The beginning port number you are disabling :type to_port: int :param to_port: The ending port number you are disabling :type src_group_id: src_group_id :param src_group_id: The source security group you are revoking access to. :type cidr_ip: string :param cidr_ip: The CIDR block you are revoking access to. See http://goo.gl/Yj5QC :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful. rrNrrrrr_r`ZRevokeSecurityGroupEgressrcrdrrrHrHrIrevoke_security_group_egressF s&*z*EC2Connection.revoke_security_group_egresscCs^i}|r|||d|r&||||r2d|d<|jd|dtfgdd}|D] }t|_qN|S)a~ Get all available regions for the EC2 service. :type region_names: list of str :param region_names: Names of regions to limit output :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.regioninfo.RegionInfo` Z RegionNamer_r`ZDescribeRegionsrbrcrd)rfr\rgrr.Zconnection_cls)r8Z region_namesrWrjrLZregionsr4rHrHrIget_all_regions s zEC2Connection.get_all_regionscCsi}|dk r|||d|r&||d<|r2||d<|r>||d<|rN||||dk r^||d<|dk rn||d<|dk r|rd|d <nd |d <| dk rt| |d <| dk rt| |d <| dk rt| |d <| dk r| |d<| dk rt| |d<|rd|d<|jd|dtfgddS)a Describes Reserved Instance offerings that are available for purchase. :type reserved_instances_offering_ids: list :param reserved_instances_id: One or more Reserved Instances offering IDs. :type instance_type: str :param instance_type: Displays Reserved Instances of the specified instance type. :type availability_zone: str :param availability_zone: Displays Reserved Instances within the specified Availability Zone. :type product_description: str :param product_description: Displays Reserved Instances with the specified product description. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type instance_tenancy: string :param instance_tenancy: The tenancy of the Reserved Instance offering. A Reserved Instance with tenancy of dedicated will run on single-tenant hardware and can only be launched within a VPC. :type offering_type: string :param offering_type: The Reserved Instance offering type. Valid Values: `"Heavy Utilization" | "Medium Utilization" | "Light Utilization"` :type include_marketplace: bool :param include_marketplace: Include Marketplace offerings in the response. :type min_duration: int :param min_duration: Minimum duration (in seconds) to filter when searching for offerings. :type max_duration: int :param max_duration: Maximum duration (in seconds) to filter when searching for offerings. :type max_instance_count: int :param max_instance_count: Maximum number of instances to filter when searching for offerings. :type next_token: string :param next_token: Token to use when requesting the next paginated set of offerings. :type max_results: int :param max_results: Maximum number of offerings to return per call. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.reservedinstance.ReservedInstancesOffering`. NReservedInstancesOfferingIdr$rrZInstanceTenancyZ OfferingTyper_ZIncludeMarketplacerZ MinDurationZ MaxDurationZMaxInstanceCountrrr`Z"DescribeReservedInstancesOfferingsrbrcrd)rfr\r;rgr)r8Zreserved_instances_offering_idsrrrrWZinstance_tenancyZ offering_typeZinclude_marketplaceZ min_durationZ max_durationZmax_instance_countrrrjrLrHrHrI$get_all_reserved_instances_offerings sLT      z2EC2Connection.get_all_reserved_instances_offeringscCsJi}|r|||d|r&||||r2d|d<|jd|dtfgddS)a Describes one or more of the Reserved Instances that you purchased. :type reserved_instance_ids: list :param reserved_instance_ids: A list of the reserved instance ids that will be returned. If not provided, all reserved instances will be returned. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.reservedinstance.ReservedInstance` ReservedInstancesIdr_r`ZDescribeReservedInstancesrbrcrd)rfr\rgr)r8reserved_instances_idrWrjrLrHrHrIget_all_reserved_instances(s z(EC2Connection.get_all_reserved_instancescCsP||d}|dk r2t|d|d<t|d|d<|r>d|d<|jd |td d S) a Purchase a Reserved Instance for use with your account. ** CAUTION ** This request can result in large amounts of money being charged to your AWS account. Use with caution! :type reserved_instances_offering_id: string :param reserved_instances_offering_id: The offering ID of the Reserved Instance to purchase :type instance_count: int :param instance_count: The number of Reserved Instances to purchase. Default value is 1. :type limit_price: tuple :param instance_count: Limit the price on the total order. Must be a tuple of (amount, currency_code), for example: (100.0, 'USD'). :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.reservedinstance.ReservedInstance` :return: The newly created Reserved Instance )rrNrzLimitPrice.AmountrOzLimitPrice.CurrencyCoder_r`Z!PurchaseReservedInstancesOfferingrcrd)r;rzr)r8Zreserved_instances_offering_idinstance_countZ limit_pricerjrLrHrHrI#purchase_reserved_instance_offeringKsz1EC2Connection.purchase_reserved_instance_offeringc Csn|t||d}t|D]0\}}|\} } t| |d|<t| |d|<q|rVd|d<|jd|dtfgdd S) a Creates a new listing for Reserved Instances. Creates a new listing for Amazon EC2 Reserved Instances that will be sold in the Reserved Instance Marketplace. You can submit one Reserved Instance listing at a time. The Reserved Instance Marketplace matches sellers who want to resell Reserved Instance capacity that they no longer need with buyers who want to purchase additional capacity. Reserved Instances bought and sold through the Reserved Instance Marketplace work like any other Reserved Instances. If you want to sell your Reserved Instances, you must first register as a Seller in the Reserved Instance Marketplace. After completing the registration process, you can create a Reserved Instance Marketplace listing of some or all of your Reserved Instances, and specify the upfront price you want to receive for them. Your Reserved Instance listings then become available for purchase. :type reserved_instances_id: string :param reserved_instances_id: The ID of the Reserved Instance that will be listed. :type instance_count: int :param instance_count: The number of instances that are a part of a Reserved Instance account that will be listed in the Reserved Instance Marketplace. This number should be less than or equal to the instance count associated with the Reserved Instance ID specified in this call. :type price_schedules: List of tuples :param price_schedules: A list specifying the price of the Reserved Instance for each month remaining in the Reserved Instance term. Each tuple contains two elements, the price and the term. For example, for an instance that 11 months remaining in its term, we can have a price schedule with an upfront price of $2.50. At 8 months remaining we can drop the price down to $2.00. This would be expressed as:: price_schedules=[('2.50', 11), ('2.00', 8)] :type client_token: string :param client_token: Unique, case-sensitive identifier you provide to ensure idempotency of the request. Maximum 64 ASCII characters. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.reservedinstance.ReservedInstanceListing` )rrrzPriceSchedules.%s.PricezPriceSchedules.%s.Termr_r`ZCreateReservedInstancesListingrbrcrd)r;rrgr) r8rrZprice_schedulesrrjrLrXscheduler ZtermrHrHrI!create_reserved_instances_listingss9z/EC2Connection.create_reserved_instances_listingcCs>i}|dk r|||d|r&d|d<|jd|dtfgddS) aCancels the specified Reserved Instance listing. :type reserved_instances_listing_ids: List of strings :param reserved_instances_listing_ids: The ID of the Reserved Instance listing to be cancelled. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.reservedinstance.ReservedInstanceListing` NZReservedInstancesListingIdr_r`ZCancelReservedInstancesListingrbrcrd)rfrgr)r8Zreserved_instances_listing_idsrjrLrHrHrI!cancel_reserved_instances_listingsz/EC2Connection.cancel_reserved_instances_listingcCs~t|D]p\}}d|}|jdk r0|j||d<|jdk rH|j||d<|jdk r`|j||d<|jdk r|j||d<qdS)Nz-ReservedInstancesConfigurationSetItemType.%d.rPlatformrr$)rrplatformrr)r8rLtarget_configurationsoffsetZtcr rHrHrIbuild_configurations_param_lists    z-EC2Connection.build_configurations_param_listcCsVi}|dk r||d<|dk r*|||d|dk r>||||jd|tdd}|jS)a Modifies the specified Reserved Instances. :type client_token: string :param client_token: A unique, case-sensitive, token you provide to ensure idempotency of your modification request. :type reserved_instance_ids: List of strings :param reserved_instance_ids: The IDs of the Reserved Instances to modify. :type target_configurations: List of :class:`boto.ec2.reservedinstance.ReservedInstancesConfiguration` :param target_configurations: The configuration settings for the modified Reserved Instances. :rtype: string :return: The unique ID for the submitted modification request. NrrZModifyReservedInstancesrcrd)rfrrzrZmodification_id)r8rZreserved_instance_idsrrLZmrirrHrHrImodify_reserved_instancess  z'EC2Connection.modify_reserved_instancescCsJi}|r|||d|r"||d<|r2||||jd|dtfgddS)a A request to describe the modifications made to Reserved Instances in your account. :type reserved_instances_modification_ids: list :param reserved_instances_modification_ids: An optional list of Reserved Instances modification IDs to describe. :type next_token: str :param next_token: A string specifying the next paginated set of results to return. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :rtype: list :return: A list of :class:`boto.ec2.reservedinstance.ReservedInstance` ZReservedInstancesModificationIdrZ&DescribeReservedInstancesModificationsrbrcrd)rfr\rgr)r8Z#reserved_instances_modification_idsrrWrLrHrHrI)describe_reserved_instances_modificationss z7EC2Connection.describe_reserved_instances_modificationscCs6i}|||d|rd|d<|jd|dtfgddS)at Enable detailed CloudWatch monitoring for the supplied instances. :type instance_id: list of strings :param instance_id: The instance ids :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.instanceinfo.InstanceInfo` rr_r`ZMonitorInstancesrbrcrdrfrgrrrHrHrImonitor_instances-s zEC2Connection.monitor_instancescCs|j|g|dS)a Deprecated Version, maintained for backward compatibility. Enable detailed CloudWatch monitoring for the supplied instance. :type instance_id: string :param instance_id: The instance id :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.instanceinfo.InstanceInfo` rJ)rr8rrjrHrHrImonitor_instanceAszEC2Connection.monitor_instancecCs6i}|||d|rd|d<|jd|dtfgddS)ai Disable CloudWatch monitoring for the supplied instance. :type instance_id: list of string :param instance_id: The instance id :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.instanceinfo.InstanceInfo` rr_r`ZUnmonitorInstancesrbrcrdrrrHrHrIunmonitor_instancesQs z!EC2Connection.unmonitor_instancescCs|j|g|dS)a Deprecated Version, maintained for backward compatibility. Disable detailed CloudWatch monitoring for the supplied instance. :type instance_id: string :param instance_id: The instance id :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.instanceinfo.InstanceInfo` rJ)rrrHrHrIunmonitor_instanceesz EC2Connection.unmonitor_instancec Cs`||||d}tjdtj|jdg}|j|d<||}||d<|rNd|d<|jd|td d S) a Bundle Windows instance. :type instance_id: string :param instance_id: The instance id :type s3_bucket: string :param s3_bucket: The bucket in which the AMI should be stored. :type s3_prefix: string :param s3_prefix: The beginning of the file name for the AMI. :type s3_upload_policy: string :param s3_upload_policy: Base64 encoded policy that specifies condition and permissions for Amazon EC2 to upload the user's image into Amazon S3. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. )rzStorage.S3.BucketzStorage.S3.PrefixzStorage.S3.UploadPolicyNZs3zStorage.S3.AWSAccessKeyIdz Storage.S3.UploadPolicySignaturer_r`ZBundleInstancercrd) rhauthZget_auth_handlerconfigZproviderr9Z sign_stringrzr!) r8rZ s3_bucketZ s3_prefixZs3_upload_policyrjrLZs3auth signaturerHrHrIbundle_instanceys$   zEC2Connection.bundle_instancecCsJi}|r|||d|r&||||r2d|d<|jd|dtfgddS)a Retrieve current bundling tasks. If no bundle id is specified, all tasks are retrieved. :type bundle_ids: list :param bundle_ids: A list of strings containing identifiers for previously created bundling tasks. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. BundleIdr_r`ZDescribeBundleTasksrbrcrd)rfr\rgr!)r8Z bundle_idsrWrjrLrHrHrIget_all_bundle_taskss z"EC2Connection.get_all_bundle_taskscCs&d|i}|rd|d<|jd|tddS)a Cancel a previously submitted bundle task :type bundle_id: string :param bundle_id: The identifier of the bundle task to cancel. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rr_r`ZCancelBundleTaskrcrd)rzr!)r8Z bundle_idrjrLrHrHrIcancel_bundle_tasks z EC2Connection.cancel_bundle_taskcCs,d|i}|rd|d<|jd|tdd}|jS)aR Get encrypted administrator password for a Windows instance. :type instance_id: string :param instance_id: The identifier of the instance to retrieve the password for. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rr_r`ZGetPasswordDatarcrd)rzrZ passwordData)r8rrjrLrrHrHrIget_password_datas zEC2Connection.get_password_datacCsJi}|r|||d|r&||||r2d|d<|jd|dtfgddS)a Get all placement groups associated with your account in a region. :type groupnames: list :param groupnames: A list of the names of placement groups to retrieve. If not provided, all placement groups will be returned. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.placementgroup.PlacementGroup` rr_r`ZDescribePlacementGroupsrbrcrd)rfr\rgr")r8rrWrjrLrHrHrIget_all_placement_groupss z&EC2Connection.get_all_placement_groupsclustercCs*||d}|rd|d<|jd|dd}|S)aY Create a new placement group for your account. This will create the placement group within the region you are currently connected to. :type name: string :param name: The name of the new placement group :type strategy: string :param strategy: The placement strategy of the new placement group. Currently, the only acceptable value is "cluster". :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: bool :return: True if successful )rZStrategyr_r`ZCreatePlacementGrouprcrdr)r8rMZstrategyrjrLrrHrHrIcreate_placement_groups  z$EC2Connection.create_placement_groupcCs$d|i}|rd|d<|jd|ddS)a Delete a placement group from your account. :type key_name: string :param key_name: The name of the keypair to delete :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rr_r`ZDeletePlacementGrouprcrdr)r8rMrjrLrHrHrIdelete_placement_group's z$EC2Connection.delete_placement_groupcCsNt|}d}|D]4}||}||d|<|dk r@||d|<|d7}qdS)NrOz Tag.%d.Keyz Tag.%d.Value)rdkeys)r8rLrKrrXrrYrHrHrIbuild_tag_param_list9s   z"EC2Connection.build_tag_param_listcCsHi}|r||||r d|d<|dk r0||d<|jd|dtfgddS) a Retrieve all the metadata tags associated with your account. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type max_results: int :param max_results: The maximum number of paginated instance items per response. :rtype: list :return: A list of :class:`boto.ec2.tag.Tag` objects r_r`NrZ DescribeTagsrbrcrd)r\rgr#)r8rWrjrrLrHrHrI get_all_tagsCs zEC2Connection.get_all_tagscCs:i}|||d||||r*d|d<|jd|ddS)a Create new metadata tags for the specified resource ids. :type resource_ids: list :param resource_ids: List of strings :type tags: dict :param tags: A dictionary containing the name/value pairs. If you want to create only a tag name, the value for that tag should be the empty string (e.g. ''). :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. ResourceIdr_r`Z CreateTagsrcrd)rfrrr8Z resource_idsrKrjrLrHrHrI create_tagses  zEC2Connection.create_tagscCsPt|tri|d}i}|||d||||r@d|d<|jd|ddS)a Delete metadata tags for the specified resource ids. :type resource_ids: list :param resource_ids: List of strings :type tags: dict or list :param tags: Either a dictionary containing name/value pairs or a list containing just tag names. If you pass in a dictionary, the values must match the actual tag values or the tag will not be deleted. If you pass in a value of None for the tag value, all tags with that name will be deleted. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. Nrr_r`Z DeleteTagsrcrd)rRrVfromkeysrfrrrrHrHrI delete_tags}s   zEC2Connection.delete_tagscCsJi}|r|||d|r&||||r2d|d<|jd|dtfgddS)a Retrieve all of the Elastic Network Interfaces (ENI's) associated with your account. :type network_interface_ids: list :param network_interface_ids: a list of strings representing ENI IDs :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: list :return: A list of :class:`boto.ec2.networkinterface.NetworkInterface` rr_r`ZDescribeNetworkInterfacesrbrcrd)rfr\rgr')r8Znetwork_interface_idsrWrjrLrHrHrIget_all_network_interfacess z(EC2Connection.get_all_network_interfacesc Csd|i}|r||d<|r ||d<|rbg}|D]&}t|trH||jq,||q,|||d|rnd|d<|jd|tdd S) a Creates a network interface in the specified subnet. :type subnet_id: str :param subnet_id: The ID of the subnet to associate with the network interface. :type private_ip_address: str :param private_ip_address: The private IP address of the network interface. If not supplied, one will be chosen for you. :type description: str :param description: The description of the network interface. :type groups: list :param groups: Lists the groups for use by the network interface. This can be either a list of group ID's or a list of :class:`boto.ec2.securitygroup.SecurityGroup` objects. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.networkinterface.NetworkInterface` :return: The newly created network interface. rrrurr_r`ZCreateNetworkInterfacercrd)rRrrrrfrzr') r8rrr{rrjrLidsrrHrHrIcreate_network_interfaces$  z&EC2Connection.create_network_interfacecCs(|||d}|rd|d<|jd|ddS)aJ Attaches a network interface to an instance. :type network_interface_id: str :param network_interface_id: The ID of the network interface to attach. :type instance_id: str :param instance_id: The ID of the instance that will be attached to the network interface. :type device_index: int :param device_index: The index of the device for the network interface attachment on the instance. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. )rrZ DeviceIndexr_r`ZAttachNetworkInterfacercrdr)r8rrZ device_indexrjrLrHrHrIattach_network_interfacesz&EC2Connection.attach_network_interfacecCs0d|i}|rd|d<|r d|d<|jd|ddS)aZ Detaches a network interface from an instance. :type attachment_id: str :param attachment_id: The ID of the attachment. :type force: bool :param force: Set to true to force a detachment. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. Z AttachmentIdr_rr`ZDetachNetworkInterfacercrdr)r8rrrjrLrHrHrIdetach_network_interfaces z&EC2Connection.detach_network_interfacecCs$d|i}|rd|d<|jd|ddS)a Delete the specified network interface. :type network_interface_id: str :param network_interface_id: The ID of the network interface to delete. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. rr_r`ZDeleteNetworkInterfacercrdr)r8rrjrLrHrHrIdelete_network_interfaces z&EC2Connection.delete_network_interfacecCsi}|jd|dtfgddS)z Get all instance_types available on this cloud (eucalyptus specific) :rtype: list of :class:`boto.ec2.instancetype.InstanceType` :return: The requested InstanceType objects ZDescribeInstanceTypesrbrcrd)rgr$)r8rLrHrHrIget_all_instance_types-sz$EC2Connection.get_all_instance_typesc Cs||d} |dk r|| d<|dk r*|| d<|dk r:|| d<|dk rR|rJdnd| d<|dk rb|| d <|rnd| d <|jd | td d S)z :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :rtype: :class:`boto.ec2.image.CopyImage` :return: Object containing the image_id of the copied image. )rOZ SourceImageIdNrtrurr_rr9r:r`r rcrd)rzr ) r8rPZsource_image_idrMr{rrjr?r@rLrHrHrI copy_image7s$  zEC2Connection.copy_imagecCs>i}|dk r|||d|r&d|d<|jd|dtfgddS) rNZ AttributeNamer_r`ZDescribeAccountAttributesrbrcrd)rfrgr()r8Zattribute_namesrjrLrHrHrIdescribe_account_attributesSsz)EC2Connection.describe_account_attributescCs6d|i}|dk r||d<|r$d|d<|jd|tddS) rrNrr_r`ZDescribeVpcAttributercrd)rzr))r8rrrjrLrHrHrIdescribe_vpc_attributeasz$EC2Connection.describe_vpc_attributecCsTd|i}|dk r |rdnd|d<|dk r8|r0dnd|d<|rDd|d<|jd|d d S) rrNr_rzEnableDnsSupport.ValuezEnableDnsHostnames.Valuer`ZModifyVpcAttributercrdr)r8rZenable_dns_supportZenable_dns_hostnamesrjrLrHrHrImodify_vpc_attributeqs  z"EC2Connection.modify_vpc_attributecCsfi}|r|||d|r&||||r2d|d<|dk rB||d<|rN||d<|jd|dtfgd d S) aG Get all of your linked EC2-Classic instances. This request only returns information about EC2-Classic instances linked to a VPC through ClassicLink :type instance_ids: list :param instance_ids: A list of strings of instance IDs. Must be instances linked to a VPC through ClassicLink. :type filters: dict :param filters: Optional filters that can be used to limit the results returned. Filters are provided in the form of a dictionary consisting of filter names as the key and filter values as the value. The set of allowable filter names/values is dependent on the request being performed. Check the EC2 API guide for details. :type dry_run: bool :param dry_run: Set to True if the operation should not actually run. :type max_results: int :param max_results: The maximum number of paginated instance items per response. :rtype: list :return: A list of :class:`boto.ec2.instance.Instance` rr_r`NrrZDescribeClassicLinkInstancesrbrcrd)rfr\rgr )r8rrWrjrrrLrHrHrIget_all_classic_link_instancess z,EC2Connection.get_all_classic_link_instances)NNTNNNNNNrNNr/NNTN)NNNNF)NNF)NNF)F) NNNNNNNNFNNNF)FF)NFNF)rF)rrNNNF)rF)NNFN)NNFN)NNFNN)NNNNFF)rOrONNNNrNNNFNNFNNNNNNNNNFNF)NF)NFF)NF)F)NF)F)F)NF)F)F)NNF) NNNNNFNNN)rOrNNNNNNNNrNNNFNNNNNNFNF)F)F)F)F)NNF)NNNF)NF)NNNFF)NNNNNFF)NNNNNFF)NNNNNFF)NNF)NNF)NNF)NNF)NNNNF)F)r3F)F)NNNFNF)F)F)NNFF)NNNNF)NF)F)NF)rRrSrTT)rqF)rqrNNF)rqF)NNF)F)F)F)F)NNNF)NF)NNF)NNNNNNF) NNNNNNNNNF)NNNNF)NNNNNNF) NNNNNNNNNF)NNNNF)NNF)NNNNNNNNNNNNNF)NNF)rONF)F)NF)NNN)F)F)F)F)F)NNF)F)F)NNF)rF)F)NFN)F)F)NNF)NNNF)F)FF)F)NNNFNN)NF)NF)NNF)NNFNN)|__name__ __module__ __qualname__rhrrr7r2r3r,rxr6rJrNr\rkrorprsrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr#r'r(r)r*r+r.r/r2r4r6rArBrErFrHrNrrQrprsrtrurwr|r~rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr __classcell__rHrHrFrIr.Is:  .    a $ 1  ,  ) , 4 7 r       ) I B  ) P `     % *  4  0 0  ' % # /    9   - 6   '   )     , * (  ; b ' A Y @ ) z % * G  % *     ( "   $   "   " /        r.)M__doc__rrrrrhZ boto.authrZboto.connectionrZboto.resultsetrZboto.ec2.imagerrr Zboto.ec2.instancer r r r Zboto.ec2.keypairrZboto.ec2.addressrZboto.ec2.volumerrZboto.ec2.snapshotrrZ boto.ec2.zonerZboto.ec2.securitygrouprZboto.ec2.regioninforZboto.ec2.instanceinforZboto.ec2.reservedinstancerrrrrrZboto.ec2.spotinstancerequestrZboto.ec2.spotpricehistoryrZ!boto.ec2.spotdatafeedsubscriptionr Zboto.ec2.bundleinstancer!Zboto.ec2.placementgroupr"Z boto.ec2.tagr#Zboto.ec2.instancetyper$Zboto.ec2.instancestatusr%Zboto.ec2.volumestatusr&Zboto.ec2.networkinterfacer'Zboto.ec2.attributesr(r)Zboto.ec2.blockdevicemappingr*r+Zboto.exceptionr,Z boto.compatr-r.rHrHrHrIsR