Method: projects.histories.list

Muestra una lista de los historiales de un proyecto determinado.

Los historiales se ordenan por horario de modificación, en orden descendente. La clave historyId se usará para ordenar el historial con la misma hora de modificación.

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

  • PERMISSION_DENIED: Si el usuario no está autorizado para leer el proyecto.
  • INVALID_ARGUMENT: Si la solicitud está malformada.
  • NOT_FOUND: Si el historial no existe.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
projectId

string

Un ID del proyecto

Obligatorio.

Parámetros de consulta

Parámetros
pageToken

string

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

Opcional.
pageSize

integer

Es la cantidad máxima de historiales que se recuperarán.

Valor predeterminado: 20. El servidor usará este valor predeterminado si el campo no está configurado o tiene un valor de 0. Cualquier valor superior a 100 se considerará como 100.

Opcional.
filterByName

string

Si está establecido, solo muestra historiales con el nombre dado.

Opcional.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para HistoryService.List

Si se ejecuta correctamente, 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.

Solo se establecerá si hay más historiales para recuperar.

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

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

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