Method: projects.histories.list

Enumera las historias de un proyecto determinado.

Las historias están ordenadas por tiempo de modificación en orden descendente. La clave historyId se utilizará para ordenar el historial con el mismo tiempo de modificación.

Puede devolver 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 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 usa la sintaxis de transcodificación de 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 para obtener.

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 tratará como 100.

Opcional.

filterByName

string

Si se establece, solo devuelve historias con el nombre dado.

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.

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

Los tokens son válidos hasta por una hora desde el momento de la primera solicitud de lista. Por ejemplo, si realiza una solicitud de lista a la 1 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 .