get_pull_request¶

get_pull_request(**kwargs)¶

Gets information about a pull request in a specified repository.

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

Table Of Contents

get_pull_request¶