google-cloud-pubsub 1.3.0 → 1.3.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f176e0d099e688edae5273450671e309a2ddd9a34ff6845a29dcbe972e452aba
4
- data.tar.gz: 47cf3c8e40d728c48c306646381e0d3024bd95f8986675aae285c929a7ebffb0
3
+ metadata.gz: f26c2a38c13ef273ff8229e9dadb5d8aba0801d5c29b48259565034a047f8aed
4
+ data.tar.gz: de65d5a0bc5f33f08e59746c355ede1aa56ecccddcfc316450008a9f4f2803d9
5
5
  SHA512:
6
- metadata.gz: 5df91b44a3f0bcb2ec096fa49b6bac50b04af7e8cb4e6896a1d4be456663f5f009690ff37b875664e04c55a55bb84acb06c55c2dfacec290672746da071e93be
7
- data.tar.gz: 363d70b5b69b06169afc5256d83c8f8f62b2fea532bd612d37ded55114f0f421bd978f13cf5329be3ca481bd059f853143705d9aa2ca00cf27cba032b63135f2
6
+ metadata.gz: d97089f6027ead3a45ef47f728b6f9453be23b22edba0e01419a89d549045b262f2ea6ba5c10faa49d4743a33b36dcb2f556bdfd57e307f8bb41499c2a23f030
7
+ data.tar.gz: dc4246d15947e550dc362e68ef7713fed3a272d7eb2ac86e0642f6b717a1143c41f9c23069536176ede2668a93eaeea6496c6bf4224f7d7586a3df29e3b234a4
data/CHANGELOG.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # Release History
2
2
 
3
+ ### 1.3.1 / 2020-02-18
4
+
5
+ #### Bug Fixes
6
+
7
+ * Move Thread.new to end of AsyncPublisher#initialize
8
+
3
9
  ### 1.3.0 / 2020-02-10
4
10
 
5
11
  #### Features
@@ -83,12 +83,12 @@ module Google
83
83
  @published_at = nil
84
84
  @publish_thread_pool = Concurrent::ThreadPoolExecutor.new max_threads: @publish_threads
85
85
  @callback_thread_pool = Concurrent::ThreadPoolExecutor.new max_threads: @callback_threads
86
- @thread = Thread.new { run_background }
87
86
 
88
87
  @ordered = false
89
88
  @batches = {}
90
-
91
89
  @cond = new_cond
90
+
91
+ @thread = Thread.new { run_background }
92
92
  end
93
93
 
94
94
  ##
@@ -29,7 +29,7 @@ module Google
29
29
  # A topic resource.
30
30
  # @!attribute [rw] name
31
31
  # @return [String]
32
- # The name of the topic. It must have the format
32
+ # Required. The name of the topic. It must have the format
33
33
  # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
34
34
  # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
35
35
  # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
@@ -95,17 +95,17 @@ module Google
95
95
  # Request for the GetTopic method.
96
96
  # @!attribute [rw] topic
97
97
  # @return [String]
98
- # The name of the topic to get.
98
+ # Required. The name of the topic to get.
99
99
  # Format is `projects/{project}/topics/{topic}`.
100
100
  class GetTopicRequest; end
101
101
 
102
102
  # Request for the UpdateTopic method.
103
103
  # @!attribute [rw] topic
104
104
  # @return [Google::Cloud::PubSub::V1::Topic]
105
- # The updated topic object.
105
+ # Required. The updated topic object.
106
106
  # @!attribute [rw] update_mask
107
107
  # @return [Google::Protobuf::FieldMask]
108
- # Indicates which fields in the provided topic to update. Must be specified
108
+ # Required. Indicates which fields in the provided topic to update. Must be specified
109
109
  # and non-empty. Note that if `update_mask` contains
110
110
  # "message_storage_policy" then the new value will be determined based on the
111
111
  # policy configured at the project or organization level. The
@@ -115,11 +115,11 @@ module Google
115
115
  # Request for the Publish method.
116
116
  # @!attribute [rw] topic
117
117
  # @return [String]
118
- # The messages in the request will be published on this topic.
118
+ # Required. The messages in the request will be published on this topic.
119
119
  # Format is `projects/{project}/topics/{topic}`.
120
120
  # @!attribute [rw] messages
121
121
  # @return [Array<Google::Cloud::PubSub::V1::PubsubMessage>]
122
- # The messages to publish.
122
+ # Required. The messages to publish.
123
123
  class PublishRequest; end
124
124
 
125
125
  # Response for the `Publish` method.
@@ -133,7 +133,7 @@ module Google
133
133
  # Request for the `ListTopics` method.
134
134
  # @!attribute [rw] project
135
135
  # @return [String]
136
- # The name of the project in which to list topics.
136
+ # Required. The name of the project in which to list topics.
137
137
  # Format is `projects/{project-id}`.
138
138
  # @!attribute [rw] page_size
139
139
  # @return [Integer]
@@ -158,7 +158,7 @@ module Google
158
158
  # Request for the `ListTopicSubscriptions` method.
159
159
  # @!attribute [rw] topic
160
160
  # @return [String]
161
- # The name of the topic that subscriptions are attached to.
161
+ # Required. The name of the topic that subscriptions are attached to.
162
162
  # Format is `projects/{project}/topics/{topic}`.
163
163
  # @!attribute [rw] page_size
164
164
  # @return [Integer]
@@ -210,22 +210,22 @@ module Google
210
210
  # Request for the `DeleteTopic` method.
211
211
  # @!attribute [rw] topic
212
212
  # @return [String]
213
- # Name of the topic to delete.
213
+ # Required. Name of the topic to delete.
214
214
  # Format is `projects/{project}/topics/{topic}`.
215
215
  class DeleteTopicRequest; end
216
216
 
217
217
  # A subscription resource.
218
218
  # @!attribute [rw] name
219
219
  # @return [String]
220
- # The name of the subscription. It must have the format
220
+ # Required. The name of the subscription. It must have the format
221
221
  # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
222
222
  # start with a letter, and contain only letters (`[A-Za-z]`), numbers
223
223
  # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
224
224
  # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
225
- # in length, and it must not start with `"goog"`
225
+ # in length, and it must not start with `"goog"`.
226
226
  # @!attribute [rw] topic
227
227
  # @return [String]
228
- # The name of the topic from which this subscription is receiving messages.
228
+ # Required. The name of the topic from which this subscription is receiving messages.
229
229
  # Format is `projects/{project}/topics/{topic}`.
230
230
  # The value of this field will be `_deleted-topic_` if the topic has been
231
231
  # deleted.
@@ -438,24 +438,24 @@ module Google
438
438
  # Request for the GetSubscription method.
439
439
  # @!attribute [rw] subscription
440
440
  # @return [String]
441
- # The name of the subscription to get.
441
+ # Required. The name of the subscription to get.
442
442
  # Format is `projects/{project}/subscriptions/{sub}`.
443
443
  class GetSubscriptionRequest; end
444
444
 
445
445
  # Request for the UpdateSubscription method.
446
446
  # @!attribute [rw] subscription
447
447
  # @return [Google::Cloud::PubSub::V1::Subscription]
448
- # The updated subscription object.
448
+ # Required. The updated subscription object.
449
449
  # @!attribute [rw] update_mask
450
450
  # @return [Google::Protobuf::FieldMask]
451
- # Indicates which fields in the provided subscription to update.
451
+ # Required. Indicates which fields in the provided subscription to update.
452
452
  # Must be specified and non-empty.
453
453
  class UpdateSubscriptionRequest; end
454
454
 
455
455
  # Request for the `ListSubscriptions` method.
456
456
  # @!attribute [rw] project
457
457
  # @return [String]
458
- # The name of the project in which to list subscriptions.
458
+ # Required. The name of the project in which to list subscriptions.
459
459
  # Format is `projects/{project-id}`.
460
460
  # @!attribute [rw] page_size
461
461
  # @return [Integer]
@@ -481,18 +481,18 @@ module Google
481
481
  # Request for the DeleteSubscription method.
482
482
  # @!attribute [rw] subscription
483
483
  # @return [String]
484
- # The subscription to delete.
484
+ # Required. The subscription to delete.
485
485
  # Format is `projects/{project}/subscriptions/{sub}`.
486
486
  class DeleteSubscriptionRequest; end
487
487
 
488
488
  # Request for the ModifyPushConfig method.
489
489
  # @!attribute [rw] subscription
490
490
  # @return [String]
491
- # The name of the subscription.
491
+ # Required. The name of the subscription.
492
492
  # Format is `projects/{project}/subscriptions/{sub}`.
493
493
  # @!attribute [rw] push_config
494
494
  # @return [Google::Cloud::PubSub::V1::PushConfig]
495
- # The push configuration for future deliveries.
495
+ # Required. The push configuration for future deliveries.
496
496
  #
497
497
  # An empty `pushConfig` indicates that the Pub/Sub system should
498
498
  # stop pushing messages from the given subscription and allow
@@ -503,7 +503,7 @@ module Google
503
503
  # Request for the `Pull` method.
504
504
  # @!attribute [rw] subscription
505
505
  # @return [String]
506
- # The subscription from which messages should be pulled.
506
+ # Required. The subscription from which messages should be pulled.
507
507
  # Format is `projects/{project}/subscriptions/{sub}`.
508
508
  # @!attribute [rw] return_immediately
509
509
  # @return [true, false]
@@ -513,7 +513,7 @@ module Google
513
513
  # least one message is available, rather than returning no messages.
514
514
  # @!attribute [rw] max_messages
515
515
  # @return [Integer]
516
- # The maximum number of messages to return for this request. Must be a
516
+ # Required. The maximum number of messages to return for this request. Must be a
517
517
  # positive integer. The Pub/Sub system may return fewer than the number
518
518
  # specified.
519
519
  class PullRequest; end
@@ -530,14 +530,14 @@ module Google
530
530
  # Request for the ModifyAckDeadline method.
531
531
  # @!attribute [rw] subscription
532
532
  # @return [String]
533
- # The name of the subscription.
533
+ # Required. The name of the subscription.
534
534
  # Format is `projects/{project}/subscriptions/{sub}`.
535
535
  # @!attribute [rw] ack_ids
536
536
  # @return [Array<String>]
537
- # List of acknowledgment IDs.
537
+ # Required. List of acknowledgment IDs.
538
538
  # @!attribute [rw] ack_deadline_seconds
539
539
  # @return [Integer]
540
- # The new ack deadline with respect to the time this request was sent to
540
+ # Required. The new ack deadline with respect to the time this request was sent to
541
541
  # the Pub/Sub system. For example, if the value is 10, the new
542
542
  # ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
543
543
  # was made. Specifying zero might immediately make the message available for
@@ -550,11 +550,11 @@ module Google
550
550
  # Request for the Acknowledge method.
551
551
  # @!attribute [rw] subscription
552
552
  # @return [String]
553
- # The subscription whose message is being acknowledged.
553
+ # Required. The subscription whose message is being acknowledged.
554
554
  # Format is `projects/{project}/subscriptions/{sub}`.
555
555
  # @!attribute [rw] ack_ids
556
556
  # @return [Array<String>]
557
- # The acknowledgment ID for the messages being acknowledged that was returned
557
+ # Required. The acknowledgment ID for the messages being acknowledged that was returned
558
558
  # by the Pub/Sub system in the `Pull` response. Must not be empty.
559
559
  class AcknowledgeRequest; end
560
560
 
@@ -563,7 +563,7 @@ module Google
563
563
  # deadline modifications from the client to the server.
564
564
  # @!attribute [rw] subscription
565
565
  # @return [String]
566
- # The subscription for which to initialize the new stream. This must be
566
+ # Required. The subscription for which to initialize the new stream. This must be
567
567
  # provided in the first request on the stream, and must not be set in
568
568
  # subsequent requests from client to server.
569
569
  # Format is `projects/{project}/subscriptions/{sub}`.
@@ -596,7 +596,7 @@ module Google
596
596
  # processing was interrupted.
597
597
  # @!attribute [rw] stream_ack_deadline_seconds
598
598
  # @return [Integer]
599
- # The ack deadline to use for the stream. This must be provided in the
599
+ # Required. The ack deadline to use for the stream. This must be provided in the
600
600
  # first request on the stream, but it can also be updated on subsequent
601
601
  # requests from client to server. The minimum deadline you can specify is 10
602
602
  # seconds. The maximum deadline you can specify is 600 seconds (10 minutes).
@@ -620,7 +620,7 @@ module Google
620
620
  # Request for the `CreateSnapshot` method.
621
621
  # @!attribute [rw] name
622
622
  # @return [String]
623
- # User-provided name for this snapshot. If the name is not provided in the
623
+ # Required. User-provided name for this snapshot. If the name is not provided in the
624
624
  # request, the server will assign a random name for this snapshot on the same
625
625
  # project as the subscription. Note that for REST API requests, you must
626
626
  # specify a name. See the <a
@@ -628,7 +628,7 @@ module Google
628
628
  # name rules</a>. Format is `projects/{project}/snapshots/{snap}`.
629
629
  # @!attribute [rw] subscription
630
630
  # @return [String]
631
- # The subscription whose backlog the snapshot retains.
631
+ # Required. The subscription whose backlog the snapshot retains.
632
632
  # Specifically, the created snapshot is guaranteed to retain:
633
633
  # (a) The existing backlog on the subscription. More precisely, this is
634
634
  # defined as the messages in the subscription's backlog that are
@@ -646,10 +646,10 @@ module Google
646
646
  # Request for the UpdateSnapshot method.
647
647
  # @!attribute [rw] snapshot
648
648
  # @return [Google::Cloud::PubSub::V1::Snapshot]
649
- # The updated snapshot object.
649
+ # Required. The updated snapshot object.
650
650
  # @!attribute [rw] update_mask
651
651
  # @return [Google::Protobuf::FieldMask]
652
- # Indicates which fields in the provided snapshot to update.
652
+ # Required. Indicates which fields in the provided snapshot to update.
653
653
  # Must be specified and non-empty.
654
654
  class UpdateSnapshotRequest; end
655
655
 
@@ -686,14 +686,14 @@ module Google
686
686
  # Request for the GetSnapshot method.
687
687
  # @!attribute [rw] snapshot
688
688
  # @return [String]
689
- # The name of the snapshot to get.
689
+ # Required. The name of the snapshot to get.
690
690
  # Format is `projects/{project}/snapshots/{snap}`.
691
691
  class GetSnapshotRequest; end
692
692
 
693
693
  # Request for the `ListSnapshots` method.
694
694
  # @!attribute [rw] project
695
695
  # @return [String]
696
- # The name of the project in which to list snapshots.
696
+ # Required. The name of the project in which to list snapshots.
697
697
  # Format is `projects/{project-id}`.
698
698
  # @!attribute [rw] page_size
699
699
  # @return [Integer]
@@ -718,14 +718,14 @@ module Google
718
718
  # Request for the `DeleteSnapshot` method.
719
719
  # @!attribute [rw] snapshot
720
720
  # @return [String]
721
- # The name of the snapshot to delete.
721
+ # Required. The name of the snapshot to delete.
722
722
  # Format is `projects/{project}/snapshots/{snap}`.
723
723
  class DeleteSnapshotRequest; end
724
724
 
725
725
  # Request for the `Seek` method.
726
726
  # @!attribute [rw] subscription
727
727
  # @return [String]
728
- # The subscription to affect.
728
+ # Required. The subscription to affect.
729
729
  # @!attribute [rw] time
730
730
  # @return [Google::Protobuf::Timestamp]
731
731
  # The time to seek to.
@@ -330,7 +330,7 @@ module Google
330
330
  # resource name rules</a>.
331
331
  #
332
332
  # @param name [String]
333
- # The name of the topic. It must have the format
333
+ # Required. The name of the topic. It must have the format
334
334
  # `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
335
335
  # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
336
336
  # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
@@ -386,11 +386,11 @@ module Google
386
386
  # topic are not modifiable.
387
387
  #
388
388
  # @param topic [Google::Cloud::PubSub::V1::Topic | Hash]
389
- # The updated topic object.
389
+ # Required. The updated topic object.
390
390
  # A hash of the same form as `Google::Cloud::PubSub::V1::Topic`
391
391
  # can also be provided.
392
392
  # @param update_mask [Google::Protobuf::FieldMask | Hash]
393
- # Indicates which fields in the provided topic to update. Must be specified
393
+ # Required. Indicates which fields in the provided topic to update. Must be specified
394
394
  # and non-empty. Note that if `update_mask` contains
395
395
  # "message_storage_policy" then the new value will be determined based on the
396
396
  # policy configured at the project or organization level. The
@@ -434,10 +434,10 @@ module Google
434
434
  # does not exist.
435
435
  #
436
436
  # @param topic [String]
437
- # The messages in the request will be published on this topic.
437
+ # Required. The messages in the request will be published on this topic.
438
438
  # Format is `projects/{project}/topics/{topic}`.
439
439
  # @param messages [Array<Google::Cloud::PubSub::V1::PubsubMessage | Hash>]
440
- # The messages to publish.
440
+ # Required. The messages to publish.
441
441
  # A hash of the same form as `Google::Cloud::PubSub::V1::PubsubMessage`
442
442
  # can also be provided.
443
443
  # @param options [Google::Gax::CallOptions]
@@ -474,7 +474,7 @@ module Google
474
474
  # Gets the configuration of a topic.
475
475
  #
476
476
  # @param topic [String]
477
- # The name of the topic to get.
477
+ # Required. The name of the topic to get.
478
478
  # Format is `projects/{project}/topics/{topic}`.
479
479
  # @param options [Google::Gax::CallOptions]
480
480
  # Overrides the default settings for this call, e.g, timeout,
@@ -505,7 +505,7 @@ module Google
505
505
  # Lists matching topics.
506
506
  #
507
507
  # @param project [String]
508
- # The name of the project in which to list topics.
508
+ # Required. The name of the project in which to list topics.
509
509
  # Format is `projects/{project-id}`.
510
510
  # @param page_size [Integer]
511
511
  # The maximum number of resources contained in the underlying API
@@ -560,7 +560,7 @@ module Google
560
560
  # Lists the names of the subscriptions on this topic.
561
561
  #
562
562
  # @param topic [String]
563
- # The name of the topic that subscriptions are attached to.
563
+ # Required. The name of the topic that subscriptions are attached to.
564
564
  # Format is `projects/{project}/topics/{topic}`.
565
565
  # @param page_size [Integer]
566
566
  # The maximum number of resources contained in the underlying API
@@ -619,7 +619,7 @@ module Google
619
619
  # not deleted, but their `topic` field is set to `_deleted-topic_`.
620
620
  #
621
621
  # @param topic [String]
622
- # Name of the topic to delete.
622
+ # Required. Name of the topic to delete.
623
623
  # Format is `projects/{project}/topics/{topic}`.
624
624
  # @param options [Google::Gax::CallOptions]
625
625
  # Overrides the default settings for this call, e.g, timeout,
@@ -647,8 +647,11 @@ module Google
647
647
  nil
648
648
  end
649
649
 
650
- # Sets the access control policy on the specified resource. Replaces any
651
- # existing policy.
650
+ # Sets the access control policy on the specified resource. Replaces
651
+ # any existing policy.
652
+ #
653
+ # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
654
+ # PERMISSION_DENIED
652
655
  #
653
656
  # @param resource [String]
654
657
  # REQUIRED: The resource for which the policy is being specified.
@@ -691,9 +694,8 @@ module Google
691
694
  @set_iam_policy.call(req, options, &block)
692
695
  end
693
696
 
694
- # Gets the access control policy for a resource.
695
- # Returns an empty policy if the resource exists and does not have a policy
696
- # set.
697
+ # Gets the access control policy for a resource. Returns an empty policy
698
+ # if the resource exists and does not have a policy set.
697
699
  #
698
700
  # @param resource [String]
699
701
  # REQUIRED: The resource for which the policy is being requested.
@@ -731,13 +733,13 @@ module Google
731
733
  @get_iam_policy.call(req, options, &block)
732
734
  end
733
735
 
734
- # Returns permissions that a caller has on the specified resource.
735
- # If the resource does not exist, this will return an empty set of
736
+ # Returns permissions that a caller has on the specified resource. If the
737
+ # resource does not exist, this will return an empty set of
736
738
  # permissions, not a NOT_FOUND error.
737
739
  #
738
- # Note: This operation is designed to be used for building permission-aware
739
- # UIs and command-line tools, not for authorization checking. This operation
740
- # may "fail open" without warning.
740
+ # Note: This operation is designed to be used for building
741
+ # permission-aware UIs and command-line tools, not for authorization
742
+ # checking. This operation may "fail open" without warning.
741
743
  #
742
744
  # @param resource [String]
743
745
  # REQUIRED: The resource for which the policy detail is being requested.
@@ -53,7 +53,7 @@
53
53
  "retry_params_name": "default"
54
54
  },
55
55
  "Publish": {
56
- "timeout_millis": 60000,
56
+ "timeout_millis": 20000,
57
57
  "retry_codes_name": "publish",
58
58
  "retry_params_name": "messaging",
59
59
  "bundling": {
@@ -424,14 +424,14 @@ module Google
424
424
  # for REST API requests, you must specify a name in the request.
425
425
  #
426
426
  # @param name [String]
427
- # The name of the subscription. It must have the format
427
+ # Required. The name of the subscription. It must have the format
428
428
  # `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
429
429
  # start with a letter, and contain only letters (`[A-Za-z]`), numbers
430
430
  # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
431
431
  # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
432
- # in length, and it must not start with `"goog"`
432
+ # in length, and it must not start with `"goog"`.
433
433
  # @param topic [String]
434
- # The name of the topic from which this subscription is receiving messages.
434
+ # Required. The name of the topic from which this subscription is receiving messages.
435
435
  # Format is `projects/{project}/topics/{topic}`.
436
436
  # The value of this field will be `_deleted-topic_` if the topic has been
437
437
  # deleted.
@@ -561,7 +561,7 @@ module Google
561
561
  # Gets the configuration details of a subscription.
562
562
  #
563
563
  # @param subscription [String]
564
- # The name of the subscription to get.
564
+ # Required. The name of the subscription to get.
565
565
  # Format is `projects/{project}/subscriptions/{sub}`.
566
566
  # @param options [Google::Gax::CallOptions]
567
567
  # Overrides the default settings for this call, e.g, timeout,
@@ -593,11 +593,11 @@ module Google
593
593
  # subscription, such as its topic, are not modifiable.
594
594
  #
595
595
  # @param subscription [Google::Cloud::PubSub::V1::Subscription | Hash]
596
- # The updated subscription object.
596
+ # Required. The updated subscription object.
597
597
  # A hash of the same form as `Google::Cloud::PubSub::V1::Subscription`
598
598
  # can also be provided.
599
599
  # @param update_mask [Google::Protobuf::FieldMask | Hash]
600
- # Indicates which fields in the provided subscription to update.
600
+ # Required. Indicates which fields in the provided subscription to update.
601
601
  # Must be specified and non-empty.
602
602
  # A hash of the same form as `Google::Protobuf::FieldMask`
603
603
  # can also be provided.
@@ -636,7 +636,7 @@ module Google
636
636
  # Lists matching subscriptions.
637
637
  #
638
638
  # @param project [String]
639
- # The name of the project in which to list subscriptions.
639
+ # Required. The name of the project in which to list subscriptions.
640
640
  # Format is `projects/{project-id}`.
641
641
  # @param page_size [Integer]
642
642
  # The maximum number of resources contained in the underlying API
@@ -695,7 +695,7 @@ module Google
695
695
  # subscription or its topic unless the same topic is specified.
696
696
  #
697
697
  # @param subscription [String]
698
- # The subscription to delete.
698
+ # Required. The subscription to delete.
699
699
  # Format is `projects/{project}/subscriptions/{sub}`.
700
700
  # @param options [Google::Gax::CallOptions]
701
701
  # Overrides the default settings for this call, e.g, timeout,
@@ -730,12 +730,12 @@ module Google
730
730
  # subscription-level `ackDeadlineSeconds` used for subsequent messages.
731
731
  #
732
732
  # @param subscription [String]
733
- # The name of the subscription.
733
+ # Required. The name of the subscription.
734
734
  # Format is `projects/{project}/subscriptions/{sub}`.
735
735
  # @param ack_ids [Array<String>]
736
- # List of acknowledgment IDs.
736
+ # Required. List of acknowledgment IDs.
737
737
  # @param ack_deadline_seconds [Integer]
738
- # The new ack deadline with respect to the time this request was sent to
738
+ # Required. The new ack deadline with respect to the time this request was sent to
739
739
  # the Pub/Sub system. For example, if the value is 10, the new
740
740
  # ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
741
741
  # was made. Specifying zero might immediately make the message available for
@@ -788,10 +788,10 @@ module Google
788
788
  # than once will not result in an error.
789
789
  #
790
790
  # @param subscription [String]
791
- # The subscription whose message is being acknowledged.
791
+ # Required. The subscription whose message is being acknowledged.
792
792
  # Format is `projects/{project}/subscriptions/{sub}`.
793
793
  # @param ack_ids [Array<String>]
794
- # The acknowledgment ID for the messages being acknowledged that was returned
794
+ # Required. The acknowledgment ID for the messages being acknowledged that was returned
795
795
  # by the Pub/Sub system in the `Pull` response. Must not be empty.
796
796
  # @param options [Google::Gax::CallOptions]
797
797
  # Overrides the default settings for this call, e.g, timeout,
@@ -829,10 +829,10 @@ module Google
829
829
  # subscription.
830
830
  #
831
831
  # @param subscription [String]
832
- # The subscription from which messages should be pulled.
832
+ # Required. The subscription from which messages should be pulled.
833
833
  # Format is `projects/{project}/subscriptions/{sub}`.
834
834
  # @param max_messages [Integer]
835
- # The maximum number of messages to return for this request. Must be a
835
+ # Required. The maximum number of messages to return for this request. Must be a
836
836
  # positive integer. The Pub/Sub system may return fewer than the number
837
837
  # specified.
838
838
  # @param return_immediately [true, false]
@@ -925,10 +925,10 @@ module Google
925
925
  # continuously through the call regardless of changes to the `PushConfig`.
926
926
  #
927
927
  # @param subscription [String]
928
- # The name of the subscription.
928
+ # Required. The name of the subscription.
929
929
  # Format is `projects/{project}/subscriptions/{sub}`.
930
930
  # @param push_config [Google::Cloud::PubSub::V1::PushConfig | Hash]
931
- # The push configuration for future deliveries.
931
+ # Required. The push configuration for future deliveries.
932
932
  #
933
933
  # An empty `pushConfig` indicates that the Pub/Sub system should
934
934
  # stop pushing messages from the given subscription and allow
@@ -975,7 +975,7 @@ module Google
975
975
  # captured by a snapshot.
976
976
  #
977
977
  # @param project [String]
978
- # The name of the project in which to list snapshots.
978
+ # Required. The name of the project in which to list snapshots.
979
979
  # Format is `projects/{project-id}`.
980
980
  # @param page_size [Integer]
981
981
  # The maximum number of resources contained in the underlying API
@@ -1047,14 +1047,14 @@ module Google
1047
1047
  # REST API requests, you must specify a name in the request.
1048
1048
  #
1049
1049
  # @param name [String]
1050
- # User-provided name for this snapshot. If the name is not provided in the
1050
+ # Required. User-provided name for this snapshot. If the name is not provided in the
1051
1051
  # request, the server will assign a random name for this snapshot on the same
1052
1052
  # project as the subscription. Note that for REST API requests, you must
1053
1053
  # specify a name. See the <a
1054
1054
  # href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource
1055
1055
  # name rules</a>. Format is `projects/{project}/snapshots/{snap}`.
1056
1056
  # @param subscription [String]
1057
- # The subscription whose backlog the snapshot retains.
1057
+ # Required. The subscription whose backlog the snapshot retains.
1058
1058
  # Specifically, the created snapshot is guaranteed to retain:
1059
1059
  # (a) The existing backlog on the subscription. More precisely, this is
1060
1060
  # defined as the messages in the subscription's backlog that are
@@ -1105,11 +1105,11 @@ module Google
1105
1105
  # captured by a snapshot.
1106
1106
  #
1107
1107
  # @param snapshot [Google::Cloud::PubSub::V1::Snapshot | Hash]
1108
- # The updated snapshot object.
1108
+ # Required. The updated snapshot object.
1109
1109
  # A hash of the same form as `Google::Cloud::PubSub::V1::Snapshot`
1110
1110
  # can also be provided.
1111
1111
  # @param update_mask [Google::Protobuf::FieldMask | Hash]
1112
- # Indicates which fields in the provided snapshot to update.
1112
+ # Required. Indicates which fields in the provided snapshot to update.
1113
1113
  # Must be specified and non-empty.
1114
1114
  # A hash of the same form as `Google::Protobuf::FieldMask`
1115
1115
  # can also be provided.
@@ -1158,7 +1158,7 @@ module Google
1158
1158
  # snapshot or its subscription, unless the same subscription is specified.
1159
1159
  #
1160
1160
  # @param snapshot [String]
1161
- # The name of the snapshot to delete.
1161
+ # Required. The name of the snapshot to delete.
1162
1162
  # Format is `projects/{project}/snapshots/{snap}`.
1163
1163
  # @param options [Google::Gax::CallOptions]
1164
1164
  # Overrides the default settings for this call, e.g, timeout,
@@ -1196,7 +1196,7 @@ module Google
1196
1196
  # must be on the same topic.
1197
1197
  #
1198
1198
  # @param subscription [String]
1199
- # The subscription to affect.
1199
+ # Required. The subscription to affect.
1200
1200
  # @param time [Google::Protobuf::Timestamp | Hash]
1201
1201
  # The time to seek to.
1202
1202
  # Messages retained in the subscription that were published before this
@@ -1245,8 +1245,11 @@ module Google
1245
1245
  @seek.call(req, options, &block)
1246
1246
  end
1247
1247
 
1248
- # Sets the access control policy on the specified resource. Replaces any
1249
- # existing policy.
1248
+ # Sets the access control policy on the specified resource. Replaces
1249
+ # any existing policy.
1250
+ #
1251
+ # Can return Public Errors: NOT_FOUND, INVALID_ARGUMENT and
1252
+ # PERMISSION_DENIED
1250
1253
  #
1251
1254
  # @param resource [String]
1252
1255
  # REQUIRED: The resource for which the policy is being specified.
@@ -1289,9 +1292,8 @@ module Google
1289
1292
  @set_iam_policy.call(req, options, &block)
1290
1293
  end
1291
1294
 
1292
- # Gets the access control policy for a resource.
1293
- # Returns an empty policy if the resource exists and does not have a policy
1294
- # set.
1295
+ # Gets the access control policy for a resource. Returns an empty policy
1296
+ # if the resource exists and does not have a policy set.
1295
1297
  #
1296
1298
  # @param resource [String]
1297
1299
  # REQUIRED: The resource for which the policy is being requested.
@@ -1329,13 +1331,13 @@ module Google
1329
1331
  @get_iam_policy.call(req, options, &block)
1330
1332
  end
1331
1333
 
1332
- # Returns permissions that a caller has on the specified resource.
1333
- # If the resource does not exist, this will return an empty set of
1334
+ # Returns permissions that a caller has on the specified resource. If the
1335
+ # resource does not exist, this will return an empty set of
1334
1336
  # permissions, not a NOT_FOUND error.
1335
1337
  #
1336
- # Note: This operation is designed to be used for building permission-aware
1337
- # UIs and command-line tools, not for authorization checking. This operation
1338
- # may "fail open" without warning.
1338
+ # Note: This operation is designed to be used for building
1339
+ # permission-aware UIs and command-line tools, not for authorization
1340
+ # checking. This operation may "fail open" without warning.
1339
1341
  #
1340
1342
  # @param resource [String]
1341
1343
  # REQUIRED: The resource for which the policy detail is being requested.
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module PubSub
19
- VERSION = "1.3.0".freeze
19
+ VERSION = "1.3.1".freeze
20
20
  end
21
21
 
22
22
  Pubsub = PubSub unless const_defined? :Pubsub
@@ -4,12 +4,14 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
8
7
  require 'google/api/client_pb'
8
+ require 'google/api/field_behavior_pb'
9
+ require 'google/api/resource_pb'
9
10
  require 'google/protobuf/duration_pb'
10
11
  require 'google/protobuf/empty_pb'
11
12
  require 'google/protobuf/field_mask_pb'
12
13
  require 'google/protobuf/timestamp_pb'
14
+ require 'google/api/annotations_pb'
13
15
  Google::Protobuf::DescriptorPool.generated_pool.build do
14
16
  add_message "google.pubsub.v1.MessageStoragePolicy" do
15
17
  repeated :allowed_persistence_regions, :string, 1
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-pubsub
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.3.0
4
+ version: 1.3.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Mike Moore
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2020-02-10 00:00:00.000000000 Z
12
+ date: 2020-02-18 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: concurrent-ruby