Package google.devtools.sourcerepo.v1

Index

SourceRepo

Service de l'API Source Repo.

CreateRepo

rpc CreateRepo ( CreateRepoRequest ) renvoie ( Repo )

Crée un dépôt avec le nom donné dans le projet donné.

Si le nom du dépôt existe déjà, CreateRepo renvoie ALREADY_EXISTS.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
DeleteRepo

rpc DeleteRepo ( DeleteRepoRequest ) renvoie ( Empty )

Supprime un dépôt.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
GetIamPolicy

rpc GetIamPolicy ( GetIamPolicyRequest ) renvoie ( Policy )

Récupère la stratégie de contrôle d'accès d'une ressource. Renvoie une stratégie vide si la ressource existe, mais qu'elle ne dispose d'aucune stratégie.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
GetProjectConfig

rpc GetProjectConfig ( GetProjectConfigRequest ) retourne ( ProjectConfig )

Renvoie la configuration Cloud Source Repositories du projet.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
GetRepo

rpc GetRepo ( GetRepoRequest ) renvoie ( Repo )

Renvoie des informations sur un dépôt.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
ListRepos

rpc ListRepos ( ListReposRequest ) renvoie ( ListReposResponse )

Renvoie tous les dépôts appartenant à un projet. La taille des dépôts n'est pas définie par ListRepos. Pour obtenir la taille d'un dépôt, utilisez GetRepo.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
SetIamPolicy

rpc SetIamPolicy ( SetIamPolicyRequest ) renvoie ( Policy )

Définit la stratégie de contrôle d'accès de la ressource spécifiée. Remplace toute stratégie existante.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
TestIamPermissions

rpc TestIamPermissions ( TestIamPermissionsRequest ) renvoie ( TestIamPermissionsResponse )

Renvoie les autorisations qu'un appelant a sur la ressource spécifiée. Si la ressource n'existe pas, renvoie un ensemble vide d'autorisations. Ne renvoie pas l'erreur NOT_FOUND.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
UpdateProjectConfig

rpc UpdateProjectConfig ( UpdateProjectConfigRequest ) retourne ( ProjectConfig )

Met à jour la configuration Cloud Source Repositories du projet.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.
UpdateRepo

rpc UpdateRepo ( UpdateRepoRequest ) renvoie ( Repo )

Met à jour les informations relatives à un dépôt.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

Pour en savoir plus, consultez Présentation de l'authentification.

CreateRepoRequest

Requête de CreateRepo.

Champs
parent

string

Projet dans lequel créer le dépôt. Les valeurs ont le format suivant : projects/<project>.

L'autorisation Google IAM suivante est nécessaire sur la ressource parent spécifiée :

  • source.repos.create
repo

Repo

Dépôt à créer. Seul le nom doit être défini. Le fait de définir d'autres champs est une erreur. Le projet dans "name" doit correspondre au champ "parent".

DeleteRepoRequest

Requête de DeleteRepo.

Champs
name

string

Nom du dépôt à supprimer. Les valeurs ont le format suivant : projects/<project>/repos/<repo>.

Autorisation Google IAM nécessaire pour la ressource name spécifiée :

  • source.repos.delete

GetProjectConfigRequest

Requête pour GetProjectConfig.

Champs
name

string

Nom du projet demandé. Les valeurs ont le format suivant : projects/<project>.

Autorisation Google IAM nécessaire pour la ressource name spécifiée :

  • source.repos.getProjectConfig

GetRepoRequest

Requête de GetRepo.

Champs
name

string

Nom du dépôt demandé. Les valeurs ont le format suivant : projects/<project>/repos/<repo>.

Autorisation Google IAM nécessaire pour la ressource name spécifiée :

  • source.repos.get

ListReposRequest

Requête de ListRepos.

Champs
name

string

ID du projet dont les dépôts doivent être répertoriés. Les valeurs ont le format suivant : projects/<project>.

Autorisation Google IAM nécessaire pour la ressource name spécifiée :

  • source.repos.list
page_size

int32

Nombre maximal de dépôts à renvoyer. Entre 1 et 500. S'il n'est pas défini ou qu'il est défini sur zéro, 100 est utilisé par défaut sur le serveur.

page_token

string

Reprise du listage des dépôts à l'endroit où une ListReposResponse antérieure s'est arrêtée. Il s'agit d'un jeton opaque qui doit être obtenu à partir du champ next_page_token d'une ListReposResponse antérieure.

ListReposResponse

Réponse de ListRepos. La taille n'est pas définie dans les dépôts renvoyés.

Champs
repos[]

Repo

Dépôts répertoriés.

next_page_token

string

Si ce champ n'est pas vide, cela signifie que d'autres dépôts existent dans le projet. Ils peuvent être récupérés en incluant cette valeur dans le champ page_token de la ListReposRequest suivante.

MirrorConfig

Configuration permettant de mettre en miroir automatiquement le dépôt d'un autre service d'hébergement, par exemple GitHub ou Bitbucket.

Champs
url

string

URL du dépôt principal de l'autre service d'hébergement.

webhook_id

string

ID du webhook qui écoute les mises à jour pour déclencher la mise en miroir. La suppression de ce webhook de l'autre service d'hébergement empêchera Google Cloud Source Repositories de recevoir des notifications. La mise en miroir est par conséquent désactivée.

deploy_key_id

string

ID de la clé de déploiement SSH sur l'autre service d'hébergement. La suppression de cette clé de l'autre service entraînera l'annulation d'autorisation de la mise en miroir de Google Cloud Source Repositories.

ProjectConfig

Configuration Cloud Source Repositories d'un projet.

Champs
name

string

Nom du projet. Les valeurs ont le format suivant : projects/<project>.

pubsub_configs

map <chaîne, PubsubConfig >

Comment ce projet publie une modification dans les dépôts via Cloud Pub/Sub. Saisies par nom de sujet.

enable_private_key_check

bool

Rejeter une commande Git push contenant une clé privée.

PubsubConfig

Configuration permettant de publier un message Cloud Pub/Sub.

Champs
topic

string

Un sujet de Cloud Pub/Sub. Les valeurs ont le format suivant : projects/<project>/topics/<topic>. Le projet doit être identique à celui dans lequel se trouve cette configuration.

message_format

MessageFormat

Format des messages Cloud Pub/Sub.

service_account_email

string

Adresse e-mail du compte de service utilisé pour la publication de messages Cloud Pub/Sub. Ce compte de service doit appartenir au même projet que PubsubConfig. Une fois ajouté, l'appelant doit disposer de l'autorisation iam.serviceAccounts.actAs sur ce compte de service. S'il n'est pas spécifié, le compte de service par défaut du moteur de calcul est utilisé par défaut.

MessageFormat

Format des messages Cloud Pub/Sub.

Enums
MESSAGE_FORMAT_UNSPECIFIED Non spécifié.
PROTOBUF La charge utile du message est un tampon de protocole sérialisé de SourceRepoEvent.
JSON La charge utilise du message est une chaîne JSON de SourceRepoEvent.

Repo

Un dépôt est un dépôt Git qui stocke du contenu source avec des versions gérées.

Champs
name

string

Nom de la ressource du dépôt. Il a le format suivant : projects/<project>/repos/<repo>. Le nom du dépôt peut contenir des barres obliques. Par exemple : projects/myproject/repos/name/with/slash.

size

int64

Espace disque utilisé du dépôt, en octets. Il s'agit d'un champ en lecture seule. La taille est renvoyée uniquement par GetRepo.

url

string

URL permettant de cloner le dépôt à partir de Google Cloud Source Repositories. Il s'agit d'un champ en lecture seule.

mirror_config

MirrorConfig

Façon dont ce dépôt est le miroir d'un dépôt géré par un autre service. Il s'agit d'un champ en lecture seule.

pubsub_configs

map <chaîne, PubsubConfig >

Comment ce dépôt publie une modification dans le dépôt via Cloud Pub/Sub. Saisies par nom de sujet.

UpdateProjectConfigRequest

Requête de UpdateProjectConfig.

Champs
name

string

Nom du projet demandé. Les valeurs ont le format suivant : projects/<project>.

Autorisation Google IAM nécessaire pour la ressource name spécifiée :

  • source.repos.updateProjectConfig
project_config

ProjectConfig

Nouvelle configuration du projet.

update_mask

FieldMask

Chemin FieldMask spécifiant les champs du project_config à modifier. Seuls les champs du masque seront modifiés. Si aucun masque n'est fourni, cette demande est ignorée.

UpdateRepoRequest

Demande de UpdateRepo.

Champs
name

string

Nom du dépôt demandé. Les valeurs ont le format suivant : projects/<project>/repos/<repo>.

Autorisation Google IAM nécessaire pour la ressource name spécifiée :

  • source.repos.updateRepoConfig
repo

Repo

Nouvelle configuration du dépôt.

update_mask

FieldMask

Chemin FieldMask spécifiant les champs du dépôt à modifier. Seuls les champs du masque seront modifiés. Si aucun masque n'est fourni, cette demande est ignorée.