Skip to main content

Get integrated VCS repositories metadata

Prisma Cloud Code Security’s Projects table enables you to view your integrated VCS repository snapshots. With Projects, you can analyze your repository usage rate according to various parameters, such as weekly commits and Git users who have merged their commits into the default branch in a set period of time. This data can help you understand which of your repositories are used most, and which have the highest risk of deploying a misconfigured or vulnerable code.

The response includes the following data for each VCS repository:

  • Repository: the Git repository to which the scanned item belongs
  • Organization: the Git organization to which the repository belongs and its VCS type
  • SourceType: Which VCS the Git repository is hosted on
  • currentWeekCommits: the total number of commits from the latest week that were merged into the default branch. If no records are available from the past week, the currentWeekCommits value will be -1.
  • prevWeekCommits: the total number of commits from previous week that were merged into the default branch. If no records are available from the past week, the prevWeekCommits value will be -1.
  • gitUsers: how many Git users have merged their commits into the default branch over the past 90 days. If no records are available from the past week, the gitUsers value will be 1.
  • failedPrs: the number of failed open PRs out of all open PRs based on Prisma Cloud Code Security's findings and Enforcement settings. For more information, see Enforcement. If no records are available from the past week, the failedPrs value will be 1.
  • totalPrs: the number of open PRs evaluated by Prisma Cloud Code Security’s VCS app. If no records are available from the past week, the totalPrs value will be 1.
  • pendingFixPrs: the number of open PRs created by Prisma Cloud Code Security/Prisma Cloud after being submitted by users within the platform. These are yet to be merged into the default branch. If no records are available from the past week, the pendingFixPrs value will be 1.
  • latestPR: { title: PR name number: PR id lastScanDate: time and date of the latest PR scan }
Query Parameters
  • page double required
    • (the index of the results page) Type: number Default value: 0
  • sortBy string

    Possible values: [weeklyCommits, usersCount, failedPrs, pendingFixPrs, scanTime, repository, organization]

    • (The column name by which to sort the results) Type: ['weeklyCommits' | 'usersCount' | 'failedPrs' | 'pendingFixPrs' | 'scanTime'| 'repository' | 'organization'] Default value - null (the results will be sorted by ‘usersCount’ by default)
  • sortDir string

    Possible values: [ASC, DESC]

  • search string
    • (search for code reviews of specific repositories) Type: string Default value - null
  • pageSize double
    • (results number to get) Type: number Default value: 1000
  • withTotal boolean
    • (get the number of the total results or not) Type: boolean Default value: false
Responses

Get projects PRs data for customer


Schema
  • data object[] required
  • Array [
  • currentWeekCommits double required
  • failedPrs double required
  • gitUsers double required
  • latestPR object required
  • enforcementRule object
  • IAC object required
  • commentsBotThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • hardFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • softFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • IMAGES object required
  • commentsBotThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • hardFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • softFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • OPEN_SOURCE object required
  • commentsBotThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • hardFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • softFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • SECRETS object required
  • commentsBotThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • hardFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • softFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • SUPPLY_CHAIN object required
  • commentsBotThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • hardFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • softFailThreshold RuleThreshold required

    Possible values: [OFF, INFO, LOW, MEDIUM, HIGH, CRITICAL]

  • fromBranch string
  • intoBranch string
  • lastScanDate date-time
  • prNumber string required
  • title string required
  • organization string required
  • pendingFixPrs double required
  • prevWeekCommits double required
  • repository string required
  • runId double required
  • sourceType SourceType required

    Possible values: [Github, Bitbucket, Gitlab, AzureRepos, cli, AWS, Azure, GCP, Docker, githubEnterprise, gitlabEnterprise, bitbucketEnterprise, terraformCloud, githubActions, circleci, codebuild, jenkins, tfcRunTasks, admissionController, terraformEnterprise]

  • totalPrs double required
  • ]
  • hasNext boolean required
Loading...