google-api-client 0.41.1 → 0.43.0

data/generated/google/apis/prod_tt_sasportal_v1alpha1/service.rb

@@ -79,12 +79,10 @@ module Google
         
         # Returns a list of requested customers.
         # @param [Fixnum] page_size
-        #   The maximum number of customers
-        #   to return in the response.
+        #   The maximum number of customers to return in the response.
         # @param [String] page_token
         #   A pagination token returned from a previous call to ListCustomers method that
-        #   indicates where
-        #   this listing should continue from.
+        #   indicates where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -215,8 +213,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a signed device under a
-        # node or customer.
+        # Creates a signed device under a node or customer.
         # @param [String] parent
         #   Required. The name of the parent resource.
         # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalCreateSignedDeviceRequest] sas_portal_create_signed_device_request_object
@@ -313,16 +310,15 @@ module Google
         # @param [String] parent
         #   Required. The name of the parent resource.
         # @param [String] filter
-        #   The filter expression. The filter should have one of the following
-        #   formats: "sn=123454" or "display_name=MyDevice". sn
-        #   corresponds to serial_number of the device. The filter is case insensitive.
+        #   The filter expression. The filter should have one of the following formats: "
+        #   sn=123454" or "display_name=MyDevice". sn corresponds to serial_number of the
+        #   device. The filter is case insensitive.
         # @param [Fixnum] page_size
-        #   The maximum number of devices to return in the response.
-        #   If empty or zero, all devices will be listed.
-        #   Must be in the range [0, 1000].
+        #   The maximum number of devices to return in the response. If empty or zero, all
+        #   devices will be listed. Must be in the range [0, 1000].
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListDevices
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListDevices that indicates
+        #   where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -587,8 +583,8 @@ module Google
         # @param [Fixnum] page_size
         #   The maximum number of nodes to return in the response.
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListNodes method
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListNodes method that
+        #   indicates where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -620,8 +616,7 @@ module Google
         
         # Moves a node under another node or customer.
         # @param [String] name
-        #   Required. The name of the node to
-        #   move.
+        #   Required. The name of the node to move.
         # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalMoveNodeRequest] sas_portal_move_node_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -727,8 +722,8 @@ module Google
         # @param [Fixnum] page_size
         #   The maximum number of nodes to return in the response.
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListNodes method
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListNodes method that
+        #   indicates where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -914,8 +909,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a signed device under a
-        # node or customer.
+        # Creates a signed device under a node or customer.
         # @param [String] parent
         #   Required. The name of the parent resource.
         # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalCreateSignedDeviceRequest] sas_portal_create_signed_device_request_object
@@ -1012,16 +1006,15 @@ module Google
         # @param [String] parent
         #   Required. The name of the parent resource.
         # @param [String] filter
-        #   The filter expression. The filter should have one of the following
-        #   formats: "sn=123454" or "display_name=MyDevice". sn
-        #   corresponds to serial_number of the device. The filter is case insensitive.
+        #   The filter expression. The filter should have one of the following formats: "
+        #   sn=123454" or "display_name=MyDevice". sn corresponds to serial_number of the
+        #   device. The filter is case insensitive.
         # @param [Fixnum] page_size
-        #   The maximum number of devices to return in the response.
-        #   If empty or zero, all devices will be listed.
-        #   Must be in the range [0, 1000].
+        #   The maximum number of devices to return in the response. If empty or zero, all
+        #   devices will be listed. Must be in the range [0, 1000].
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListDevices
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListDevices that indicates
+        #   where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1286,8 +1279,8 @@ module Google
         # @param [Fixnum] page_size
         #   The maximum number of nodes to return in the response.
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListNodes method
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListNodes method that
+        #   indicates where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1319,8 +1312,7 @@ module Google
         
         # Moves a node under another node or customer.
         # @param [String] name
-        #   Required. The name of the node to
-        #   move.
+        #   Required. The name of the node to move.
         # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalMoveNodeRequest] sas_portal_move_node_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1453,8 +1445,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a signed device under a
-        # node or customer.
+        # Creates a signed device under a node or customer.
         # @param [String] parent
         #   Required. The name of the parent resource.
         # @param [Google::Apis::ProdTtSasportalV1alpha1::SasPortalCreateSignedDeviceRequest] sas_portal_create_signed_device_request_object
@@ -1491,16 +1482,15 @@ module Google
         # @param [String] parent
         #   Required. The name of the parent resource.
         # @param [String] filter
-        #   The filter expression. The filter should have one of the following
-        #   formats: "sn=123454" or "display_name=MyDevice". sn
-        #   corresponds to serial_number of the device. The filter is case insensitive.
+        #   The filter expression. The filter should have one of the following formats: "
+        #   sn=123454" or "display_name=MyDevice". sn corresponds to serial_number of the
+        #   device. The filter is case insensitive.
         # @param [Fixnum] page_size
-        #   The maximum number of devices to return in the response.
-        #   If empty or zero, all devices will be listed.
-        #   Must be in the range [0, 1000].
+        #   The maximum number of devices to return in the response. If empty or zero, all
+        #   devices will be listed. Must be in the range [0, 1000].
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListDevices
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListDevices that indicates
+        #   where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1570,8 +1560,8 @@ module Google
         # @param [Fixnum] page_size
         #   The maximum number of nodes to return in the response.
         # @param [String] page_token
-        #   A pagination token returned from a previous call to ListNodes method
-        #   that indicates where this listing should continue from.
+        #   A pagination token returned from a previous call to ListNodes method that
+        #   indicates where this listing should continue from.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1601,9 +1591,8 @@ module Google
           execute_or_queue_command(command, &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 [Google::Apis::ProdTtSasportalV1alpha1::SasPortalGetPolicyRequest] sas_portal_get_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/pubsub_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/pubsub/docs
     module PubsubV1
       VERSION = 'V1'
-      REVISION = '20200616'
+      REVISION = '20200713'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/pubsub_v1/classes.rb

@@ -733,11 +733,11 @@ module Google
       # A message that is published by publishers and consumed by subscribers. The
       # message must contain either a non-empty data field or at least one attribute.
       # Note that client libraries represent this object differently
-      # depending on the language. See the corresponding
-      # <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
-      # library documentation</a> for more information. See
-      # <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
-      # for more information about message limits.
+      # depending on the language. See the corresponding [client library
+      # documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
+      # more information. See [quotas and limits]
+      # (https://cloud.google.com/pubsub/quotas) for more information about message
+      # limits.
       class Message
         include Google::Apis::Core::Hashable
       
@@ -763,6 +763,16 @@ module Google
         # @return [String]
         attr_accessor :message_id
       
+        # If non-empty, identifies related messages for which publish order should be
+        # respected. If a `Subscription` has `enable_message_ordering` set to `true`,
+        # messages published with the same non-empty `ordering_key` value will be
+        # delivered to subscribers in the order in which they are received by the
+        # Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
+        # must specify the same `ordering_key` value.
+        # Corresponds to the JSON property `orderingKey`
+        # @return [String]
+        attr_accessor :ordering_key
+      
         # The time at which the message was published, populated by the server when
         # it receives the `Publish` call. It must not be populated by the
         # publisher in a `Publish` call.
@@ -779,6 +789,7 @@ module Google
           @attributes = args[:attributes] if args.key?(:attributes)
           @data = args[:data] if args.key?(:data)
           @message_id = args[:message_id] if args.key?(:message_id)
+          @ordering_key = args[:ordering_key] if args.key?(:ordering_key)
           @publish_time = args[:publish_time] if args.key?(:publish_time)
         end
       end
@@ -917,11 +928,11 @@ module Google
         # A message that is published by publishers and consumed by subscribers. The
         # message must contain either a non-empty data field or at least one attribute.
         # Note that client libraries represent this object differently
-        # depending on the language. See the corresponding
-        # <a href="https://cloud.google.com/pubsub/docs/reference/libraries">client
-        # library documentation</a> for more information. See
-        # <a href="https://cloud.google.com/pubsub/quotas">Quotas and limits</a>
-        # for more information about message limits.
+        # depending on the language. See the corresponding [client library
+        # documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
+        # more information. See [quotas and limits]
+        # (https://cloud.google.com/pubsub/quotas) for more information about message
+        # limits.
         # Corresponds to the JSON property `message`
         # @return [Google::Apis::PubsubV1::Message]
         attr_accessor :message
@@ -1102,11 +1113,10 @@ module Google
       end
       
       # A snapshot resource. 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.
+      # [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+      # 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.
       class Snapshot
         include Google::Apis::Core::Hashable
       
@@ -1124,8 +1134,8 @@ module Google
         # @return [String]
         attr_accessor :expire_time
       
-        # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-        # managing labels</a>.
+        # See [Creating and managing labels]
+        # (https://cloud.google.com/pubsub/docs/labels).
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1186,6 +1196,15 @@ module Google
         # @return [Google::Apis::PubsubV1::DeadLetterPolicy]
         attr_accessor :dead_letter_policy
       
+        # If true, messages published with the same `ordering_key` in `PubsubMessage`
+        # will be delivered to the subscribers in the order in which they
+        # are received by the Pub/Sub system. Otherwise, they may be delivered in
+        # any order.
+        # Corresponds to the JSON property `enableMessageOrdering`
+        # @return [Boolean]
+        attr_accessor :enable_message_ordering
+        alias_method :enable_message_ordering?, :enable_message_ordering
+      
         # A policy that specifies the conditions for resource expiration (i.e.,
         # automatic resource deletion).
         # Corresponds to the JSON property `expirationPolicy`
@@ -1235,10 +1254,8 @@ module Google
         # Indicates whether to retain acknowledged messages. If true, then
         # messages are not expunged from the subscription's backlog, even if they are
         # acknowledged, until they fall out of the `message_retention_duration`
-        # window. This must be true if you would like to
-        # <a
-        # href="https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time">
-        # Seek to a timestamp</a>.
+        # window. This must be true if you would like to [Seek to a timestamp]
+        # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
         # Corresponds to the JSON property `retainAckedMessages`
         # @return [Boolean]
         attr_accessor :retain_acked_messages
@@ -1273,6 +1290,7 @@ module Google
         def update!(**args)
           @ack_deadline_seconds = args[:ack_deadline_seconds] if args.key?(:ack_deadline_seconds)
           @dead_letter_policy = args[:dead_letter_policy] if args.key?(:dead_letter_policy)
+          @enable_message_ordering = args[:enable_message_ordering] if args.key?(:enable_message_ordering)
           @expiration_policy = args[:expiration_policy] if args.key?(:expiration_policy)
           @filter = args[:filter] if args.key?(:filter)
           @labels = args[:labels] if args.key?(:labels)
@@ -1338,8 +1356,8 @@ module Google
         # @return [String]
         attr_accessor :kms_key_name
       
-        # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-        # managing labels</a>.
+        # See [Creating and managing labels]
+        # (https://cloud.google.com/pubsub/docs/labels).
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1377,11 +1395,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A snapshot resource. 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.
+        # [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
+        # 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.
         # Corresponds to the JSON property `snapshot`
         # @return [Google::Apis::PubsubV1::Snapshot]
         attr_accessor :snapshot

data/generated/google/apis/pubsub_v1/representations.rb

@@ -411,6 +411,7 @@ module Google
           hash :attributes, as: 'attributes'
           property :data, :base64 => true, as: 'data'
           property :message_id, as: 'messageId'
+          property :ordering_key, as: 'orderingKey'
           property :publish_time, as: 'publishTime'
         end
       end
@@ -497,6 +498,7 @@ module Google
           property :ack_deadline_seconds, as: 'ackDeadlineSeconds'
           property :dead_letter_policy, as: 'deadLetterPolicy', class: Google::Apis::PubsubV1::DeadLetterPolicy, decorator: Google::Apis::PubsubV1::DeadLetterPolicy::Representation
       
+          property :enable_message_ordering, as: 'enableMessageOrdering'
           property :expiration_policy, as: 'expirationPolicy', class: Google::Apis::PubsubV1::ExpirationPolicy, decorator: Google::Apis::PubsubV1::ExpirationPolicy::Representation
       
           property :filter, as: 'filter'

data/generated/google/apis/pubsub_v1/service.rb

@@ -48,21 +48,19 @@ module Google
         end
         
         # Creates a snapshot from the requested subscription. 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.
-        # <br><br>If the snapshot already exists, returns `ALREADY_EXISTS`.
+        # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) 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.
+        # If the snapshot already exists, returns `ALREADY_EXISTS`.
         # If the requested subscription doesn't exist, returns `NOT_FOUND`.
         # If the backlog in the subscription is too old -- and the resulting snapshot
         # would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
         # See also the `Snapshot.expire_time` field. 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, conforming
-        # to the
-        # [resource name
-        # format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
+        # to the [resource name format]
+        # (https://cloud.google.com/pubsub/docs/admin#resource_names). The
         # generated name is populated in the returned Snapshot object. Note that for
         # REST API requests, you must specify a name in the request.
         # @param [String] name
@@ -103,12 +101,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes an existing 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.<br><br>
+        # Removes an existing snapshot. Snapshots are used in [Seek]
+        # (https://cloud.google.com/pubsub/docs/replay-overview) 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.
         # When the snapshot is deleted, all messages retained in the snapshot
         # are immediately dropped. After a snapshot is deleted, a new one may be
         # created with the same name, but the new one has no association with the old
@@ -222,12 +219,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the existing snapshots. 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.
+        # Lists the existing snapshots. Snapshots are used in [Seek](
+        # https://cloud.google.com/pubsub/docs/replay-overview) 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 [String] project
         #   Required. The name of the project in which to list snapshots.
         #   Format is `projects/`project-id``.
@@ -418,18 +414,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a subscription to a given topic. See the
-        # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-        # resource name rules</a>.
+        # Creates a subscription to a given topic. See the [resource name rules]
+        # (https://cloud.google.com/pubsub/docs/admin#resource_names).
         # If the subscription already exists, returns `ALREADY_EXISTS`.
         # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
         # If the name is not provided in the request, the server will assign a random
         # name for this subscription on the same project as the topic, conforming
-        # to the
-        # [resource name
-        # format](https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        # generated name is populated in the returned Subscription object. Note that
-        # for REST API requests, you must specify a name in the request.
+        # to the [resource name format]
+        # (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
+        # name is populated in the returned Subscription object. Note that for REST
+        # API requests, you must specify a name in the request.
         # @param [String] name
         #   Required. The name of the subscription. It must have the format
         #   `"projects/`project`/subscriptions/`subscription`"`. ``subscription`` must
@@ -802,13 +796,12 @@ module Google
         end
         
         # Seeks an existing subscription to a point in time or to a given snapshot,
-        # whichever is provided in the request. 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. Note that both the subscription and the snapshot
-        # must be on the same topic.
+        # whichever is provided in the request. Snapshots are used in [Seek](
+        # https://cloud.google.com/pubsub/docs/replay-overview) 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. Note that both the subscription and the
+        # snapshot must be on the same topic.
         # @param [String] subscription
         #   Required. The subscription to affect.
         # @param [Google::Apis::PubsubV1::SeekRequest] seek_request_object
@@ -916,9 +909,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates the given topic with the given name. See the
-        # <a href="https://cloud.google.com/pubsub/docs/admin#resource_names">
-        # resource name rules</a>.
+        # Creates the given topic with the given name. See the [resource name rules](
+        # https://cloud.google.com/pubsub/docs/admin#resource_names).
         # @param [String] name
         #   Required. The name of the topic. It must have the format
         #   `"projects/`project`/topics/`topic`"`. ``topic`` must start with a letter,
@@ -1255,11 +1247,10 @@ module Google
         end
         
         # 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>
-        # 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.
+        # [Seek](https://cloud.google.com/pubsub/docs/replay-overview) 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 [String] topic
         #   Required. The name of the topic that snapshots are attached to.
         #   Format is `projects/`project`/topics/`topic``.