Class CloudStorageConfig (2.18.4)

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

NameDescription
bucket 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 str
User-provided prefix for Cloud Storage filename. See the `object naming requirements
filename_suffix str
User-provided suffix for Cloud Storage filename. See the `object naming requirements
text_config google.pubsub_v1.types.CloudStorageConfig.TextConfig
If set, message data will be written to Cloud Storage in text format. This field is a member of oneof_ output_format.
avro_config google.pubsub_v1.types.CloudStorageConfig.AvroConfig
If set, message data will be written to Cloud Storage in Avro format. This field is a member of oneof_ output_format.
max_duration google.protobuf.duration_pb2.Duration
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 int
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.
state google.pubsub_v1.types.CloudStorageConfig.State
Output only. An output-only field that indicates whether or not the subscription can receive messages.

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.

Values: STATE_UNSPECIFIED (0): Default value. This value is unused. ACTIVE (1): The subscription can actively send messages to Cloud Storage. PERMISSION_DENIED (2): Cannot write to the Cloud Storage bucket because of permission denied errors. NOT_FOUND (3): Cannot write to the Cloud Storage bucket because it does not exist.

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.