package google.devtools.sourcerepo.v1

Get desktop application:
View/edit binary Protocol Buffers messages

The Source Repo API service.

• rpc ListRepos (ListReposRequest, ListReposResponse)

  sourcerepo.proto:33

  Returns all repos belonging to a project. The sizes of the repos are not set by ListRepos. To get the size of a repo, use GetRepo.

  message ListReposRequest

  sourcerepo.proto:142

  Request for ListRepos.

  • string name = 1

    The project ID whose repos should be listed. Values are of the form `projects/<project>`.

  • int32 page_size = 2

    Maximum number of repositories to return; between 1 and 500. If not set or zero, defaults to 100 at the server.

  • string page_token = 3

    Resume listing repositories where a prior ListReposResponse left off. This is an opaque token that must be obtained from a recent, prior ListReposResponse's next_page_token field.

  message ListReposResponse

  sourcerepo.proto:158

  Response for ListRepos. The size is not set in the returned repositories.

  • repeated Repo repos = 1

    The listed repos.

  • string next_page_token = 2

    If non-empty, additional repositories exist within the project. These can be retrieved by including this value in the next ListReposRequest's page_token field.

• rpc GetRepo (GetRepoRequest, Repo)

  sourcerepo.proto:40

  Returns information about a repo.

  message GetRepoRequest

  sourcerepo.proto:135

  Request for GetRepo.

  • string name = 1

    The name of the requested repository. Values are of the form `projects/<project>/repos/<repo>`.

• rpc CreateRepo (CreateRepoRequest, Repo)

  sourcerepo.proto:50

  Creates a repo in the given project with the given name. If the named repository already exists, `CreateRepo` returns `ALREADY_EXISTS`.

  message CreateRepoRequest

  sourcerepo.proto:169

  Request for CreateRepo

  • string parent = 1

    The project in which to create the repo. Values are of the form `projects/<project>`.

  • optional Repo repo = 2

    The repo to create. Only name should be set; setting other fields is an error. The project in the name should match the parent field.

• rpc DeleteRepo (DeleteRepoRequest, protobuf.Empty)

  sourcerepo.proto:58

  Deletes a repo.

  message DeleteRepoRequest

  sourcerepo.proto:180

  Request for DeleteRepo.

  • string name = 1

    The name of the repo to delete. Values are of the form `projects/<project>/repos/<repo>`.

• rpc SetIamPolicy (iam.v1.SetIamPolicyRequest, iam.v1.Policy)

  sourcerepo.proto:66

  Sets the access control policy on the specified resource. Replaces any existing policy.

• rpc GetIamPolicy (iam.v1.GetIamPolicyRequest, iam.v1.Policy)

  sourcerepo.proto:77

  Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.

• rpc TestIamPermissions (iam.v1.TestIamPermissionsRequest, iam.v1.TestIamPermissionsResponse)

  sourcerepo.proto:87

  Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a NOT_FOUND error.

Configuration to automatically mirror a repository from another hosting service, for example GitHub or BitBucket.

Used in: Repo

• string url = 1

  URL of the main repository at the other hosting service.

• string webhook_id = 2

  ID of the webhook listening to updates to trigger mirroring. Removing this webhook from the other hosting service will stop Google Cloud Source Repositories from receiving notifications, and thereby disabling mirroring.

• string deploy_key_id = 3

  ID of the SSH deploy key at the other hosting service. Removing this key from the other service would deauthorize Google Cloud Source Repositories from mirroring.

A repository (or repo) is a Git repository storing versioned source content.

Used as response type in: SourceRepo.CreateRepo, SourceRepo.GetRepo

Used as field type in: CreateRepoRequest, ListReposResponse

• string name = 1

  Resource name of the repository, of the form `projects/<project>/repos/<repo>`. The repo name may contain slashes. eg, `projects/myproject/repos/name/with/slash`

• int64 size = 2

  The disk usage of the repo, in bytes. Read-only field. Size is only returned by GetRepo.

• string url = 3

  URL to clone the repository from Google Cloud Source Repositories. Read-only field.

• optional MirrorConfig mirror_config = 4

  How this repository mirrors a repository managed by another service. Read-only field.