google-apis-spanner_v1 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 625e4ebcbf0da1d443e489addb6607a46b0dda44997b096f81f78a1b2a66f55e
-  data.tar.gz: 26c8f98f6954b9cf6d8ed56eec3cc58ff07637fe5dc9563c7151799ae64e35e4
+  metadata.gz: c691986d397c3d14116d3e6feb75191a64935d454f738f138f3cd5eb298278fb
+  data.tar.gz: 249c23193582a4420af547ca7a0e0bb4f4e8fc884bc80783a6eebf3acdf601eb
 SHA512:
-  metadata.gz: 0d1137d4f8a15222bdb338a4ab275fe3510af66e805697ffbd0b5f32664f421bb492105aee1fe069b884d0b8ab29c35cdd259e4cb05187331323f2bb64dc16e8
-  data.tar.gz: 57b20be9d4bf8e90d7bbd7787099db71b2b57952abd3eb5ecb18649a106ef7a65090aacc2c01652e7543277a87f3e9cdf8a1af7155201410d9bfecdc262cebda
+  metadata.gz: 40e59ff7dff5cc84138d0e2f4914e630cc4b1f9a693b8bef24a6f50eb8f7d1073c31f819a3c7d89eb36e2ff952a9aae5d3eea6ec9835367d9ef4ef13f427a384
+  data.tar.gz: 3b48ef1c5c75b29e9a6fa511aebe07ac2fbbc3b0014a7a1bbd01b0ed9dac24022563d4dafae8f0d526af631984c55e909c961e2c1d2cfa4c32d1c067ec999573

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-spanner_v1
 
+### v0.2.0 (2021-01-28)
+
+* Regenerated from discovery document revision 20210123
+* Regenerated using generator version 0.1.2
+
 ### v0.1.0 (2021-01-07)
 
 * Regenerated using generator version 0.1.1

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

@@ -26,9 +26,9 @@ module Google
       class Backup
         include Google::Apis::Core::Hashable
       
-        # Output only. The backup will contain an externally consistent copy of the
-        # database at the timestamp specified by `create_time`. `create_time` is
-        # approximately the time the CreateBackup request is received.
+        # Output only. The time the CreateBackup request is received. If the request
+        # does not specify `version_time`, the `version_time` of the backup will be
+        # equivalent to the `create_time`.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -80,6 +80,13 @@ module Google
         # @return [String]
         attr_accessor :state
       
+        # The backup will contain an externally consistent copy of the database at the
+        # timestamp specified by `version_time`. If `version_time` is not specified, the
+        # system will set `version_time` to the `create_time` of the backup.
+        # Corresponds to the JSON property `versionTime`
+        # @return [String]
+        attr_accessor :version_time
+      
         def initialize(**args)
            update!(**args)
         end
@@ -93,6 +100,7 @@ module Google
           @referencing_databases = args[:referencing_databases] if args.key?(:referencing_databases)
           @size_bytes = args[:size_bytes] if args.key?(:size_bytes)
           @state = args[:state] if args.key?(:state)
+          @version_time = args[:version_time] if args.key?(:version_time)
         end
       end
       
@@ -105,8 +113,7 @@ module Google
         # @return [String]
         attr_accessor :backup
       
-        # The backup contains an externally consistent copy of `source_database` at the
-        # timestamp specified by `create_time`.
+        # The time the CreateBackup request was received.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -116,6 +123,14 @@ module Google
         # @return [String]
         attr_accessor :source_database
       
+        # The backup contains an externally consistent copy of `source_database` at the
+        # timestamp specified by `version_time`. If the CreateBackup request did not
+        # specify `version_time`, the `version_time` of the backup is equivalent to the `
+        # create_time`.
+        # Corresponds to the JSON property `versionTime`
+        # @return [String]
+        attr_accessor :version_time
+      
         def initialize(**args)
            update!(**args)
         end
@@ -125,6 +140,7 @@ module Google
           @backup = args[:backup] if args.key?(:backup)
           @create_time = args[:create_time] if args.key?(:create_time)
           @source_database = args[:source_database] if args.key?(:source_database)
+          @version_time = args[:version_time] if args.key?(:version_time)
         end
       end
       
@@ -472,6 +488,13 @@ module Google
         # @return [Array<Google::Apis::SpannerV1::Mutation>]
         attr_accessor :mutations
       
+        # If `true`, then statistics related to the transaction will be included in the
+        # CommitResponse. Default value is `false`.
+        # Corresponds to the JSON property `returnCommitStats`
+        # @return [Boolean]
+        attr_accessor :return_commit_stats
+        alias_method :return_commit_stats?, :return_commit_stats
+      
         # # Transactions Each session can have at most one active transaction at a time (
         # note that standalone reads and queries use a transaction internally and do
         # count towards the one transaction limit). After the active transaction is
@@ -648,6 +671,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @mutations = args[:mutations] if args.key?(:mutations)
+          @return_commit_stats = args[:return_commit_stats] if args.key?(:return_commit_stats)
           @single_use_transaction = args[:single_use_transaction] if args.key?(:single_use_transaction)
           @transaction_id = args[:transaction_id] if args.key?(:transaction_id)
         end
@@ -657,6 +681,11 @@ module Google
       class CommitResponse
         include Google::Apis::Core::Hashable
       
+        # Additional statistics about a commit.
+        # Corresponds to the JSON property `commitStats`
+        # @return [Google::Apis::SpannerV1::CommitStats]
+        attr_accessor :commit_stats
+      
         # The Cloud Spanner timestamp at which the transaction committed.
         # Corresponds to the JSON property `commitTimestamp`
         # @return [String]
@@ -668,10 +697,37 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @commit_stats = args[:commit_stats] if args.key?(:commit_stats)
           @commit_timestamp = args[:commit_timestamp] if args.key?(:commit_timestamp)
         end
       end
       
+      # Additional statistics about a commit.
+      class CommitStats
+        include Google::Apis::Core::Hashable
+      
+        # The total number of mutations for the transaction. Knowing the `mutation_count`
+        # value can help you maximize the number of mutations in a transaction and
+        # minimize the number of API round trips. You can also monitor this value to
+        # prevent transactions from exceeding the system [limit](http://cloud.google.com/
+        # spanner/quotas#limits_for_creating_reading_updating_and_deleting_data). If the
+        # number of mutations exceeds the limit, the server returns [INVALID_ARGUMENT](
+        # http://cloud.google.com/spanner/docs/reference/rest/v1/Code#ENUM_VALUES.
+        # INVALID_ARGUMENT).
+        # Corresponds to the JSON property `mutationCount`
+        # @return [Fixnum]
+        attr_accessor :mutation_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mutation_count = args[:mutation_count] if args.key?(:mutation_count)
+        end
+      end
+      
       # Metadata type for the operation returned by CreateBackup.
       class CreateBackupMetadata
         include Google::Apis::Core::Hashable
@@ -861,6 +917,12 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # Output only. Earliest timestamp at which older versions of the data can be
+        # read.
+        # Corresponds to the JSON property `earliestVersionTime`
+        # @return [String]
+        attr_accessor :earliest_version_time
+      
         # Required. The name of the database. Values are of the form `projects//
         # instances//databases/`, where `` is as specified in the `CREATE DATABASE`
         # statement. This name can be passed to other API methods to identify the
@@ -879,6 +941,13 @@ module Google
         # @return [String]
         attr_accessor :state
       
+        # Output only. The period in which Cloud Spanner retains all versions of data
+        # for the database. This is same as the value of version_retention_period
+        # database option set using UpdateDatabaseDdl. Defaults to 1 hour, if not set.
+        # Corresponds to the JSON property `versionRetentionPeriod`
+        # @return [String]
+        attr_accessor :version_retention_period
+      
         def initialize(**args)
            update!(**args)
         end
@@ -886,9 +955,11 @@ module Google
         # Update properties of this object
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @earliest_version_time = args[:earliest_version_time] if args.key?(:earliest_version_time)
           @name = args[:name] if args.key?(:name)
           @restore_info = args[:restore_info] if args.key?(:restore_info)
           @state = args[:state] if args.key?(:state)
+          @version_retention_period = args[:version_retention_period] if args.key?(:version_retention_period)
         end
       end
       
@@ -1652,6 +1723,12 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
+        # The list of unreachable instances. It includes the names of instances whose
+        # metadata could not be retrieved within instance_deadline.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1660,6 +1737,7 @@ module Google
         def update!(**args)
           @instances = args[:instances] if args.key?(:instances)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
         end
       end
       

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.1.0"
+      GEM_VERSION = "0.2.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.1.1"
+      GENERATOR_VERSION = "0.1.2"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20201130"
+      REVISION = "20210123"
     end
   end
 end

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

@@ -76,6 +76,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CommitStats
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CreateBackupMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -518,6 +524,7 @@ module Google
           collection :referencing_databases, as: 'referencingDatabases'
           property :size_bytes, :numeric_string => true, as: 'sizeBytes'
           property :state, as: 'state'
+          property :version_time, as: 'versionTime'
         end
       end
       
@@ -527,6 +534,7 @@ module Google
           property :backup, as: 'backup'
           property :create_time, as: 'createTime'
           property :source_database, as: 'sourceDatabase'
+          property :version_time, as: 'versionTime'
         end
       end
       
@@ -579,6 +587,7 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           collection :mutations, as: 'mutations', class: Google::Apis::SpannerV1::Mutation, decorator: Google::Apis::SpannerV1::Mutation::Representation
       
+          property :return_commit_stats, as: 'returnCommitStats'
           property :single_use_transaction, as: 'singleUseTransaction', class: Google::Apis::SpannerV1::TransactionOptions, decorator: Google::Apis::SpannerV1::TransactionOptions::Representation
       
           property :transaction_id, :base64 => true, as: 'transactionId'
@@ -588,10 +597,19 @@ module Google
       class CommitResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :commit_stats, as: 'commitStats', class: Google::Apis::SpannerV1::CommitStats, decorator: Google::Apis::SpannerV1::CommitStats::Representation
+      
           property :commit_timestamp, as: 'commitTimestamp'
         end
       end
       
+      class CommitStats
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :mutation_count, :numeric_string => true, as: 'mutationCount'
+        end
+      end
+      
       class CreateBackupMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -650,10 +668,12 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :create_time, as: 'createTime'
+          property :earliest_version_time, as: 'earliestVersionTime'
           property :name, as: 'name'
           property :restore_info, as: 'restoreInfo', class: Google::Apis::SpannerV1::RestoreInfo, decorator: Google::Apis::SpannerV1::RestoreInfo::Representation
       
           property :state, as: 'state'
+          property :version_retention_period, as: 'versionRetentionPeriod'
         end
       end
       
@@ -850,6 +870,7 @@ module Google
           collection :instances, as: 'instances', class: Google::Apis::SpannerV1::Instance, decorator: Google::Apis::SpannerV1::Instance::Representation
       
           property :next_page_token, as: 'nextPageToken'
+          collection :unreachable, as: 'unreachable'
         end
       end
       

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

@@ -290,6 +290,10 @@ module Google
         #   value of the label contains the string "dev". * `name:howl labels.env:dev` -->
         #   The instance's name contains "howl" and it has the label "env" with its value
         #   containing "dev".
+        # @param [String] instance_deadline
+        #   Deadline used while retrieving metadata for instances. Instances whose
+        #   metadata cannot be retrieved within this deadline will be added to unreachable
+        #   in ListInstancesResponse.
         # @param [Fixnum] page_size
         #   Number of instances to be returned in the response. If 0 or less, defaults to
         #   the server's maximum allowed page size.
@@ -313,12 +317,13 @@ module Google
         # @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_project_instances(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_instances(parent, filter: nil, instance_deadline: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+parent}/instances', options)
           command.response_representation = Google::Apis::SpannerV1::ListInstancesResponse::Representation
           command.response_class = Google::Apis::SpannerV1::ListInstancesResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['filter'] = filter unless filter.nil?
+          command.query['instanceDeadline'] = instance_deadline unless instance_deadline.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['fields'] = fields unless fields.nil?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-spanner_v1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-08 00:00:00.000000000 Z
+date: 2021-02-08 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.1.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.2.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1
 post_install_message: 
 rdoc_options: []
@@ -69,7 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.6
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Spanner API V1