Skip to content

Returns information about one or more pull request events

Description

Returns information about one or more pull request events.

Usage

codecommit_describe_pull_request_events(pullRequestId,
  pullRequestEventType, actorArn, nextToken, maxResults)

Arguments

  • pullRequestId

    [required] The system-generated ID of the pull request. To get this ID, use list_pull_requests.

  • pullRequestEventType

    Optional. The pull request event type about which you want to return information.

  • actorArn

    The Amazon Resource Name (ARN) of the user whose actions resulted in the event. Examples include updating the pull request with more commits or changing the status of a pull request.

  • nextToken

    An enumeration token that, when provided in a request, returns the next batch of the results.

  • maxResults

    A non-zero, non-negative integer used to limit the number of returned results. The default is 100 events, which is also the maximum number of events that can be returned in a result.

Value

A list with the following syntax:

list(
  pullRequestEvents = list(
    list(
      pullRequestId = "string",
      eventDate = as.POSIXct(
        "2015-01-01"
      ),
      pullRequestEventType = "PULL_REQUEST_CREATED"|"PULL_REQUEST_STATUS_CHANGED"|"PULL_REQUEST_SOURCE_REFERENCE_UPDATED"|"PULL_REQUEST_MERGE_STATE_CHANGED"|"PULL_REQUEST_APPROVAL_RULE_CREATED"|"PULL_REQUEST_APPROVAL_RULE_UPDATED"|"PULL_REQUEST_APPROVAL_RULE_DELETED"|"PULL_REQUEST_APPROVAL_RULE_OVERRIDDEN"|"PULL_REQUEST_APPROVAL_STATE_CHANGED",
      actorArn = "string",
      pullRequestCreatedEventMetadata = list(
        repositoryName = "string",
        sourceCommitId = "string",
        destinationCommitId = "string",
        mergeBase = "string"
      ),
      pullRequestStatusChangedEventMetadata = list(
        pullRequestStatus = "OPEN"|"CLOSED"
      ),
      pullRequestSourceReferenceUpdatedEventMetadata = list(
        repositoryName = "string",
        beforeCommitId = "string",
        afterCommitId = "string",
        mergeBase = "string"
      ),
      pullRequestMergedStateChangedEventMetadata = list(
        repositoryName = "string",
        destinationReference = "string",
        mergeMetadata = list(
          isMerged = TRUE|FALSE,
          mergedBy = "string",
          mergeCommitId = "string",
          mergeOption = "FAST_FORWARD_MERGE"|"SQUASH_MERGE"|"THREE_WAY_MERGE"
        )
      ),
      approvalRuleEventMetadata = list(
        approvalRuleName = "string",
        approvalRuleId = "string",
        approvalRuleContent = "string"
      ),
      approvalStateChangedEventMetadata = list(
        revisionId = "string",
        approvalStatus = "APPROVE"|"REVOKE"
      ),
      approvalRuleOverriddenEventMetadata = list(
        revisionId = "string",
        overrideStatus = "OVERRIDE"|"REVOKE"
      )
    )
  ),
  nextToken = "string"
)

Request syntax

svc$describe_pull_request_events(
  pullRequestId = "string",
  pullRequestEventType = "PULL_REQUEST_CREATED"|"PULL_REQUEST_STATUS_CHANGED"|"PULL_REQUEST_SOURCE_REFERENCE_UPDATED"|"PULL_REQUEST_MERGE_STATE_CHANGED"|"PULL_REQUEST_APPROVAL_RULE_CREATED"|"PULL_REQUEST_APPROVAL_RULE_UPDATED"|"PULL_REQUEST_APPROVAL_RULE_DELETED"|"PULL_REQUEST_APPROVAL_RULE_OVERRIDDEN"|"PULL_REQUEST_APPROVAL_STATE_CHANGED",
  actorArn = "string",
  nextToken = "string",
  maxResults = 123
)