CodeCommit / Client / get_pull_request

get_pull_request#

CodeCommit.Client.get_pull_request(**kwargs)#

Gets information about a pull request in a specified repository.

See also: AWS API Documentation

Request Syntax

response = client.get_pull_request(
    pullRequestId='string'
)
Parameters:

pullRequestId (string) –

[REQUIRED]

The system-generated ID of the pull request. To get this ID, use ListPullRequests.

Return type:

dict

Returns:

Response Syntax

{
    'pullRequest': {
        'pullRequestId': 'string',
        'title': 'string',
        'description': 'string',
        'lastActivityDate': datetime(2015, 1, 1),
        'creationDate': datetime(2015, 1, 1),
        'pullRequestStatus': 'OPEN'|'CLOSED',
        'authorArn': 'string',
        'pullRequestTargets': [
            {
                'repositoryName': 'string',
                'sourceReference': 'string',
                'destinationReference': 'string',
                'destinationCommit': 'string',
                'sourceCommit': 'string',
                'mergeBase': 'string',
                'mergeMetadata': {
                    'isMerged': True|False,
                    'mergedBy': 'string',
                    'mergeCommitId': 'string',
                    'mergeOption': 'FAST_FORWARD_MERGE'|'SQUASH_MERGE'|'THREE_WAY_MERGE'
                }
            },
        ],
        'clientRequestToken': 'string',
        'revisionId': 'string',
        'approvalRules': [
            {
                'approvalRuleId': 'string',
                'approvalRuleName': 'string',
                'approvalRuleContent': 'string',
                'ruleContentSha256': 'string',
                'lastModifiedDate': datetime(2015, 1, 1),
                'creationDate': datetime(2015, 1, 1),
                'lastModifiedUser': 'string',
                'originApprovalRuleTemplate': {
                    'approvalRuleTemplateId': 'string',
                    'approvalRuleTemplateName': 'string'
                }
            },
        ]
    }
}

Response Structure

  • (dict) –

    • pullRequest (dict) –

      Information about the specified pull request.

      • pullRequestId (string) –

        The system-generated ID of the pull request.

      • title (string) –

        The user-defined title of the pull request. This title is displayed in the list of pull requests to other repository users.

      • description (string) –

        The user-defined description of the pull request. This description can be used to clarify what should be reviewed and other details of the request.

      • lastActivityDate (datetime) –

        The day and time of the last user or system activity on the pull request, in timestamp format.

      • creationDate (datetime) –

        The date and time the pull request was originally created, in timestamp format.

      • pullRequestStatus (string) –

        The status of the pull request. Pull request status can only change from OPEN to CLOSED.

      • authorArn (string) –

        The Amazon Resource Name (ARN) of the user who created the pull request.

      • pullRequestTargets (list) –

        The targets of the pull request, including the source branch and destination branch for the pull request.

        • (dict) –

          Returns information about a pull request target.

          • repositoryName (string) –

            The name of the repository that contains the pull request source and destination branches.

          • sourceReference (string) –

            The branch of the repository that contains the changes for the pull request. Also known as the source branch.

          • destinationReference (string) –

            The branch of the repository where the pull request changes are merged. Also known as the destination branch.

          • destinationCommit (string) –

            The full commit ID that is the tip of the destination branch. This is the commit where the pull request was or will be merged.

          • sourceCommit (string) –

            The full commit ID of the tip of the source branch used to create the pull request. If the pull request branch is updated by a push while the pull request is open, the commit ID changes to reflect the new tip of the branch.

          • mergeBase (string) –

            The commit ID of the most recent commit that the source branch and the destination branch have in common.

          • mergeMetadata (dict) –

            Returns metadata about the state of the merge, including whether the merge has been made.

            • isMerged (boolean) –

              A Boolean value indicating whether the merge has been made.

            • mergedBy (string) –

              The Amazon Resource Name (ARN) of the user who merged the branches.

            • mergeCommitId (string) –

              The commit ID for the merge commit, if any.

            • mergeOption (string) –

              The merge strategy used in the merge.

      • clientRequestToken (string) –

        A unique, client-generated idempotency token that, when provided in a request, ensures the request cannot be repeated with a changed parameter. If a request is received with the same parameters and a token is included, the request returns information about the initial request that used that token.

      • revisionId (string) –

        The system-generated revision ID for the pull request.

      • approvalRules (list) –

        The approval rules applied to the pull request.

        • (dict) –

          Returns information about an approval rule.

          • approvalRuleId (string) –

            The system-generated ID of the approval rule.

          • approvalRuleName (string) –

            The name of the approval rule.

          • approvalRuleContent (string) –

            The content of the approval rule.

          • ruleContentSha256 (string) –

            The SHA-256 hash signature for the content of the approval rule.

          • lastModifiedDate (datetime) –

            The date the approval rule was most recently changed, in timestamp format.

          • creationDate (datetime) –

            The date the approval rule was created, in timestamp format.

          • lastModifiedUser (string) –

            The Amazon Resource Name (ARN) of the user who made the most recent changes to the approval rule.

          • originApprovalRuleTemplate (dict) –

            The approval rule template used to create the rule.

            • approvalRuleTemplateId (string) –

              The ID of the template that created the approval rule.

            • approvalRuleTemplateName (string) –

              The name of the template that created the approval rule.

Exceptions

  • CodeCommit.Client.exceptions.PullRequestDoesNotExistException

  • CodeCommit.Client.exceptions.InvalidPullRequestIdException

  • CodeCommit.Client.exceptions.PullRequestIdRequiredException

  • CodeCommit.Client.exceptions.EncryptionIntegrityChecksFailedException

  • CodeCommit.Client.exceptions.EncryptionKeyAccessDeniedException

  • CodeCommit.Client.exceptions.EncryptionKeyDisabledException

  • CodeCommit.Client.exceptions.EncryptionKeyNotFoundException

  • CodeCommit.Client.exceptions.EncryptionKeyUnavailableException