OrganizationSink

Manages a organization-level logging sink. For more information see the official documentation and Exporting Logs in the API.

Note that you must have the “Logs Configuration Writer” IAM role (roles/logging.configWriter) granted to the credentials used with this provider.

Create a OrganizationSink Resource

new OrganizationSink(name: string, args: OrganizationSinkArgs, opts?: CustomResourceOptions);

def OrganizationSink(resource_name, opts=None, bigquery_options=None, destination=None, filter=None, include_children=None, name=None, org_id=None, __props__=None);

func NewOrganizationSink(ctx *Context, name string, args OrganizationSinkArgs, opts ...ResourceOption) (*OrganizationSink, error)

public OrganizationSink(string name, OrganizationSinkArgs args, CustomResourceOptions? opts = null)

name string: The unique name of the resource.
args OrganizationSinkArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
opts ResourceOptions: A bag of options that control this resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args OrganizationSinkArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args OrganizationSinkArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

OrganizationSink Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.

Inputs

The OrganizationSink resource accepts the following input properties:

Destination string: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
OrgId string: The numeric ID of the organization to be exported to the sink.
BigqueryOptions OrganizationSinkBigqueryOptionsArgs: Options that affect sinks exporting data to BigQuery. Structure documented below.
Filter string: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
IncludeChildren bool: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
Name string: The name of the logging sink.

Destination string: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
OrgId string: The numeric ID of the organization to be exported to the sink.
BigqueryOptions OrganizationSinkBigqueryOptions: Options that affect sinks exporting data to BigQuery. Structure documented below.
Filter string: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
IncludeChildren bool: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
Name string: The name of the logging sink.

destination string: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
orgId string: The numeric ID of the organization to be exported to the sink.
bigqueryOptions OrganizationSinkBigqueryOptions: Options that affect sinks exporting data to BigQuery. Structure documented below.
filter string: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
includeChildren boolean: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
name string: The name of the logging sink.

destination str: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
org_id str: The numeric ID of the organization to be exported to the sink.
bigquery_options Dict[OrganizationSinkBigqueryOptions]: Options that affect sinks exporting data to BigQuery. Structure documented below.
filter str: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
include_children bool: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
name str: The name of the logging sink.

Outputs

All input properties are implicitly available as output properties. Additionally, the OrganizationSink resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.
WriterIdentity string: The identity associated with this sink. This identity must be granted write access to the configured destination.

Id string: The provider-assigned unique ID for this managed resource.
WriterIdentity string: The identity associated with this sink. This identity must be granted write access to the configured destination.

id string: The provider-assigned unique ID for this managed resource.
writerIdentity string: The identity associated with this sink. This identity must be granted write access to the configured destination.

id str: The provider-assigned unique ID for this managed resource.
writer_identity str: The identity associated with this sink. This identity must be granted write access to the configured destination.

Look up an Existing OrganizationSink Resource

Get an existing OrganizationSink resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: OrganizationSinkState, opts?: CustomResourceOptions): OrganizationSink

static get(resource_name, id, opts=None, bigquery_options=None, destination=None, filter=None, include_children=None, name=None, org_id=None, writer_identity=None, __props__=None);

func GetOrganizationSink(ctx *Context, name string, id IDInput, state *OrganizationSinkState, opts ...ResourceOption) (*OrganizationSink, error)

public static OrganizationSink Get(string name, Input<string> id, OrganizationSinkState? state, CustomResourceOptions? opts = null)

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

BigqueryOptions OrganizationSinkBigqueryOptionsArgs: Options that affect sinks exporting data to BigQuery. Structure documented below.
Destination string: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
Filter string: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
IncludeChildren bool: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
Name string: The name of the logging sink.
OrgId string: The numeric ID of the organization to be exported to the sink.
WriterIdentity string: The identity associated with this sink. This identity must be granted write access to the configured destination.

BigqueryOptions OrganizationSinkBigqueryOptions: Options that affect sinks exporting data to BigQuery. Structure documented below.
Destination string: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
Filter string: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
IncludeChildren bool: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
Name string: The name of the logging sink.
OrgId string: The numeric ID of the organization to be exported to the sink.
WriterIdentity string: The identity associated with this sink. This identity must be granted write access to the configured destination.

bigqueryOptions OrganizationSinkBigqueryOptions: Options that affect sinks exporting data to BigQuery. Structure documented below.
destination string: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
filter string: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
includeChildren boolean: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
name string: The name of the logging sink.
orgId string: The numeric ID of the organization to be exported to the sink.
writerIdentity string: The identity associated with this sink. This identity must be granted write access to the configured destination.

bigquery_options Dict[OrganizationSinkBigqueryOptions]: Options that affect sinks exporting data to BigQuery. Structure documented below.
destination str: The destination of the sink (or, in other words, where logs are written to). Can be a Cloud Storage bucket, a PubSub topic, or a BigQuery dataset. Examples:
filter str: The filter to apply when exporting logs. Only log entries that match the filter are exported. See Advanced Log Filters for information on how to write a filter.
include_children bool: Whether or not to include children organizations in the sink export. If true, logs associated with child projects are also exported; otherwise only logs relating to the provided organization are included.
name str: The name of the logging sink.
org_id str: The numeric ID of the organization to be exported to the sink.
writer_identity str: The identity associated with this sink. This identity must be granted write access to the configured destination.

Supporting Types

OrganizationSinkBigqueryOptions

See the input and output API doc for this type.

UsePartitionedTables bool: Whether to use BigQuery’s partition tables. By default, Logging creates dated tables based on the log entries’ timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and special query syntax has to be used instead. In both cases, tables are sharded based on UTC timezone.

UsePartitionedTables bool: Whether to use BigQuery’s partition tables. By default, Logging creates dated tables based on the log entries’ timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and special query syntax has to be used instead. In both cases, tables are sharded based on UTC timezone.

usePartitionedTables boolean: Whether to use BigQuery’s partition tables. By default, Logging creates dated tables based on the log entries’ timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and special query syntax has to be used instead. In both cases, tables are sharded based on UTC timezone.

usePartitionedTables bool: Whether to use BigQuery’s partition tables. By default, Logging creates dated tables based on the log entries’ timestamps, e.g. syslog_20170523. With partitioned tables the date suffix is no longer present and special query syntax has to be used instead. In both cases, tables are sharded based on UTC timezone.

Package Details

Repository: https://github.com/pulumi/pulumi-gcp
License: Apache-2.0
Notes: This Pulumi package is based on the google-beta Terraform Provider.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud