Method: projects.histories.list

Répertorie les historiques pour un projet donné.

Les historiques sont triés par heure de modification par ordre décroissant. La clé historyId sera utilisée pour classer l'historique avec la même heure de modification.

Peut renvoyer l’un des codes d’erreur canoniques suivants :

  • PERMISSION_DENIED - si l'utilisateur n'est pas autorisé à lire le projet
  • INVALID_ARGUMENT - si la requête est mal formée
  • NOT_FOUND - si l'historique n'existe pas

Requête HTTP

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories

L'URL utilise la syntaxe de transcodage gRPC .

Paramètres du chemin

Paramètres
projectId

string

Un identifiant de projet.

Requis.

Paramètres de requête

Paramètres
pageToken

string

Un jeton de continuation pour reprendre la requête à l'élément suivant.

Facultatif.

pageSize

integer

Le nombre maximum d'historiques à récupérer.

Valeur par défaut : 20. Le serveur utilisera cette valeur par défaut si le champ n'est pas défini ou a une valeur de 0. Toute valeur supérieure à 100 sera traitée comme 100.

Facultatif.

filterByName

string

Si défini, renvoie uniquement les historiques portant le nom donné.

Facultatif.

Corps de la demande

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

Corps de réponse

Message de réponse pour HistoryService.List

En cas de succès, le corps de la réponse contient des données avec la structure suivante :

Représentation JSON
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
Des champs
histories[]

object ( History )

Histoires.

nextPageToken

string

Un jeton de continuation pour reprendre la requête à l'élément suivant.

Ne sera défini que s'il y a plus d'historiques à récupérer.

Les jetons sont valables jusqu'à une heure à compter de la première demande de liste. Par exemple, si vous effectuez une demande de liste à 13 heures et utilisez le jeton de cette première demande 10 minutes plus tard, le jeton de cette deuxième réponse ne sera valable que 50 minutes.

Portées des autorisations

Nécessite le champ d'application OAuth suivant :

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

Pour plus d'informations, consultez la Présentation de l'authentification .