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 +4 -4
- data/CHANGELOG.md +17 -0
- data/OVERVIEW.md +2 -2
- data/lib/google/apis/spanner_v1/classes.rb +290 -277
- data/lib/google/apis/spanner_v1/gem_version.rb +2 -2
- data/lib/google/apis/spanner_v1/service.rb +1 -1
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: bb2fb93630e646e00cbb617fecf123bd8e0f1e833363f3507628e5b3e0a90975
|
4
|
+
data.tar.gz: b6709fded435e0437bfd429c6b16427cf9d3af3877fd414ea2d534944a7887f2
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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/
|
64
|
-
* The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/
|
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 (
|
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
|
256
|
-
#
|
257
|
-
#
|
258
|
-
#
|
259
|
-
#
|
260
|
-
# ABORTED`. If this behavior is undesirable, periodically executing
|
261
|
-
# query in the transaction (
|
262
|
-
# becoming idle. Snapshot Read-Only Transactions: Snapshot read-
|
263
|
-
# transactions provides a simpler method than locking read-write
|
264
|
-
# for doing several consistent reads. However, this type of
|
265
|
-
# support writes. Snapshot transactions do not take locks.
|
266
|
-
# choosing a Cloud Spanner timestamp, then executing all
|
267
|
-
# Since they do not acquire locks, they do not block
|
268
|
-
# transactions. Unlike locking read-write transactions,
|
269
|
-
# transactions never abort. They can fail if the chosen read
|
270
|
-
# garbage collected; however, the default garbage collection policy
|
271
|
-
# enough that most applications do not need to worry about this in
|
272
|
-
# Snapshot read-only transactions do not need to call Commit or
|
273
|
-
# fact are not permitted to do so). To execute a snapshot
|
274
|
-
# client specifies a timestamp bound, which tells Cloud Spanner
|
275
|
-
# read timestamp. The types of timestamp bound are: - Strong (
|
276
|
-
# Bounded staleness. - Exact staleness. If the Cloud Spanner
|
277
|
-
# is geographically distributed, stale read-only
|
278
|
-
# quickly than strong or read-write transaction,
|
279
|
-
# execute far from the leader replica. Each type of
|
280
|
-
# in detail below. Strong: Strong reads are
|
281
|
-
#
|
282
|
-
# all rows yielded by a single read are
|
283
|
-
#
|
284
|
-
# transaction. Strong reads are not repeatable:
|
285
|
-
# transactions might return inconsistent
|
286
|
-
#
|
287
|
-
# transaction or at an exact
|
288
|
-
# strong. Exact Staleness: These
|
289
|
-
#
|
290
|
-
#
|
291
|
-
#
|
292
|
-
#
|
293
|
-
#
|
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
|
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
|
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
|
437
|
-
#
|
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 (
|
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
|
567
|
-
#
|
568
|
-
#
|
569
|
-
#
|
570
|
-
#
|
571
|
-
# ABORTED`. If this behavior is undesirable, periodically executing
|
572
|
-
# query in the transaction (
|
573
|
-
# becoming idle. Snapshot Read-Only Transactions: Snapshot read-
|
574
|
-
# transactions provides a simpler method than locking read-write
|
575
|
-
# for doing several consistent reads. However, this type of
|
576
|
-
# support writes. Snapshot transactions do not take locks.
|
577
|
-
# choosing a Cloud Spanner timestamp, then executing all
|
578
|
-
# Since they do not acquire locks, they do not block
|
579
|
-
# transactions. Unlike locking read-write transactions,
|
580
|
-
# transactions never abort. They can fail if the chosen read
|
581
|
-
# garbage collected; however, the default garbage collection policy
|
582
|
-
# enough that most applications do not need to worry about this in
|
583
|
-
# Snapshot read-only transactions do not need to call Commit or
|
584
|
-
# fact are not permitted to do so). To execute a snapshot
|
585
|
-
# client specifies a timestamp bound, which tells Cloud Spanner
|
586
|
-
# read timestamp. The types of timestamp bound are: - Strong (
|
587
|
-
# Bounded staleness. - Exact staleness. If the Cloud Spanner
|
588
|
-
# is geographically distributed, stale read-only
|
589
|
-
# quickly than strong or read-write transaction,
|
590
|
-
# execute far from the leader replica. Each type of
|
591
|
-
# in detail below. Strong: Strong reads are
|
592
|
-
#
|
593
|
-
# all rows yielded by a single read are
|
594
|
-
#
|
595
|
-
# transaction. Strong reads are not repeatable:
|
596
|
-
# transactions might return inconsistent
|
597
|
-
#
|
598
|
-
# transaction or at an exact
|
599
|
-
# strong. Exact Staleness: These
|
600
|
-
#
|
601
|
-
#
|
602
|
-
#
|
603
|
-
#
|
604
|
-
#
|
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
|
1564
|
-
# 3. Requests specifying an invalid value will be
|
1565
|
-
# policies with any conditional bindings must
|
1566
|
-
#
|
1567
|
-
# field unset.
|
1568
|
-
#
|
1569
|
-
#
|
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: `
|
1655
|
-
#
|
1656
|
-
#
|
1657
|
-
#
|
1658
|
-
#
|
1659
|
-
#
|
1660
|
-
#
|
1661
|
-
#
|
1662
|
-
#
|
1663
|
-
#
|
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
|
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
|
2919
|
-
# user accounts, service accounts, Google groups, and domains (
|
2920
|
-
# A `role` is a named list of permissions; each `role` can be
|
2921
|
-
# role or a user-created custom role. For some types of Google
|
2922
|
-
# a `binding` can also specify a `condition`, which is a
|
2923
|
-
# allows access to a resource only if the expression
|
2924
|
-
# condition can add constraints based on attributes of
|
2925
|
-
# or both. To learn which resources support
|
2926
|
-
# see the [IAM documentation](https://cloud.
|
2927
|
-
# resource-policies). **JSON example:** ` "
|
2928
|
-
# resourcemanager.organizationAdmin", "members": [
|
2929
|
-
# group:admins@example.com", "domain:google.com", "
|
2930
|
-
# appspot.gserviceaccount.com" ] `, ` "role": "
|
2931
|
-
# organizationViewer", "members": [ "user:eve@example.com"
|
2932
|
-
# title": "expirable access", "description": "Does not grant
|
2933
|
-
# 2020", "expression": "request.time < timestamp('2020-10-01T00:
|
2934
|
-
# ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
|
2935
|
-
# members: - user:mike@example.com - group:admins@example.com -
|
2936
|
-
# com - serviceAccount:my-project-id@appspot.gserviceaccount.com
|
2937
|
-
# resourcemanager.organizationAdmin - members: - user:eve@example.
|
2938
|
-
# roles/resourcemanager.organizationViewer condition: title: expirable
|
2939
|
-
# description: Does not grant access after Sep 2020 expression: request.
|
2940
|
-
# timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
|
2941
|
-
# description of IAM and its features, see the [IAM documentation](https://
|
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
|
2947
|
-
# condition` that determines how and when the `bindings` are applied.
|
2948
|
-
# the `bindings` must contain at least one
|
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 doesn
|
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
|
3773
|
-
# user accounts, service accounts, Google groups, and domains (
|
3774
|
-
# A `role` is a named list of permissions; each `role` can be
|
3775
|
-
# role or a user-created custom role. For some types of Google
|
3776
|
-
# a `binding` can also specify a `condition`, which is a
|
3777
|
-
# allows access to a resource only if the expression
|
3778
|
-
# condition can add constraints based on attributes of
|
3779
|
-
# or both. To learn which resources support
|
3780
|
-
# see the [IAM documentation](https://cloud.
|
3781
|
-
# resource-policies). **JSON example:** ` "
|
3782
|
-
# resourcemanager.organizationAdmin", "members": [
|
3783
|
-
# group:admins@example.com", "domain:google.com", "
|
3784
|
-
# appspot.gserviceaccount.com" ] `, ` "role": "
|
3785
|
-
# organizationViewer", "members": [ "user:eve@example.com"
|
3786
|
-
# title": "expirable access", "description": "Does not grant
|
3787
|
-
# 2020", "expression": "request.time < timestamp('2020-10-01T00:
|
3788
|
-
# ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
|
3789
|
-
# members: - user:mike@example.com - group:admins@example.com -
|
3790
|
-
# com - serviceAccount:my-project-id@appspot.gserviceaccount.com
|
3791
|
-
# resourcemanager.organizationAdmin - members: - user:eve@example.
|
3792
|
-
# roles/resourcemanager.organizationViewer condition: title: expirable
|
3793
|
-
# description: Does not grant access after Sep 2020 expression: request.
|
3794
|
-
# timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
|
3795
|
-
# description of IAM and its features, see the [IAM documentation](https://
|
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 (
|
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
|
4065
|
-
#
|
4066
|
-
#
|
4067
|
-
#
|
4068
|
-
#
|
4069
|
-
# ABORTED`. If this behavior is undesirable, periodically executing
|
4070
|
-
# query in the transaction (
|
4071
|
-
# becoming idle. Snapshot Read-Only Transactions: Snapshot read-
|
4072
|
-
# transactions provides a simpler method than locking read-write
|
4073
|
-
# for doing several consistent reads. However, this type of
|
4074
|
-
# support writes. Snapshot transactions do not take locks.
|
4075
|
-
# choosing a Cloud Spanner timestamp, then executing all
|
4076
|
-
# Since they do not acquire locks, they do not block
|
4077
|
-
# transactions. Unlike locking read-write transactions,
|
4078
|
-
# transactions never abort. They can fail if the chosen read
|
4079
|
-
# garbage collected; however, the default garbage collection policy
|
4080
|
-
# enough that most applications do not need to worry about this in
|
4081
|
-
# Snapshot read-only transactions do not need to call Commit or
|
4082
|
-
# fact are not permitted to do so). To execute a snapshot
|
4083
|
-
# client specifies a timestamp bound, which tells Cloud Spanner
|
4084
|
-
# read timestamp. The types of timestamp bound are: - Strong (
|
4085
|
-
# Bounded staleness. - Exact staleness. If the Cloud Spanner
|
4086
|
-
# is geographically distributed, stale read-only
|
4087
|
-
# quickly than strong or read-write transaction,
|
4088
|
-
# execute far from the leader replica. Each type of
|
4089
|
-
# in detail below. Strong: Strong reads are
|
4090
|
-
#
|
4091
|
-
# all rows yielded by a single read are
|
4092
|
-
#
|
4093
|
-
# transaction. Strong reads are not repeatable:
|
4094
|
-
# transactions might return inconsistent
|
4095
|
-
#
|
4096
|
-
# transaction or at an exact
|
4097
|
-
# strong. Exact Staleness: These
|
4098
|
-
#
|
4099
|
-
#
|
4100
|
-
#
|
4101
|
-
#
|
4102
|
-
#
|
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 (
|
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
|
4260
|
-
#
|
4261
|
-
#
|
4262
|
-
#
|
4263
|
-
#
|
4264
|
-
# ABORTED`. If this behavior is undesirable, periodically executing
|
4265
|
-
# query in the transaction (
|
4266
|
-
# becoming idle. Snapshot Read-Only Transactions: Snapshot read-
|
4267
|
-
# transactions provides a simpler method than locking read-write
|
4268
|
-
# for doing several consistent reads. However, this type of
|
4269
|
-
# support writes. Snapshot transactions do not take locks.
|
4270
|
-
# choosing a Cloud Spanner timestamp, then executing all
|
4271
|
-
# Since they do not acquire locks, they do not block
|
4272
|
-
# transactions. Unlike locking read-write transactions,
|
4273
|
-
# transactions never abort. They can fail if the chosen read
|
4274
|
-
# garbage collected; however, the default garbage collection policy
|
4275
|
-
# enough that most applications do not need to worry about this in
|
4276
|
-
# Snapshot read-only transactions do not need to call Commit or
|
4277
|
-
# fact are not permitted to do so). To execute a snapshot
|
4278
|
-
# client specifies a timestamp bound, which tells Cloud Spanner
|
4279
|
-
# read timestamp. The types of timestamp bound are: - Strong (
|
4280
|
-
# Bounded staleness. - Exact staleness. If the Cloud Spanner
|
4281
|
-
# is geographically distributed, stale read-only
|
4282
|
-
# quickly than strong or read-write transaction,
|
4283
|
-
# execute far from the leader replica. Each type of
|
4284
|
-
# in detail below. Strong: Strong reads are
|
4285
|
-
#
|
4286
|
-
# all rows yielded by a single read are
|
4287
|
-
#
|
4288
|
-
# transaction. Strong reads are not repeatable:
|
4289
|
-
# transactions might return inconsistent
|
4290
|
-
#
|
4291
|
-
# transaction or at an exact
|
4292
|
-
# strong. Exact Staleness: These
|
4293
|
-
#
|
4294
|
-
#
|
4295
|
-
#
|
4296
|
-
#
|
4297
|
-
#
|
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 (
|
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
|
4429
|
-
#
|
4430
|
-
#
|
4431
|
-
#
|
4432
|
-
#
|
4433
|
-
# ABORTED`. If this behavior is undesirable, periodically executing
|
4434
|
-
# query in the transaction (
|
4435
|
-
# becoming idle. Snapshot Read-Only Transactions: Snapshot read-
|
4436
|
-
# transactions provides a simpler method than locking read-write
|
4437
|
-
# for doing several consistent reads. However, this type of
|
4438
|
-
# support writes. Snapshot transactions do not take locks.
|
4439
|
-
# choosing a Cloud Spanner timestamp, then executing all
|
4440
|
-
# Since they do not acquire locks, they do not block
|
4441
|
-
# transactions. Unlike locking read-write transactions,
|
4442
|
-
# transactions never abort. They can fail if the chosen read
|
4443
|
-
# garbage collected; however, the default garbage collection policy
|
4444
|
-
# enough that most applications do not need to worry about this in
|
4445
|
-
# Snapshot read-only transactions do not need to call Commit or
|
4446
|
-
# fact are not permitted to do so). To execute a snapshot
|
4447
|
-
# client specifies a timestamp bound, which tells Cloud Spanner
|
4448
|
-
# read timestamp. The types of timestamp bound are: - Strong (
|
4449
|
-
# Bounded staleness. - Exact staleness. If the Cloud Spanner
|
4450
|
-
# is geographically distributed, stale read-only
|
4451
|
-
# quickly than strong or read-write transaction,
|
4452
|
-
# execute far from the leader replica. Each type of
|
4453
|
-
# in detail below. Strong: Strong reads are
|
4454
|
-
#
|
4455
|
-
# all rows yielded by a single read are
|
4456
|
-
#
|
4457
|
-
# transaction. Strong reads are not repeatable:
|
4458
|
-
# transactions might return inconsistent
|
4459
|
-
#
|
4460
|
-
# transaction or at an exact
|
4461
|
-
# strong. Exact Staleness: These
|
4462
|
-
#
|
4463
|
-
#
|
4464
|
-
#
|
4465
|
-
#
|
4466
|
-
#
|
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.
|
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 = "
|
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.
|
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-
|
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/
|
61
|
-
documentation_uri: https://googleapis.dev/ruby/google-apis-spanner_v1/v0.
|
62
|
-
source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/
|
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:
|