Pacote google.devtools.sourcerepo.v1

Índice

SourceRepo

O serviço Source Repo API.

CreateRepo

rpc CreateRepo (CreateRepoRequest) retorna (Repo)

Cria um repositório no projeto especificado com o nome especificado.

Se o repositório nomeado já existir, CreateRepo retornará ALREADY_EXISTS.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

DeleteRepo

rpc DeleteRepo(DeleteRepoRequest) retorna (Empty)

Exclui um repositório.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

GetIamPolicy

rpc GetIamPolicy(GetIamPolicyRequest) retorna (Policy)

Busca a política de controle de acesso de um recurso. Retornará uma política vazia se o recurso estiver presente e não tiver um conjunto de políticas.

Escopos da autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

GetProjectConfig

rpc GetProjectConfig(GetProjectConfigRequest) retorna (ProjectConfig)

Retorna a configuração do Cloud Source Repositories do projeto.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

GetRepo

rpc GetRepo(GetRepoRequest) retorna (Repo)

Retorna informações sobre um repositório.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

ListRepos

rpc ListRepos(ListReposRequest) retorna (ListReposResponse)

Retorna todos os repositórios que pertencem a um projeto. Os tamanhos dos repositórios não são definidos por ListRepos. Para saber o tamanho de um repositório, use GetRepo.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte a Visão geral da autenticação.

SetIamPolicy

rpc SetIamPolicy(SetIamPolicyRequest) retorna (Policy)

Define a política de controle de acesso no recurso especificado. Substitui qualquer política existente.

Escopos da autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte a Visão geral da autenticação.

TestIamPermissions

rpc TestIamPermissions(TestIamPermissionsRequest) retorna (TestIamPermissionsResponse)

Retorna permissões do autor da chamada no recurso especificado. Se o recurso não estiver presente, isso retornará um conjunto vazio de permissões, não um erro NOT_FOUND.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

UpdateProjectConfig

rpc UpdateProjectConfig(UpdateProjectConfigRequest) retorna (ProjectConfig)

Atualiza a configuração do Cloud Source Repositories do projeto.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

UpdateRepo

rpc UpdateRepo(UpdateRepoRequest) retorna (Repo)

Atualiza as informações sobre um repositório.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.

CreateRepoRequest

Solicitação para CreateRepo

Campos
parent

string

O projeto em que o repositório será criado. Os valores são no formato projects/<project>.

A autorização requer a seguinte permissão do Google IAM no recurso parent especificado:

  • source.repos.create

repo

Repo

O repositório a ser criado. Defina somente o nome. Definir outros campos resultará em um erro. O projeto no nome precisa corresponder ao campo pai.

DeleteRepoRequest

Solicitação para DeleteRepo.

Campos
name

string

O nome do repositório a ser excluído. Os valores são no formato projects/<project>/repos/<repo>.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • source.repos.delete

GetProjectConfigRequest

Solicitação para GetProjectConfig.

Campos
name

string

O nome do projeto solicitado. Os valores são no formato projects/<project>.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • source.repos.getProjectConfig

GetRepoRequest

Solicitação para GetRepo.

Campos
name

string

O nome do repositório solicitado. Os valores são no formato projects/<project>/repos/<repo>.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • source.repos.get

ListReposRequest

Solicitação para ListRepos.

Campos
name

string

O project ID cujos repositórios precisam ser listados. Os valores são no formato projects/<project>.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • source.repos.list

page_size

int32

Número máximo de repositórios para retornar: entre 1 e 500. Se não definido ou zero, o padrão é 100 no servidor.

page_token

string

Retomar os repositórios de listagem de onde um ListReposResponse anterior parou. Este é um token opaco que precisa ser obtido a partir de um campo next_page_token recente do ListReposResponse anterior.

ListReposResponse

Resposta para ListRepos. O tamanho não está definido nos repositórios retornados.

Campos
repos[]

Repo

Os repositórios listados.

next_page_token

string

Se não estiver vazio, existem repositórios adicionais dentro do projeto. Esses repositórios podem ser recuperados com a inclusão desse valor no próximo campo page_token de ListReposRequest.

MirrorConfig

Configuração para espelhar automaticamente um repositório de outro serviço de hospedagem como, por exemplo, GitHub ou Bitbucket.

Campos
url

string

URL do repositório principal no outro serviço de hospedagem.

webhook_id

string

Código do webhook que detecta atualizações para acionar o espelhamento. A remoção desse webhook do outro serviço de hospedagem fará que o Google Cloud Source Repositories pare de receber notificações. Assim, o espelhamento será desativado.

deploy_key_id

string

Código da chave de implantação SSH no outro serviço de hospedagem. A remoção dessa chave do outro serviço desautoriza o espelhamento pelo Google Cloud Source Repositories.

ProjectConfig

Configuração do Cloud Source Repositories do projeto.

Campos
name

string

O nome do projeto. Os valores são no formato projects/<project>.

pubsub_configs

map<string, PubsubConfig>

Como o projeto publica uma alteração nos repositórios por meio do Cloud Pub/Sub. Codificado pelos nomes dos tópicos.

enable_private_key_check

bool

Rejeita um comando “git push” que contém uma chave privada.

PubsubConfig

Configuração para publicar uma mensagem do Cloud Pub/Sub.

Campos
topic

string

Um tópico do Cloud Pub/Sub. Os valores são no formato projects/<project>/topics/<topic>. O projeto precisa ser o mesmo em que esta configuração está.

message_format

MessageFormat

O formato das mensagens do Cloud Pub/Sub.

service_account_email

string

Endereço de e-mail da conta de serviço usada para publicar mensagens do Cloud Pub/Sub. Essa conta de serviço precisa estar no mesmo projeto em que PubsubConfig está. Quando adicionado, o autor da chamada precisa ter a permissão iam.serviceAccounts.actAs na conta de serviço. Se não for especificado, a conta de serviço padrão do Compute Engine será usada.

MessageFormat

O formato das mensagens do Cloud Pub/Sub.

Enumerações
MESSAGE_FORMAT_UNSPECIFIED Não especificado.
PROTOBUF O payload da mensagem é um protocol buffer serializado de SourceRepoEvent.
JSON O payload da mensagem é uma string JSON de SourceRepoEvent.

Repo

Um repositório (ou repo) é um repositório Git que armazena conteúdo de código-fonte com controle de versões.

Campos
name

string

Nome do recurso do repositório, no formato projects/<project>/repos/<repo>. O nome do repositório pode conter barras, por exemplo, projects/myproject/repos/name/with/slash.

size

int64

O uso de disco do repositório, em bytes. Campo somente leitura. O tamanho só é retornado pelo GetRepo.

url

string

URL para clonar o repositório do Google Cloud Source Repositories. Campo somente leitura.

mirror_config

MirrorConfig

Como esse repositório espelha um repositório gerenciado por outro serviço. Campo somente leitura.

pubsub_configs

map<string, PubsubConfig>

Como este repositório publica uma alteração no repositório por meio do Cloud Pub/Sub. Codificado pelos nomes dos tópicos.

UpdateProjectConfigRequest

Solicitação de UpdateProjectConfig.

Campos
name

string

O nome do projeto solicitado. Os valores são no formato projects/<project>.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • source.repos.updateProjectConfig

project_config

ProjectConfig

A nova configuração do projeto.

update_mask

FieldMask

Uma FieldMask especificando os campos de project_config a serem modificados. Somente os campos da máscara serão modificados. Se nenhuma máscara for fornecida, essa solicitação será autônoma.

UpdateRepoRequest

Solicitação de UpdateRepo.

Campos
name

string

O nome do repositório solicitado. Os valores são no formato projects/<project>/repos/<repo>.

A autorização requer a seguinte permissão do Google IAM no recurso name especificado:

  • source.repos.updateRepoConfig

repo

Repo

A nova configuração do repositório.

update_mask

FieldMask

Uma FieldMask especificando os campos do repositório a serem modificados. Somente os campos da máscara serão modificados. Se nenhuma máscara for fornecida, essa solicitação será autônoma.