Method: projects.histories.list

Enumera los historiales de un proyecto determinado.

Los historiales están ordenados por hora de modificación en orden descendente. La clave historicId se utilizará para ordenar el historial con la misma hora de modificación.

Puede devolver cualquiera de los siguientes códigos de error canónicos:

  • PERMISSION_DENIED: si el usuario no está autorizado a leer el proyecto
  • INVALID_ARGUMENT: si la solicitud tiene un formato incorrecto
  • NOT_FOUND: si el historial no existe

solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
projectId

string

Una identificación del proyecto.

Requerido.

Parámetros de consulta

Parámetros
pageToken

string

Un token de continuación para reanudar la consulta en el siguiente elemento.

Opcional.

pageSize

integer

El número máximo de historiales que se van a recuperar.

Valor predeterminado: 20. El servidor utilizará este valor predeterminado si el campo no está configurado o tiene un valor de 0. Cualquier valor mayor que 100 se tratará como 100.

Opcional.

filterByName

string

Si se establece, solo devolverá historiales con el nombre de pila.

Opcional.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de respuesta

Mensaje de respuesta para HistoryService.List

Si tiene éxito, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "histories": [
    {
      object (History)
    }
  ],
  "nextPageToken": string
}
Campos
histories[]

object ( History )

Historias.

nextPageToken

string

Un token de continuación para reanudar la consulta en el siguiente elemento.

Sólo se configurará si hay más historiales para recuperar.

Los tokens son válidos por hasta una hora desde el momento de la primera solicitud de lista. Por ejemplo, si realiza una solicitud de lista a la 1:00 p. m. y usa el token de esta primera solicitud 10 minutos después, el token de esta segunda respuesta solo será válido durante 50 minutos.

Ámbitos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulte Descripción general de la autenticación .