Method: logTypeSchemas.list

Full name: projects.locations.instances.feedSourceTypeSchemas.logTypeSchemas.list

List all LogTypeSchemas compatible with a given FeedSourceType.

HTTP request

GET https://chronicle.googleapis.com/v1alpha/{parent}/logTypeSchemas

Path parameters

Parameters
parent

string

Required. The parent, which owns this collection of LogTypeSchemas. Format: Format: projects/{project}/locations/{location}/instances/{instance}/feedSourceTypeSchemas/{feed_source_type}

Query parameters

Parameters
pageSize

integer

The maximum number of LogTypeSchemas to return. The service may return fewer than this value. If unspecified, at most 5000 LogTypeSchemas will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.

pageToken

string

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

Request body

The request body must be empty.

Response body

ListLogTypeSchemas response message.

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

JSON representation
{
  "log_type_schemas": [
    {
      object (LogTypeSchema)
    }
  ],
  "next_page_token": string
}
Fields
log_type_schemas[]

object (LogTypeSchema)

LogTypeSchemas.

next_page_token

string

A token, which can be sent as page_token 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.logTypeSchemas.list

For more information, see the IAM documentation.

LogTypeSchema

Metadata that pertains to a log type in the context of Feeds, and is useful for building interfaces to construct valid Feed messages.

JSON representation
{
  "name": string,
  "display_name": string,
  "log_type": string,
  "read_only": boolean,
  "supporting_documentation": string,
  "details_field_schemas": [
    {
      object (DetailsFieldSchema)
    }
  ],
  "details_field_schema_alternatives": [
    {
      object (DetailsFieldSchemaAlternative)
    }
  ]
}
Fields
name

string

The resource name. Format: "projects/{project}/locations/{location}/instances/{instance}/feedSourceTypeSchemas/{feed_source_type}/logTypeSchemas/{log_type}" See FeedDetails.FeedSourceType for the feed source type.

display_name

string

A human-readable name for this log type.

log_type

string

The log type to be used in the details.log_type field.

read_only

boolean

Whether this log type schema represents a feed configuration that may exist, but should not be modified (created, edited, or deleted).

supporting_documentation

string

A description that is displayed when users create or edit feeds.

details_field_schemas[]

object (DetailsFieldSchema)

The schemas for detail fields that are compatible with this log type and feed source type. All fields for this log type and feed source type are either contained here or within details_field_schema_alternatives.

details_field_schema_alternatives[]

object (DetailsFieldSchemaAlternative)

There are sets of fields which represent alternatives to one another. A user would only fill in one set of fields for any one alternative.

DetailsFieldSchema

A schema for a particular details field on the Feed proto message.

JSON representation
{
  "field_path": string,
  "display_name": string,
  "description": string,
  "type": enum (SemanticType),
  "enum_field_schemas": [
    {
      object (EnumFieldSchema)
    }
  ],
  "required": boolean,
  "example_input": string,
  "read_only": boolean
}
Fields
field_path

string

The protocol buffer field path. For example, "details.azure_ad_context_settings.authentication.token_endpoint".

display_name

string

A human-readable name for this field.

description

string

A human-readable description for this field.

type

enum (SemanticType)

A type that represents both the encoding and the semantics of this field.

enum_field_schemas[]

object (EnumFieldSchema)

If a field has an enum type, this is the schema describing the possible values.

required

boolean

Whether this field must be specified to have a valid feed configuration.

example_input

string

For those fields with input requirements that aren't adequately expressed by the SemanticType it is often useful to supply an example input.

read_only

boolean

For those fields which are read only.

SemanticType

An enumeration of the possible types of a Feed.details field, where type implies both encoding and semantics. This is used in constructing a schema in order to construct a UI for creating well formed feeds.

Enums
SEMANTIC_TYPE_UNSPECIFIED No semantic type. All fields must specify a semantic type.
BOOL A boolean (with no special semantics).
ENUM An enum (with no special semantics).
KEY_VALUE_LIST A repeated field with a Message type where the Message contains two fields: key and value.
MAP_STRING_STRING A map<string, string> (with no special semantics).
STRING A string (with no special semantics).
STRING_LIST A repeated string (with no special semantics).
STRING_MULTILINE A string that may contain any whitespace characters (with no special semantics).
STRING_MULTILINE_SECRET A string that may contain any whitespace characters and that encodes a secret.
STRING_SECRET A string which encodes a secret.
STRING_URI A string which encodes a URI.
STRING_URI_LIST A repeated string which encodes URIs.

EnumFieldSchema

A schema for a particular value, for a particular enum details field on the Feed proto message.

JSON representation
{
  "value": string,
  "display_name": string,
  "description": string
}
Fields
value

string

The value to assign to the field.

display_name

string

A human-readable name for this value.

description

string

A human-readable description for this value.

DetailsFieldSchemaAlternative

A collection of details field schema sets. The user must provide values for only one set of fields within an alternative.

JSON representation
{
  "details_field_schema_sets": [
    {
      object (DetailsFieldSchemaSet)
    }
  ]
}
Fields
details_field_schema_sets[]

object (DetailsFieldSchemaSet)

The schemas for each alternative set of fields.

DetailsFieldSchemaSet

A collection of schemas for related fields within details.

JSON representation
{
  "display_name": string,
  "description": string,
  "details_field_schemas": [
    {
      object (DetailsFieldSchema)
    }
  ]
}
Fields
display_name

string

A human-readable name for this collection of details fields.

description

string

A human-readable description for this collection of details fields.

details_field_schemas[]

object (DetailsFieldSchema)

Schemas for the fields in this set.