google-apis-spanner_v1 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1243dcf90ea82fda1dae00b5a98f84e653b2610e887b6633aac5b573249cc70
-  data.tar.gz: f0db958321c5009cac506b1ee4fb9e798020ce6de390e8283ec354c27812781e
+  metadata.gz: 9d298077ac6791fa4a61e2f2b6b65cf07ca365a438e5fdf3855201908a636e81
+  data.tar.gz: 73dd1e17d5cef167fc75816ea0306c93607ca71faf5802978d0260c46bb6f685
 SHA512:
-  metadata.gz: '01860fbbfdb61ed4fb3da58328c6ab11769097d7ca2d52dbc5234eecb147fef348920a724138f6918d65c8e7bdbffd717fde36ee51e39a14d836f1324ede17aa'
-  data.tar.gz: bf892f11e0fa5beac035efccbb672c87d0a18d6de49c0fe0a0dbd1890a1c4a4ed0f9bb4c74ba52adb07d2e4227c09b49fb4847413ff8e4f3ba55f3d507d563d6
+  metadata.gz: 3babd3de3ba956c13eba380f71fcc2deedbdeb038214ad2a3f1a88be08b68a7c103daf6f0ee45478bf0cf6a9f718b774284ca4d5d7e352b2adfc8b92e49d5c12
+  data.tar.gz: f7bd4236ac9abc7b6e87f70de14c0c66505bb703ca5ce4ef622a0a5accd482a7dbc05fa14fa6bb22553352fda8d38fcf334a8a88c5729a7d6499679e73d35374

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-spanner_v1
 
+### v0.10.0 (2021-05-22)
+
+* Regenerated from discovery document revision 20210517
+* Unspecified changes
+
 ### v0.9.0 (2021-04-17)
 
 * Regenerated from discovery document revision 20210405

data/lib/google/apis/spanner_v1/classes.rb

@@ -746,6 +746,45 @@ module Google
         end
       end
       
+      # A message representing context for a KeyRangeInfo, including a label, value,
+      # unit, and severity.
+      class ContextValue
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `label`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :label
+      
+        # The severity of this context.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        # The unit of the context value.
+        # Corresponds to the JSON property `unit`
+        # @return [String]
+        attr_accessor :unit
+      
+        # The value for the context.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @label = args[:label] if args.key?(:label)
+          @severity = args[:severity] if args.key?(:severity)
+          @unit = args[:unit] if args.key?(:unit)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
       # Metadata type for the operation returned by CreateBackup.
       class CreateBackupMetadata
         include Google::Apis::Core::Hashable
@@ -1036,6 +1075,85 @@ module Google
         end
       end
       
+      # A message representing a derived metric.
+      class DerivedMetric
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `denominator`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :denominator
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `numerator`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :numerator
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @denominator = args[:denominator] if args.key?(:denominator)
+          @numerator = args[:numerator] if args.key?(:numerator)
+        end
+      end
+      
+      # A message representing the key visualizer diagnostic messages.
+      class DiagnosticMessage
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `info`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :info
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `metric`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :metric
+      
+        # Whether this message is specific only for the current metric. By default
+        # Diagnostics are shown for all metrics, regardless which metric is the
+        # currently selected metric in the UI. However occasionally a metric will
+        # generate so many messages that the resulting visual clutter becomes
+        # overwhelming. In this case setting this to true, will show the diagnostic
+        # messages for that metric only if it is the currently selected metric.
+        # Corresponds to the JSON property `metricSpecific`
+        # @return [Boolean]
+        attr_accessor :metric_specific
+        alias_method :metric_specific?, :metric_specific
+      
+        # The severity of the diagnostic message.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `shortMessage`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :short_message
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @info = args[:info] if args.key?(:info)
+          @metric = args[:metric] if args.key?(:metric)
+          @metric_specific = args[:metric_specific] if args.key?(:metric_specific)
+          @severity = args[:severity] if args.key?(:severity)
+          @short_message = args[:short_message] if args.key?(:short_message)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -1454,6 +1572,49 @@ module Google
         end
       end
       
+      # A message representing a (sparse) collection of hot keys for specific key
+      # buckets.
+      class IndexedHotKey
+        include Google::Apis::Core::Hashable
+      
+        # A (sparse) mapping from key bucket index to the index of the specific hot row
+        # key for that key bucket. The index of the hot row key can be translated to the
+        # actual row key via the ScanData.VisualizationData.indexed_keys repeated field.
+        # Corresponds to the JSON property `sparseHotKeys`
+        # @return [Hash<String,Fixnum>]
+        attr_accessor :sparse_hot_keys
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sparse_hot_keys = args[:sparse_hot_keys] if args.key?(:sparse_hot_keys)
+        end
+      end
+      
+      # A message representing a (sparse) collection of KeyRangeInfos for specific key
+      # buckets.
+      class IndexedKeyRangeInfos
+        include Google::Apis::Core::Hashable
+      
+        # A (sparse) mapping from key bucket index to the KeyRangeInfos for that key
+        # bucket.
+        # Corresponds to the JSON property `keyRangeInfos`
+        # @return [Hash<String,Google::Apis::SpannerV1::KeyRangeInfos>]
+        attr_accessor :key_range_infos
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @key_range_infos = args[:key_range_infos] if args.key?(:key_range_infos)
+        end
+      end
+      
       # An isolated set of Cloud Spanner resources on which databases can be hosted.
       class Instance
         include Google::Apis::Core::Hashable
@@ -1642,6 +1803,97 @@ module Google
         end
       end
       
+      # A message representing information for a key range (possibly one key).
+      class KeyRangeInfo
+        include Google::Apis::Core::Hashable
+      
+        # The list of context values for this key range.
+        # Corresponds to the JSON property `contextValues`
+        # @return [Array<Google::Apis::SpannerV1::ContextValue>]
+        attr_accessor :context_values
+      
+        # The index of the end key in indexed_keys.
+        # Corresponds to the JSON property `endKeyIndex`
+        # @return [Fixnum]
+        attr_accessor :end_key_index
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `info`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :info
+      
+        # The number of keys this range covers.
+        # Corresponds to the JSON property `keysCount`
+        # @return [Fixnum]
+        attr_accessor :keys_count
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `metric`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :metric
+      
+        # The index of the start key in indexed_keys.
+        # Corresponds to the JSON property `startKeyIndex`
+        # @return [Fixnum]
+        attr_accessor :start_key_index
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `unit`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :unit
+      
+        # The value of the metric.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @context_values = args[:context_values] if args.key?(:context_values)
+          @end_key_index = args[:end_key_index] if args.key?(:end_key_index)
+          @info = args[:info] if args.key?(:info)
+          @keys_count = args[:keys_count] if args.key?(:keys_count)
+          @metric = args[:metric] if args.key?(:metric)
+          @start_key_index = args[:start_key_index] if args.key?(:start_key_index)
+          @unit = args[:unit] if args.key?(:unit)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # A message representing a list of specific information for multiple key ranges.
+      class KeyRangeInfos
+        include Google::Apis::Core::Hashable
+      
+        # The list individual KeyRangeInfos.
+        # Corresponds to the JSON property `infos`
+        # @return [Array<Google::Apis::SpannerV1::KeyRangeInfo>]
+        attr_accessor :infos
+      
+        # The total size of the list of all KeyRangeInfos. This may be larger than the
+        # number of repeated messages above. If that is the case, this number may be
+        # used to determine how many are not being shown.
+        # Corresponds to the JSON property `totalSize`
+        # @return [Fixnum]
+        attr_accessor :total_size
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @infos = args[:infos] if args.key?(:infos)
+          @total_size = args[:total_size] if args.key?(:total_size)
+        end
+      end
+      
       # `KeySet` defines a collection of Cloud Spanner keys and/or key ranges. All the
       # keys are expected to be in the same table or index. The keys need not be
       # sorted in any particular way. If the same key is specified multiple times in
@@ -1879,6 +2131,32 @@ module Google
         end
       end
       
+      # Response method from the ListScans method.
+      class ListScansResponse
+        include Google::Apis::Core::Hashable
+      
+        # Token to retrieve the next page of results, or empty if there are no more
+        # results in the list.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # Available scans based on the list query parameters.
+        # Corresponds to the JSON property `scans`
+        # @return [Array<Google::Apis::SpannerV1::Scan>]
+        attr_accessor :scans
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @scans = args[:scans] if args.key?(:scans)
+        end
+      end
+      
       # The response for ListSessions.
       class ListSessionsResponse
         include Google::Apis::Core::Hashable
@@ -1905,6 +2183,179 @@ module Google
         end
       end
       
+      # A message representing a user-facing string whose value may need to be
+      # translated before being displayed.
+      class LocalizedString
+        include Google::Apis::Core::Hashable
+      
+        # A map of arguments used when creating the localized message. Keys represent
+        # parameter names which may be used by the localized version when substituting
+        # dynamic values.
+        # Corresponds to the JSON property `args`
+        # @return [Hash<String,String>]
+        attr_accessor :args
+      
+        # The canonical English version of this message. If no token is provided or the
+        # front-end has no message associated with the token, this text will be
+        # displayed as-is.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        # The token identifying the message, e.g. 'METRIC_READ_CPU'. This should be
+        # unique within the service.
+        # Corresponds to the JSON property `token`
+        # @return [String]
+        attr_accessor :token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @args = args[:args] if args.key?(:args)
+          @message = args[:message] if args.key?(:message)
+          @token = args[:token] if args.key?(:token)
+        end
+      end
+      
+      # A message representing the actual monitoring data, values for each key bucket
+      # over time, of a metric.
+      class Metric
+        include Google::Apis::Core::Hashable
+      
+        # The aggregation function used to aggregate each key bucket
+        # Corresponds to the JSON property `aggregation`
+        # @return [String]
+        attr_accessor :aggregation
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `category`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :category
+      
+        # A message representing a derived metric.
+        # Corresponds to the JSON property `derived`
+        # @return [Google::Apis::SpannerV1::DerivedMetric]
+        attr_accessor :derived
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `displayLabel`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :display_label
+      
+        # Whether the metric has any non-zero data.
+        # Corresponds to the JSON property `hasNonzeroData`
+        # @return [Boolean]
+        attr_accessor :has_nonzero_data
+        alias_method :has_nonzero_data?, :has_nonzero_data
+      
+        # The value that is considered hot for the metric. On a per metric basis hotness
+        # signals high utilization and something that might potentially be a cause for
+        # concern by the end user. hot_value is used to calibrate and scale visual color
+        # scales.
+        # Corresponds to the JSON property `hotValue`
+        # @return [Float]
+        attr_accessor :hot_value
+      
+        # The (sparse) mapping from time index to an IndexedHotKey message, representing
+        # those time intervals for which there are hot keys.
+        # Corresponds to the JSON property `indexedHotKeys`
+        # @return [Hash<String,Google::Apis::SpannerV1::IndexedHotKey>]
+        attr_accessor :indexed_hot_keys
+      
+        # The (sparse) mapping from time interval index to an IndexedKeyRangeInfos
+        # message, representing those time intervals for which there are informational
+        # messages concerning key ranges.
+        # Corresponds to the JSON property `indexedKeyRangeInfos`
+        # @return [Hash<String,Google::Apis::SpannerV1::IndexedKeyRangeInfos>]
+        attr_accessor :indexed_key_range_infos
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `info`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :info
+      
+        # A message representing a matrix of floats.
+        # Corresponds to the JSON property `matrix`
+        # @return [Google::Apis::SpannerV1::MetricMatrix]
+        attr_accessor :matrix
+      
+        # A message representing a user-facing string whose value may need to be
+        # translated before being displayed.
+        # Corresponds to the JSON property `unit`
+        # @return [Google::Apis::SpannerV1::LocalizedString]
+        attr_accessor :unit
+      
+        # Whether the metric is visible to the end user.
+        # Corresponds to the JSON property `visible`
+        # @return [Boolean]
+        attr_accessor :visible
+        alias_method :visible?, :visible
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aggregation = args[:aggregation] if args.key?(:aggregation)
+          @category = args[:category] if args.key?(:category)
+          @derived = args[:derived] if args.key?(:derived)
+          @display_label = args[:display_label] if args.key?(:display_label)
+          @has_nonzero_data = args[:has_nonzero_data] if args.key?(:has_nonzero_data)
+          @hot_value = args[:hot_value] if args.key?(:hot_value)
+          @indexed_hot_keys = args[:indexed_hot_keys] if args.key?(:indexed_hot_keys)
+          @indexed_key_range_infos = args[:indexed_key_range_infos] if args.key?(:indexed_key_range_infos)
+          @info = args[:info] if args.key?(:info)
+          @matrix = args[:matrix] if args.key?(:matrix)
+          @unit = args[:unit] if args.key?(:unit)
+          @visible = args[:visible] if args.key?(:visible)
+        end
+      end
+      
+      # A message representing a matrix of floats.
+      class MetricMatrix
+        include Google::Apis::Core::Hashable
+      
+        # The rows of the matrix.
+        # Corresponds to the JSON property `rows`
+        # @return [Array<Google::Apis::SpannerV1::MetricMatrixRow>]
+        attr_accessor :rows
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @rows = args[:rows] if args.key?(:rows)
+        end
+      end
+      
+      # A message representing a row of a matrix of floats.
+      class MetricMatrixRow
+        include Google::Apis::Core::Hashable
+      
+        # The columns of the row.
+        # Corresponds to the JSON property `cols`
+        # @return [Array<Float>]
+        attr_accessor :cols
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @cols = args[:cols] if args.key?(:cols)
+        end
+      end
+      
       # A modification to one or more Cloud Spanner rows. Mutations can be applied to
       # a Cloud Spanner database by sending them in a Commit call.
       class Mutation
@@ -2513,6 +2964,55 @@ module Google
         end
       end
       
+      # A message representing a key prefix node in the key prefix hierarchy. for eg.
+      # Bigtable keyspaces are lexicographically ordered mappings of keys to values.
+      # Keys often have a shared prefix structure where users use the keys to organize
+      # data. Eg ///employee In this case Keysight will possibly use one node for a
+      # company and reuse it for all employees that fall under the company. Doing so
+      # improves legibility in the UI.
+      class PrefixNode
+        include Google::Apis::Core::Hashable
+      
+        # Whether this corresponds to a data_source name.
+        # Corresponds to the JSON property `dataSourceNode`
+        # @return [Boolean]
+        attr_accessor :data_source_node
+        alias_method :data_source_node?, :data_source_node
+      
+        # The depth in the prefix hierarchy.
+        # Corresponds to the JSON property `depth`
+        # @return [Fixnum]
+        attr_accessor :depth
+      
+        # The index of the end key bucket of the range that this node spans.
+        # Corresponds to the JSON property `endIndex`
+        # @return [Fixnum]
+        attr_accessor :end_index
+      
+        # The index of the start key bucket of the range that this node spans.
+        # Corresponds to the JSON property `startIndex`
+        # @return [Fixnum]
+        attr_accessor :start_index
+      
+        # The string represented by the prefix node.
+        # Corresponds to the JSON property `word`
+        # @return [String]
+        attr_accessor :word
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_source_node = args[:data_source_node] if args.key?(:data_source_node)
+          @depth = args[:depth] if args.key?(:depth)
+          @end_index = args[:end_index] if args.key?(:end_index)
+          @start_index = args[:start_index] if args.key?(:start_index)
+          @word = args[:word] if args.key?(:word)
+        end
+      end
+      
       # Query optimizer configuration.
       class QueryOptions
         include Google::Apis::Core::Hashable
@@ -3104,6 +3604,87 @@ module Google
         end
       end
       
+      # Scan is a structure which describes Cloud Key Visualizer scan information.
+      class Scan
+        include Google::Apis::Core::Hashable
+      
+        # Additional information provided by the implementer.
+        # Corresponds to the JSON property `details`
+        # @return [Hash<String,Object>]
+        attr_accessor :details
+      
+        # The upper bound for when the scan is defined.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The unique name of the scan, specific to the Database service implementing
+        # this interface.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # ScanData contains Cloud Key Visualizer scan data used by the caller to
+        # construct a visualization.
+        # Corresponds to the JSON property `scanData`
+        # @return [Google::Apis::SpannerV1::ScanData]
+        attr_accessor :scan_data
+      
+        # A range of time (inclusive) for when the scan is defined. The lower bound for
+        # when the scan is defined.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @details = args[:details] if args.key?(:details)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @name = args[:name] if args.key?(:name)
+          @scan_data = args[:scan_data] if args.key?(:scan_data)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # ScanData contains Cloud Key Visualizer scan data used by the caller to
+      # construct a visualization.
+      class ScanData
+        include Google::Apis::Core::Hashable
+      
+        # Cloud Key Visualizer scan data. The range of time this information covers is
+        # captured via the above time range fields. Note, this field is not available to
+        # the ListScans method.
+        # Corresponds to the JSON property `data`
+        # @return [Google::Apis::SpannerV1::VisualizationData]
+        attr_accessor :data
+      
+        # The upper bound for when the contained data is defined.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # A range of time (inclusive) for when the contained data is defined. The lower
+        # bound for when the contained data is defined.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
       # A session in the Cloud Spanner API.
       class Session
         include Google::Apis::Core::Hashable
@@ -4130,6 +4711,84 @@ module Google
         end
       end
       
+      # 
+      class VisualizationData
+        include Google::Apis::Core::Hashable
+      
+        # The token signifying the end of a data_source.
+        # Corresponds to the JSON property `dataSourceEndToken`
+        # @return [String]
+        attr_accessor :data_source_end_token
+      
+        # The token delimiting a datasource name from the rest of a key in a data_source.
+        # Corresponds to the JSON property `dataSourceSeparatorToken`
+        # @return [String]
+        attr_accessor :data_source_separator_token
+      
+        # The list of messages (info, alerts, ...)
+        # Corresponds to the JSON property `diagnosticMessages`
+        # @return [Array<Google::Apis::SpannerV1::DiagnosticMessage>]
+        attr_accessor :diagnostic_messages
+      
+        # We discretize the entire keyspace into buckets. Assuming each bucket has an
+        # inclusive keyrange and covers keys from k(i) ... k(n). In this case k(n) would
+        # be an end key for a given range. end_key_string is the collection of all such
+        # end keys
+        # Corresponds to the JSON property `endKeyStrings`
+        # @return [Array<String>]
+        attr_accessor :end_key_strings
+      
+        # Whether this scan contains PII.
+        # Corresponds to the JSON property `hasPii`
+        # @return [Boolean]
+        attr_accessor :has_pii
+        alias_method :has_pii?, :has_pii
+      
+        # Keys of key ranges that contribute significantly to a given metric Can be
+        # thought of as heavy hitters.
+        # Corresponds to the JSON property `indexedKeys`
+        # @return [Array<String>]
+        attr_accessor :indexed_keys
+      
+        # The token delimiting the key prefixes.
+        # Corresponds to the JSON property `keySeparator`
+        # @return [String]
+        attr_accessor :key_separator
+      
+        # The unit for the key: e.g. 'key' or 'chunk'.
+        # Corresponds to the JSON property `keyUnit`
+        # @return [String]
+        attr_accessor :key_unit
+      
+        # The list of data objects for each metric.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::SpannerV1::Metric>]
+        attr_accessor :metrics
+      
+        # The list of extracted key prefix nodes used in the key prefix hierarchy.
+        # Corresponds to the JSON property `prefixNodes`
+        # @return [Array<Google::Apis::SpannerV1::PrefixNode>]
+        attr_accessor :prefix_nodes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data_source_end_token = args[:data_source_end_token] if args.key?(:data_source_end_token)
+          @data_source_separator_token = args[:data_source_separator_token] if args.key?(:data_source_separator_token)
+          @diagnostic_messages = args[:diagnostic_messages] if args.key?(:diagnostic_messages)
+          @end_key_strings = args[:end_key_strings] if args.key?(:end_key_strings)
+          @has_pii = args[:has_pii] if args.key?(:has_pii)
+          @indexed_keys = args[:indexed_keys] if args.key?(:indexed_keys)
+          @key_separator = args[:key_separator] if args.key?(:key_separator)
+          @key_unit = args[:key_unit] if args.key?(:key_unit)
+          @metrics = args[:metrics] if args.key?(:metrics)
+          @prefix_nodes = args[:prefix_nodes] if args.key?(:prefix_nodes)
+        end
+      end
+      
       # Arguments to insert, update, insert_or_update, and replace operations.
       class Write
         include Google::Apis::Core::Hashable

data/lib/google/apis/spanner_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module SpannerV1
       # Version of the google-apis-spanner_v1 gem
-      GEM_VERSION = "0.9.0"
+      GEM_VERSION = "0.10.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.2.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210405"
+      REVISION = "20210517"
     end
   end
 end

data/lib/google/apis/spanner_v1/representations.rb

@@ -82,6 +82,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ContextValue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CreateBackupMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -130,6 +136,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DerivedMetric
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class DiagnosticMessage
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -196,6 +214,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class IndexedHotKey
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class IndexedKeyRangeInfos
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Instance
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -214,6 +244,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class KeyRangeInfo
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class KeyRangeInfos
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class KeySet
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -262,12 +304,42 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListScansResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListSessionsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LocalizedString
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Metric
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class MetricMatrix
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class MetricMatrixRow
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Mutation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -346,6 +418,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PrefixNode
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class QueryOptions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -436,6 +514,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Scan
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ScanData
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Session
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -532,6 +622,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class VisualizationData
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Write
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -640,6 +736,17 @@ module Google
         end
       end
       
+      class ContextValue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :label, as: 'label', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :severity, as: 'severity'
+          property :unit, as: 'unit'
+          property :value, as: 'value'
+        end
+      end
+      
       class CreateBackupMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -722,6 +829,30 @@ module Google
         end
       end
       
+      class DerivedMetric
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :denominator, as: 'denominator', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :numerator, as: 'numerator', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+        end
+      end
+      
+      class DiagnosticMessage
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :info, as: 'info', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :metric, as: 'metric', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :metric_specific, as: 'metricSpecific'
+          property :severity, as: 'severity'
+          property :short_message, as: 'shortMessage', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -829,6 +960,21 @@ module Google
         end
       end
       
+      class IndexedHotKey
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :sparse_hot_keys, as: 'sparseHotKeys'
+        end
+      end
+      
+      class IndexedKeyRangeInfos
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :key_range_infos, as: 'keyRangeInfos', class: Google::Apis::SpannerV1::KeyRangeInfos, decorator: Google::Apis::SpannerV1::KeyRangeInfos::Representation
+      
+        end
+      end
+      
       class Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -862,6 +1008,33 @@ module Google
         end
       end
       
+      class KeyRangeInfo
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :context_values, as: 'contextValues', class: Google::Apis::SpannerV1::ContextValue, decorator: Google::Apis::SpannerV1::ContextValue::Representation
+      
+          property :end_key_index, as: 'endKeyIndex'
+          property :info, as: 'info', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :keys_count, :numeric_string => true, as: 'keysCount'
+          property :metric, as: 'metric', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :start_key_index, as: 'startKeyIndex'
+          property :unit, as: 'unit', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :value, as: 'value'
+        end
+      end
+      
+      class KeyRangeInfos
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :infos, as: 'infos', class: Google::Apis::SpannerV1::KeyRangeInfo, decorator: Google::Apis::SpannerV1::KeyRangeInfo::Representation
+      
+          property :total_size, as: 'totalSize'
+        end
+      end
+      
       class KeySet
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -940,6 +1113,15 @@ module Google
         end
       end
       
+      class ListScansResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :scans, as: 'scans', class: Google::Apis::SpannerV1::Scan, decorator: Google::Apis::SpannerV1::Scan::Representation
+      
+        end
+      end
+      
       class ListSessionsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -949,6 +1131,56 @@ module Google
         end
       end
       
+      class LocalizedString
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :args, as: 'args'
+          property :message, as: 'message'
+          property :token, as: 'token'
+        end
+      end
+      
+      class Metric
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :aggregation, as: 'aggregation'
+          property :category, as: 'category', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :derived, as: 'derived', class: Google::Apis::SpannerV1::DerivedMetric, decorator: Google::Apis::SpannerV1::DerivedMetric::Representation
+      
+          property :display_label, as: 'displayLabel', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :has_nonzero_data, as: 'hasNonzeroData'
+          property :hot_value, as: 'hotValue'
+          hash :indexed_hot_keys, as: 'indexedHotKeys', class: Google::Apis::SpannerV1::IndexedHotKey, decorator: Google::Apis::SpannerV1::IndexedHotKey::Representation
+      
+          hash :indexed_key_range_infos, as: 'indexedKeyRangeInfos', class: Google::Apis::SpannerV1::IndexedKeyRangeInfos, decorator: Google::Apis::SpannerV1::IndexedKeyRangeInfos::Representation
+      
+          property :info, as: 'info', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :matrix, as: 'matrix', class: Google::Apis::SpannerV1::MetricMatrix, decorator: Google::Apis::SpannerV1::MetricMatrix::Representation
+      
+          property :unit, as: 'unit', class: Google::Apis::SpannerV1::LocalizedString, decorator: Google::Apis::SpannerV1::LocalizedString::Representation
+      
+          property :visible, as: 'visible'
+        end
+      end
+      
+      class MetricMatrix
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :rows, as: 'rows', class: Google::Apis::SpannerV1::MetricMatrixRow, decorator: Google::Apis::SpannerV1::MetricMatrixRow::Representation
+      
+        end
+      end
+      
+      class MetricMatrixRow
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :cols, as: 'cols'
+        end
+      end
+      
       class Mutation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1093,6 +1325,17 @@ module Google
         end
       end
       
+      class PrefixNode
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_source_node, as: 'dataSourceNode'
+          property :depth, as: 'depth'
+          property :end_index, as: 'endIndex'
+          property :start_index, as: 'startIndex'
+          property :word, as: 'word'
+        end
+      end
+      
       class QueryOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1247,6 +1490,28 @@ module Google
         end
       end
       
+      class Scan
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :details, as: 'details'
+          property :end_time, as: 'endTime'
+          property :name, as: 'name'
+          property :scan_data, as: 'scanData', class: Google::Apis::SpannerV1::ScanData, decorator: Google::Apis::SpannerV1::ScanData::Representation
+      
+          property :start_time, as: 'startTime'
+        end
+      end
+      
+      class ScanData
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data, as: 'data', class: Google::Apis::SpannerV1::VisualizationData, decorator: Google::Apis::SpannerV1::VisualizationData::Representation
+      
+          property :end_time, as: 'endTime'
+          property :start_time, as: 'startTime'
+        end
+      end
+      
       class Session
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1396,6 +1661,25 @@ module Google
         end
       end
       
+      class VisualizationData
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data_source_end_token, as: 'dataSourceEndToken'
+          property :data_source_separator_token, as: 'dataSourceSeparatorToken'
+          collection :diagnostic_messages, as: 'diagnosticMessages', class: Google::Apis::SpannerV1::DiagnosticMessage, decorator: Google::Apis::SpannerV1::DiagnosticMessage::Representation
+      
+          collection :end_key_strings, as: 'endKeyStrings'
+          property :has_pii, as: 'hasPii'
+          collection :indexed_keys, as: 'indexedKeys'
+          property :key_separator, as: 'keySeparator'
+          property :key_unit, as: 'keyUnit'
+          collection :metrics, as: 'metrics', class: Google::Apis::SpannerV1::Metric, decorator: Google::Apis::SpannerV1::Metric::Representation
+      
+          collection :prefix_nodes, as: 'prefixNodes', class: Google::Apis::SpannerV1::PrefixNode, decorator: Google::Apis::SpannerV1::PrefixNode::Representation
+      
+        end
+      end
+      
       class Write
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/spanner_v1/service.rb

@@ -1262,6 +1262,51 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Request a specific scan with Database-specific data for Cloud Key Visualizer.
+        # @param [String] name
+        #   Required. The unique name of the scan containing the requested information,
+        #   specific to the Database service implementing this interface.
+        # @param [String] end_time
+        #   The upper bound for the time range to retrieve Scan data for.
+        # @param [String] start_time
+        #   These fields restrict the Database-specific information returned in the `Scan.
+        #   data` field. If a `View` is provided that does not include the `Scan.data`
+        #   field, these are ignored. This range of time must be entirely contained within
+        #   the defined time range of the targeted scan. The lower bound for the time
+        #   range to retrieve Scan data for.
+        # @param [String] view
+        #   Specifies which parts of the Scan should be returned in the response. Note, if
+        #   left unspecified, the FULL view is assumed.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SpannerV1::Scan] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SpannerV1::Scan]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_instance_database_scans(name, end_time: nil, start_time: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+name}/scans', options)
+          command.response_representation = Google::Apis::SpannerV1::Scan::Representation
+          command.response_class = Google::Apis::SpannerV1::Scan
+          command.params['name'] = name unless name.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists Cloud Spanner databases.
         # @param [String] parent
         #   Required. The instance whose databases should be listed. Values are of the
@@ -2329,6 +2374,52 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Return available scans given a Database-specific resource name.
+        # @param [String] parent
+        #   Required. The unique name of the parent resource, specific to the Database
+        #   service implementing this interface.
+        # @param [String] filter
+        #   A filter expression to restrict the results based on information present in
+        #   the available Scan collection. The filter applies to all fields within the
+        #   Scan message except for `data`.
+        # @param [Fixnum] page_size
+        #   The maximum number of items to return.
+        # @param [String] page_token
+        #   The next_page_token value returned from a previous List request, if any.
+        # @param [String] view
+        #   Specifies which parts of the Scan should be returned in the response. Note,
+        #   only the SUMMARY view (the default) is currently supported for ListScans.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SpannerV1::ListScansResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SpannerV1::ListScansResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_scans(parent, filter: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1/{+parent}', options)
+          command.response_representation = Google::Apis::SpannerV1::ListScansResponse::Representation
+          command.response_class = Google::Apis::SpannerV1::ListScansResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-spanner_v1
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-18 00:00:00.000000000 Z
+date: 2021-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -52,7 +52,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.9.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.10.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1
 post_install_message: 
 rdoc_options: []