google-apis-spanner_v1 0.17.0 → 0.21.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9f64da38486d04149fd47e3d7f8c4b8e4bdb0568873bb25be9c15a38a698d6cc
4
- data.tar.gz: 5e62ddb4822ea2d3c947eb23a8fec73f017a45a6a96d7a5a7b90a64f598d0d0d
3
+ metadata.gz: bb2fb93630e646e00cbb617fecf123bd8e0f1e833363f3507628e5b3e0a90975
4
+ data.tar.gz: b6709fded435e0437bfd429c6b16427cf9d3af3877fd414ea2d534944a7887f2
5
5
  SHA512:
6
- metadata.gz: 03aa8e9905cfbcb28bf6290ac22728d53600e76bbc1a6dd96fff62823f2579adff3fd91f154d422ed271113aa0ff7c7691700891b3a61d2818ec833d1b90a448
7
- data.tar.gz: 4896b71dce9056003e548e23375b93c00df274c53681e2027c37d9b9772fba3a4a4b259e34e2a8ae52a736d57d34901d53ac872960a4c2140285c9e17a2729b4
6
+ metadata.gz: fd00cdd4d3f1e910839b8926a3627bc9106cdabc1896790482e8219bc7c8ba140d0587a4a75c45a81a89a74f1ba8cc1e36940fe414c1980eefe9d4a6ffdd36d6
7
+ data.tar.gz: 345f8058b0da5719df7cc2678d79df0f01dfea0cb3a8f9b26f7c858390f6f349393291379d0c3db8863b417b843000fd00ff006f7c396377f16bd7854449a39c
data/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # Release history for google-apis-spanner_v1
2
2
 
3
+ ### v0.21.0 (2021-12-05)
4
+
5
+ * Regenerated from discovery document revision 20211202
6
+
7
+ ### v0.20.0 (2021-10-23)
8
+
9
+ * Regenerated from discovery document revision 20211021
10
+ * Unspecified changes
11
+
12
+ ### v0.19.0 (2021-09-27)
13
+
14
+ * Regenerated from discovery document revision 20210914
15
+
16
+ ### v0.18.0 (2021-08-30)
17
+
18
+ * Regenerated from discovery document revision 20210825
19
+
3
20
  ### v0.17.0 (2021-08-21)
4
21
 
5
22
  * Regenerated from discovery document revision 20210816
data/OVERVIEW.md CHANGED
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
60
60
 
61
61
  More detailed descriptions of the Google simple REST clients are available in two documents.
62
62
 
63
- * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
- * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
63
+ * The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
64
+ * The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
65
65
 
66
66
  (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Spanner service in particular.)
67
67
 
@@ -248,49 +248,50 @@ module Google
248
248
  # committing the retry, the client should execute the retry in the same session
249
249
  # as the original attempt. The original session's lock priority increases with
250
250
  # each consecutive abort, meaning that each attempt has a slightly better chance
251
- # of success than the previous. Under some circumstances (e.g., many
251
+ # of success than the previous. Under some circumstances (for example, many
252
252
  # transactions attempting to modify the same row(s)), a transaction can abort
253
253
  # many times in a short period before successfully committing. Thus, it is not a
254
254
  # good idea to cap the number of retries a transaction can attempt; instead, it
255
- # is better to limit the total amount of wall time spent retrying. Idle
256
- # Transactions: A transaction is considered idle if it has no outstanding reads
257
- # or SQL queries and has not started a read or SQL query within the last 10
258
- # seconds. Idle transactions can be aborted by Cloud Spanner so that they don't
259
- # hold on to locks indefinitely. In that case, the commit will fail with error `
260
- # ABORTED`. If this behavior is undesirable, periodically executing a simple SQL
261
- # query in the transaction (e.g., `SELECT 1`) prevents the transaction from
262
- # becoming idle. Snapshot Read-Only Transactions: Snapshot read-only
263
- # transactions provides a simpler method than locking read-write transactions
264
- # for doing several consistent reads. However, this type of transaction does not
265
- # support writes. Snapshot transactions do not take locks. Instead, they work by
266
- # choosing a Cloud Spanner timestamp, then executing all reads at that timestamp.
267
- # Since they do not acquire locks, they do not block concurrent read-write
268
- # transactions. Unlike locking read-write transactions, snapshot read-only
269
- # transactions never abort. They can fail if the chosen read timestamp is
270
- # garbage collected; however, the default garbage collection policy is generous
271
- # enough that most applications do not need to worry about this in practice.
272
- # Snapshot read-only transactions do not need to call Commit or Rollback (and in
273
- # fact are not permitted to do so). To execute a snapshot transaction, the
274
- # client specifies a timestamp bound, which tells Cloud Spanner how to choose a
275
- # read timestamp. The types of timestamp bound are: - Strong (the default). -
276
- # Bounded staleness. - Exact staleness. If the Cloud Spanner database to be read
277
- # is geographically distributed, stale read-only transactions can execute more
278
- # quickly than strong or read-write transaction, because they are able to
279
- # execute far from the leader replica. Each type of timestamp bound is discussed
280
- # in detail below. Strong: Strong reads are guaranteed to see the effects of all
281
- # transactions that have committed before the start of the read. Furthermore,
282
- # all rows yielded by a single read are consistent with each other -- if any
283
- # part of the read observes a transaction, all parts of the read see the
284
- # transaction. Strong reads are not repeatable: two consecutive strong read-only
285
- # transactions might return inconsistent results if there are concurrent writes.
286
- # If consistency across reads is required, the reads should be executed within a
287
- # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
288
- # strong. Exact Staleness: These timestamp bounds execute reads at a user-
289
- # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
290
- # prefix of the global transaction history: they observe modifications done by
291
- # all transactions with a commit timestamp <= the read timestamp, and observe
292
- # none of the modifications done by transactions with a larger commit timestamp.
293
- # They will block until all conflicting transactions that may be assigned commit
255
+ # is better to limit the total amount of time spent retrying. Idle Transactions:
256
+ # A transaction is considered idle if it has no outstanding reads or SQL queries
257
+ # and has not started a read or SQL query within the last 10 seconds. Idle
258
+ # transactions can be aborted by Cloud Spanner so that they don't hold on to
259
+ # locks indefinitely. If an idle transaction is aborted, the commit will fail
260
+ # with error `ABORTED`. If this behavior is undesirable, periodically executing
261
+ # a simple SQL query in the transaction (for example, `SELECT 1`) prevents the
262
+ # transaction from becoming idle. Snapshot Read-Only Transactions: Snapshot read-
263
+ # only transactions provides a simpler method than locking read-write
264
+ # transactions for doing several consistent reads. However, this type of
265
+ # transaction does not support writes. Snapshot transactions do not take locks.
266
+ # Instead, they work by choosing a Cloud Spanner timestamp, then executing all
267
+ # reads at that timestamp. Since they do not acquire locks, they do not block
268
+ # concurrent read-write transactions. Unlike locking read-write transactions,
269
+ # snapshot read-only transactions never abort. They can fail if the chosen read
270
+ # timestamp is garbage collected; however, the default garbage collection policy
271
+ # is generous enough that most applications do not need to worry about this in
272
+ # practice. Snapshot read-only transactions do not need to call Commit or
273
+ # Rollback (and in fact are not permitted to do so). To execute a snapshot
274
+ # transaction, the client specifies a timestamp bound, which tells Cloud Spanner
275
+ # how to choose a read timestamp. The types of timestamp bound are: - Strong (
276
+ # the default). - Bounded staleness. - Exact staleness. If the Cloud Spanner
277
+ # database to be read is geographically distributed, stale read-only
278
+ # transactions can execute more quickly than strong or read-write transaction,
279
+ # because they are able to execute far from the leader replica. Each type of
280
+ # timestamp bound is discussed in detail below. Strong: Strong reads are
281
+ # guaranteed to see the effects of all transactions that have committed before
282
+ # the start of the read. Furthermore, all rows yielded by a single read are
283
+ # consistent with each other -- if any part of the read observes a transaction,
284
+ # all parts of the read see the transaction. Strong reads are not repeatable:
285
+ # two consecutive strong read-only transactions might return inconsistent
286
+ # results if there are concurrent writes. If consistency across reads is
287
+ # required, the reads should be executed within a transaction or at an exact
288
+ # read timestamp. See TransactionOptions.ReadOnly.strong. Exact Staleness: These
289
+ # timestamp bounds execute reads at a user-specified timestamp. Reads at a
290
+ # timestamp are guaranteed to see a consistent prefix of the global transaction
291
+ # history: they observe modifications done by all transactions with a commit
292
+ # timestamp less than or equal to the read timestamp, and observe none of the
293
+ # modifications done by transactions with a larger commit timestamp. They will
294
+ # block until all conflicting transactions that may be assigned commit
294
295
  # timestamps <= the read timestamp have finished. The timestamp can either be
295
296
  # expressed as an absolute Cloud Spanner commit timestamp or a staleness
296
297
  # relative to the current time. These modes do not require a "negotiation phase"
@@ -380,7 +381,7 @@ module Google
380
381
  end
381
382
  end
382
383
 
383
- # Associates `members` with a `role`.
384
+ # Associates `members`, or principals, with a `role`.
384
385
  class Binding
385
386
  include Google::Apis::Core::Hashable
386
387
 
@@ -403,7 +404,7 @@ module Google
403
404
  # @return [Google::Apis::SpannerV1::Expr]
404
405
  attr_accessor :condition
405
406
 
406
- # Specifies the identities requesting access for a Cloud Platform resource. `
407
+ # Specifies the principals requesting access for a Cloud Platform resource. `
407
408
  # members` can have the following values: * `allUsers`: A special identifier
408
409
  # that represents anyone who is on the internet; with or without a Google
409
410
  # account. * `allAuthenticatedUsers`: A special identifier that represents
@@ -433,8 +434,8 @@ module Google
433
434
  # @return [Array<String>]
434
435
  attr_accessor :members
435
436
 
436
- # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
437
- # , or `roles/owner`.
437
+ # Role that is assigned to the list of `members`, or principals. For example, `
438
+ # roles/viewer`, `roles/editor`, or `roles/owner`.
438
439
  # Corresponds to the JSON property `role`
439
440
  # @return [String]
440
441
  attr_accessor :role
@@ -559,49 +560,50 @@ module Google
559
560
  # committing the retry, the client should execute the retry in the same session
560
561
  # as the original attempt. The original session's lock priority increases with
561
562
  # each consecutive abort, meaning that each attempt has a slightly better chance
562
- # of success than the previous. Under some circumstances (e.g., many
563
+ # of success than the previous. Under some circumstances (for example, many
563
564
  # transactions attempting to modify the same row(s)), a transaction can abort
564
565
  # many times in a short period before successfully committing. Thus, it is not a
565
566
  # good idea to cap the number of retries a transaction can attempt; instead, it
566
- # is better to limit the total amount of wall time spent retrying. Idle
567
- # Transactions: A transaction is considered idle if it has no outstanding reads
568
- # or SQL queries and has not started a read or SQL query within the last 10
569
- # seconds. Idle transactions can be aborted by Cloud Spanner so that they don't
570
- # hold on to locks indefinitely. In that case, the commit will fail with error `
571
- # ABORTED`. If this behavior is undesirable, periodically executing a simple SQL
572
- # query in the transaction (e.g., `SELECT 1`) prevents the transaction from
573
- # becoming idle. Snapshot Read-Only Transactions: Snapshot read-only
574
- # transactions provides a simpler method than locking read-write transactions
575
- # for doing several consistent reads. However, this type of transaction does not
576
- # support writes. Snapshot transactions do not take locks. Instead, they work by
577
- # choosing a Cloud Spanner timestamp, then executing all reads at that timestamp.
578
- # Since they do not acquire locks, they do not block concurrent read-write
579
- # transactions. Unlike locking read-write transactions, snapshot read-only
580
- # transactions never abort. They can fail if the chosen read timestamp is
581
- # garbage collected; however, the default garbage collection policy is generous
582
- # enough that most applications do not need to worry about this in practice.
583
- # Snapshot read-only transactions do not need to call Commit or Rollback (and in
584
- # fact are not permitted to do so). To execute a snapshot transaction, the
585
- # client specifies a timestamp bound, which tells Cloud Spanner how to choose a
586
- # read timestamp. The types of timestamp bound are: - Strong (the default). -
587
- # Bounded staleness. - Exact staleness. If the Cloud Spanner database to be read
588
- # is geographically distributed, stale read-only transactions can execute more
589
- # quickly than strong or read-write transaction, because they are able to
590
- # execute far from the leader replica. Each type of timestamp bound is discussed
591
- # in detail below. Strong: Strong reads are guaranteed to see the effects of all
592
- # transactions that have committed before the start of the read. Furthermore,
593
- # all rows yielded by a single read are consistent with each other -- if any
594
- # part of the read observes a transaction, all parts of the read see the
595
- # transaction. Strong reads are not repeatable: two consecutive strong read-only
596
- # transactions might return inconsistent results if there are concurrent writes.
597
- # If consistency across reads is required, the reads should be executed within a
598
- # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
599
- # strong. Exact Staleness: These timestamp bounds execute reads at a user-
600
- # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
601
- # prefix of the global transaction history: they observe modifications done by
602
- # all transactions with a commit timestamp <= the read timestamp, and observe
603
- # none of the modifications done by transactions with a larger commit timestamp.
604
- # They will block until all conflicting transactions that may be assigned commit
567
+ # is better to limit the total amount of time spent retrying. Idle Transactions:
568
+ # A transaction is considered idle if it has no outstanding reads or SQL queries
569
+ # and has not started a read or SQL query within the last 10 seconds. Idle
570
+ # transactions can be aborted by Cloud Spanner so that they don't hold on to
571
+ # locks indefinitely. If an idle transaction is aborted, the commit will fail
572
+ # with error `ABORTED`. If this behavior is undesirable, periodically executing
573
+ # a simple SQL query in the transaction (for example, `SELECT 1`) prevents the
574
+ # transaction from becoming idle. Snapshot Read-Only Transactions: Snapshot read-
575
+ # only transactions provides a simpler method than locking read-write
576
+ # transactions for doing several consistent reads. However, this type of
577
+ # transaction does not support writes. Snapshot transactions do not take locks.
578
+ # Instead, they work by choosing a Cloud Spanner timestamp, then executing all
579
+ # reads at that timestamp. Since they do not acquire locks, they do not block
580
+ # concurrent read-write transactions. Unlike locking read-write transactions,
581
+ # snapshot read-only transactions never abort. They can fail if the chosen read
582
+ # timestamp is garbage collected; however, the default garbage collection policy
583
+ # is generous enough that most applications do not need to worry about this in
584
+ # practice. Snapshot read-only transactions do not need to call Commit or
585
+ # Rollback (and in fact are not permitted to do so). To execute a snapshot
586
+ # transaction, the client specifies a timestamp bound, which tells Cloud Spanner
587
+ # how to choose a read timestamp. The types of timestamp bound are: - Strong (
588
+ # the default). - Bounded staleness. - Exact staleness. If the Cloud Spanner
589
+ # database to be read is geographically distributed, stale read-only
590
+ # transactions can execute more quickly than strong or read-write transaction,
591
+ # because they are able to execute far from the leader replica. Each type of
592
+ # timestamp bound is discussed in detail below. Strong: Strong reads are
593
+ # guaranteed to see the effects of all transactions that have committed before
594
+ # the start of the read. Furthermore, all rows yielded by a single read are
595
+ # consistent with each other -- if any part of the read observes a transaction,
596
+ # all parts of the read see the transaction. Strong reads are not repeatable:
597
+ # two consecutive strong read-only transactions might return inconsistent
598
+ # results if there are concurrent writes. If consistency across reads is
599
+ # required, the reads should be executed within a transaction or at an exact
600
+ # read timestamp. See TransactionOptions.ReadOnly.strong. Exact Staleness: These
601
+ # timestamp bounds execute reads at a user-specified timestamp. Reads at a
602
+ # timestamp are guaranteed to see a consistent prefix of the global transaction
603
+ # history: they observe modifications done by all transactions with a commit
604
+ # timestamp less than or equal to the read timestamp, and observe none of the
605
+ # modifications done by transactions with a larger commit timestamp. They will
606
+ # block until all conflicting transactions that may be assigned commit
605
607
  # timestamps <= the read timestamp have finished. The timestamp can either be
606
608
  # expressed as an absolute Cloud Spanner commit timestamp or a staleness
607
609
  # relative to the current time. These modes do not require a "negotiation phase"
@@ -1560,13 +1562,16 @@ module Google
1560
1562
  class GetPolicyOptions
1561
1563
  include Google::Apis::Core::Hashable
1562
1564
 
1563
- # Optional. The policy format version to be returned. Valid values are 0, 1, and
1564
- # 3. Requests specifying an invalid value will be rejected. Requests for
1565
- # policies with any conditional bindings must specify version 3. Policies
1566
- # without any conditional bindings may specify any valid value or leave the
1567
- # field unset. To learn which resources support conditions in their IAM policies,
1568
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
1569
- # resource-policies).
1565
+ # Optional. The maximum policy version that will be used to format the policy.
1566
+ # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
1567
+ # rejected. Requests for policies with any conditional role bindings must
1568
+ # specify version 3. Policies with no conditional role bindings may specify any
1569
+ # valid value or leave the field unset. The policy in the response might use the
1570
+ # policy version that you specified, or it might use a lower policy version. For
1571
+ # example, if you specify version 3, but the policy has no conditional role
1572
+ # bindings, the response uses version 1. To learn which resources support
1573
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1574
+ # google.com/iam/help/conditions/resource-policies).
1570
1575
  # Corresponds to the JSON property `requestedPolicyVersion`
1571
1576
  # @return [Fixnum]
1572
1577
  attr_accessor :requested_policy_version
@@ -1651,16 +1656,16 @@ module Google
1651
1656
  # resources. They can be used to control how resource metrics are aggregated.
1652
1657
  # And they can be used as arguments to policy management rules (e.g. route,
1653
1658
  # firewall, load balancing, etc.). * Label keys must be between 1 and 63
1654
- # characters long and must conform to the following regular expression: `[a-z]([-
1655
- # a-z0-9]*[a-z0-9])?`. * Label values must be between 0 and 63 characters long
1656
- # and must conform to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`. *
1657
- # No more than 64 labels can be associated with a given resource. See https://
1658
- # goo.gl/xmQnxf for more information on and examples of labels. If you plan to
1659
- # use labels in your own code, please note that additional characters may be
1660
- # allowed in the future. And so you are advised to use an internal label
1661
- # representation, such as JSON, which doesn't rely upon specific characters
1662
- # being disallowed. For example, representing labels as the string: name + "_" +
1663
- # value would prove problematic if we were to allow "_" in a future release.
1659
+ # characters long and must conform to the following regular expression: `a-z`0,
1660
+ # 62``. * Label values must be between 0 and 63 characters long and must conform
1661
+ # to the regular expression `[a-z0-9_-]`0,63``. * No more than 64 labels can be
1662
+ # associated with a given resource. See https://goo.gl/xmQnxf for more
1663
+ # information on and examples of labels. If you plan to use labels in your own
1664
+ # code, please note that additional characters may be allowed in the future. And
1665
+ # so you are advised to use an internal label representation, such as JSON,
1666
+ # which doesn't rely upon specific characters being disallowed. For example,
1667
+ # representing labels as the string: name + "_" + value would prove problematic
1668
+ # if we were to allow "_" in a future release.
1664
1669
  # Corresponds to the JSON property `labels`
1665
1670
  # @return [Hash<String,String>]
1666
1671
  attr_accessor :labels
@@ -1725,14 +1730,14 @@ module Google
1725
1730
  # @return [String]
1726
1731
  attr_accessor :display_name
1727
1732
 
1728
- # Allowed values of the default_leader schema option for databases in
1733
+ # Allowed values of the "default_leader" schema option for databases in
1729
1734
  # instances that use this instance configuration.
1730
1735
  # Corresponds to the JSON property `leaderOptions`
1731
1736
  # @return [Array<String>]
1732
1737
  attr_accessor :leader_options
1733
1738
 
1734
1739
  # A unique identifier for the instance configuration. Values are of the form `
1735
- # projects//instanceConfigs/a-z*`
1740
+ # projects//instanceConfigs/a-z*`.
1736
1741
  # Corresponds to the JSON property `name`
1737
1742
  # @return [String]
1738
1743
  attr_accessor :name
@@ -2915,37 +2920,42 @@ module Google
2915
2920
 
2916
2921
  # An Identity and Access Management (IAM) policy, which specifies access
2917
2922
  # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
2918
- # A `binding` binds one or more `members` to a single `role`. Members can be
2919
- # user accounts, service accounts, Google groups, and domains (such as G Suite).
2920
- # A `role` is a named list of permissions; each `role` can be an IAM predefined
2921
- # role or a user-created custom role. For some types of Google Cloud resources,
2922
- # a `binding` can also specify a `condition`, which is a logical expression that
2923
- # allows access to a resource only if the expression evaluates to `true`. A
2924
- # condition can add constraints based on attributes of the request, the resource,
2925
- # or both. To learn which resources support conditions in their IAM policies,
2926
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
2927
- # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
2928
- # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
2929
- # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
2930
- # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
2931
- # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
2932
- # title": "expirable access", "description": "Does not grant access after Sep
2933
- # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
2934
- # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
2935
- # members: - user:mike@example.com - group:admins@example.com - domain:google.
2936
- # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
2937
- # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
2938
- # roles/resourcemanager.organizationViewer condition: title: expirable access
2939
- # description: Does not grant access after Sep 2020 expression: request.time <
2940
- # timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a
2941
- # description of IAM and its features, see the [IAM documentation](https://cloud.
2942
- # google.com/iam/docs/).
2923
+ # A `binding` binds one or more `members`, or principals, to a single `role`.
2924
+ # Principals can be user accounts, service accounts, Google groups, and domains (
2925
+ # such as G Suite). A `role` is a named list of permissions; each `role` can be
2926
+ # an IAM predefined role or a user-created custom role. For some types of Google
2927
+ # Cloud resources, a `binding` can also specify a `condition`, which is a
2928
+ # logical expression that allows access to a resource only if the expression
2929
+ # evaluates to `true`. A condition can add constraints based on attributes of
2930
+ # the request, the resource, or both. To learn which resources support
2931
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
2932
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
2933
+ # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
2934
+ # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
2935
+ # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
2936
+ # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
2937
+ # ], "condition": ` "title": "expirable access", "description": "Does not grant
2938
+ # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
2939
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
2940
+ # bindings: - members: - user:mike@example.com - group:admins@example.com -
2941
+ # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
2942
+ # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
2943
+ # com role: roles/resourcemanager.organizationViewer condition: title: expirable
2944
+ # access description: Does not grant access after Sep 2020 expression: request.
2945
+ # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
2946
+ # a description of IAM and its features, see the [IAM documentation](https://
2947
+ # cloud.google.com/iam/docs/).
2943
2948
  class Policy
2944
2949
  include Google::Apis::Core::Hashable
2945
2950
 
2946
- # Associates a list of `members` to a `role`. Optionally, may specify a `
2947
- # condition` that determines how and when the `bindings` are applied. Each of
2948
- # the `bindings` must contain at least one member.
2951
+ # Associates a list of `members`, or principals, with a `role`. Optionally, may
2952
+ # specify a `condition` that determines how and when the `bindings` are applied.
2953
+ # Each of the `bindings` must contain at least one principal. The `bindings` in
2954
+ # a `Policy` can refer to up to 1,500 principals; up to 250 of these principals
2955
+ # can be Google groups. Each occurrence of a principal counts towards these
2956
+ # limits. For example, if the `bindings` grant 50 different roles to `user:alice@
2957
+ # example.com`, and not to any other principal, then you can add another 1,450
2958
+ # principals to the `bindings` in the `Policy`.
2949
2959
  # Corresponds to the JSON property `bindings`
2950
2960
  # @return [Array<Google::Apis::SpannerV1::Binding>]
2951
2961
  attr_accessor :bindings
@@ -3347,7 +3357,7 @@ module Google
3347
3357
  # A tag used for statistics collection about this transaction. Both request_tag
3348
3358
  # and transaction_tag can be specified for a read or query that belongs to a
3349
3359
  # transaction. The value of transaction_tag should be the same for all requests
3350
- # belonging to the same transaction. If this request doesnt belong to any
3360
+ # belonging to the same transaction. If this request doesn't belong to any
3351
3361
  # transaction, transaction_tag will be ignored. Legal characters for `
3352
3362
  # transaction_tag` values are all printable characters (ASCII 32 - 126) and the
3353
3363
  # length of a transaction_tag is limited to 50 characters. Values that exceed
@@ -3769,31 +3779,31 @@ module Google
3769
3779
 
3770
3780
  # An Identity and Access Management (IAM) policy, which specifies access
3771
3781
  # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
3772
- # A `binding` binds one or more `members` to a single `role`. Members can be
3773
- # user accounts, service accounts, Google groups, and domains (such as G Suite).
3774
- # A `role` is a named list of permissions; each `role` can be an IAM predefined
3775
- # role or a user-created custom role. For some types of Google Cloud resources,
3776
- # a `binding` can also specify a `condition`, which is a logical expression that
3777
- # allows access to a resource only if the expression evaluates to `true`. A
3778
- # condition can add constraints based on attributes of the request, the resource,
3779
- # or both. To learn which resources support conditions in their IAM policies,
3780
- # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
3781
- # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
3782
- # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
3783
- # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
3784
- # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
3785
- # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
3786
- # title": "expirable access", "description": "Does not grant access after Sep
3787
- # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
3788
- # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
3789
- # members: - user:mike@example.com - group:admins@example.com - domain:google.
3790
- # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
3791
- # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
3792
- # roles/resourcemanager.organizationViewer condition: title: expirable access
3793
- # description: Does not grant access after Sep 2020 expression: request.time <
3794
- # timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a
3795
- # description of IAM and its features, see the [IAM documentation](https://cloud.
3796
- # google.com/iam/docs/).
3782
+ # A `binding` binds one or more `members`, or principals, to a single `role`.
3783
+ # Principals can be user accounts, service accounts, Google groups, and domains (
3784
+ # such as G Suite). A `role` is a named list of permissions; each `role` can be
3785
+ # an IAM predefined role or a user-created custom role. For some types of Google
3786
+ # Cloud resources, a `binding` can also specify a `condition`, which is a
3787
+ # logical expression that allows access to a resource only if the expression
3788
+ # evaluates to `true`. A condition can add constraints based on attributes of
3789
+ # the request, the resource, or both. To learn which resources support
3790
+ # conditions in their IAM policies, see the [IAM documentation](https://cloud.
3791
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
3792
+ # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
3793
+ # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
3794
+ # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
3795
+ # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
3796
+ # ], "condition": ` "title": "expirable access", "description": "Does not grant
3797
+ # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
3798
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
3799
+ # bindings: - members: - user:mike@example.com - group:admins@example.com -
3800
+ # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
3801
+ # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
3802
+ # com role: roles/resourcemanager.organizationViewer condition: title: expirable
3803
+ # access description: Does not grant access after Sep 2020 expression: request.
3804
+ # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
3805
+ # a description of IAM and its features, see the [IAM documentation](https://
3806
+ # cloud.google.com/iam/docs/).
3797
3807
  # Corresponds to the JSON property `policy`
3798
3808
  # @return [Google::Apis::SpannerV1::Policy]
3799
3809
  attr_accessor :policy
@@ -4057,49 +4067,50 @@ module Google
4057
4067
  # committing the retry, the client should execute the retry in the same session
4058
4068
  # as the original attempt. The original session's lock priority increases with
4059
4069
  # each consecutive abort, meaning that each attempt has a slightly better chance
4060
- # of success than the previous. Under some circumstances (e.g., many
4070
+ # of success than the previous. Under some circumstances (for example, many
4061
4071
  # transactions attempting to modify the same row(s)), a transaction can abort
4062
4072
  # many times in a short period before successfully committing. Thus, it is not a
4063
4073
  # good idea to cap the number of retries a transaction can attempt; instead, it
4064
- # is better to limit the total amount of wall time spent retrying. Idle
4065
- # Transactions: A transaction is considered idle if it has no outstanding reads
4066
- # or SQL queries and has not started a read or SQL query within the last 10
4067
- # seconds. Idle transactions can be aborted by Cloud Spanner so that they don't
4068
- # hold on to locks indefinitely. In that case, the commit will fail with error `
4069
- # ABORTED`. If this behavior is undesirable, periodically executing a simple SQL
4070
- # query in the transaction (e.g., `SELECT 1`) prevents the transaction from
4071
- # becoming idle. Snapshot Read-Only Transactions: Snapshot read-only
4072
- # transactions provides a simpler method than locking read-write transactions
4073
- # for doing several consistent reads. However, this type of transaction does not
4074
- # support writes. Snapshot transactions do not take locks. Instead, they work by
4075
- # choosing a Cloud Spanner timestamp, then executing all reads at that timestamp.
4076
- # Since they do not acquire locks, they do not block concurrent read-write
4077
- # transactions. Unlike locking read-write transactions, snapshot read-only
4078
- # transactions never abort. They can fail if the chosen read timestamp is
4079
- # garbage collected; however, the default garbage collection policy is generous
4080
- # enough that most applications do not need to worry about this in practice.
4081
- # Snapshot read-only transactions do not need to call Commit or Rollback (and in
4082
- # fact are not permitted to do so). To execute a snapshot transaction, the
4083
- # client specifies a timestamp bound, which tells Cloud Spanner how to choose a
4084
- # read timestamp. The types of timestamp bound are: - Strong (the default). -
4085
- # Bounded staleness. - Exact staleness. If the Cloud Spanner database to be read
4086
- # is geographically distributed, stale read-only transactions can execute more
4087
- # quickly than strong or read-write transaction, because they are able to
4088
- # execute far from the leader replica. Each type of timestamp bound is discussed
4089
- # in detail below. Strong: Strong reads are guaranteed to see the effects of all
4090
- # transactions that have committed before the start of the read. Furthermore,
4091
- # all rows yielded by a single read are consistent with each other -- if any
4092
- # part of the read observes a transaction, all parts of the read see the
4093
- # transaction. Strong reads are not repeatable: two consecutive strong read-only
4094
- # transactions might return inconsistent results if there are concurrent writes.
4095
- # If consistency across reads is required, the reads should be executed within a
4096
- # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
4097
- # strong. Exact Staleness: These timestamp bounds execute reads at a user-
4098
- # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
4099
- # prefix of the global transaction history: they observe modifications done by
4100
- # all transactions with a commit timestamp <= the read timestamp, and observe
4101
- # none of the modifications done by transactions with a larger commit timestamp.
4102
- # They will block until all conflicting transactions that may be assigned commit
4074
+ # is better to limit the total amount of time spent retrying. Idle Transactions:
4075
+ # A transaction is considered idle if it has no outstanding reads or SQL queries
4076
+ # and has not started a read or SQL query within the last 10 seconds. Idle
4077
+ # transactions can be aborted by Cloud Spanner so that they don't hold on to
4078
+ # locks indefinitely. If an idle transaction is aborted, the commit will fail
4079
+ # with error `ABORTED`. If this behavior is undesirable, periodically executing
4080
+ # a simple SQL query in the transaction (for example, `SELECT 1`) prevents the
4081
+ # transaction from becoming idle. Snapshot Read-Only Transactions: Snapshot read-
4082
+ # only transactions provides a simpler method than locking read-write
4083
+ # transactions for doing several consistent reads. However, this type of
4084
+ # transaction does not support writes. Snapshot transactions do not take locks.
4085
+ # Instead, they work by choosing a Cloud Spanner timestamp, then executing all
4086
+ # reads at that timestamp. Since they do not acquire locks, they do not block
4087
+ # concurrent read-write transactions. Unlike locking read-write transactions,
4088
+ # snapshot read-only transactions never abort. They can fail if the chosen read
4089
+ # timestamp is garbage collected; however, the default garbage collection policy
4090
+ # is generous enough that most applications do not need to worry about this in
4091
+ # practice. Snapshot read-only transactions do not need to call Commit or
4092
+ # Rollback (and in fact are not permitted to do so). To execute a snapshot
4093
+ # transaction, the client specifies a timestamp bound, which tells Cloud Spanner
4094
+ # how to choose a read timestamp. The types of timestamp bound are: - Strong (
4095
+ # the default). - Bounded staleness. - Exact staleness. If the Cloud Spanner
4096
+ # database to be read is geographically distributed, stale read-only
4097
+ # transactions can execute more quickly than strong or read-write transaction,
4098
+ # because they are able to execute far from the leader replica. Each type of
4099
+ # timestamp bound is discussed in detail below. Strong: Strong reads are
4100
+ # guaranteed to see the effects of all transactions that have committed before
4101
+ # the start of the read. Furthermore, all rows yielded by a single read are
4102
+ # consistent with each other -- if any part of the read observes a transaction,
4103
+ # all parts of the read see the transaction. Strong reads are not repeatable:
4104
+ # two consecutive strong read-only transactions might return inconsistent
4105
+ # results if there are concurrent writes. If consistency across reads is
4106
+ # required, the reads should be executed within a transaction or at an exact
4107
+ # read timestamp. See TransactionOptions.ReadOnly.strong. Exact Staleness: These
4108
+ # timestamp bounds execute reads at a user-specified timestamp. Reads at a
4109
+ # timestamp are guaranteed to see a consistent prefix of the global transaction
4110
+ # history: they observe modifications done by all transactions with a commit
4111
+ # timestamp less than or equal to the read timestamp, and observe none of the
4112
+ # modifications done by transactions with a larger commit timestamp. They will
4113
+ # block until all conflicting transactions that may be assigned commit
4103
4114
  # timestamps <= the read timestamp have finished. The timestamp can either be
4104
4115
  # expressed as an absolute Cloud Spanner commit timestamp or a staleness
4105
4116
  # relative to the current time. These modes do not require a "negotiation phase"
@@ -4252,49 +4263,50 @@ module Google
4252
4263
  # committing the retry, the client should execute the retry in the same session
4253
4264
  # as the original attempt. The original session's lock priority increases with
4254
4265
  # each consecutive abort, meaning that each attempt has a slightly better chance
4255
- # of success than the previous. Under some circumstances (e.g., many
4266
+ # of success than the previous. Under some circumstances (for example, many
4256
4267
  # transactions attempting to modify the same row(s)), a transaction can abort
4257
4268
  # many times in a short period before successfully committing. Thus, it is not a
4258
4269
  # good idea to cap the number of retries a transaction can attempt; instead, it
4259
- # is better to limit the total amount of wall time spent retrying. Idle
4260
- # Transactions: A transaction is considered idle if it has no outstanding reads
4261
- # or SQL queries and has not started a read or SQL query within the last 10
4262
- # seconds. Idle transactions can be aborted by Cloud Spanner so that they don't
4263
- # hold on to locks indefinitely. In that case, the commit will fail with error `
4264
- # ABORTED`. If this behavior is undesirable, periodically executing a simple SQL
4265
- # query in the transaction (e.g., `SELECT 1`) prevents the transaction from
4266
- # becoming idle. Snapshot Read-Only Transactions: Snapshot read-only
4267
- # transactions provides a simpler method than locking read-write transactions
4268
- # for doing several consistent reads. However, this type of transaction does not
4269
- # support writes. Snapshot transactions do not take locks. Instead, they work by
4270
- # choosing a Cloud Spanner timestamp, then executing all reads at that timestamp.
4271
- # Since they do not acquire locks, they do not block concurrent read-write
4272
- # transactions. Unlike locking read-write transactions, snapshot read-only
4273
- # transactions never abort. They can fail if the chosen read timestamp is
4274
- # garbage collected; however, the default garbage collection policy is generous
4275
- # enough that most applications do not need to worry about this in practice.
4276
- # Snapshot read-only transactions do not need to call Commit or Rollback (and in
4277
- # fact are not permitted to do so). To execute a snapshot transaction, the
4278
- # client specifies a timestamp bound, which tells Cloud Spanner how to choose a
4279
- # read timestamp. The types of timestamp bound are: - Strong (the default). -
4280
- # Bounded staleness. - Exact staleness. If the Cloud Spanner database to be read
4281
- # is geographically distributed, stale read-only transactions can execute more
4282
- # quickly than strong or read-write transaction, because they are able to
4283
- # execute far from the leader replica. Each type of timestamp bound is discussed
4284
- # in detail below. Strong: Strong reads are guaranteed to see the effects of all
4285
- # transactions that have committed before the start of the read. Furthermore,
4286
- # all rows yielded by a single read are consistent with each other -- if any
4287
- # part of the read observes a transaction, all parts of the read see the
4288
- # transaction. Strong reads are not repeatable: two consecutive strong read-only
4289
- # transactions might return inconsistent results if there are concurrent writes.
4290
- # If consistency across reads is required, the reads should be executed within a
4291
- # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
4292
- # strong. Exact Staleness: These timestamp bounds execute reads at a user-
4293
- # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
4294
- # prefix of the global transaction history: they observe modifications done by
4295
- # all transactions with a commit timestamp <= the read timestamp, and observe
4296
- # none of the modifications done by transactions with a larger commit timestamp.
4297
- # They will block until all conflicting transactions that may be assigned commit
4270
+ # is better to limit the total amount of time spent retrying. Idle Transactions:
4271
+ # A transaction is considered idle if it has no outstanding reads or SQL queries
4272
+ # and has not started a read or SQL query within the last 10 seconds. Idle
4273
+ # transactions can be aborted by Cloud Spanner so that they don't hold on to
4274
+ # locks indefinitely. If an idle transaction is aborted, the commit will fail
4275
+ # with error `ABORTED`. If this behavior is undesirable, periodically executing
4276
+ # a simple SQL query in the transaction (for example, `SELECT 1`) prevents the
4277
+ # transaction from becoming idle. Snapshot Read-Only Transactions: Snapshot read-
4278
+ # only transactions provides a simpler method than locking read-write
4279
+ # transactions for doing several consistent reads. However, this type of
4280
+ # transaction does not support writes. Snapshot transactions do not take locks.
4281
+ # Instead, they work by choosing a Cloud Spanner timestamp, then executing all
4282
+ # reads at that timestamp. Since they do not acquire locks, they do not block
4283
+ # concurrent read-write transactions. Unlike locking read-write transactions,
4284
+ # snapshot read-only transactions never abort. They can fail if the chosen read
4285
+ # timestamp is garbage collected; however, the default garbage collection policy
4286
+ # is generous enough that most applications do not need to worry about this in
4287
+ # practice. Snapshot read-only transactions do not need to call Commit or
4288
+ # Rollback (and in fact are not permitted to do so). To execute a snapshot
4289
+ # transaction, the client specifies a timestamp bound, which tells Cloud Spanner
4290
+ # how to choose a read timestamp. The types of timestamp bound are: - Strong (
4291
+ # the default). - Bounded staleness. - Exact staleness. If the Cloud Spanner
4292
+ # database to be read is geographically distributed, stale read-only
4293
+ # transactions can execute more quickly than strong or read-write transaction,
4294
+ # because they are able to execute far from the leader replica. Each type of
4295
+ # timestamp bound is discussed in detail below. Strong: Strong reads are
4296
+ # guaranteed to see the effects of all transactions that have committed before
4297
+ # the start of the read. Furthermore, all rows yielded by a single read are
4298
+ # consistent with each other -- if any part of the read observes a transaction,
4299
+ # all parts of the read see the transaction. Strong reads are not repeatable:
4300
+ # two consecutive strong read-only transactions might return inconsistent
4301
+ # results if there are concurrent writes. If consistency across reads is
4302
+ # required, the reads should be executed within a transaction or at an exact
4303
+ # read timestamp. See TransactionOptions.ReadOnly.strong. Exact Staleness: These
4304
+ # timestamp bounds execute reads at a user-specified timestamp. Reads at a
4305
+ # timestamp are guaranteed to see a consistent prefix of the global transaction
4306
+ # history: they observe modifications done by all transactions with a commit
4307
+ # timestamp less than or equal to the read timestamp, and observe none of the
4308
+ # modifications done by transactions with a larger commit timestamp. They will
4309
+ # block until all conflicting transactions that may be assigned commit
4298
4310
  # timestamps <= the read timestamp have finished. The timestamp can either be
4299
4311
  # expressed as an absolute Cloud Spanner commit timestamp or a staleness
4300
4312
  # relative to the current time. These modes do not require a "negotiation phase"
@@ -4421,49 +4433,50 @@ module Google
4421
4433
  # committing the retry, the client should execute the retry in the same session
4422
4434
  # as the original attempt. The original session's lock priority increases with
4423
4435
  # each consecutive abort, meaning that each attempt has a slightly better chance
4424
- # of success than the previous. Under some circumstances (e.g., many
4436
+ # of success than the previous. Under some circumstances (for example, many
4425
4437
  # transactions attempting to modify the same row(s)), a transaction can abort
4426
4438
  # many times in a short period before successfully committing. Thus, it is not a
4427
4439
  # good idea to cap the number of retries a transaction can attempt; instead, it
4428
- # is better to limit the total amount of wall time spent retrying. Idle
4429
- # Transactions: A transaction is considered idle if it has no outstanding reads
4430
- # or SQL queries and has not started a read or SQL query within the last 10
4431
- # seconds. Idle transactions can be aborted by Cloud Spanner so that they don't
4432
- # hold on to locks indefinitely. In that case, the commit will fail with error `
4433
- # ABORTED`. If this behavior is undesirable, periodically executing a simple SQL
4434
- # query in the transaction (e.g., `SELECT 1`) prevents the transaction from
4435
- # becoming idle. Snapshot Read-Only Transactions: Snapshot read-only
4436
- # transactions provides a simpler method than locking read-write transactions
4437
- # for doing several consistent reads. However, this type of transaction does not
4438
- # support writes. Snapshot transactions do not take locks. Instead, they work by
4439
- # choosing a Cloud Spanner timestamp, then executing all reads at that timestamp.
4440
- # Since they do not acquire locks, they do not block concurrent read-write
4441
- # transactions. Unlike locking read-write transactions, snapshot read-only
4442
- # transactions never abort. They can fail if the chosen read timestamp is
4443
- # garbage collected; however, the default garbage collection policy is generous
4444
- # enough that most applications do not need to worry about this in practice.
4445
- # Snapshot read-only transactions do not need to call Commit or Rollback (and in
4446
- # fact are not permitted to do so). To execute a snapshot transaction, the
4447
- # client specifies a timestamp bound, which tells Cloud Spanner how to choose a
4448
- # read timestamp. The types of timestamp bound are: - Strong (the default). -
4449
- # Bounded staleness. - Exact staleness. If the Cloud Spanner database to be read
4450
- # is geographically distributed, stale read-only transactions can execute more
4451
- # quickly than strong or read-write transaction, because they are able to
4452
- # execute far from the leader replica. Each type of timestamp bound is discussed
4453
- # in detail below. Strong: Strong reads are guaranteed to see the effects of all
4454
- # transactions that have committed before the start of the read. Furthermore,
4455
- # all rows yielded by a single read are consistent with each other -- if any
4456
- # part of the read observes a transaction, all parts of the read see the
4457
- # transaction. Strong reads are not repeatable: two consecutive strong read-only
4458
- # transactions might return inconsistent results if there are concurrent writes.
4459
- # If consistency across reads is required, the reads should be executed within a
4460
- # transaction or at an exact read timestamp. See TransactionOptions.ReadOnly.
4461
- # strong. Exact Staleness: These timestamp bounds execute reads at a user-
4462
- # specified timestamp. Reads at a timestamp are guaranteed to see a consistent
4463
- # prefix of the global transaction history: they observe modifications done by
4464
- # all transactions with a commit timestamp <= the read timestamp, and observe
4465
- # none of the modifications done by transactions with a larger commit timestamp.
4466
- # They will block until all conflicting transactions that may be assigned commit
4440
+ # is better to limit the total amount of time spent retrying. Idle Transactions:
4441
+ # A transaction is considered idle if it has no outstanding reads or SQL queries
4442
+ # and has not started a read or SQL query within the last 10 seconds. Idle
4443
+ # transactions can be aborted by Cloud Spanner so that they don't hold on to
4444
+ # locks indefinitely. If an idle transaction is aborted, the commit will fail
4445
+ # with error `ABORTED`. If this behavior is undesirable, periodically executing
4446
+ # a simple SQL query in the transaction (for example, `SELECT 1`) prevents the
4447
+ # transaction from becoming idle. Snapshot Read-Only Transactions: Snapshot read-
4448
+ # only transactions provides a simpler method than locking read-write
4449
+ # transactions for doing several consistent reads. However, this type of
4450
+ # transaction does not support writes. Snapshot transactions do not take locks.
4451
+ # Instead, they work by choosing a Cloud Spanner timestamp, then executing all
4452
+ # reads at that timestamp. Since they do not acquire locks, they do not block
4453
+ # concurrent read-write transactions. Unlike locking read-write transactions,
4454
+ # snapshot read-only transactions never abort. They can fail if the chosen read
4455
+ # timestamp is garbage collected; however, the default garbage collection policy
4456
+ # is generous enough that most applications do not need to worry about this in
4457
+ # practice. Snapshot read-only transactions do not need to call Commit or
4458
+ # Rollback (and in fact are not permitted to do so). To execute a snapshot
4459
+ # transaction, the client specifies a timestamp bound, which tells Cloud Spanner
4460
+ # how to choose a read timestamp. The types of timestamp bound are: - Strong (
4461
+ # the default). - Bounded staleness. - Exact staleness. If the Cloud Spanner
4462
+ # database to be read is geographically distributed, stale read-only
4463
+ # transactions can execute more quickly than strong or read-write transaction,
4464
+ # because they are able to execute far from the leader replica. Each type of
4465
+ # timestamp bound is discussed in detail below. Strong: Strong reads are
4466
+ # guaranteed to see the effects of all transactions that have committed before
4467
+ # the start of the read. Furthermore, all rows yielded by a single read are
4468
+ # consistent with each other -- if any part of the read observes a transaction,
4469
+ # all parts of the read see the transaction. Strong reads are not repeatable:
4470
+ # two consecutive strong read-only transactions might return inconsistent
4471
+ # results if there are concurrent writes. If consistency across reads is
4472
+ # required, the reads should be executed within a transaction or at an exact
4473
+ # read timestamp. See TransactionOptions.ReadOnly.strong. Exact Staleness: These
4474
+ # timestamp bounds execute reads at a user-specified timestamp. Reads at a
4475
+ # timestamp are guaranteed to see a consistent prefix of the global transaction
4476
+ # history: they observe modifications done by all transactions with a commit
4477
+ # timestamp less than or equal to the read timestamp, and observe none of the
4478
+ # modifications done by transactions with a larger commit timestamp. They will
4479
+ # block until all conflicting transactions that may be assigned commit
4467
4480
  # timestamps <= the read timestamp have finished. The timestamp can either be
4468
4481
  # expressed as an absolute Cloud Spanner commit timestamp or a staleness
4469
4482
  # relative to the current time. These modes do not require a "negotiation phase"
@@ -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.17.0"
19
+ GEM_VERSION = "0.21.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.4.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20210816"
25
+ REVISION = "20211202"
26
26
  end
27
27
  end
28
28
  end
@@ -350,7 +350,7 @@ module Google
350
350
  # the format `/operations/` and can be used to track the instance modification.
351
351
  # The metadata field type is UpdateInstanceMetadata. The response field type is
352
352
  # Instance, if successful. Authorization requires `spanner.instances.update`
353
- # permission on resource name.
353
+ # permission on the resource name.
354
354
  # @param [String] name
355
355
  # Required. A unique identifier for the instance, which cannot be changed after
356
356
  # the instance is created. Values are of the form `projects//instances/a-z*[a-z0-
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-spanner_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.17.0
4
+ version: 0.21.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-08-23 00:00:00.000000000 Z
11
+ date: 2021-12-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
57
57
  - Apache-2.0
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
- changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.17.0
62
- source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-spanner_v1
60
+ changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1/CHANGELOG.md
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.21.0
62
+ source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-spanner_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
65
65
  require_paths: