List and view repositories

This document outlines how to search for and view Secure Source Manager repositories by full or partial repository ID.

Required roles

To get the permissions that you need to search repositories, ask your administrator to grant you the following IAM roles:

For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

For information on granting Secure Source Manager roles, see Access control with IAM and Grant users instance access.

List repositories

web interface

To access the Secure Source Manager instance through its web interface, copy the following URL into your browser address bar.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Replace the following:

  • INSTANCE_ID with the instance name.
  • PROJECT_NUMBER with the instance's Google Cloud project number. For information on identifying projects, see Identifying projects.
  • LOCATION with the instance's region.

The My repositories tab displays all repositories you have access to view.

API

To list details for all repositories in a given region for your instance, use the following HTTP method and URL.

Before using any of the request data, make the following replacements:

  • PROJECT_ID: the project ID of the Google Cloud project where Secure Source Manager is running.
  • INSTANCE_ID: the instance ID.
  • LOCATION: the region where your instance is located. For information on supported locations, see Locations.

HTTP method and URL: 

GET https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID

To send your request, expand one of these options:

You should receive a JSON response similar to the following:

{
    "repositories" : [
          {
            "createTime" : "2023-08-09T19:32:15Z",
            "instance" : "projects/012345678901/locations/us-central1/instances/my-instance",
            "name" : "projects/my-project/locations/us-central1/repositories/my-repo",
            "uris" : {
                "api" : "https://my-instance-012345678901-api.us-central1.sourcemanager.dev/v1/projects/my-project/locations/us-central1/repositories/my-repo",
                "gitHttps" : "https://my-instance-012345678901-git.us-central1.sourcemanager.dev/my-project/my-repo.git",
                "html" : "https://my-instance-012345678901.us-central1.sourcemanager.dev/my-project/my-repo"
            }
          }
    ]
}

View details for a specific repository

To list details for a single repository, use the following HTTP method and URL.

Before using any of the request data, make the following replacements:

  • PROJECT_ID: the project ID of the Google Cloud project where Secure Source Manager is running.
  • LOCATION: the region where your instance is located. For information on supported locations, see Locations.
  • REPOSITORY_ID: the repository ID.

HTTP method and URL: 

GET https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

To send your request, expand one of these options:

You should receive a JSON response similar to the following:

    {
      "createTime" : "2023-08-09T19:32:15Z",
      "instance" : "projects/012345678901/locations/us-central1/instances/my-instance",
      "name" : "projects/my-project/locations/us-central1/repositories/my-repo",
      "uris" : {
          "api" : "https://my-instance-012345678901-api.us-central1.sourcemanager.dev/v1/projects/my-project/locations/us-central1/repositories/my-repo",
          "gitHttps" : "https://my-instance-012345678901-git.us-central1.sourcemanager.dev/my-project/my-repo.git",
          "html" : "https://my-instance-012345678901.us-central1.sourcemanager.dev/my-project/my-repo"
      }
    }

View repositories in the web interface

You can search for repositories within the My repositories tab by keyword.

  1. In the Secure Source Manager web interface, enter your search keyword in the Search repository names search bar.

    The search results include all repositories that include your keyword in their repository ID.

  2. Select the repository you want to view.

    The repository page opens.

What's next