Paket google.devtools.sourcerepo.v1

Index

SourceRepo (Schnittstelle)
CreateRepoRequest (Nachricht)
DeleteRepoRequest (Nachricht)
GetProjectConfigRequest (Nachricht)
GetRepoRequest (Nachricht)
ListReposRequest (Nachricht)
ListReposResponse (Nachricht)
MirrorConfig (Nachricht)
ProjectConfig (Nachricht)
PubsubConfig (Nachricht)
PubsubConfig.MessageFormat (Enum)
Repo (Nachricht)
UpdateProjectConfigRequest (Nachricht)
UpdateRepoRequest (Nachricht)

SourceRepo

Der Source Repo API-Dienst.

CreateRepo

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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`

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

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`

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

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`

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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.