U W+d@sXddlZddlmZddlmZddlmZddlmZddl m Z GdddeZ dS) N)json)AWSQueryConnection) RegionInfo)JSONResponseError) exceptionsc-seZdZdZdZdZdZdZdZe Z e j e j e je je je je je je je je je je je je je je je je je je j e j!e j"e j#e j$e j%e j&e j'e j(e j)e j*e j+e j,e j-e j.e j/e j0e j1e j2e j3e j4e j5e j6e j7d,Z8fdd Z9d d Z:dAd dZ;dBddZdDddZ?dEddZ@ddZAddZBddZCdd ZDd!d"ZEd#d$ZFd%d&ZGd'd(ZHd)d*ZIdFd+d,ZJdGd-d.ZKdHd/d0ZLdId1d2ZMdJd3d4ZNdKd5d6ZOdLd7d8ZPd9d:ZQdMd;d<ZRdNd=d>ZSd?d@ZTZUS)OCodeDeployConnectiona AWS CodeDeploy **Overview** This is the AWS CodeDeploy API Reference. This guide provides descriptions of the AWS CodeDeploy APIs. For additional information, see the `AWS CodeDeploy User Guide`_. **Using the APIs** You can use the AWS CodeDeploy APIs to work with the following items: + Applications , which are unique identifiers that AWS CodeDeploy uses to ensure that the correct combinations of revisions, deployment configurations, and deployment groups are being referenced during deployments. You can work with applications by calling CreateApplication, DeleteApplication, GetApplication, ListApplications, BatchGetApplications, and UpdateApplication to create, delete, and get information about applications, and to change information about an application, respectively. + Deployment configurations , which are sets of deployment rules and deployment success and failure conditions that AWS CodeDeploy uses during deployments. You can work with deployment configurations by calling CreateDeploymentConfig, DeleteDeploymentConfig, GetDeploymentConfig, and ListDeploymentConfigs to create, delete, and get information about deployment configurations, respectively. + Deployment groups , which represent groups of Amazon EC2 instances to which application revisions can be deployed. You can work with deployment groups by calling CreateDeploymentGroup, DeleteDeploymentGroup, GetDeploymentGroup, ListDeploymentGroups, and UpdateDeploymentGroup to create, delete, and get information about single and multiple deployment groups, and to change information about a deployment group, respectively. + Deployment instances (also known simply as instances ), which represent Amazon EC2 instances to which application revisions are deployed. Deployment instances are identified by their Amazon EC2 tags or Auto Scaling group names. Deployment instances belong to deployment groups. You can work with deployment instances by calling GetDeploymentInstance and ListDeploymentInstances to get information about single and multiple deployment instances, respectively. + Deployments , which represent the process of deploying revisions to deployment groups. You can work with deployments by calling CreateDeployment, GetDeployment, ListDeployments, BatchGetDeployments, and StopDeployment to create and get information about deployments, and to stop a deployment, respectively. + Application revisions (also known simply as revisions ), which are archive files that are stored in Amazon S3 buckets or GitHub repositories. These revisions contain source content (such as source code, web pages, executable files, any deployment scripts, and similar) along with an Application Specification file (AppSpec file). (The AppSpec file is unique to AWS CodeDeploy; it defines a series of deployment actions that you want AWS CodeDeploy to execute.) An application revision is uniquely identified by its Amazon S3 object key and its ETag, version, or both. Application revisions are deployed to deployment groups. You can work with application revisions by calling GetApplicationRevision, ListApplicationRevisions, and RegisterApplicationRevision to get information about application revisions and to inform AWS CodeDeploy about an application revision, respectively. z 2014-10-06z us-east-1z"codedeploy.us-east-1.amazonaws.comZ codedeployZCodeDeploy_20141006),InvalidDeploymentIdException#InvalidDeploymentGroupNameException&DeploymentConfigAlreadyExistsExceptionInvalidRoleExceptionRoleRequiredException%DeploymentGroupAlreadyExistsException&DeploymentConfigLimitExceededExceptionInvalidNextTokenException$InvalidDeploymentConfigNameExceptionInvalidSortByExceptionInstanceDoesNotExistException'InvalidMinimumHealthyHostValueException!ApplicationLimitExceededException ApplicationNameRequiredExceptionInvalidEC2TagExceptionDeploymentDoesNotExistException DeploymentLimitExceededExceptionInvalidInstanceStatusExceptionRevisionRequiredException InvalidBucketNameFilterException%DeploymentGroupLimitExceededException$DeploymentGroupDoesNotExistException%DeploymentConfigNameRequiredException#DeploymentAlreadyCompletedExceptionRevisionDoesNotExistException$DeploymentGroupNameRequiredExceptionDeploymentIdRequiredException%DeploymentConfigDoesNotExistException!BucketNameFilterRequiredExceptionInvalidTimeRangeException ApplicationDoesNotExistExceptionInvalidRevisionExceptionInvalidSortOrderExceptionInvalidOperationException InvalidAutoScalingGroupExceptionInvalidApplicationNameExceptionDescriptionTooLongException!ApplicationAlreadyExistsException#InvalidDeployedStateFilterExceptionDeploymentNotStartedExceptionDeploymentConfigInUseExceptionInstanceIdRequiredExceptionInvalidKeyPrefixFilterException InvalidDeploymentStatusExceptionc sZ|dd}|s t||j|j}d|ks4|ddkr>|j|d<tt|jf|||_dS)Nregionhost) poprDefaultRegionNameDefaultRegionEndpointendpointsuperr__init__r4)selfkwargsr4 __class__:/tmp/pip-unpacked-wheel-dlxw5sjy/boto/codedeploy/layer1.pyr;s  zCodeDeployConnection.__init__cCsdgS)Nzhmac-v4r@)r<r@r@rA_required_auth_capabilitysz.CodeDeployConnection._required_auth_capabilityNcCs(i}|dk r||d<|jdt|dS)z Gets information about one or more applications. :type application_names: list :param application_names: A list of application names, with multiple application names separated by spaces. NZapplicationNamesZBatchGetApplicationsactionbody make_requestrdumps)r<Zapplication_namesparamsr@r@rAbatch_get_applicationss z+CodeDeployConnection.batch_get_applicationscCs(i}|dk r||d<|jdt|dS)z Gets information about one or more deployments. :type deployment_ids: list :param deployment_ids: A list of deployment IDs, with multiple deployment IDs separated by spaces. NZ deploymentIdsZBatchGetDeploymentsrCrF)r<Zdeployment_idsrIr@r@rAbatch_get_deploymentss z*CodeDeployConnection.batch_get_deploymentscCsd|i}|jdt|dS)z Creates a new application. :type application_name: string :param application_name: The name of the application. This name must be unique within the AWS user account. applicationNameZCreateApplicationrCrFr<application_namerIr@r@rAcreate_applications z'CodeDeployConnection.create_applicationcCsld|i}|dk r||d<|dk r(||d<|dk r8||d<|dk rH||d<|dk rX||d<|jdt|d S) a Deploys an application revision to the specified deployment group. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type deployment_group_name: string :param deployment_group_name: The deployment group's name. :type revision: dict :param revision: The type of revision to deploy, along with information about the revision's location. :type deployment_config_name: string :param deployment_config_name: The name of an existing deployment configuration within the AWS user account. If not specified, the value configured in the deployment group will be used as the default. If the deployment group does not have a deployment configuration associated with it, then CodeDeployDefault.OneAtATime will be used by default. :type description: string :param description: A comment about the deployment. :type ignore_application_stop_failures: boolean :param ignore_application_stop_failures: If set to true, then if the deployment causes the ApplicationStop deployment lifecycle event to fail to a specific instance, the deployment will not be considered to have failed to that instance at that point and will continue on to the BeforeInstall deployment lifecycle event. If set to false or not specified, then if the deployment causes the ApplicationStop deployment lifecycle event to fail to a specific instance, the deployment will stop to that instance, and the deployment to that instance will be considered to have failed. rLNdeploymentGroupNamerevisiondeploymentConfigName descriptionZignoreApplicationStopFailuresZCreateDeploymentrCrF)r<rNdeployment_group_namerQdeployment_config_namerSZ ignore_application_stop_failuresrIr@r@rAcreate_deployments*z&CodeDeployConnection.create_deploymentcCs,d|i}|dk r||d<|jdt|dS)a Creates a new deployment configuration. :type deployment_config_name: string :param deployment_config_name: The name of the deployment configuration to create. :type minimum_healthy_hosts: dict :param minimum_healthy_hosts: The minimum number of healthy instances that should be available at any time during the deployment. There are two parameters expected in the input: type and value. The type parameter takes either of the following values: + HOST_COUNT: The value parameter represents the minimum number of healthy instances, as an absolute value. + FLEET_PERCENT: The value parameter represents the minimum number of healthy instances, as a percentage of the total number of instances in the deployment. If you specify FLEET_PERCENT, then at the start of the deployment AWS CodeDeploy converts the percentage to the equivalent number of instances and rounds fractional instances up. The value parameter takes an integer. For example, to set a minimum of 95% healthy instances, specify a type of FLEET_PERCENT and a value of 95. rRNZminimumHealthyHostsZCreateDeploymentConfigrCrF)r<rUZminimum_healthy_hostsrIr@r@rAcreate_deployment_configs z-CodeDeployConnection.create_deployment_configcCs^||d}|dk r||d<|dk r*||d<|dk r:||d<|dk rJ||d<|jdt|dS) a Creates a new deployment group for application revisions to be deployed to. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type deployment_group_name: string :param deployment_group_name: The name of an existing deployment group for the specified application. :type deployment_config_name: string :param deployment_config_name: If specified, the deployment configuration name must be one of the predefined values, or it can be a custom deployment configuration: + CodeDeployDefault.AllAtOnce deploys an application revision to up to all of the Amazon EC2 instances at once. The overall deployment succeeds if the application revision deploys to at least one of the instances. The overall deployment fails after the application revision fails to deploy to all of the instances. For example, for 9 instances, deploy to up to all 9 instances at once. The overall deployment succeeds if any of the 9 instances is successfully deployed to, and it fails if all 9 instances fail to be deployed to. + CodeDeployDefault.HalfAtATime deploys to up to half of the instances at a time (with fractions rounded down). The overall deployment succeeds if the application revision deploys to at least half of the instances (with fractions rounded up); otherwise, the deployment fails. For example, for 9 instances, deploy to up to 4 instances at a time. The overall deployment succeeds if 5 or more instances are successfully deployed to; otherwise, the deployment fails. Note that the deployment may successfully deploy to some instances, even if the overall deployment fails. + CodeDeployDefault.OneAtATime deploys the application revision to only one of the instances at a time. The overall deployment succeeds if the application revision deploys to all of the instances. The overall deployment fails after the application revision first fails to deploy to any one instance. For example, for 9 instances, deploy to one instance at a time. The overall deployment succeeds if all 9 instances are successfully deployed to, and it fails if any of one of the 9 instances fail to be deployed to. Note that the deployment may successfully deploy to some instances, even if the overall deployment fails. This is the default deployment configuration if a configuration isn't specified for either the deployment or the deployment group. To create a custom deployment configuration, call the create deployment configuration operation. :type ec_2_tag_filters: list :param ec_2_tag_filters: The Amazon EC2 tags to filter on. :type auto_scaling_groups: list :param auto_scaling_groups: A list of associated Auto Scaling groups. :type service_role_arn: string :param service_role_arn: A service role ARN that allows AWS CodeDeploy to act on the user's behalf when interacting with AWS services. rLrPNrR ec2TagFiltersautoScalingGroupsserviceRoleArnZCreateDeploymentGrouprCrF)r<rNrTrUec_2_tag_filtersauto_scaling_groupsservice_role_arnrIr@r@rAcreate_deployment_group+sFz,CodeDeployConnection.create_deployment_groupcCsd|i}|jdt|dS)z Deletes an application. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. rLZDeleteApplicationrCrFrMr@r@rAdelete_applications z'CodeDeployConnection.delete_applicationcCsd|i}|jdt|dS)ay Deletes a deployment configuration. A deployment configuration cannot be deleted if it is currently in use. Also, predefined configurations cannot be deleted. :type deployment_config_name: string :param deployment_config_name: The name of an existing deployment configuration within the AWS user account. rRZDeleteDeploymentConfigrCrFr<rUrIr@r@rAdelete_deployment_configs z-CodeDeployConnection.delete_deployment_configcCs||d}|jdt|dS)az Deletes a deployment group. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type deployment_group_name: string :param deployment_group_name: The name of an existing deployment group for the specified application. rXZDeleteDeploymentGrouprCrFr<rNrTrIr@r@rAdelete_deployment_groups z,CodeDeployConnection.delete_deployment_groupcCsd|i}|jdt|dS)z Gets information about an application. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. rLZGetApplicationrCrFrMr@r@rAget_applications z$CodeDeployConnection.get_applicationcCs||d}|jdt|dS)a{ Gets information about an application revision. :type application_name: string :param application_name: The name of the application that corresponds to the revision. :type revision: dict :param revision: Information about the application revision to get, including the revision's type and its location. rLrQZGetApplicationRevisionrCrF)r<rNrQrIr@r@rAget_application_revisions z-CodeDeployConnection.get_application_revisioncCsd|i}|jdt|dS)z Gets information about a deployment. :type deployment_id: string :param deployment_id: An existing deployment ID within the AWS user account. deploymentIdZ GetDeploymentrCrFr< deployment_idrIr@r@rAget_deployments z#CodeDeployConnection.get_deploymentcCsd|i}|jdt|dS)z Gets information about a deployment configuration. :type deployment_config_name: string :param deployment_config_name: The name of an existing deployment configuration within the AWS user account. rRZGetDeploymentConfigrCrFrar@r@rAget_deployment_configs z*CodeDeployConnection.get_deployment_configcCs||d}|jdt|dS)a Gets information about a deployment group. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type deployment_group_name: string :param deployment_group_name: The name of an existing deployment group for the specified application. rXZGetDeploymentGrouprCrFrcr@r@rAget_deployment_groups z)CodeDeployConnection.get_deployment_groupcCs||d}|jdt|dS)a\ Gets information about an Amazon EC2 instance as part of a deployment. :type deployment_id: string :param deployment_id: The unique ID of a deployment. :type instance_id: string :param instance_id: The unique ID of an Amazon EC2 instance in the deployment's deployment group. )rhZ instanceIdZGetDeploymentInstancerCrF)r<rjZ instance_idrIr@r@rAget_deployment_instances z,CodeDeployConnection.get_deployment_instancec Cs|d|i}|dk r||d<|dk r(||d<|dk r8||d<|dk rH||d<|dk rX||d<|dk rh||d<|jd t|d S) a Lists information about revisions for an application. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type sort_by: string :param sort_by: The column name to sort the list results by: + registerTime: Sort the list results by when the revisions were registered with AWS CodeDeploy. + firstUsedTime: Sort the list results by when the revisions were first used by in a deployment. + lastUsedTime: Sort the list results by when the revisions were last used in a deployment. If not specified or set to null, the results will be returned in an arbitrary order. :type sort_order: string :param sort_order: The order to sort the list results by: + ascending: Sort the list results in ascending order. + descending: Sort the list results in descending order. If not specified, the results will be sorted in ascending order. If set to null, the results will be sorted in an arbitrary order. :type s_3_bucket: string :param s_3_bucket: A specific Amazon S3 bucket name to limit the search for revisions. If set to null, then all of the user's buckets will be searched. :type s_3_key_prefix: string :param s_3_key_prefix: A specific key prefix for the set of Amazon S3 objects to limit the search for revisions. :type deployed: string :param deployed: Whether to list revisions based on whether the revision is the target revision of an deployment group: + include: List revisions that are target revisions of a deployment group. + exclude: Do not list revisions that are target revisions of a deployment group. + ignore: List all revisions, regardless of whether they are target revisions of a deployment group. :type next_token: string :param next_token: An identifier that was returned from the previous list application revisions call, which can be used to return the next set of applications in the list. rLNZsortByZ sortOrderZs3BucketZ s3KeyPrefixdeployed nextTokenZListApplicationRevisionsrCrF) r<rNZsort_byZ sort_orderZ s_3_bucketZs_3_key_prefixro next_tokenrIr@r@rAlist_application_revisionss @z/CodeDeployConnection.list_application_revisionscCs(i}|dk r||d<|jdt|dS)a6 Lists the applications registered within the AWS user account. :type next_token: string :param next_token: An identifier that was returned from the previous list applications call, which can be used to return the next set of applications in the list. NrpZListApplicationsrCrFr<rqrIr@r@rAlist_applicationses z&CodeDeployConnection.list_applicationscCs(i}|dk r||d<|jdt|dS)aZ Lists the deployment configurations within the AWS user account. :type next_token: string :param next_token: An identifier that was returned from the previous list deployment configurations call, which can be used to return the next set of deployment configurations in the list. NrpZListDeploymentConfigsrCrFrsr@r@rAlist_deployment_configsus z,CodeDeployConnection.list_deployment_configscCs,d|i}|dk r||d<|jdt|dS)a Lists the deployment groups for an application registered within the AWS user account. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type next_token: string :param next_token: An identifier that was returned from the previous list deployment groups call, which can be used to return the next set of deployment groups in the list. rLNrpZListDeploymentGroupsrCrF)r<rNrqrIr@r@rAlist_deployment_groupss z+CodeDeployConnection.list_deployment_groupscCs<d|i}|dk r||d<|dk r(||d<|jdt|dS)a Lists the Amazon EC2 instances for a deployment within the AWS user account. :type deployment_id: string :param deployment_id: The unique ID of a deployment. :type next_token: string :param next_token: An identifier that was returned from the previous list deployment instances call, which can be used to return the next set of deployment instances in the list. :type instance_status_filter: list :param instance_status_filter: A subset of instances to list, by status: + Pending: Include in the resulting list those instances with pending deployments. + InProgress: Include in the resulting list those instances with in- progress deployments. + Succeeded: Include in the resulting list those instances with succeeded deployments. + Failed: Include in the resulting list those instances with failed deployments. + Skipped: Include in the resulting list those instances with skipped deployments. + Unknown: Include in the resulting list those instances with deployments in an unknown state. rhNrpZinstanceStatusFilterZListDeploymentInstancesrCrF)r<rjrqZinstance_status_filterrIr@r@rAlist_deployment_instancess!z.CodeDeployConnection.list_deployment_instancescCshi}|dk r||d<|dk r$||d<|dk r4||d<|dk rD||d<|dk rT||d<|jdt|dS) a Lists the deployments under a deployment group for an application registered within the AWS user account. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type deployment_group_name: string :param deployment_group_name: The name of an existing deployment group for the specified application. :type include_only_statuses: list :param include_only_statuses: A subset of deployments to list, by status: + Created: Include in the resulting list created deployments. + Queued: Include in the resulting list queued deployments. + In Progress: Include in the resulting list in-progress deployments. + Succeeded: Include in the resulting list succeeded deployments. + Failed: Include in the resulting list failed deployments. + Aborted: Include in the resulting list aborted deployments. :type create_time_range: dict :param create_time_range: A deployment creation start- and end-time range for returning a subset of the list of deployments. :type next_token: string :param next_token: An identifier that was returned from the previous list deployments call, which can be used to return the next set of deployments in the list. NrLrPZincludeOnlyStatusesZcreateTimeRangerpZListDeploymentsrCrF)r<rNrTZinclude_only_statusesZcreate_time_rangerqrIr@r@rAlist_deploymentss%z%CodeDeployConnection.list_deploymentscCs.||d}|dk r||d<|jdt|dS)a Registers with AWS CodeDeploy a revision for the specified application. :type application_name: string :param application_name: The name of an existing AWS CodeDeploy application within the AWS user account. :type description: string :param description: A comment about the revision. :type revision: dict :param revision: Information about the application revision to register, including the revision's type and its location. rfNrSZRegisterApplicationRevisionrCrF)r<rNrQrSrIr@r@rAregister_application_revisionsz2CodeDeployConnection.register_application_revisioncCsd|i}|jdt|dS)z Attempts to stop an ongoing deployment. :type deployment_id: string :param deployment_id: The unique ID of a deployment. rhZStopDeploymentrCrFrir@r@rAstop_deploymentsz$CodeDeployConnection.stop_deploymentcCs8i}|dk r||d<|dk r$||d<|jdt|dS)ab Changes an existing application's name. :type application_name: string :param application_name: The current name of the application that you want to change. :type new_application_name: string :param new_application_name: The new name that you want to change the application to. NrLZnewApplicationNameZUpdateApplicationrCrF)r<rNZnew_application_namerIr@r@rAupdate_applicationsz'CodeDeployConnection.update_applicationc Csn||d}|dk r||d<|dk r*||d<|dk r:||d<|dk rJ||d<|dk rZ||d<|jdt|d S) a Changes information about an existing deployment group. :type application_name: string :param application_name: The application name corresponding to the deployment group to update. :type current_deployment_group_name: string :param current_deployment_group_name: The current name of the existing deployment group. :type new_deployment_group_name: string :param new_deployment_group_name: The new name of the deployment group, if you want to change it. :type deployment_config_name: string :param deployment_config_name: The replacement deployment configuration name to use, if you want to change it. :type ec_2_tag_filters: list :param ec_2_tag_filters: The replacement set of Amazon EC2 tags to filter on, if you want to change them. :type auto_scaling_groups: list :param auto_scaling_groups: The replacement list of Auto Scaling groups to be included in the deployment group, if you want to change them. :type service_role_arn: string :param service_role_arn: A replacement service role's ARN, if you want to change it. )rLZcurrentDeploymentGroupNameNZnewDeploymentGroupNamerRrYrZr[ZUpdateDeploymentGrouprCrF) r<rNZcurrent_deployment_group_nameZnew_deployment_group_namerUr\r]r^rIr@r@rAupdate_deployment_group4s (z,CodeDeployConnection.update_deployment_groupc Csd|j|f|jjdtt|d}|jdddi||d}|j|ddd}|d }t j ||j d kr~|rt |Sn8t |}|d d}|j||j} | |j |j|d dS) Nz%s.%szapplication/x-amz-json-1.1)z X-Amz-TargetHostz Content-TypezContent-LengthPOST/)methodpathZ auth_pathrIheadersdata )ZsenderZoverride_num_retrieszutf-8Z__type)rE) TargetPrefixr4r9strlenZbuild_base_http_requestZ_mexereaddecodebotologdebugstatusrloadsget_faults ResponseErrorreason) r<rDrEr http_requestresponseZ response_bodyZ json_bodyZ fault_nameZexception_classr@r@rArGls6        z!CodeDeployConnection.make_request)N)N)NNNNN)N)NNNN)NNNNNN)N)N)N)NN)NNNNN)N)NN)NNNNN)V__name__ __module__ __qualname____doc__Z APIVersionr7r8Z ServiceNamerrrrrr r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3rr;rBrJrKrOrVrWr_r`rbrdrergrkrlrmrnrrrtrurvrwrxryrzr{r|rG __classcell__r@r@r>rArs=0     9 ' T     P    ) 4    8r) rZ boto.compatrZboto.connectionrZboto.regioninforZboto.exceptionrZboto.codedeployrrr@r@r@rAs