REST Resource: organizations.locations.bigQueryExports

Resource: BigQueryExport

Configures how to deliver Findings to BigQuery Instance.

JSON representation
{
  "name": string,
  "description": string,
  "filter": string,
  "dataset": string,
  "createTime": string,
  "updateTime": string,
  "mostRecentEditor": string,
  "principal": string
}
Fields
name

string

Identifier. The relative resource name of this export. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name. The following list shows some examples:

+ organizations/{organization_id}/locations/{locationId}/bigQueryExports/{export_id} + folders/{folder_id}/locations/{locationId}/bigQueryExports/{export_id} + projects/{projectId}/locations/{locationId}/bigQueryExports/{export_id}

This field is provided in responses, and is ignored when provided in create requests.

description

string

The description of the export (max of 1024 characters).

filter

string

Expression that defines the filter to apply across create/update events of findings. The expression is a list of zero or more restrictions combined via logical operators AND and OR. Parentheses are supported, and OR has higher precedence than AND.

Restrictions have the form <field> <operator> <value> and may have a - character in front of them to indicate negation. The fields map to those defined in the corresponding resource.

The supported operators are:

  • = for all value types.
  • >, <, >=, <= for integer values.
  • :, meaning substring matching, for strings.

The supported value types are:

  • string literals in quotes.
  • integer literals without quotes.
  • boolean literals true and false without quotes.
dataset

string

The dataset to write findings' updates to. Its format is "projects/[projectId]/datasets/[bigquery_dataset_id]". BigQuery dataset unique ID must contain only letters (a-z, A-Z), numbers (0-9), or underscores (_).

createTime

string (Timestamp format)

Output only. The time at which the BigQuery export was created. This field is set by the server and will be ignored if provided on export on creation.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The most recent time at which the BigQuery export was updated. This field is set by the server and will be ignored if provided on export creation or update.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

mostRecentEditor

string

Output only. Email address of the user who last edited the BigQuery export. This field is set by the server and will be ignored if provided on export creation or update.

principal

string

Output only. The service account that needs permission to create table and upload data to the BigQuery dataset.

Methods

create

Creates a BigQuery export.

delete

Deletes an existing BigQuery export.

get

Gets a BigQuery export.

list

Lists BigQuery exports.

patch

Updates a BigQuery export.