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