Method: logs.list

Full name: projects.locations.instances.logTypes.logs.list

Lists all Logs.

HTTP request


GET https://chronicle.africa-south1.rep.googleapis.com/v1alpha/{parent}/logs

Path parameters

Parameters
parent

string

Required. The parent, which owns this collection of logs. Format: projects/{project}/locations/{region}/instances/{instance}/logTypes/{logType}

Query parameters

Parameters
pageSize

integer

The maximum number of logs to return. The service may return fewer than this value.
pageToken

string

A page token, received from a previous logs.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to logs.list must match the call that provided the page token.
filter

string

A filter string following AIP guideline-168. We only support filtering on collectionTime, with the supported format as: collectionTime.seconds >= 123 AND collectionTime.seconds <= 456.

Request body

The request body must be empty.

Response body

Response message for listing logs.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "logs": [
    {
      object (Log)
    }
  ],
  "nextPageToken": string
}
Fields
logs[]

object (Log)

The logs from the specified chronicle instance and log type. Ordered by resource name.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • chronicle.logs.list

For more information, see the IAM documentation.