Method: revisions.list

Full name: projects.locations.instances.integrations.transformers.revisions.list

Lists all saved revisions for a specific Transformer. Supports pagination and allows users to browse through the version history of a custom Transformer definition.

HTTP request


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

Path parameters

Parameters
parent

string

Required. The parent transformer to list revisions for. Format: projects/{project}/locations/{location}/instances/{instance}/integrations/{integration}/transformers/{transformer}

Query parameters

Parameters
pageSize

integer

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

string

Optional. A page token, received from a previous revisions.list call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to revisions.list must match the call that provided the page token.
filter

string

Optional. A filter that can be used to filter the list of transformer revisions.
orderBy

string

Optional. A field that can be used to sort the list of transformer revisions.

Request body

The request body must be empty.

Response body

Response message for listing transformer revisions.

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

JSON representation 
{
  "revisions": [
    {
      object (TransformerRevision)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Fields
revisions[]

object (TransformerRevision)

The list of TransformerRevisions.
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.
totalSize

integer

Output only. Total number of revisions for the transformer.

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • chronicle.transformerRevisions.get

For more information, see the IAM documentation.