Failure when ingesting from a Cloud Storage source.
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.
str
Optional. Name of the Cloud Storage bucket
used for ingestion.
object_name
:noindex:
str
Optional. Name of the Cloud Storage object
which contained the section that couldn't be
ingested.
object_generation
:noindex:
int
Optional. Generation of the Cloud Storage
object which contained the section that couldn't
be ingested.
avro_failure_reason
:noindex:
google.pubsub_v1.types.IngestionFailureEvent.AvroFailureReason
Optional. Failure encountered when parsing an
Avro file.
This field is a member of oneof_ reason.
api_violation_reason
:noindex:
google.pubsub_v1.types.IngestionFailureEvent.ApiViolationReason
Optional. The Pub/Sub API limits prevented
the desired message from being published.
This field is a member of oneof_ reason.
schema_violation_reason
:noindex:
google.pubsub_v1.types.IngestionFailureEvent.SchemaViolationReason
Optional. The Pub/Sub message failed schema
validation.
This field is a member of oneof_ reason.
message_transformation_failure_reason
:noindex:
google.pubsub_v1.types.IngestionFailureEvent.MessageTransformationFailureReason
Optional. Failure encountered when applying a
message transformation to the Pub/Sub message.
This field is a member of oneof_ reason.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class CloudStorageFailure (2.31.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.31.0 (latest)](/python/docs/reference/pubsub/latest/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.30.0](/python/docs/reference/pubsub/2.30.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.29.1](/python/docs/reference/pubsub/2.29.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.28.0](/python/docs/reference/pubsub/2.28.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.27.3](/python/docs/reference/pubsub/2.27.3/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.26.1](/python/docs/reference/pubsub/2.26.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.25.2](/python/docs/reference/pubsub/2.25.2/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.23.1](/python/docs/reference/pubsub/2.23.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.22.0](/python/docs/reference/pubsub/2.22.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.21.5](/python/docs/reference/pubsub/2.21.5/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.20.3](/python/docs/reference/pubsub/2.20.3/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.19.8](/python/docs/reference/pubsub/2.19.8/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.18.4](/python/docs/reference/pubsub/2.18.4/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.17.1](/python/docs/reference/pubsub/2.17.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.16.1](/python/docs/reference/pubsub/2.16.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.15.2](/python/docs/reference/pubsub/2.15.2/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.14.1](/python/docs/reference/pubsub/2.14.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.13.12](/python/docs/reference/pubsub/2.13.12/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.12.1](/python/docs/reference/pubsub/2.12.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.11.1](/python/docs/reference/pubsub/2.11.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.10.0](/python/docs/reference/pubsub/2.10.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.9.0](/python/docs/reference/pubsub/2.9.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.8.0](/python/docs/reference/pubsub/2.8.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.7.1](/python/docs/reference/pubsub/2.7.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.6.1](/python/docs/reference/pubsub/2.6.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.5.0](/python/docs/reference/pubsub/2.5.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.4.2](/python/docs/reference/pubsub/2.4.2/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.3.0](/python/docs/reference/pubsub/2.3.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.2.0](/python/docs/reference/pubsub/2.2.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.1.0](/python/docs/reference/pubsub/2.1.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [2.0.0](/python/docs/reference/pubsub/2.0.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.7.2](/python/docs/reference/pubsub/1.7.2/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.6.1](/python/docs/reference/pubsub/1.6.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.5.0](/python/docs/reference/pubsub/1.5.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.4.3](/python/docs/reference/pubsub/1.4.3/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.3.1](/python/docs/reference/pubsub/1.3.1/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.2.0](/python/docs/reference/pubsub/1.2.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.1.0](/python/docs/reference/pubsub/1.1.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [1.0.2](/python/docs/reference/pubsub/1.0.2/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [0.45.0](/python/docs/reference/pubsub/0.45.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [0.44.0](/python/docs/reference/pubsub/0.44.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure)\n- [0.43.0](/python/docs/reference/pubsub/0.43.0/google.cloud.pubsub_v1.types.IngestionFailureEvent.CloudStorageFailure) \n\n CloudStorageFailure(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nFailure when ingesting from a Cloud Storage source.\n\nThis message has `oneof`_ fields (mutually exclusive fields).\nFor each oneof, at most one member field can be set at the same time.\nSetting any member of the oneof automatically clears all other\nmembers.\n\n.. _oneof: \u003chttps://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields\u003e"]]