google-cloud-pubsub 1.1.3 → 1.10.0

data/lib/google/cloud/pubsub/v1/subscriber_client.rb

@@ -1,4 +1,4 @@
-# Copyright 2019 Google LLC
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -222,6 +222,9 @@ module Google
             google_api_client.freeze
 
             headers = { :"x-goog-api-client" => google_api_client }
+            if credentials.respond_to?(:quota_project_id) && credentials.quota_project_id
+              headers[:"x-goog-user-project"] = credentials.quota_project_id
+            end
             headers.merge!(metadata) unless metadata.nil?
             client_config_file = Pathname.new(__dir__).join(
               "subscriber_client_config.json"
@@ -304,6 +307,14 @@ module Google
                 {'subscription' => request.subscription}
               end
             )
+            @get_snapshot = Google::Gax.create_api_call(
+              @subscriber_stub.method(:get_snapshot),
+              defaults["get_snapshot"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'snapshot' => request.snapshot}
+              end
+            )
             @modify_ack_deadline = Google::Gax.create_api_call(
               @subscriber_stub.method(:modify_ack_deadline),
               defaults["modify_ack_deadline"],
@@ -424,17 +435,16 @@ module Google
           # for REST API requests, you must specify a name in the request.
           #
           # @param name [String]
-          #   The name of the subscription. It must have the format
+          #   Required. The name of the subscription. It must have the format
           #   `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
           #   start with a letter, and contain only letters (`[A-Za-z]`), numbers
           #   (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
           #   plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
-          #   in length, and it must not start with `"goog"`
+          #   in length, and it must not start with `"goog"`.
           # @param topic [String]
-          #   The name of the topic from which this subscription is receiving messages.
-          #   Format is `projects/{project}/topics/{topic}`.
-          #   The value of this field will be `_deleted-topic_` if the topic has been
-          #   deleted.
+          #   Required. The name of the topic from which this subscription is receiving
+          #   messages. Format is `projects/{project}/topics/{topic}`. The value of this
+          #   field will be `_deleted-topic_` if the topic has been deleted.
           # @param push_config [Google::Cloud::PubSub::V1::PushConfig | Hash]
           #   If push delivery is used with this subscription, this field is
           #   used to configure it. An empty `pushConfig` signifies that the subscriber
@@ -499,6 +509,12 @@ module Google
           #   value for `expiration_policy.ttl` is 1 day.
           #   A hash of the same form as `Google::Cloud::PubSub::V1::ExpirationPolicy`
           #   can also be provided.
+          # @param filter [String]
+          #   An expression written in the Pub/Sub [filter
+          #   language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
+          #   then only `PubsubMessage`s whose `attributes` field matches the filter are
+          #   delivered on this subscription. If empty, then no messages are filtered
+          #   out.
           # @param dead_letter_policy [Google::Cloud::PubSub::V1::DeadLetterPolicy | Hash]
           #   A policy that specifies the conditions for dead lettering messages in
           #   this subscription. If dead_letter_policy is not set, dead lettering
@@ -508,11 +524,24 @@ module Google
           #   parent project (i.e.,
           #   service-\\{project_number}@gcp-sa-pubsub.iam.gserviceaccount.com) must have
           #   permission to Acknowledge() messages on this subscription.
-          #   <b>EXPERIMENTAL:</b> This feature is part of a closed alpha release. This
-          #   API might be changed in backward-incompatible ways and is not recommended
-          #   for production use. It is not subject to any SLA or deprecation policy.
           #   A hash of the same form as `Google::Cloud::PubSub::V1::DeadLetterPolicy`
           #   can also be provided.
+          # @param retry_policy [Google::Cloud::PubSub::V1::RetryPolicy | Hash]
+          #   A policy that specifies how Pub/Sub retries message delivery for this
+          #   subscription.
+          #
+          #   If not set, the default retry policy is applied. This generally implies
+          #   that messages will be retried as soon as possible for healthy subscribers.
+          #   RetryPolicy will be triggered on NACKs or acknowledgement deadline
+          #   exceeded events for a given message.
+          #   A hash of the same form as `Google::Cloud::PubSub::V1::RetryPolicy`
+          #   can also be provided.
+          # @param detached [true, false]
+          #   Indicates whether the subscription is detached from its topic. Detached
+          #   subscriptions don't receive messages from their topic and don't retain any
+          #   backlog. `Pull` and `StreamingPull` requests will return
+          #   FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
+          #   the endpoint will not be made.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -539,7 +568,10 @@ module Google
               labels: nil,
               enable_message_ordering: nil,
               expiration_policy: nil,
+              filter: nil,
               dead_letter_policy: nil,
+              retry_policy: nil,
+              detached: nil,
               options: nil,
               &block
             req = {
@@ -552,7 +584,10 @@ module Google
               labels: labels,
               enable_message_ordering: enable_message_ordering,
               expiration_policy: expiration_policy,
-              dead_letter_policy: dead_letter_policy
+              filter: filter,
+              dead_letter_policy: dead_letter_policy,
+              retry_policy: retry_policy,
+              detached: detached
             }.delete_if { |_, v| v.nil? }
             req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::Subscription)
             @create_subscription.call(req, options, &block)
@@ -561,7 +596,7 @@ module Google
           # Gets the configuration details of a subscription.
           #
           # @param subscription [String]
-          #   The name of the subscription to get.
+          #   Required. The name of the subscription to get.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -593,11 +628,11 @@ module Google
           # subscription, such as its topic, are not modifiable.
           #
           # @param subscription [Google::Cloud::PubSub::V1::Subscription | Hash]
-          #   The updated subscription object.
+          #   Required. The updated subscription object.
           #   A hash of the same form as `Google::Cloud::PubSub::V1::Subscription`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Indicates which fields in the provided subscription to update.
+          #   Required. Indicates which fields in the provided subscription to update.
           #   Must be specified and non-empty.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
           #   can also be provided.
@@ -636,7 +671,7 @@ module Google
           # Lists matching subscriptions.
           #
           # @param project [String]
-          #   The name of the project in which to list subscriptions.
+          #   Required. The name of the project in which to list subscriptions.
           #   Format is `projects/{project-id}`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
@@ -695,7 +730,7 @@ module Google
           # subscription or its topic unless the same topic is specified.
           #
           # @param subscription [String]
-          #   The subscription to delete.
+          #   Required. The subscription to delete.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -723,6 +758,41 @@ module Google
             nil
           end
 
+          # Gets the configuration details of a snapshot. Snapshots are used in
+          # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
+          # operations, which allow you to manage message acknowledgments in bulk. That
+          # is, you can set the acknowledgment state of messages in an existing
+          # subscription to the state captured by a snapshot.
+          #
+          # @param snapshot [String]
+          #   Required. The name of the snapshot to get.
+          #   Format is `projects/{project}/snapshots/{snap}`.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::PubSub::V1::Snapshot]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::PubSub::V1::Snapshot]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/pubsub"
+          #
+          #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
+          #   formatted_snapshot = Google::Cloud::PubSub::V1::SubscriberClient.snapshot_path("[PROJECT]", "[SNAPSHOT]")
+          #   response = subscriber_client.get_snapshot(formatted_snapshot)
+
+          def get_snapshot \
+              snapshot,
+              options: nil,
+              &block
+            req = {
+              snapshot: snapshot
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::PubSub::V1::GetSnapshotRequest)
+            @get_snapshot.call(req, options, &block)
+          end
+
           # Modifies the ack deadline for a specific message. This method is useful
           # to indicate that more time is needed to process a message by the
           # subscriber, or to make the message available for redelivery if the
@@ -730,15 +800,15 @@ module Google
           # subscription-level `ackDeadlineSeconds` used for subsequent messages.
           #
           # @param subscription [String]
-          #   The name of the subscription.
+          #   Required. The name of the subscription.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param ack_ids [Array<String>]
-          #   List of acknowledgment IDs.
+          #   Required. List of acknowledgment IDs.
           # @param ack_deadline_seconds [Integer]
-          #   The new ack deadline with respect to the time this request was sent to
-          #   the Pub/Sub system. For example, if the value is 10, the new
-          #   ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
-          #   was made. Specifying zero might immediately make the message available for
+          #   Required. The new ack deadline with respect to the time this request was
+          #   sent to the Pub/Sub system. For example, if the value is 10, the new ack
+          #   deadline will expire 10 seconds after the `ModifyAckDeadline` call was
+          #   made. Specifying zero might immediately make the message available for
           #   delivery to another subscriber client. This typically results in an
           #   increase in the rate of message redeliveries (that is, duplicates).
           #   The minimum deadline you can specify is 0 seconds.
@@ -788,11 +858,12 @@ module Google
           # than once will not result in an error.
           #
           # @param subscription [String]
-          #   The subscription whose message is being acknowledged.
+          #   Required. The subscription whose message is being acknowledged.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param ack_ids [Array<String>]
-          #   The acknowledgment ID for the messages being acknowledged that was returned
-          #   by the Pub/Sub system in the `Pull` response. Must not be empty.
+          #   Required. The acknowledgment ID for the messages being acknowledged that
+          #   was returned by the Pub/Sub system in the `Pull` response. Must not be
+          #   empty.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -829,17 +900,20 @@ module Google
           # subscription.
           #
           # @param subscription [String]
-          #   The subscription from which messages should be pulled.
+          #   Required. The subscription from which messages should be pulled.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param max_messages [Integer]
-          #   The maximum number of messages to return for this request. Must be a
-          #   positive integer. The Pub/Sub system may return fewer than the number
+          #   Required. The maximum number of messages to return for this request. Must
+          #   be a positive integer. The Pub/Sub system may return fewer than the number
           #   specified.
           # @param return_immediately [true, false]
-          #   If this field set to true, the system will respond immediately even if
-          #   it there are no messages available to return in the `Pull` response.
-          #   Otherwise, the system may wait (for a bounded amount of time) until at
-          #   least one message is available, rather than returning no messages.
+          #   Optional. If this field set to true, the system will respond immediately
+          #   even if it there are no messages available to return in the `Pull`
+          #   response. Otherwise, the system may wait (for a bounded amount of time)
+          #   until at least one message is available, rather than returning no messages.
+          #   Warning: setting this field to `true` is discouraged because it adversely
+          #   impacts the performance of `Pull` operations. We recommend that users do
+          #   not set this field.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -925,10 +999,10 @@ module Google
           # continuously through the call regardless of changes to the `PushConfig`.
           #
           # @param subscription [String]
-          #   The name of the subscription.
+          #   Required. The name of the subscription.
           #   Format is `projects/{project}/subscriptions/{sub}`.
           # @param push_config [Google::Cloud::PubSub::V1::PushConfig | Hash]
-          #   The push configuration for future deliveries.
+          #   Required. The push configuration for future deliveries.
           #
           #   An empty `pushConfig` indicates that the Pub/Sub system should
           #   stop pushing messages from the given subscription and allow
@@ -975,7 +1049,7 @@ module Google
           # captured by a snapshot.
           #
           # @param project [String]
-          #   The name of the project in which to list snapshots.
+          #   Required. The name of the project in which to list snapshots.
           #   Format is `projects/{project-id}`.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
@@ -1047,15 +1121,14 @@ module Google
           # REST API requests, you must specify a name in the request.
           #
           # @param name [String]
-          #   Optional user-provided name for this snapshot.
-          #   If the name is not provided in the request, the server will assign a random
-          #   name for this snapshot on the same project as the subscription.
-          #   Note that for REST API requests, you must specify a name.  See the
-          #   <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-          #   resource name rules</a>.
-          #   Format is `projects/{project}/snapshots/{snap}`.
+          #   Required. User-provided name for this snapshot. If the name is not provided
+          #   in the request, the server will assign a random name for this snapshot on
+          #   the same project as the subscription. Note that for REST API requests, you
+          #   must specify a name.  See the <a
+          #   href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource
+          #   name rules</a>. Format is `projects/{project}/snapshots/{snap}`.
           # @param subscription [String]
-          #   The subscription whose backlog the snapshot retains.
+          #   Required. The subscription whose backlog the snapshot retains.
           #   Specifically, the created snapshot is guaranteed to retain:
           #    (a) The existing backlog on the subscription. More precisely, this is
           #        defined as the messages in the subscription's backlog that are
@@ -1106,11 +1179,11 @@ module Google
           # captured by a snapshot.
           #
           # @param snapshot [Google::Cloud::PubSub::V1::Snapshot | Hash]
-          #   The updated snapshot object.
+          #   Required. The updated snapshot object.
           #   A hash of the same form as `Google::Cloud::PubSub::V1::Snapshot`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Indicates which fields in the provided snapshot to update.
+          #   Required. Indicates which fields in the provided snapshot to update.
           #   Must be specified and non-empty.
           #   A hash of the same form as `Google::Protobuf::FieldMask`
           #   can also be provided.
@@ -1159,7 +1232,7 @@ module Google
           # snapshot or its subscription, unless the same subscription is specified.
           #
           # @param snapshot [String]
-          #   The name of the snapshot to delete.
+          #   Required. The name of the snapshot to delete.
           #   Format is `projects/{project}/snapshots/{snap}`.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
@@ -1197,7 +1270,7 @@ module Google
           # must be on the same topic.
           #
           # @param subscription [String]
-          #   The subscription to affect.
+          #   Required. The subscription to affect.
           # @param time [Google::Protobuf::Timestamp | Hash]
           #   The time to seek to.
           #   Messages retained in the subscription that were published before this
@@ -1246,8 +1319,11 @@ module Google
             @seek.call(req, options, &block)
           end
 
-          # Sets the access control policy on the specified resource. Replaces any
-          # existing policy.
+          # Sets the access control policy on the specified resource. Replaces
+          # any existing policy.
+          #
+          # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`
+          # errors.
           #
           # @param resource [String]
           #   REQUIRED: The resource for which the policy is being specified.
@@ -1271,11 +1347,13 @@ module Google
           #   require "google/cloud/pubsub"
           #
           #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #
+          #   # TODO: Initialize `resource`:
+          #   resource = ''
           #
           #   # TODO: Initialize `policy`:
           #   policy = {}
-          #   response = subscriber_client.set_iam_policy(formatted_resource, policy)
+          #   response = subscriber_client.set_iam_policy(resource, policy)
 
           def set_iam_policy \
               resource,
@@ -1290,9 +1368,8 @@ module Google
             @set_iam_policy.call(req, options, &block)
           end
 
-          # Gets the access control policy for a resource.
-          # Returns an empty policy if the resource exists and does not have a policy
-          # set.
+          # Gets the access control policy for a resource. Returns an empty policy
+          # if the resource exists and does not have a policy set.
           #
           # @param resource [String]
           #   REQUIRED: The resource for which the policy is being requested.
@@ -1314,8 +1391,10 @@ module Google
           #   require "google/cloud/pubsub"
           #
           #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
-          #   response = subscriber_client.get_iam_policy(formatted_resource)
+          #
+          #   # TODO: Initialize `resource`:
+          #   resource = ''
+          #   response = subscriber_client.get_iam_policy(resource)
 
           def get_iam_policy \
               resource,
@@ -1330,13 +1409,13 @@ module Google
             @get_iam_policy.call(req, options, &block)
           end
 
-          # Returns permissions that a caller has on the specified resource.
-          # If the resource does not exist, this will return an empty set of
-          # permissions, not a NOT_FOUND error.
+          # Returns permissions that a caller has on the specified resource. If the
+          # resource does not exist, this will return an empty set of
+          # permissions, not a `NOT_FOUND` error.
           #
-          # Note: This operation is designed to be used for building permission-aware
-          # UIs and command-line tools, not for authorization checking. This operation
-          # may "fail open" without warning.
+          # Note: This operation is designed to be used for building
+          # permission-aware UIs and command-line tools, not for authorization
+          # checking. This operation may "fail open" without warning.
           #
           # @param resource [String]
           #   REQUIRED: The resource for which the policy detail is being requested.
@@ -1358,11 +1437,13 @@ module Google
           #   require "google/cloud/pubsub"
           #
           #   subscriber_client = Google::Cloud::PubSub::Subscriber.new(version: :v1)
-          #   formatted_resource = Google::Cloud::PubSub::V1::SubscriberClient.subscription_path("[PROJECT]", "[SUBSCRIPTION]")
+          #
+          #   # TODO: Initialize `resource`:
+          #   resource = ''
           #
           #   # TODO: Initialize `permissions`:
           #   permissions = []
-          #   response = subscriber_client.test_iam_permissions(formatted_resource, permissions)
+          #   response = subscriber_client.test_iam_permissions(resource, permissions)
 
           def test_iam_permissions \
               resource,

data/lib/google/cloud/pubsub/v1/subscriber_client_config.json

@@ -10,6 +10,10 @@
         "non_idempotent": [
           "UNAVAILABLE"
         ],
+        "idempotent2": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ],
         "streaming_pull": [
           "ABORTED",
           "DEADLINE_EXCEEDED",
@@ -32,9 +36,9 @@
           "initial_retry_delay_millis": 100,
           "retry_delay_multiplier": 1.3,
           "max_retry_delay_millis": 60000,
-          "initial_rpc_timeout_millis": 5000,
-          "rpc_timeout_multiplier": 1.3,
-          "max_rpc_timeout_millis": 600000,
+          "initial_rpc_timeout_millis": 25000,
+          "rpc_timeout_multiplier": 1.0,
+          "max_rpc_timeout_millis": 25000,
           "total_timeout_millis": 600000
         },
         "streaming_messaging": {
@@ -73,6 +77,11 @@
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
+        "GetSnapshot": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent2",
+          "retry_params_name": "default"
+        },
         "ModifyAckDeadline": {
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",

data/lib/google/cloud/pubsub/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module PubSub
-      VERSION = "1.1.3".freeze
+      VERSION = "1.10.0".freeze
     end
 
     Pubsub = PubSub unless const_defined? :Pubsub

data/lib/google/pubsub/v1/pubsub_pb.rb

@@ -6,6 +6,8 @@ require 'google/protobuf'
 
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
@@ -71,6 +73,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.pubsub.v1.DeleteTopicRequest" do
     optional :topic, :string, 1
   end
+  add_message "google.pubsub.v1.DetachSubscriptionRequest" do
+    optional :subscription, :string, 1
+  end
+  add_message "google.pubsub.v1.DetachSubscriptionResponse" do
+  end
   add_message "google.pubsub.v1.Subscription" do
     optional :name, :string, 1
     optional :topic, :string, 2
@@ -81,7 +88,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     map :labels, :string, :string, 9
     optional :enable_message_ordering, :bool, 10
     optional :expiration_policy, :message, 11, "google.pubsub.v1.ExpirationPolicy"
+    optional :filter, :string, 12
     optional :dead_letter_policy, :message, 13, "google.pubsub.v1.DeadLetterPolicy"
+    optional :retry_policy, :message, 14, "google.pubsub.v1.RetryPolicy"
+    optional :detached, :bool, 15
+  end
+  add_message "google.pubsub.v1.RetryPolicy" do
+    optional :minimum_backoff, :message, 1, "google.protobuf.Duration"
+    optional :maximum_backoff, :message, 2, "google.protobuf.Duration"
   end
   add_message "google.pubsub.v1.DeadLetterPolicy" do
     optional :dead_letter_topic, :string, 1
@@ -152,6 +166,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :modify_deadline_seconds, :int32, 3
     repeated :modify_deadline_ack_ids, :string, 4
     optional :stream_ack_deadline_seconds, :int32, 5
+    optional :client_id, :string, 6
+    optional :max_outstanding_messages, :int64, 7
+    optional :max_outstanding_bytes, :int64, 8
   end
   add_message "google.pubsub.v1.StreamingPullResponse" do
     repeated :received_messages, :message, 1, "google.pubsub.v1.ReceivedMessage"
@@ -219,7 +236,10 @@ module Google::Cloud::PubSub::V1
   ListTopicSnapshotsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicSnapshotsRequest").msgclass
   ListTopicSnapshotsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ListTopicSnapshotsResponse").msgclass
   DeleteTopicRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeleteTopicRequest").msgclass
+  DetachSubscriptionRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DetachSubscriptionRequest").msgclass
+  DetachSubscriptionResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DetachSubscriptionResponse").msgclass
   Subscription = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Subscription").msgclass
+  RetryPolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.RetryPolicy").msgclass
   DeadLetterPolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeadLetterPolicy").msgclass
   ExpirationPolicy = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ExpirationPolicy").msgclass
   PushConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PushConfig").msgclass

data/lib/google/pubsub/v1/pubsub_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/pubsub/v1/pubsub.proto for package 'Google::Cloud::PubSub::V1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2020 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,7 +15,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-#
 
 
 require 'grpc'
@@ -54,7 +53,7 @@ module Google::Cloud::PubSub::V1
       rpc :GetTopic, GetTopicRequest, Topic
       # Lists matching topics.
       rpc :ListTopics, ListTopicsRequest, ListTopicsResponse
-      # Lists the names of the subscriptions on this topic.
+      # Lists the names of the attached subscriptions on this topic.
       rpc :ListTopicSubscriptions, ListTopicSubscriptionsRequest, ListTopicSubscriptionsResponse
       # Lists the names of the snapshots on this topic. Snapshots are used in
       # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
@@ -69,6 +68,11 @@ module Google::Cloud::PubSub::V1
       # configuration or subscriptions. Existing subscriptions to this topic are
       # not deleted, but their `topic` field is set to `_deleted-topic_`.
       rpc :DeleteTopic, DeleteTopicRequest, Google::Protobuf::Empty
+      # Detaches a subscription from this topic. All messages retained in the
+      # subscription are dropped. Subsequent `Pull` and `StreamingPull` requests
+      # will return FAILED_PRECONDITION. If the subscription is a push
+      # subscription, pushes to the endpoint will stop.
+      rpc :DetachSubscription, DetachSubscriptionRequest, DetachSubscriptionResponse
     end
 
     Stub = Service.rpc_stub_class

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: 1.10.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-20 00:00:00.000000000 Z
+date: 2020-07-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -141,14 +141,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '5.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.10'
+        version: '5.14'
 - !ruby/object:Gem::Dependency
   name: minitest-autotest
   requirement: !ruby/object:Gem::Requirement
@@ -278,6 +278,7 @@ files:
 - lib/google/cloud/pubsub/project.rb
 - lib/google/cloud/pubsub/publish_result.rb
 - lib/google/cloud/pubsub/received_message.rb
+- lib/google/cloud/pubsub/retry_policy.rb
 - lib/google/cloud/pubsub/service.rb
 - lib/google/cloud/pubsub/snapshot.rb
 - lib/google/cloud/pubsub/snapshot/list.rb
@@ -329,7 +330,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.1.3
 signing_key: 
 specification_version: 4
 summary: API Client library for Google Cloud Pub/Sub