google-apis-spanner_v1 0.44.0 → 0.46.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f94ddd3a38c1bce164cdadedebce2083cccc4038af71a6e91cc46a003bf055bf
4
- data.tar.gz: 5de1e4480e4ec081ec3549afbd6b7aec520e0f2bc493ab854047929b4713774d
3
+ metadata.gz: 998106fc7b59053485fbe747c99d7a207897e378f0e425f22f25ca32eab20822
4
+ data.tar.gz: 908165719b7a513cef3cd747a9e35ee7086e5674e2ece49fb09a5ca6e3870688
5
5
  SHA512:
6
- metadata.gz: 6ea3cd6e82d86e8e37a4b6dfe61501a88660c2ec7411c765f965a08f0e2a98c3da429f706780424512d52abb14aac169ba9720aaf161c983245b345ffab33e55
7
- data.tar.gz: 4886d04f2ebdaf62229a891269f094c9916a3f62a6fe60edabc1518177357bf6fe09e6d4e317397ce441cb28dbd022c7ab1678f3b0d88e6c3f40a8d70209084f
6
+ metadata.gz: 7dfa2f26271b259fc80a8955dbc5d7bf952f0660215f2fcda80c2bac7ba16305e469d4c80db1f5ba59d61da4a348b77b0ebb3683f6b057929f4b8376a6607ea9
7
+ data.tar.gz: 5048dd9bd25d8773fc67614fe9c1384d7ce2232a97f4490e738e7cba82e98b4459be8d68fc18d266fc0ea11f1b68910a8f00f61dd8270b39f76f5a76818ecc91
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-spanner_v1
2
2
 
3
+ ### v0.46.0 (2025-11-16)
4
+
5
+ * Regenerated from discovery document revision 20251031
6
+
7
+ ### v0.45.0 (2025-10-05)
8
+
9
+ * Regenerated from discovery document revision 20250920
10
+
3
11
  ### v0.44.0 (2025-07-20)
4
12
 
5
13
  * Regenerated from discovery document revision 20250708
@@ -58,6 +58,14 @@ module Google
58
58
  class AdaptMessageResponse
59
59
  include Google::Apis::Core::Hashable
60
60
 
61
+ # Optional. Indicates whether this is the last AdaptMessageResponse in the
62
+ # stream. This field may be optionally set by the server. Clients should not
63
+ # rely on this field being set in all cases.
64
+ # Corresponds to the JSON property `last`
65
+ # @return [Boolean]
66
+ attr_accessor :last
67
+ alias_method :last?, :last
68
+
61
69
  # Optional. Uninterpreted bytes from the underlying wire protocol.
62
70
  # Corresponds to the JSON property `payload`
63
71
  # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -75,6 +83,7 @@ module Google
75
83
 
76
84
  # Update properties of this object
77
85
  def update!(**args)
86
+ @last = args[:last] if args.key?(:last)
78
87
  @payload = args[:payload] if args.key?(:payload)
79
88
  @state_updates = args[:state_updates] if args.key?(:state_updates)
80
89
  end
@@ -408,9 +417,9 @@ module Google
408
417
  # @return [String]
409
418
  attr_accessor :incremental_backup_chain_id
410
419
 
411
- # Output only. The instance partition(s) storing the backup. This is the same as
412
- # the list of the instance partition(s) that the database had footprint in at
413
- # the backup's `version_time`.
420
+ # Output only. The instance partition storing the backup. This is the same as
421
+ # the list of the instance partitions that the database recorded at the backup's
422
+ # `version_time`.
414
423
  # Corresponds to the JSON property `instancePartitions`
415
424
  # @return [Array<Google::Apis::SpannerV1::BackupInstancePartition>]
416
425
  attr_accessor :instance_partitions
@@ -665,10 +674,11 @@ module Google
665
674
  class BatchCreateSessionsRequest
666
675
  include Google::Apis::Core::Hashable
667
676
 
668
- # Required. The number of sessions to be created in this batch call. The API can
669
- # return fewer than the requested number of sessions. If a specific number of
670
- # sessions are desired, the client can make additional calls to `
671
- # BatchCreateSessions` (adjusting session_count as necessary).
677
+ # Required. The number of sessions to be created in this batch call. At least
678
+ # one session is created. The API can return fewer than the requested number of
679
+ # sessions. If a specific number of sessions are desired, the client can make
680
+ # additional calls to `BatchCreateSessions` (adjusting session_count as
681
+ # necessary).
672
682
  # Corresponds to the JSON property `sessionCount`
673
683
  # @return [Fixnum]
674
684
  attr_accessor :session_count
@@ -1220,6 +1230,13 @@ module Google
1220
1230
  # @return [Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken]
1221
1231
  attr_accessor :precommit_token
1222
1232
 
1233
+ # If `TransactionOptions.isolation_level` is set to `IsolationLevel.
1234
+ # REPEATABLE_READ`, then the snapshot timestamp is the timestamp at which all
1235
+ # reads in the transaction ran. This timestamp is never returned.
1236
+ # Corresponds to the JSON property `snapshotTimestamp`
1237
+ # @return [String]
1238
+ attr_accessor :snapshot_timestamp
1239
+
1223
1240
  def initialize(**args)
1224
1241
  update!(**args)
1225
1242
  end
@@ -1229,6 +1246,7 @@ module Google
1229
1246
  @commit_stats = args[:commit_stats] if args.key?(:commit_stats)
1230
1247
  @commit_timestamp = args[:commit_timestamp] if args.key?(:commit_timestamp)
1231
1248
  @precommit_token = args[:precommit_token] if args.key?(:precommit_token)
1249
+ @snapshot_timestamp = args[:snapshot_timestamp] if args.key?(:snapshot_timestamp)
1232
1250
  end
1233
1251
  end
1234
1252
 
@@ -1306,9 +1324,15 @@ module Google
1306
1324
  # @return [String]
1307
1325
  attr_accessor :encryption_type
1308
1326
 
1309
- # Optional. The Cloud KMS key that will be used to protect the backup. This
1310
- # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
1311
- # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
1327
+ # Optional. This field is maintained for backwards compatibility. For new
1328
+ # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
1329
+ # kms_key_name` if the location of the KMS key matches the database instance's
1330
+ # configuration (location) exactly. For example, if the KMS location is in `us-
1331
+ # central1` or `nam3`, then the database instance must also be in `us-central1`
1332
+ # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
1333
+ # database. Set this field only when encryption_type is `
1334
+ # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
1335
+ # keyRings//cryptoKeys/`.
1312
1336
  # Corresponds to the JSON property `kmsKeyName`
1313
1337
  # @return [String]
1314
1338
  attr_accessor :kms_key_name
@@ -1442,9 +1466,15 @@ module Google
1442
1466
  # @return [String]
1443
1467
  attr_accessor :encryption_type
1444
1468
 
1445
- # Optional. The Cloud KMS key that will be used to protect the backup. This
1446
- # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
1447
- # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
1469
+ # Optional. This field is maintained for backwards compatibility. For new
1470
+ # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
1471
+ # kms_key_name` if the location of the KMS key matches the database instance's
1472
+ # configuration (location) exactly. For example, if the KMS location is in `us-
1473
+ # central1` or `nam3`, then the database instance must also be in `us-central1`
1474
+ # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
1475
+ # database. Set this field only when encryption_type is `
1476
+ # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
1477
+ # keyRings//cryptoKeys/`.
1448
1478
  # Corresponds to the JSON property `kmsKeyName`
1449
1479
  # @return [String]
1450
1480
  attr_accessor :kms_key_name
@@ -2164,23 +2194,23 @@ module Google
2164
2194
  class DdlStatementActionInfo
2165
2195
  include Google::Apis::Core::Hashable
2166
2196
 
2167
- # The action for the DDL statement, e.g. CREATE, ALTER, DROP, GRANT, etc. This
2168
- # field is a non-empty string.
2197
+ # The action for the DDL statement, for example, CREATE, ALTER, DROP, GRANT, etc.
2198
+ # This field is a non-empty string.
2169
2199
  # Corresponds to the JSON property `action`
2170
2200
  # @return [String]
2171
2201
  attr_accessor :action
2172
2202
 
2173
- # The entity name(s) being operated on the DDL statement. E.g. 1. For statement "
2174
- # CREATE TABLE t1(...)", `entity_names` = ["t1"]. 2. For statement "GRANT ROLE
2175
- # r1, r2 ...", `entity_names` = ["r1", "r2"]. 3. For statement "ANALYZE", `
2176
- # entity_names` = [].
2203
+ # The entity names being operated on the DDL statement. For example, 1. For
2204
+ # statement "CREATE TABLE t1(...)", `entity_names` = ["t1"]. 2. For statement "
2205
+ # GRANT ROLE r1, r2 ...", `entity_names` = ["r1", "r2"]. 3. For statement "
2206
+ # ANALYZE", `entity_names` = [].
2177
2207
  # Corresponds to the JSON property `entityNames`
2178
2208
  # @return [Array<String>]
2179
2209
  attr_accessor :entity_names
2180
2210
 
2181
- # The entity type for the DDL statement, e.g. TABLE, INDEX, VIEW, etc. This
2182
- # field can be empty string for some DDL statement, e.g. for statement "ANALYZE",
2183
- # `entity_type` = "".
2211
+ # The entity type for the DDL statement, for example, TABLE, INDEX, VIEW, etc.
2212
+ # This field can be empty string for some DDL statement, for example, for
2213
+ # statement "ANALYZE", `entity_type` = "".
2184
2214
  # Corresponds to the JSON property `entityType`
2185
2215
  # @return [String]
2186
2216
  attr_accessor :entity_type
@@ -3366,12 +3396,12 @@ module Google
3366
3396
  include Google::Apis::Core::Hashable
3367
3397
 
3368
3398
  # Optional. This field is maintained for backwards compatibility. For new
3369
- # callers, we recommend using `kms_key_names` to specify the KMS key. `
3370
- # kms_key_name` should only be used if the location of the KMS key matches the
3371
- # database instance’s configuration (location) exactly. E.g. The KMS location is
3372
- # in us-central1 or nam3 and the database instance is also in us-central1 or
3373
- # nam3. The Cloud KMS key to be used for encrypting and decrypting the database.
3374
- # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
3399
+ # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
3400
+ # kms_key_name` if the location of the KMS key matches the database instance's
3401
+ # configuration (location) exactly. For example, if the KMS location is in `us-
3402
+ # central1` or `nam3`, then the database instance must also be in `us-central1`
3403
+ # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
3404
+ # database. Values are of the form `projects//locations//keyRings//cryptoKeys/`.
3375
3405
  # Corresponds to the JSON property `kmsKeyName`
3376
3406
  # @return [String]
3377
3407
  attr_accessor :kms_key_name
@@ -3440,6 +3470,11 @@ module Google
3440
3470
  class InstancePartition
3441
3471
  include Google::Apis::Core::Hashable
3442
3472
 
3473
+ # Autoscaling configuration for an instance.
3474
+ # Corresponds to the JSON property `autoscalingConfig`
3475
+ # @return [Google::Apis::SpannerV1::AutoscalingConfig]
3476
+ attr_accessor :autoscaling_config
3477
+
3443
3478
  # Required. The name of the instance partition's configuration. Values are of
3444
3479
  # the form `projects//instanceConfigs/`. See also InstanceConfig and
3445
3480
  # ListInstanceConfigs.
@@ -3527,6 +3562,7 @@ module Google
3527
3562
 
3528
3563
  # Update properties of this object
3529
3564
  def update!(**args)
3565
+ @autoscaling_config = args[:autoscaling_config] if args.key?(:autoscaling_config)
3530
3566
  @config = args[:config] if args.key?(:config)
3531
3567
  @create_time = args[:create_time] if args.key?(:create_time)
3532
3568
  @display_name = args[:display_name] if args.key?(:display_name)
@@ -3545,7 +3581,7 @@ module Google
3545
3581
  class InstanceReplicaSelection
3546
3582
  include Google::Apis::Core::Hashable
3547
3583
 
3548
- # Required. Name of the location of the replicas (e.g., "us-central1").
3584
+ # Required. Name of the location of the replicas (for example, "us-central1").
3549
3585
  # Corresponds to the JSON property `location`
3550
3586
  # @return [String]
3551
3587
  attr_accessor :location
@@ -4129,6 +4165,13 @@ module Google
4129
4165
  # @return [Array<Google::Apis::SpannerV1::Operation>]
4130
4166
  attr_accessor :operations
4131
4167
 
4168
+ # Unordered list. Unreachable resources. Populated when the request sets `
4169
+ # ListOperationsRequest.return_partial_success` and reads across collections e.g.
4170
+ # when attempting to list all resources across all supported locations.
4171
+ # Corresponds to the JSON property `unreachable`
4172
+ # @return [Array<String>]
4173
+ attr_accessor :unreachable
4174
+
4132
4175
  def initialize(**args)
4133
4176
  update!(**args)
4134
4177
  end
@@ -4137,6 +4180,7 @@ module Google
4137
4180
  def update!(**args)
4138
4181
  @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
4139
4182
  @operations = args[:operations] if args.key?(:operations)
4183
+ @unreachable = args[:unreachable] if args.key?(:unreachable)
4140
4184
  end
4141
4185
  end
4142
4186
 
@@ -5956,8 +6000,13 @@ module Google
5956
6000
  # @return [String]
5957
6001
  attr_accessor :encryption_type
5958
6002
 
5959
- # Optional. The Cloud KMS key that will be used to encrypt/decrypt the restored
5960
- # database. This field should be set only when encryption_type is `
6003
+ # Optional. This field is maintained for backwards compatibility. For new
6004
+ # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
6005
+ # kms_key_name` if the location of the KMS key matches the database instance's
6006
+ # configuration (location) exactly. For example, if the KMS location is in `us-
6007
+ # central1` or `nam3`, then the database instance must also be in `us-central1`
6008
+ # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
6009
+ # database. Set this field only when encryption_type is `
5961
6010
  # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
5962
6011
  # keyRings//cryptoKeys/`.
5963
6012
  # Corresponds to the JSON property `kmsKeyName`
@@ -6467,11 +6516,11 @@ module Google
6467
6516
  class SingleRegionQuorum
6468
6517
  include Google::Apis::Core::Hashable
6469
6518
 
6470
- # Required. The location of the serving region, e.g. "us-central1". The location
6471
- # must be one of the regions within the dual-region instance configuration of
6472
- # your database. The list of valid locations is available using the
6473
- # GetInstanceConfig API. This should only be used if you plan to change quorum
6474
- # to the single-region quorum type.
6519
+ # Required. The location of the serving region, for example, "us-central1". The
6520
+ # location must be one of the regions within the dual-region instance
6521
+ # configuration of your database. The list of valid locations is available using
6522
+ # the GetInstanceConfig API. This should only be used if you plan to change
6523
+ # quorum to the single-region quorum type.
6475
6524
  # Corresponds to the JSON property `servingLocation`
6476
6525
  # @return [String]
6477
6526
  attr_accessor :serving_location
@@ -6884,9 +6933,9 @@ module Google
6884
6933
  # @return [Array<String>]
6885
6934
  attr_accessor :statements
6886
6935
 
6887
- # Output only. When true, indicates that the operation is throttled e.g. due to
6888
- # resource constraints. When resources become available the operation will
6889
- # resume and this field will be false again.
6936
+ # Output only. When true, indicates that the operation is throttled, for example,
6937
+ # due to resource constraints. When resources become available the operation
6938
+ # will resume and this field will be false again.
6890
6939
  # Corresponds to the JSON property `throttled`
6891
6940
  # @return [Boolean]
6892
6941
  attr_accessor :throttled
@@ -6911,13 +6960,13 @@ module Google
6911
6960
  # all at once, to the database schema at some point (or points) in the future.
6912
6961
  # The server checks that the statements are executable (syntactically valid,
6913
6962
  # name tables that exist, etc.) before enqueueing them, but they may still fail
6914
- # upon later execution (e.g., if a statement from another batch of statements is
6915
- # applied first and it conflicts in some way, or if there is some data-related
6916
- # problem like a `NULL` value in a column to which `NOT NULL` would be added).
6917
- # If a statement fails, all subsequent statements in the batch are automatically
6918
- # cancelled. Each batch of statements is assigned a name which can be used with
6919
- # the Operations API to monitor progress. See the operation_id field for more
6920
- # details.
6963
+ # upon later execution (for example, if a statement from another batch of
6964
+ # statements is applied first and it conflicts in some way, or if there is some
6965
+ # data-related problem like a `NULL` value in a column to which `NOT NULL` would
6966
+ # be added). If a statement fails, all subsequent statements in the batch are
6967
+ # automatically cancelled. Each batch of statements is assigned a name which can
6968
+ # be used with the Operations API to monitor progress. See the operation_id
6969
+ # field for more details.
6921
6970
  class UpdateDatabaseDdlRequest
6922
6971
  include Google::Apis::Core::Hashable
6923
6972
 
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module SpannerV1
18
18
  # Version of the google-apis-spanner_v1 gem
19
- GEM_VERSION = "0.44.0"
19
+ GEM_VERSION = "0.46.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20250708"
25
+ REVISION = "20251031"
26
26
  end
27
27
  end
28
28
  end
@@ -1090,6 +1090,7 @@ module Google
1090
1090
  class AdaptMessageResponse
1091
1091
  # @private
1092
1092
  class Representation < Google::Apis::Core::JsonRepresentation
1093
+ property :last, as: 'last'
1093
1094
  property :payload, :base64 => true, as: 'payload'
1094
1095
  hash :state_updates, as: 'stateUpdates'
1095
1096
  end
@@ -1377,6 +1378,7 @@ module Google
1377
1378
  property :commit_timestamp, as: 'commitTimestamp'
1378
1379
  property :precommit_token, as: 'precommitToken', class: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken, decorator: Google::Apis::SpannerV1::MultiplexedSessionPrecommitToken::Representation
1379
1380
 
1381
+ property :snapshot_timestamp, as: 'snapshotTimestamp'
1380
1382
  end
1381
1383
  end
1382
1384
 
@@ -1916,6 +1918,8 @@ module Google
1916
1918
  class InstancePartition
1917
1919
  # @private
1918
1920
  class Representation < Google::Apis::Core::JsonRepresentation
1921
+ property :autoscaling_config, as: 'autoscalingConfig', class: Google::Apis::SpannerV1::AutoscalingConfig, decorator: Google::Apis::SpannerV1::AutoscalingConfig::Representation
1922
+
1919
1923
  property :config, as: 'config'
1920
1924
  property :create_time, as: 'createTime'
1921
1925
  property :display_name, as: 'displayName'
@@ -2104,6 +2108,7 @@ module Google
2104
2108
  property :next_page_token, as: 'nextPageToken'
2105
2109
  collection :operations, as: 'operations', class: Google::Apis::SpannerV1::Operation, decorator: Google::Apis::SpannerV1::Operation::Representation
2106
2110
 
2111
+ collection :unreachable, as: 'unreachable'
2107
2112
  end
2108
2113
  end
2109
2114
 
@@ -458,6 +458,13 @@ module Google
458
458
  # The standard list page size.
459
459
  # @param [String] page_token
460
460
  # The standard list page token.
461
+ # @param [Boolean] return_partial_success
462
+ # When set to `true`, operations that are reachable are returned as normal, and
463
+ # those that are unreachable are returned in the [ListOperationsResponse.
464
+ # unreachable] field. This can only be `true` when reading across collections e.
465
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
466
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
467
+ # explicitly documented otherwise in service or product specific documentation.
461
468
  # @param [String] fields
462
469
  # Selector specifying which fields to include in a partial response.
463
470
  # @param [String] quota_user
@@ -475,7 +482,7 @@ module Google
475
482
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
476
483
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
477
484
  # @raise [Google::Apis::AuthorizationError] Authorization is required
478
- def list_project_instance_config_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
485
+ def list_project_instance_config_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
479
486
  command = make_simple_command(:get, 'v1/{+name}', options)
480
487
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
481
488
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
@@ -483,6 +490,7 @@ module Google
483
490
  command.query['filter'] = filter unless filter.nil?
484
491
  command.query['pageSize'] = page_size unless page_size.nil?
485
492
  command.query['pageToken'] = page_token unless page_token.nil?
493
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
486
494
  command.query['fields'] = fields unless fields.nil?
487
495
  command.query['quotaUser'] = quota_user unless quota_user.nil?
488
496
  execute_or_queue_command(command, &block)
@@ -599,6 +607,13 @@ module Google
599
607
  # The standard list page size.
600
608
  # @param [String] page_token
601
609
  # The standard list page token.
610
+ # @param [Boolean] return_partial_success
611
+ # When set to `true`, operations that are reachable are returned as normal, and
612
+ # those that are unreachable are returned in the [ListOperationsResponse.
613
+ # unreachable] field. This can only be `true` when reading across collections e.
614
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
615
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
616
+ # explicitly documented otherwise in service or product specific documentation.
602
617
  # @param [String] fields
603
618
  # Selector specifying which fields to include in a partial response.
604
619
  # @param [String] quota_user
@@ -616,7 +631,7 @@ module Google
616
631
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
617
632
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
618
633
  # @raise [Google::Apis::AuthorizationError] Authorization is required
619
- def list_project_instance_config_ssd_cach_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
634
+ def list_project_instance_config_ssd_cach_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
620
635
  command = make_simple_command(:get, 'v1/{+name}', options)
621
636
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
622
637
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
@@ -624,6 +639,7 @@ module Google
624
639
  command.query['filter'] = filter unless filter.nil?
625
640
  command.query['pageSize'] = page_size unless page_size.nil?
626
641
  command.query['pageToken'] = page_token unless page_token.nil?
642
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
627
643
  command.query['fields'] = fields unless fields.nil?
628
644
  command.query['quotaUser'] = quota_user unless quota_user.nil?
629
645
  execute_or_queue_command(command, &block)
@@ -1169,11 +1185,10 @@ module Google
1169
1185
  # delete the backup. There can be only one pending backup creation per database.
1170
1186
  # Backup creation of different databases can run concurrently.
1171
1187
  # @param [String] parent
1172
- # Required. The name of the instance in which the backup will be created. This
1173
- # must be the same instance that contains the database the backup will be
1174
- # created from. The backup will be stored in the location(s) specified in the
1175
- # instance configuration of this instance. Values are of the form `projects//
1176
- # instances/`.
1188
+ # Required. The name of the instance in which the backup is created. This must
1189
+ # be the same instance that contains the database the backup is created from.
1190
+ # The backup will be stored in the locations specified in the instance
1191
+ # configuration of this instance. Values are of the form `projects//instances/`.
1177
1192
  # @param [Google::Apis::SpannerV1::Backup] backup_object
1178
1193
  # @param [String] backup_id
1179
1194
  # Required. The id of the backup to be created. The `backup_id` appended to `
@@ -1181,9 +1196,15 @@ module Google
1181
1196
  # @param [String] encryption_config_encryption_type
1182
1197
  # Required. The encryption type of the backup.
1183
1198
  # @param [String] encryption_config_kms_key_name
1184
- # Optional. The Cloud KMS key that will be used to protect the backup. This
1185
- # field should be set only when encryption_type is `CUSTOMER_MANAGED_ENCRYPTION`.
1186
- # Values are of the form `projects//locations//keyRings//cryptoKeys/`.
1199
+ # Optional. This field is maintained for backwards compatibility. For new
1200
+ # callers, we recommend using `kms_key_names` to specify the KMS key. Only use `
1201
+ # kms_key_name` if the location of the KMS key matches the database instance's
1202
+ # configuration (location) exactly. For example, if the KMS location is in `us-
1203
+ # central1` or `nam3`, then the database instance must also be in `us-central1`
1204
+ # or `nam3`. The Cloud KMS key that is used to encrypt and decrypt the restored
1205
+ # database. Set this field only when encryption_type is `
1206
+ # CUSTOMER_MANAGED_ENCRYPTION`. Values are of the form `projects//locations//
1207
+ # keyRings//cryptoKeys/`.
1187
1208
  # @param [Array<String>, String] encryption_config_kms_key_names
1188
1209
  # Optional. Specifies the KMS configuration for the one or more keys used to
1189
1210
  # protect the backup. Values are of the form `projects//locations//keyRings//
@@ -1406,11 +1427,11 @@ module Google
1406
1427
  # the form `projects//instances/`.
1407
1428
  # @param [Google::Apis::SpannerV1::Backup] backup_object
1408
1429
  # @param [String] update_mask
1409
- # Required. A mask specifying which fields (e.g. `expire_time`) in the Backup
1410
- # resource should be updated. This mask is relative to the Backup resource, not
1411
- # to the request message. The field mask must always be specified; this prevents
1412
- # any future fields from being erased accidentally by clients that do not know
1413
- # about them.
1430
+ # Required. A mask specifying which fields (for example, `expire_time`) in the
1431
+ # backup resource should be updated. This mask is relative to the backup
1432
+ # resource, not to the request message. The field mask must always be specified;
1433
+ # this prevents any future fields from being erased accidentally by clients that
1434
+ # do not know about them.
1414
1435
  # @param [String] fields
1415
1436
  # Selector specifying which fields to include in a partial response.
1416
1437
  # @param [String] quota_user
@@ -1634,6 +1655,13 @@ module Google
1634
1655
  # The standard list page size.
1635
1656
  # @param [String] page_token
1636
1657
  # The standard list page token.
1658
+ # @param [Boolean] return_partial_success
1659
+ # When set to `true`, operations that are reachable are returned as normal, and
1660
+ # those that are unreachable are returned in the [ListOperationsResponse.
1661
+ # unreachable] field. This can only be `true` when reading across collections e.
1662
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
1663
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
1664
+ # explicitly documented otherwise in service or product specific documentation.
1637
1665
  # @param [String] fields
1638
1666
  # Selector specifying which fields to include in a partial response.
1639
1667
  # @param [String] quota_user
@@ -1651,7 +1679,7 @@ module Google
1651
1679
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1652
1680
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1653
1681
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1654
- def list_project_instance_backup_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1682
+ def list_project_instance_backup_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
1655
1683
  command = make_simple_command(:get, 'v1/{+name}', options)
1656
1684
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
1657
1685
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
@@ -1659,6 +1687,7 @@ module Google
1659
1687
  command.query['filter'] = filter unless filter.nil?
1660
1688
  command.query['pageSize'] = page_size unless page_size.nil?
1661
1689
  command.query['pageToken'] = page_token unless page_token.nil?
1690
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
1662
1691
  command.query['fields'] = fields unless fields.nil?
1663
1692
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1664
1693
  execute_or_queue_command(command, &block)
@@ -2252,7 +2281,7 @@ module Google
2252
2281
  # Updates the schema of a Cloud Spanner database by creating/altering/dropping
2253
2282
  # tables, columns, indexes, etc. The returned long-running operation will have a
2254
2283
  # name of the format `/operations/` and can be used to track execution of the
2255
- # schema change(s). The metadata field type is UpdateDatabaseDdlMetadata. The
2284
+ # schema changes. The metadata field type is UpdateDatabaseDdlMetadata. The
2256
2285
  # operation has no response.
2257
2286
  # @param [String] database
2258
2287
  # Required. The database to update.
@@ -2783,6 +2812,13 @@ module Google
2783
2812
  # The standard list page size.
2784
2813
  # @param [String] page_token
2785
2814
  # The standard list page token.
2815
+ # @param [Boolean] return_partial_success
2816
+ # When set to `true`, operations that are reachable are returned as normal, and
2817
+ # those that are unreachable are returned in the [ListOperationsResponse.
2818
+ # unreachable] field. This can only be `true` when reading across collections e.
2819
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
2820
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
2821
+ # explicitly documented otherwise in service or product specific documentation.
2786
2822
  # @param [String] fields
2787
2823
  # Selector specifying which fields to include in a partial response.
2788
2824
  # @param [String] quota_user
@@ -2800,7 +2836,7 @@ module Google
2800
2836
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2801
2837
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2802
2838
  # @raise [Google::Apis::AuthorizationError] Authorization is required
2803
- def list_project_instance_database_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
2839
+ def list_project_instance_database_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
2804
2840
  command = make_simple_command(:get, 'v1/{+name}', options)
2805
2841
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
2806
2842
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
@@ -2808,6 +2844,7 @@ module Google
2808
2844
  command.query['filter'] = filter unless filter.nil?
2809
2845
  command.query['pageSize'] = page_size unless page_size.nil?
2810
2846
  command.query['pageToken'] = page_token unless page_token.nil?
2847
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
2811
2848
  command.query['fields'] = fields unless fields.nil?
2812
2849
  command.query['quotaUser'] = quota_user unless quota_user.nil?
2813
2850
  execute_or_queue_command(command, &block)
@@ -3921,6 +3958,13 @@ module Google
3921
3958
  # The standard list page size.
3922
3959
  # @param [String] page_token
3923
3960
  # The standard list page token.
3961
+ # @param [Boolean] return_partial_success
3962
+ # When set to `true`, operations that are reachable are returned as normal, and
3963
+ # those that are unreachable are returned in the [ListOperationsResponse.
3964
+ # unreachable] field. This can only be `true` when reading across collections e.
3965
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
3966
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
3967
+ # explicitly documented otherwise in service or product specific documentation.
3924
3968
  # @param [String] fields
3925
3969
  # Selector specifying which fields to include in a partial response.
3926
3970
  # @param [String] quota_user
@@ -3938,7 +3982,7 @@ module Google
3938
3982
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3939
3983
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3940
3984
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3941
- def list_project_instance_instance_partition_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3985
+ def list_project_instance_instance_partition_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
3942
3986
  command = make_simple_command(:get, 'v1/{+name}', options)
3943
3987
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
3944
3988
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
@@ -3946,6 +3990,7 @@ module Google
3946
3990
  command.query['filter'] = filter unless filter.nil?
3947
3991
  command.query['pageSize'] = page_size unless page_size.nil?
3948
3992
  command.query['pageToken'] = page_token unless page_token.nil?
3993
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
3949
3994
  command.query['fields'] = fields unless fields.nil?
3950
3995
  command.query['quotaUser'] = quota_user unless quota_user.nil?
3951
3996
  execute_or_queue_command(command, &block)
@@ -4062,6 +4107,13 @@ module Google
4062
4107
  # The standard list page size.
4063
4108
  # @param [String] page_token
4064
4109
  # The standard list page token.
4110
+ # @param [Boolean] return_partial_success
4111
+ # When set to `true`, operations that are reachable are returned as normal, and
4112
+ # those that are unreachable are returned in the [ListOperationsResponse.
4113
+ # unreachable] field. This can only be `true` when reading across collections e.
4114
+ # g. when `parent` is set to `"projects/example/locations/-"`. This field is not
4115
+ # by default supported and will result in an `UNIMPLEMENTED` error if set unless
4116
+ # explicitly documented otherwise in service or product specific documentation.
4065
4117
  # @param [String] fields
4066
4118
  # Selector specifying which fields to include in a partial response.
4067
4119
  # @param [String] quota_user
@@ -4079,7 +4131,7 @@ module Google
4079
4131
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4080
4132
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4081
4133
  # @raise [Google::Apis::AuthorizationError] Authorization is required
4082
- def list_project_instance_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
4134
+ def list_project_instance_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
4083
4135
  command = make_simple_command(:get, 'v1/{+name}', options)
4084
4136
  command.response_representation = Google::Apis::SpannerV1::ListOperationsResponse::Representation
4085
4137
  command.response_class = Google::Apis::SpannerV1::ListOperationsResponse
@@ -4087,6 +4139,7 @@ module Google
4087
4139
  command.query['filter'] = filter unless filter.nil?
4088
4140
  command.query['pageSize'] = page_size unless page_size.nil?
4089
4141
  command.query['pageToken'] = page_token unless page_token.nil?
4142
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
4090
4143
  command.query['fields'] = fields unless fields.nil?
4091
4144
  command.query['quotaUser'] = quota_user unless quota_user.nil?
4092
4145
  execute_or_queue_command(command, &block)
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-spanner_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.44.0
4
+ version: 0.46.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.44.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.46.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1
62
62
  rdoc_options: []
63
63
  require_paths: