Class CloudStorageConfig (2.23.1)

CloudStorageConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Configuration for a Cloud Storage subscription.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Attributes

Name Description
bucket :noindex: str
Required. User-provided name for the Cloud Storage bucket. The bucket must be created by the user. The bucket name must be without any prefix like "gs://". See the [bucket naming requirements] (https://cloud.google.com/storage/docs/buckets#naming).
filename_prefix :noindex: str
Optional. User-provided prefix for Cloud Storage filename. See the `object naming requirements
filename_suffix :noindex: str
Optional. User-provided suffix for Cloud Storage filename. See the `object naming requirements
filename_datetime_format :noindex: str
Optional. User-provided format string specifying how to represent datetimes in Cloud Storage filenames. See the `datetime format guidance
text_config :noindex: google.pubsub_v1.types.CloudStorageConfig.TextConfig
Optional. If set, message data will be written to Cloud Storage in text format. This field is a member of oneof_ output_format.
avro_config :noindex: google.pubsub_v1.types.CloudStorageConfig.AvroConfig
Optional. If set, message data will be written to Cloud Storage in Avro format. This field is a member of oneof_ output_format.
max_duration :noindex: google.protobuf.duration_pb2.Duration
Optional. The maximum duration that can elapse before a new Cloud Storage file is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed the subscription's acknowledgement deadline.
max_bytes :noindex: int
Optional. The maximum bytes that can be written to a Cloud Storage file before a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded in cases where messages are larger than the limit.
max_messages :noindex: int
Optional. The maximum number of messages that can be written to a Cloud Storage file before a new file is created. Min 1000 messages.
state :noindex: google.pubsub_v1.types.CloudStorageConfig.State
Output only. An output-only field that indicates whether or not the subscription can receive messages.
service_account_email :noindex: str
Optional. The service account to use to write to Cloud Storage. The subscription creator or updater that specifies this field must have iam.serviceAccounts.actAs permission on the service account. If not specified, the Pub/Sub `service agent

Classes

AvroConfig

AvroConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Configuration for writing message data in Avro format. Message payloads and metadata will be written to files as an Avro binary.

State

State(value)

Possible states for a Cloud Storage subscription.

TextConfig

TextConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Configuration for writing message data in text format. Message payloads will be written to files as raw text, separated by a newline.