Paket google.devtools.sourcerepo.v1

Index

SourceRepo

Der Source Repo API-Dienst.

CreateRepo

rpc CreateRepo ( CreateRepoRequest ) gibt ( Repo ) zurück

Erstellt ein Repository im angegebenen Projekt mit dem angegebenen Namen.

Wenn das benannte Repository bereits vorhanden ist, gibt CreateRepo den Wert ALREADY_EXISTS zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
DeleteRepo

rpc DeleteRepo ( DeleteRepoRequest ) gibt zurück ( Empty )

Löscht ein Repository.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
GetIamPolicy

rpc GetIamPolicy ( GetIamPolicyRequest ) gibt zurück ( Policy )

Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab. Gibt eine leere Richtlinie zurück, wenn die Ressource vorhanden und keine Richtlinie festgelegt ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
GetProjectConfig

rpc GetProjectConfig ( GetProjectConfigRequest ) gibt zurück ( ProjectConfig )

Gibt die Cloud Source Repositories-Konfiguration des Projekts zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
GetRepo

rpc GetRepo ( GetRepoRequest ) gibt ( Repo ) zurück

Gibt Informationen über ein Repository zurück.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
ListRepos

rpc ListRepos ( ListReposRequest ) gibt zurück ( ListReposResponse )

Gibt alle Repositories eines Projekts zurück. Die Größe der Repositories wird nicht von ListRepos festgelegt. Zum Abrufen der Größe eines Repositorys verwenden Sie GetRepo.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
SetIamPolicy

rpc SetIamPolicy ( SetIamPolicyRequest ) gibt zurück ( Policy )

Legt die Zugriffssteuerungsrichtlinie für die angegebene Ressource fest. Ersetzt jede vorhandene Richtlinie.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
TestIamPermissions

rpc TestIamPermissions ( TestIamPermissionsRequest ) gibt zurück ( TestIamPermissionsResponse )

Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück. Ist die Ressource nicht vorhanden, wird ein leerer Berechtigungssatz zurückgegeben, kein NOT_FOUND-Fehler.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
UpdateProjectConfig

rpc UpdateProjectConfig ( UpdateProjectConfigRequest ) gibt zurück ( ProjectConfig )

Aktualisiert die Cloud Source Repositories-Konfiguration des Projekts.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.
UpdateRepo

rpc UpdateRepo ( UpdateRepoRequest ) gibt ( Repo ) zurück

Aktualisiert Informationen zu einem Repository.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

CreateRepoRequest

Anfrage für CreateRepo.

Felder
parent

string

Das Projekt, in dem das Repository erstellt werden soll. Werte haben das Format projects/<project>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • source.repos.create
repo

Repo

Das Repository, das erstellt werden soll. Es darf nur der Name festgelegt werden. Bei Eingaben in andere Felder wird ein Fehler angezeigt. Das Projekt im Namen muss mit dem übergeordneten Feld übereinstimmen.

DeleteRepoRequest

Anfrage für DeleteRepo.

Felder
name

string

Der Name des Repositorys, das gelöscht werden soll. Werte haben das Format projects/<project>/repos/<repo>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • source.repos.delete

GetProjectConfigRequest

Anfrage für GetProjectConfig.

Felder
name

string

Der Name des angeforderten Projekts. Werte haben das Format projects/<project>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • source.repos.getProjectConfig

GetRepoRequest

Anfrage für GetRepo.

Felder
name

string

Der Name des angefragten Repositorys. Werte haben das Format projects/<project>/repos/<repo>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • source.repos.get

ListReposRequest

Anfrage für ListRepos.

Felder
name

string

Die ID des Projekts, dessen Repositories aufgeführt werden sollen. Werte haben das Format projects/<project>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • source.repos.list
page_size

int32

Maximale Anzahl von Repositories, die zurückgegeben werden können (von 1 bis 500). Wenn kein Wert oder null festgelegt ist, gilt für den Server standardmäßig der Wert 100.

page_token

string

Setzt das Auflisten von Repositories fort, nachdem ListReposResponse zuvor unterbrochen wurde. Dies ist ein verdecktes Token, das vom Feld next_page_token eines aktuellen, zuvor ausgeführten ListReposResponse abgerufen werden muss.

ListReposResponse

Antwort für ListRepos. Die Größe ist in den zurückgegebenen Repositories nicht festgelegt.

Felder
repos[]

Repo

Die aufgeführten Repositories.

next_page_token

string

Wenn das Feld nicht leer ist, sind zusätzliche Repositories im Projekt vorhanden. Diese können durch Aufnahme dieses Wertes in das nächste page_token-Feld von ListReposRequest abgerufen werden.

MirrorConfig

Konfiguration des automatischen Spiegelns eines Repositorys von einem anderen Hostingdienst, z. B. GitHub oder BitBucket.

Felder
url

string

URL des Haupt-Repositorys beim anderen Hostingdienst.

webhook_id

string

ID des Webhook, der auf Aktualisierungen zum Auslösen einer Spiegelung prüft. Wenn Sie diesen Webhook aus dem anderen Hostingdienst entfernen, erhalten Google Cloud Source Repositories keine Benachrichtigungen mehr, wodurch die Spiegelung deaktiviert wird.

deploy_key_id

string

ID des SSH-Bereitstellungsschlüssels beim anderen Hostingdienst. Wenn Sie diesen Schlüssel aus dem anderen Dienst entfernen, wird die Autorisierung der Google Cloud Source Repositories für die Spiegelung aufgehoben.

ProjectConfig

Cloud Source Repositories-Konfiguration eines Projekts.

Felder
name

string

Name des Projekts. Werte haben das Format projects/<project>.

pubsub_configs

map<string, PubsubConfig>

Festlegung, wie dieses Projekt eine Änderung in den Repositories über Cloud Pub/Sub veröffentlicht. Eingegeben nach dem Namen der Themen.

enable_private_key_check

bool

Zurückweisen eines Git-Push-Befehls, der einen privaten Schlüssel enthält.

PubsubConfig

Konfiguration zum Veröffentlichen einer Cloud Pub/Sub-Nachricht.

Felder
topic

string

Ein Thema von Cloud Pub/Sub. Werte haben das Format projects/<project>/topics/<topic>. Es muss sich um dasselbe Projekt handeln, in dem sich diese Konfiguration befindet.

message_format

MessageFormat

Das Format der Cloud Pub/Sub-Nachrichten.

service_account_email

string

E-Mail-Adresse des Dienstkontos, das zum Veröffentlichen von Cloud Pub/Sub-Nachrichten verwendet wird. Dieses Dienstkonto muss sich in demselben Projekt wie PubsubConfig befinden. Zum Hinzufügen muss der Aufrufer die Berechtigung iam.serviceAccounts.actAs für dieses Dienstkonto haben. Wenn kein Konto angegeben ist, wird standardmäßig das Standarddienstkonto für Compute Engine verwendet.

MessageFormat

Das Format der Cloud Pub/Sub-Nachrichten.

Enums
MESSAGE_FORMAT_UNSPECIFIED Nicht angegeben.
PROTOBUF Die Nachrichtennutzlast ist ein serialisierter Log-Puffer von SourceRepoEvent.
JSON Die Nachrichtennutzlast ist ein JSON-String von SourceRepoEvent.

Repo

Ein Repository (oder Repo) ist ein Git-Repository, das versionierte Quellinhalte speichert.

Felder
name

string

Ressourcenname des Repositorys im Format projects/<project>/repos/<repo>. Der Name des Repositorys kann Schrägstriche enthalten, z. B projects/myproject/repos/name/with/slash.

size

int64

Die Festplattenbelegung des Repositorys in Byte. Schreibgeschütztes Feld. Die Größe wird nur von GetRepo zurückgegeben.

url

string

URL zum Klonen des Repositorys von Google Cloud Source Repositories. Schreibgeschütztes Feld.

mirror_config

MirrorConfig

Festlegung, wie dieses Repository ein von einem anderen Dienst verwaltetes Repository spiegelt. Schreibgeschütztes Feld.

pubsub_configs

map<string, PubsubConfig>

Festlegung, wie dieses Repository eine Änderung im Repository über Cloud Pub/Sub veröffentlicht. Eingegeben nach dem Namen der Themen.

UpdateProjectConfigRequest

Anfrage für UpdateProjectConfig.

Felder
name

string

Der Name des angeforderten Projekts. Werte haben das Format projects/<project>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • source.repos.updateProjectConfig
project_config

ProjectConfig

Die neue Konfiguration für das Projekt.

update_mask

FieldMask

Eine FieldMask, die angibt, welche Felder von project_config geändert werden sollen. Dabei werden nur die Felder in der Maske geändert. Wenn keine Maske bereitgestellt wird, erfolgt für diese Anfrage keine Aktion.

UpdateRepoRequest

Anfrage für UpdateRepo.

Felder
name

string

Der Name des angefragten Repositorys. Werte haben das Format projects/<project>/repos/<repo>.

Zur Autorisierung ist die folgende Google IAM-Berechtigung für die angegebene Ressource name erforderlich:

  • source.repos.updateRepoConfig
repo

Repo

Die neue Konfiguration für das Repository.

update_mask

FieldMask

Eine FieldMask, die angibt, welche Felder des Repos geändert werden sollen. Dabei werden nur die Felder in der Maske geändert. Wenn keine Maske bereitgestellt wird, erfolgt für diese Anfrage keine Aktion.