Describes a sink used to export log entries to one of the following destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a Cloud Pub/Sub topic. A logs filter controls which log entries are exported. The sink must be created within a project, organization, billing account, or folder.
.. attribute:: name
Required. The client-assigned sink identifier, unique within
the project. Example: "my-syslog-errors-to-pubsub". Sink
identifiers are limited to 100 characters and can include only
the following characters: upper and lower-case alphanumeric
characters, underscores, hyphens, and periods. First character
has to be alphanumeric.
Optional. An advanced logs filter
</logging/docs/view/advanced-queries>__. The only exported
log entries are those that are in the resource owning the sink
and that match the filter. For example: ::
logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND
severity>=ERROR
Optional. If set to True, then this sink is disabled and it does not export any log entries.
Output only. An IAM identity—a service account or group—under
which Logging writes the exported log entries to the sink's
destination. This field is set by
sinks.create][google.logging.v2.ConfigServiceV2.CreateSink]
and
sinks.update][google.logging.v2.ConfigServiceV2.UpdateSink]
based on the value of unique_writer_identity in those
methods. Until you grant this identity write-access to the
destination, log entry exports from this sink will fail. For
more information, see Granting Access for a Resource
</iam/docs/granting-roles-to-service-accounts#granting_access_
to_a_service_account_for_a_resource>__. Consult the
destination service's documentation to determine the
appropriate IAM roles to assign to the identity.
Optional. Destination dependent options.
Output only. The creation timestamp of the sink. This field may not be present for older sinks.
Do not use. This field is ignored.