Method: projects.locations.connections.gitRepositoryLinks.fetchCommitList

Récupérez une liste de commits à partir d'un lien de dépôt Git.

Requête HTTP

GET https://developerconnect.googleapis.com/v1/{name=projects/*/locations/*/connections/*/gitRepositoryLinks/*}:fetchCommitList

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource du GitRepositoryLink au format projects/*/locations/*/connections/*/gitRepositoryLinks/*.

Paramètres de requête

Paramètres
ref

string

Facultatif. SHA du commit ou révision symbolique (par exemple, nom de branche, tag ou référence Git) à partir duquel lister les commits.

pageSize

integer

Facultatif. Nombre de résultats à renvoyer dans la liste. La valeur par défaut est 50. La valeur maximale est de 100.

pageToken

string

Facultatif. Jeton de page reçu d'un appel gitRepositoryLinks.fetchCommitList précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à gitRepositoryLinks.fetchCommitList doivent correspondre à l'appel ayant fourni le jeton de page.

view

enum (CommitView)

Facultatif. Niveau de détails du commit à renvoyer dans la réponse. Seul BASIC est accepté. FULL renvoie INVALID_ARGUMENT. En l'absence de spécification, la valeur par défaut est BASIC. Utilisez gitRepositoryLinks.fetchCommit pour obtenir les différences de fichiers pour un seul commit.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour gitRepositoryLinks.fetchCommitList.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "commits": [
    {
      object (SCMCommit)
    }
  ],
  "nextPageToken": string
}
Champs
commits[]

object (SCMCommit)

Liste des métadonnées de commit.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • developerconnect.gitRepositoryLinks.fetchCommitList

Pour en savoir plus, consultez la documentation IAM.