Class Sink (2.6.0)

Version 2.6.0

• 3.11.3 (latest)
• 3.11.0
• 3.10.0
• 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

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.