Class Sink (3.1.1)

Version 3.1.1

• 3.10.0 (latest)
• 3.9.0
• 3.8.0
• 3.7.0
• 3.6.0
• 3.5.0
• 3.4.0
• 3.3.1
• 3.2.5
• 3.1.2
• 3.0.0
• 2.7.2
• 2.6.0
• 2.5.0
• 2.4.0
• 2.3.1
• 2.2.0
• 2.1.1
• 2.0.2
• 1.15.3
• 1.14.0
• 1.13.0
• 1.12.1

Sink(name, *, filter_=None, parent=None, destination=None, client=None)

Sinks represent filtered exports for log entries.

See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks

Inheritance

builtins.object > Sink

Properties

client

Client bound to the sink.

full_name

Fully-qualified name used in sink APIs

parent

Parent resource of the sink (project, organization, billingAccount, or folder).

path

URL path for the sink's APIs

writer_identity

Identity used for exports via the sink

Methods

Sink

Sink(name, *, filter_=None, parent=None, destination=None, client=None)

Parameters

Name	Description
name	str The name of the sink.
parent	Optional[str] The resource in which to create the sink: :: "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]". Defaults to the project stored on the client.
filter_	Optional[str] The advanced logs filter expression defining the entries exported by the sink.
destination	Optional[str] Destination URI for the entries exported by the sink. If not passed, the instance should already exist, to be refreshed via reload.
client	Optional[`logging_v2.client.Client`] A client which holds credentials and project configuration for the sink (which requires a project).

create

create(*, client=None, unique_writer_identity=False)

Create the sink via a PUT request

See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/create

Parameters

Name	Description
client	Optional[`logging_v2.client.Client`] The client to use. If not passed, falls back to the client stored on the current sink.
unique_writer_identity	Optional[bool] Determines the kind of IAM identity returned as writer_identity in the new sink.

delete

delete(*, client=None)

Delete a sink via a DELETE request

See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/delete

Parameter

Name	Description
client	Optional[`logging_v2.client.Client`] The client to use. If not passed, falls back to the client stored on the current sink.

exists

exists(*, client=None)

Test for the existence of the sink via a GET request

See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get

Parameter

Name	Description
client	Optional[`logging_v2.client.Client`] The client to use. If not passed, falls back to the client stored on the current sink.

Returns

Type	Description
bool	Boolean indicating existence of the sink.

from_api_repr

from_api_repr(resource, client, *, parent=None)

Construct a sink given its API representation

Parameters

Name	Description
resource	dict sink resource representation returned from the API
client	`logging_v2.client.Client` Client which holds credentials and project configuration for the sink.
parent	Optional[str] The resource in which to create the sink: :: "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]". Defaults to the project stored on the client.

Exceptions

Type	Description
ValueError	if ``client`` is not ``None`` and the project from the resource does not agree with the project from the client.

Returns

Type	Description
`logging_v2.sink.Sink`	Sink parsed from ``resource``.

reload

reload(*, client=None)

Sync local sink configuration via a GET request

See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/get

Parameter

Name	Description
client	Optional[`logging_v2.client.Client`] The client to use. If not passed, falls back to the client stored on the current sink.

update

update(*, client=None, unique_writer_identity=False)

Update sink configuration via a PUT request

See https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.sinks/update

Parameters

Name	Description
client	Optional[`logging_v2.client.Client`] The client to use. If not passed, falls back to the client stored on the current sink.
unique_writer_identity	Optional[bool] Determines the kind of IAM identity returned as writer_identity in the new sink.