google-cloud-pubsub-v1 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 363cd6d6ac070b74a745a773528b9e2b2a5d2aa3cc88fca1e0a9bc65a5f46611
4
- data.tar.gz: 0744f391b9a7029f0203af323be23ad57f2019b8acb566fde0ccc2bf4e67fa02
3
+ metadata.gz: 16141d36dacc4483fec550ce326114ebe6dc3bf6edd471765489291fb020db67
4
+ data.tar.gz: 0b8ba0ac187209e0d2bf52978aa0496679b7f5bca7d35b2ffa34e4f38969dc0e
5
5
  SHA512:
6
- metadata.gz: 31fe93c9229e1107457d34c8259f17ea0f1f3e645df4329b3d98d874d7ab86289106a935b45b4bc3b68a68a0174371b632beb53143e0a95f9554883b471b67c1
7
- data.tar.gz: 1fd44511807ecf8d54a8e42a94fdd9ece5eadc3b6c1eb714e70f7e7e8ee24523dd013c86bc9223330ce563413dc611dc7f9a6fcb252abfece2d161fa5abac7c9
6
+ metadata.gz: 1eb493b0932a74e97276c3c91996beb89ce598b3980842745619e4831635d25b39b05760b02a380428e8254168235e6bab48907bad4d5dfc32cacbcccd6213df
7
+ data.tar.gz: 4231d945dff51e8c9feb91915d41e8cc6c70e293b49380f7393992592da64d71e3d74e33ae20c809b961ff144796070460e610efe09ce6dff4b5fe6f726a0bed
data/README.md CHANGED
@@ -86,7 +86,7 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
86
86
 
87
87
  ## Supported Ruby Versions
88
88
 
89
- This library is supported on Ruby 2.7+.
89
+ This library is supported on Ruby 3.0+.
90
90
 
91
91
  Google provides official support for Ruby versions that are actively supported
92
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -1141,6 +1141,13 @@ module Google
1141
1141
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1142
1142
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1143
1143
  # * (`nil`) indicating no credentials
1144
+ #
1145
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1146
+ # external source for authentication to Google Cloud, you must validate it before
1147
+ # providing it to a Google API client library. Providing an unvalidated credential
1148
+ # configuration to Google APIs can compromise the security of your systems and data.
1149
+ # For more information, refer to [Validate credential configurations from external
1150
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1144
1151
  # @return [::Object]
1145
1152
  # @!attribute [rw] scope
1146
1153
  # The OAuth scopes
@@ -1107,8 +1107,12 @@ module Google
1107
1107
  # Name of the schema against which to validate.
1108
1108
  #
1109
1109
  # Format is `projects/{project}/schemas/{schema}`.
1110
+ #
1111
+ # Note: The following fields are mutually exclusive: `name`, `schema`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1110
1112
  # @param schema [::Google::Cloud::PubSub::V1::Schema, ::Hash]
1111
1113
  # Ad-hoc schema against which to validate
1114
+ #
1115
+ # Note: The following fields are mutually exclusive: `schema`, `name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1112
1116
  # @param message [::String]
1113
1117
  # Message to validate against the provided `schema_spec`.
1114
1118
  # @param encoding [::Google::Cloud::PubSub::V1::Encoding]
@@ -1222,6 +1226,13 @@ module Google
1222
1226
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1223
1227
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1224
1228
  # * (`nil`) indicating no credentials
1229
+ #
1230
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1231
+ # external source for authentication to Google Cloud, you must validate it before
1232
+ # providing it to a Google API client library. Providing an unvalidated credential
1233
+ # configuration to Google APIs can compromise the security of your systems and data.
1234
+ # For more information, refer to [Validate credential configurations from external
1235
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1225
1236
  # @return [::Object]
1226
1237
  # @!attribute [rw] scope
1227
1238
  # The OAuth scopes
@@ -1863,11 +1863,15 @@ module Google
1863
1863
  # window (or to a point before the system's notion of the subscription
1864
1864
  # creation time), only retained messages will be marked as unacknowledged,
1865
1865
  # and already-expunged messages will not be restored.
1866
+ #
1867
+ # Note: The following fields are mutually exclusive: `time`, `snapshot`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1866
1868
  # @param snapshot [::String]
1867
1869
  # Optional. The snapshot to seek to. The snapshot's topic must be the same
1868
1870
  # as that of the provided subscription. Format is
1869
1871
  # `projects/{project}/snapshots/{snap}`.
1870
1872
  #
1873
+ # Note: The following fields are mutually exclusive: `snapshot`, `time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1874
+ #
1871
1875
  # @yield [response, operation] Access the result along with the RPC operation
1872
1876
  # @yieldparam response [::Google::Cloud::PubSub::V1::SeekResponse]
1873
1877
  # @yieldparam operation [::GRPC::ActiveCall::Operation]
@@ -1976,6 +1980,13 @@ module Google
1976
1980
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1977
1981
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1978
1982
  # * (`nil`) indicating no credentials
1983
+ #
1984
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
1985
+ # external source for authentication to Google Cloud, you must validate it before
1986
+ # providing it to a Google API client library. Providing an unvalidated credential
1987
+ # configuration to Google APIs can compromise the security of your systems and data.
1988
+ # For more information, refer to [Validate credential configurations from external
1989
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
1979
1990
  # @return [::Object]
1980
1991
  # @!attribute [rw] scope
1981
1992
  # The OAuth scopes
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module PubSub
23
23
  module V1
24
- VERSION = "1.5.0"
24
+ VERSION = "1.6.0"
25
25
  end
26
26
  end
27
27
  end
@@ -71,18 +71,28 @@ module Google
71
71
  # @!attribute [rw] aws_kinesis
72
72
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::AwsKinesis]
73
73
  # Optional. Amazon Kinesis Data Streams.
74
+ #
75
+ # Note: The following fields are mutually exclusive: `aws_kinesis`, `cloud_storage`, `azure_event_hubs`, `aws_msk`, `confluent_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
74
76
  # @!attribute [rw] cloud_storage
75
77
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage]
76
78
  # Optional. Cloud Storage.
79
+ #
80
+ # Note: The following fields are mutually exclusive: `cloud_storage`, `aws_kinesis`, `azure_event_hubs`, `aws_msk`, `confluent_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
77
81
  # @!attribute [rw] azure_event_hubs
78
82
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::AzureEventHubs]
79
83
  # Optional. Azure Event Hubs.
84
+ #
85
+ # Note: The following fields are mutually exclusive: `azure_event_hubs`, `aws_kinesis`, `cloud_storage`, `aws_msk`, `confluent_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
80
86
  # @!attribute [rw] aws_msk
81
87
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::AwsMsk]
82
88
  # Optional. Amazon MSK.
89
+ #
90
+ # Note: The following fields are mutually exclusive: `aws_msk`, `aws_kinesis`, `cloud_storage`, `azure_event_hubs`, `confluent_cloud`. If a field in that set is populated, all other fields in the set will automatically be cleared.
83
91
  # @!attribute [rw] confluent_cloud
84
92
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::ConfluentCloud]
85
93
  # Optional. Confluent Cloud.
94
+ #
95
+ # Note: The following fields are mutually exclusive: `confluent_cloud`, `aws_kinesis`, `cloud_storage`, `azure_event_hubs`, `aws_msk`. If a field in that set is populated, all other fields in the set will automatically be cleared.
86
96
  # @!attribute [rw] platform_logs_settings
87
97
  # @return [::Google::Cloud::PubSub::V1::PlatformLogsSettings]
88
98
  # Optional. Platform Logs settings. If unset, no Platform Logs will be
@@ -163,14 +173,20 @@ module Google
163
173
  # @!attribute [rw] text_format
164
174
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::TextFormat]
165
175
  # Optional. Data from Cloud Storage will be interpreted as text.
176
+ #
177
+ # Note: The following fields are mutually exclusive: `text_format`, `avro_format`, `pubsub_avro_format`. If a field in that set is populated, all other fields in the set will automatically be cleared.
166
178
  # @!attribute [rw] avro_format
167
179
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::AvroFormat]
168
180
  # Optional. Data from Cloud Storage will be interpreted in Avro format.
181
+ #
182
+ # Note: The following fields are mutually exclusive: `avro_format`, `text_format`, `pubsub_avro_format`. If a field in that set is populated, all other fields in the set will automatically be cleared.
169
183
  # @!attribute [rw] pubsub_avro_format
170
184
  # @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::PubSubAvroFormat]
171
185
  # Optional. It will be assumed data from Cloud Storage was written via
172
186
  # [Cloud Storage
173
187
  # subscriptions](https://cloud.google.com/pubsub/docs/cloudstorage).
188
+ #
189
+ # Note: The following fields are mutually exclusive: `pubsub_avro_format`, `text_format`, `avro_format`. If a field in that set is populated, all other fields in the set will automatically be cleared.
174
190
  # @!attribute [rw] minimum_object_create_time
175
191
  # @return [::Google::Protobuf::Timestamp]
176
192
  # Optional. Only objects with a larger or equal creation timestamp will be
@@ -453,15 +469,23 @@ module Google
453
469
  # @!attribute [rw] cloud_storage_failure
454
470
  # @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::CloudStorageFailure]
455
471
  # Optional. Failure when ingesting from Cloud Storage.
472
+ #
473
+ # Note: The following fields are mutually exclusive: `cloud_storage_failure`, `aws_msk_failure`, `azure_event_hubs_failure`, `confluent_cloud_failure`. If a field in that set is populated, all other fields in the set will automatically be cleared.
456
474
  # @!attribute [rw] aws_msk_failure
457
475
  # @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::AwsMskFailureReason]
458
476
  # Optional. Failure when ingesting from Amazon MSK.
477
+ #
478
+ # Note: The following fields are mutually exclusive: `aws_msk_failure`, `cloud_storage_failure`, `azure_event_hubs_failure`, `confluent_cloud_failure`. If a field in that set is populated, all other fields in the set will automatically be cleared.
459
479
  # @!attribute [rw] azure_event_hubs_failure
460
480
  # @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::AzureEventHubsFailureReason]
461
481
  # Optional. Failure when ingesting from Azure Event Hubs.
482
+ #
483
+ # Note: The following fields are mutually exclusive: `azure_event_hubs_failure`, `cloud_storage_failure`, `aws_msk_failure`, `confluent_cloud_failure`. If a field in that set is populated, all other fields in the set will automatically be cleared.
462
484
  # @!attribute [rw] confluent_cloud_failure
463
485
  # @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::ConfluentCloudFailureReason]
464
486
  # Optional. Failure when ingesting from Confluent Cloud.
487
+ #
488
+ # Note: The following fields are mutually exclusive: `confluent_cloud_failure`, `cloud_storage_failure`, `aws_msk_failure`, `azure_event_hubs_failure`. If a field in that set is populated, all other fields in the set will automatically be cleared.
465
489
  class IngestionFailureEvent
466
490
  include ::Google::Protobuf::MessageExts
467
491
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -501,10 +525,14 @@ module Google
501
525
  # @!attribute [rw] avro_failure_reason
502
526
  # @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::AvroFailureReason]
503
527
  # Optional. Failure encountered when parsing an Avro file.
528
+ #
529
+ # Note: The following fields are mutually exclusive: `avro_failure_reason`, `api_violation_reason`. If a field in that set is populated, all other fields in the set will automatically be cleared.
504
530
  # @!attribute [rw] api_violation_reason
505
531
  # @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::ApiViolationReason]
506
532
  # Optional. The Pub/Sub API limits prevented the desired message from
507
533
  # being published.
534
+ #
535
+ # Note: The following fields are mutually exclusive: `api_violation_reason`, `avro_failure_reason`. If a field in that set is populated, all other fields in the set will automatically be cleared.
508
536
  class CloudStorageFailure
509
537
  include ::Google::Protobuf::MessageExts
510
538
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1187,9 +1215,13 @@ module Google
1187
1215
  # Optional. When set, the payload to the push endpoint is in the form of
1188
1216
  # the JSON representation of a PubsubMessage
1189
1217
  # (https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#pubsubmessage).
1218
+ #
1219
+ # Note: The following fields are mutually exclusive: `pubsub_wrapper`, `no_wrapper`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1190
1220
  # @!attribute [rw] no_wrapper
1191
1221
  # @return [::Google::Cloud::PubSub::V1::PushConfig::NoWrapper]
1192
1222
  # Optional. When set, the payload to the push endpoint is not wrapped.
1223
+ #
1224
+ # Note: The following fields are mutually exclusive: `no_wrapper`, `pubsub_wrapper`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1193
1225
  class PushConfig
1194
1226
  include ::Google::Protobuf::MessageExts
1195
1227
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1345,10 +1377,14 @@ module Google
1345
1377
  # @return [::Google::Cloud::PubSub::V1::CloudStorageConfig::TextConfig]
1346
1378
  # Optional. If set, message data will be written to Cloud Storage in text
1347
1379
  # format.
1380
+ #
1381
+ # Note: The following fields are mutually exclusive: `text_config`, `avro_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1348
1382
  # @!attribute [rw] avro_config
1349
1383
  # @return [::Google::Cloud::PubSub::V1::CloudStorageConfig::AvroConfig]
1350
1384
  # Optional. If set, message data will be written to Cloud Storage in Avro
1351
1385
  # format.
1386
+ #
1387
+ # Note: The following fields are mutually exclusive: `avro_config`, `text_config`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1352
1388
  # @!attribute [rw] max_duration
1353
1389
  # @return [::Google::Protobuf::Duration]
1354
1390
  # Optional. The maximum duration that can elapse before a new Cloud Storage
@@ -1934,11 +1970,15 @@ module Google
1934
1970
  # window (or to a point before the system's notion of the subscription
1935
1971
  # creation time), only retained messages will be marked as unacknowledged,
1936
1972
  # and already-expunged messages will not be restored.
1973
+ #
1974
+ # Note: The following fields are mutually exclusive: `time`, `snapshot`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1937
1975
  # @!attribute [rw] snapshot
1938
1976
  # @return [::String]
1939
1977
  # Optional. The snapshot to seek to. The snapshot's topic must be the same
1940
1978
  # as that of the provided subscription. Format is
1941
1979
  # `projects/{project}/snapshots/{snap}`.
1980
+ #
1981
+ # Note: The following fields are mutually exclusive: `snapshot`, `time`. If a field in that set is populated, all other fields in the set will automatically be cleared.
1942
1982
  class SeekRequest
1943
1983
  include ::Google::Protobuf::MessageExts
1944
1984
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -251,9 +251,13 @@ module Google
251
251
  # Name of the schema against which to validate.
252
252
  #
253
253
  # Format is `projects/{project}/schemas/{schema}`.
254
+ #
255
+ # Note: The following fields are mutually exclusive: `name`, `schema`. If a field in that set is populated, all other fields in the set will automatically be cleared.
254
256
  # @!attribute [rw] schema
255
257
  # @return [::Google::Cloud::PubSub::V1::Schema]
256
258
  # Ad-hoc schema against which to validate
259
+ #
260
+ # Note: The following fields are mutually exclusive: `schema`, `name`. If a field in that set is populated, all other fields in the set will automatically be cleared.
257
261
  # @!attribute [rw] message
258
262
  # @return [::String]
259
263
  # Message to validate against the provided `schema_spec`.
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-pubsub-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.5.0
4
+ version: 1.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  bindir: bin
9
9
  cert_chain: []
10
- date: 2025-01-15 00:00:00.000000000 Z
10
+ date: 2025-01-29 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: gapic-common
@@ -15,7 +15,7 @@ dependencies:
15
15
  requirements:
16
16
  - - ">="
17
17
  - !ruby/object:Gem::Version
18
- version: 0.24.0
18
+ version: 0.25.0
19
19
  - - "<"
20
20
  - !ruby/object:Gem::Version
21
21
  version: 2.a
@@ -25,7 +25,7 @@ dependencies:
25
25
  requirements:
26
26
  - - ">="
27
27
  - !ruby/object:Gem::Version
28
- version: 0.24.0
28
+ version: 0.25.0
29
29
  - - "<"
30
30
  - !ruby/object:Gem::Version
31
31
  version: 2.a
@@ -124,7 +124,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
124
124
  requirements:
125
125
  - - ">="
126
126
  - !ruby/object:Gem::Version
127
- version: '2.7'
127
+ version: '3.0'
128
128
  required_rubygems_version: !ruby/object:Gem::Requirement
129
129
  requirements:
130
130
  - - ">="