U W+dq@sdZddlZddlZddlZddlmZddlmZmZm Z m Z m Z m Z m Z mZmZmZmZmZddlmZddlmZddlmZddlmZGd d d eZdS) z, Represents a connection to the EMR service N) RegionInfo) AddInstanceGroupsResponseBootstrapActionListClusterClusterSummaryList HadoopStepInstanceGroupList InstanceListJobFlowJobFlowStepListModifyInstanceGroupsResponseRunJobFlowResponseStepSummaryList)JarStep)AWSQueryConnection)EmrResponseError)sixcs~eZdZejdddZejdddZejdddZe Z dZ d Z dPfdd Z ddZddZddZdQddZddZdRddZdSddZdTddZdUd d!ZdVd"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd d d d2d2d3d4d5d5d d gd d d d d d d fd6d7Zd8d9Z d:d;Z!dd?Z#d@dAZ$dBdCZ%dDdEZ&dFdGZ'dHdIZ(dJdKZ)dLdMZ*dNdOZ+Z,S)W EmrConnectionZBotoZ emr_versionz 2009-03-31Zemr_region_namez us-east-1Zemr_region_endpointz(elasticmapreduce.us-east-1.amazonaws.comzHs3://{region_name}.elasticmapreduce/libs/script-runner/script-runner.jarz?s3://{region_name}.elasticmapreduce/libs/state-pusher/0.1/fetchNTr/cs`| st||j|j} | |_tt|j|||||||||jj| | | | ||d|jj|_ d|_ dS)N)validate_certs profile_nameZelasticmapreduce) rDefaultRegionNameDefaultRegionEndpointregionsuperr__init__ZendpointnameZauth_region_nameZauth_service_name)selfZaws_access_key_idZaws_secret_access_keyZ is_secureportproxyZ proxy_portZ proxy_userZ proxy_passdebugZhttps_connection_factoryrpathZsecurity_tokenrr __class__7/tmp/pip-unpacked-wheel-dlxw5sjy/boto/emr/connection.pyr9s.  zEmrConnection.__init__cCsdgS)Nzhmac-v4r$rr$r$r%_required_auth_capabilityTsz'EmrConnection._required_auth_capabilitycCsd|i}|d|tS)z Describes an Elastic MapReduce cluster :type cluster_id: str :param cluster_id: The cluster id of interest ClusterIdZDescribeCluster) get_objectr)r cluster_idparamsr$r$r%describe_clusterWszEmrConnection.describe_clustercCs|j|gd}|r|dSdS)aD This method is deprecated. We recommend you use list_clusters, describe_cluster, list_steps, list_instance_groups and list_bootstrap_actions instead. Describes a single Elastic MapReduce job flow :type jobflow_id: str :param jobflow_id: The job flow id of interest ) jobflow_idsrN)describe_jobflows)r jobflow_idZjobflowsr$r$r%describe_jobflowcs zEmrConnection.describe_jobflowcCshi}|r|||d|r(|||d|r>|tjj|d<|rT|tjj|d<|d|dtfgS)a} This method is deprecated. We recommend you use list_clusters, describe_cluster, list_steps, list_instance_groups and list_bootstrap_actions instead. Retrieve all the Elastic MapReduce job flows on your account :type states: list :param states: A list of strings with job flow states wanted :type jobflow_ids: list :param jobflow_ids: A list of job flow IDs :type created_after: datetime :param created_after: Bound on job flow creation time :type created_before: datetime :param created_before: Bound on job flow creation time zJobFlowStates.memberJobFlowIds.member CreatedAfter CreatedBeforeZDescribeJobFlowsmember)build_list_paramsstrftimebotoutilsISO8601Zget_listr )rZstatesr- created_aftercreated_beforer+r$r$r%r.rszEmrConnection.describe_jobflowscCs||d}|d|tS)z Describe an Elastic MapReduce step :type cluster_id: str :param cluster_id: The cluster id of interest :type step_id: str :param step_id: The step id of interest )r(ZStepIdZ DescribeStep)r)r)rr*Zstep_idr+r$r$r% describe_steps zEmrConnection.describe_stepcCs"d|i}|r||d<|d|tS)z Get a list of bootstrap actions for an Elastic MapReduce cluster :type cluster_id: str :param cluster_id: The cluster id of interest :type marker: str :param marker: Pagination marker r(MarkerZListBootstrapActions)r)rrr*markerr+r$r$r%list_bootstrap_actionss z$EmrConnection.list_bootstrap_actionscCs\i}|r|tjj|d<|r0|tjj|d<|r<||d<|rN|||d|d|tS)a List Elastic MapReduce clusters with optional filtering :type created_after: datetime :param created_after: Bound on cluster creation time :type created_before: datetime :param created_before: Bound on cluster creation time :type cluster_states: list :param cluster_states: Bound on cluster states :type marker: str :param marker: Pagination marker r2r3r=zClusterStates.memberZ ListClusters)r6r7r8r9r5r)r)rr:r;Zcluster_statesr?r+r$r$r% list_clustersszEmrConnection.list_clusterscCs"d|i}|r||d<|d|tS)z List EC2 instance groups in a cluster :type cluster_id: str :param cluster_id: The cluster id of interest :type marker: str :param marker: Pagination marker r(r=ZListInstanceGroups)r)rr>r$r$r%list_instance_groupss z"EmrConnection.list_instance_groupscCs@d|i}|r||d<|r ||d<|r2|||d|d|tS)a List EC2 instances in a cluster :type cluster_id: str :param cluster_id: The cluster id of interest :type instance_group_id: str :param instance_group_id: The EC2 instance group id of interest :type instance_group_types: list :param instance_group_types: Filter by EC2 instance group type :type marker: str :param marker: Pagination marker r(ZInstanceGroupIdr=zInstanceGroupTypes.memberZ ListInstances)r5r)r )rr*Zinstance_group_idZinstance_group_typesr?r+r$r$r%list_instancesszEmrConnection.list_instancescCs4d|i}|r||d<|r&|||d|d|tS)a List cluster steps :type cluster_id: str :param cluster_id: The cluster id of interest :type step_states: list :param step_states: Filter by step states :type marker: str :param marker: Pagination marker r(r=zStepStates.memberZ ListSteps)r5r)r)rr*Z step_statesr?r+r$r$r% list_stepss zEmrConnection.list_stepscCs8t|tjstd|i}||||jd|ddS)a Create new metadata tags for the specified resource id. :type resource_id: str :param resource_id: The cluster id :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. '') or None. ResourceIdZAddTagsPOSTZverb) isinstancer string_typesAssertionErrorupdate_build_tag_list get_statusrZ resource_idtagsr+r$r$r%add_tagss zEmrConnection.add_tagscCs*d|i}||d||jd|ddS)z Remove metadata tags for the specified resource id. :type resource_id: str :param resource_id: The cluster id :type tags: list :param tags: A list of tag names to remove. rEZTagKeysZ RemoveTagsrFrG)rK_build_string_listrMrNr$r$r% remove_tags.s zEmrConnection.remove_tagscCs||gdS)z Terminate an Elastic MapReduce job flow :type jobflow_id: str :param jobflow_id: A jobflow id N)terminate_jobflows)rr/r$r$r%terminate_jobflow>szEmrConnection.terminate_jobflowcCs"i}|||d|jd|ddS)z Terminate an Elastic MapReduce job flow :type jobflow_ids: list :param jobflow_ids: A list of job flow IDs r1ZTerminateJobFlowsrFrG)r5rM)rr-r+r$r$r%rSGsz EmrConnection.terminate_jobflowscsPt|ts|g}i}||d<fdd|D}||jd|tddS)z Adds steps to a jobflow :type jobflow_id: str :param jobflow_id: The job flow id :type steps: list(boto.emr.Step) :param steps: A list of steps to add to the job JobFlowIdcsg|]}|qSr$_build_step_args.0stepr&r$r% asz3EmrConnection.add_jobflow_steps..ZAddJobFlowStepsrFrG)rHlistrK_build_step_listr)r )rr/stepsr+ step_argsr$r&r%add_jobflow_stepsRs zEmrConnection.add_jobflow_stepscCs>t|ts|g}i}||d<||||jd|tddS)aI Adds instance groups to a running cluster. :type jobflow_id: str :param jobflow_id: The id of the jobflow which will take the new instance groups :type instance_groups: list(boto.emr.InstanceGroup) :param instance_groups: A list of instance groups to add to the job rUZAddInstanceGroupsrFrG)rHr\rK_build_instance_group_list_argsr)r)rr/instance_groupsr+r$r$r%add_instance_groupsgs z!EmrConnection.add_instance_groupscCszt|ts|g}t|ts |g}t||}i}t|D]0\}}|d|d|d<|d|d|d<q6|jd|tddS)ah Modify the number of nodes and configuration settings in an instance group. :type instance_group_ids: list(str) :param instance_group_ids: A list of the ID's of the instance groups to be modified :type new_sizes: list(int) :param new_sizes: A list of the new sizes for each instance group rz(InstanceGroups.member.%d.InstanceGroupIdz&InstanceGroups.member.%d.InstanceCountZModifyInstanceGroupsrFrG)rHr\zip enumerater)r )rZinstance_group_idsZ new_sizesrbr+kZigr$r$r%modify_instance_groups{s   z$EmrConnection.modify_instance_groupszm1.smallrdTERMINATE_JOB_FLOWFcs| pg} i}|r||d<|r$||d<||d<||| | }|||sd|||}||n,|}tddt|D}||| rtdddjj j j d j j j j d d }| d || rfd d | D}||| rfdd | D}|||r*||d<|dk r<||d<|rxt|D]*\}}|dkrl||dn|||<qL|dk r|rd|d<nd|d<|dk r||d<|dk r||d<jd|tdd}|jS)a Runs a job flow :type name: str :param name: Name of the job flow :type log_uri: str :param log_uri: URI of the S3 bucket to place logs :type ec2_keyname: str :param ec2_keyname: EC2 key used for the instances :type availability_zone: str :param availability_zone: EC2 availability zone of the cluster :type master_instance_type: str :param master_instance_type: EC2 instance type of the master :type slave_instance_type: str :param slave_instance_type: EC2 instance type of the slave nodes :type num_instances: int :param num_instances: Number of instances in the Hadoop cluster :type action_on_failure: str :param action_on_failure: Action to take if a step terminates :type keep_alive: bool :param keep_alive: Denotes whether the cluster should stay alive upon completion :type enable_debugging: bool :param enable_debugging: Denotes whether AWS console debugging should be enabled. :type hadoop_version: str :param hadoop_version: Version of Hadoop to use. This no longer defaults to '0.20' and now uses the AMI default. :type steps: list(boto.emr.Step) :param steps: List of steps to add with the job :type bootstrap_actions: list(boto.emr.BootstrapAction) :param bootstrap_actions: List of bootstrap actions that run before Hadoop starts. :type instance_groups: list(boto.emr.InstanceGroup) :param instance_groups: Optional list of instance groups to use when creating this job. NB: When provided, this argument supersedes num_instances and master/slave_instance_type. :type ami_version: str :param ami_version: Amazon Machine Image (AMI) version to use for instances. Values accepted by EMR are '1.0', '2.0', and 'latest'; EMR currently defaults to '1.0' if you don't set 'ami_version'. :type additional_info: JSON str :param additional_info: A JSON string for selecting additional features :type api_params: dict :param api_params: a dictionary of additional parameters to pass directly to the EMR API (so you don't have to upgrade boto to use new EMR features). You can also delete an API parameter by setting it to None. :type visible_to_all_users: bool :param visible_to_all_users: Whether the job flow is visible to all IAM users of the AWS account associated with the job flow. If this value is set to ``True``, all IAM users of that AWS account can view and (if they have the proper policy permissions set) manage the job flow. If it is set to ``False``, only the IAM user that created the job flow can view and manage it. :type job_flow_role: str :param job_flow_role: An IAM role for the job flow. The EC2 instances of the job flow assume this role. The default role is ``EMRJobflowDefault``. In order to use the default role, you must have already created it using the CLI. :type service_role: str :param service_role: The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf. :rtype: str :return: The jobflow id ActionOnFailureZLogUriNamecss|]\}}d||fVqdS)z Instances.%sNr$)rYrgvr$r$r% sz,EmrConnection.run_jobflow..zSetup Hadoop DebuggingriN)Z region_name)raction_on_failure main_classjarr_rcsg|]}|qSr$rVrXr&r$r%r[/sz-EmrConnection.run_jobflow..csg|]}|qSr$)_build_bootstrap_action_args)rYbootstrap_actionr&r$r%r[3sZ AmiVersionZAdditionalInfotrueVisibleToAllUsersfalseZ JobFlowRoleZ ServiceRoleZ RunJobFlowrFrG)_build_instance_common_argsrK#_build_instance_count_and_type_argsradictr iteritemsr DebuggingJarformatrr DebuggingArgsinsertr]_build_bootstrap_action_listpopr)r Z jobflowid)rrZlog_uri ec2_keynameavailability_zonemaster_instance_typeslave_instance_type num_instancesrn keep_aliveZenable_debugginghadoop_versionr^bootstrap_actionsrbZadditional_infoZ ami_versionZ api_paramsZvisible_to_all_usersZ job_flow_roleZ service_roler+Z common_paramsZinstance_paramsZ list_argsZdebugging_stepr_Zbootstrap_action_argskeyvalueresponser$r&r% run_jobflows~h            zEmrConnection.run_jobflowcCs@|dks ti}|rdpd|d<|||gd|jd|ddS) a/ Set termination protection on specified Elastic MapReduce job flows :type jobflow_ids: list or str :param jobflow_ids: A list of job flow IDs :type termination_protection_status: bool :param termination_protection_status: Termination protection status TFrsruZTerminationProtectedr1ZSetTerminationProtectionrFrGrJr5rM)rr/Ztermination_protection_statusr+r$r$r%set_termination_protectionSs z(EmrConnection.set_termination_protectioncCs@|dks ti}|rdpd|d<|||gd|jd|ddS) a Set whether specified Elastic Map Reduce job flows are visible to all IAM users :type jobflow_ids: list or str :param jobflow_ids: A list of job flow IDs :type visibility: bool :param visibility: Visibility rrsrurtr1ZSetVisibleToAllUsersrFrGr)rr/Z visibilityr+r$r$r%set_visible_to_all_usersfs z&EmrConnection.set_visible_to_all_userscCsPi}|j|d<z|j|d<Wntk r0YnX|}|rL|||d|S)NzScriptBootstrapAction.Pathrkz!ScriptBootstrapAction.Args.member)r!rAttributeErrorargsr5)rrrZbootstrap_action_paramsrr$r$r%rqxs z*EmrConnection._build_bootstrap_action_argscCsVi}|j|d<||d<|}|r.||d<|}|rH|||d|j|d<|S)NrjzHadoopJarStep.JarzHadoopJarStep.MainClasszHadoopJarStep.Args.memberrk)rnrprorr5r)rrZZ step_paramsrorr$r$r%rWs   zEmrConnection._build_step_argscCsRt|ts|g}i}t|D]0\}}t|D]\}}||d|d|f<q.q|S)NzBootstrapActions.member.%s.%srdrHr\rfrry)rrr+irrrrr$r$r%r~s z*EmrConnection._build_bootstrap_action_listcCsRt|ts|g}i}t|D]0\}}t|D]\}}||d|d|f<q.q|S)NzSteps.member.%s.%srdr)rr^r+rrZrrr$r$r%r]s zEmrConnection._build_step_listcCs>t|ts|g}i}t|D]\}}||d||df<q|S)Nz %s.member.%srd)rHr\rf)rfielditemsr+ritemr$r$r%rQs  z EmrConnection._build_string_listcCsbt|tsti}ttt|ddD]4\}}|\}}d|}||d|<|r(||d|<q(|S)Nrd)startzTags.member.%sz%s.Keyz%s.Value)rHrxrJrfsortedrry)rrOr+r key_valuerrZcurrent_prefixr$r$r%rLs zEmrConnection._build_tag_listcCs8dt|i}|r||d<|r(||d<|r4||d<|S)z Takes a number of parameters used when starting a jobflow (as specified in run_jobflow() above). Returns a comparable dict for use in making a RunJobFlow request. z%Instances.KeepJobFlowAliveWhenNoStepszInstances.HadoopVersionzInstances.Ec2KeyNamez$Instances.Placement.AvailabilityZone)strlower)rrrrrr+r$r$r%rvs z)EmrConnection._build_instance_common_argscCs|||d}|S)z Takes a master instance type (string), a slave instance type (string), and a number of instances. Returns a comparable dict for use in making a RunJobFlow request. )zInstances.MasterInstanceTypezInstances.SlaveInstanceTypezInstances.InstanceCountr$)rrrrr+r$r$r%rws z1EmrConnection._build_instance_count_and_type_argscCs2|j|j|j|j|jd}|jdkr.|j|d<|S)z Takes an InstanceGroup; returns a dict that, when its keys are properly prefixed, can be used for describing InstanceGroups in RunJobFlow or AddInstanceGroups requests. )Z InstanceCountZ InstanceRoleZ InstanceTyperkZMarketZSPOTZBidPrice)rroletyperZmarketZbidprice)rinstance_groupr+r$r$r%_build_instance_group_argss  z(EmrConnection._build_instance_group_argscCs\t|ts|g}i}t|D]:\}}||}t|D]\}}||d|d|f<q8q|S)z Takes a list of InstanceGroups, or a single InstanceGroup. Returns a comparable dict for use in making a RunJobFlow or AddInstanceGroups request. zInstanceGroups.member.%d.%srd)rHr\rfrrry)rrbr+rrZig_dictrrr$r$r%ras  z-EmrConnection._build_instance_group_list_args)NNTNNNNNrNNrNTN)NNNN)N)NNNN)N)NNN)NN)-__name__ __module__ __qualname__r7configgetZ APIVersionrrr ResponseErrorrzr|rr'r,r0r.r<r@rArBrCrDrPrRrTrSr`rcrhrrrrqrWr~r]rQrLrvrwrra __classcell__r$r$r"r%r+s   #        ;     r)__doc__typesr7Z boto.utilsZboto.ec2.regioninforZboto.emr.emrobjectrrrrrrr r r r r rZ boto.emr.steprZboto.connectionrZboto.exceptionrZ boto.compatrrr$r$r$r%s 8