google-cloud-spanner 1.12.0 → 1.12.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (29) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +27 -0
  3. data/lib/google/cloud/spanner/admin/database/v1/database_admin_client.rb +14 -11
  4. data/lib/google/cloud/spanner/admin/database/v1/doc/google/iam/v1/policy.rb +6 -5
  5. data/lib/google/cloud/spanner/admin/database/v1/doc/google/spanner/admin/database/v1/spanner_database_admin.rb +1 -1
  6. data/lib/google/cloud/spanner/admin/instance/v1/doc/google/iam/v1/policy.rb +6 -5
  7. data/lib/google/cloud/spanner/admin/instance/v1/doc/google/spanner/admin/instance/v1/spanner_instance_admin.rb +96 -44
  8. data/lib/google/cloud/spanner/admin/instance/v1/instance_admin_client.rb +20 -14
  9. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/keys.rb +2 -2
  10. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/mutation.rb +22 -24
  11. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/query_plan.rb +18 -21
  12. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/result_set.rb +19 -23
  13. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/spanner.rb +86 -76
  14. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/transaction.rb +6 -14
  15. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/type.rb +8 -11
  16. data/lib/google/cloud/spanner/v1/spanner_client.rb +64 -72
  17. data/lib/google/cloud/spanner/version.rb +1 -1
  18. data/lib/google/spanner/admin/database/v1/spanner_database_admin_pb.rb +3 -0
  19. data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb +13 -11
  20. data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_pb.rb +19 -0
  21. data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_services_pb.rb +5 -4
  22. data/lib/google/spanner/v1/keys_pb.rb +1 -1
  23. data/lib/google/spanner/v1/mutation_pb.rb +1 -1
  24. data/lib/google/spanner/v1/query_plan_pb.rb +1 -1
  25. data/lib/google/spanner/v1/result_set_pb.rb +1 -1
  26. data/lib/google/spanner/v1/spanner_pb.rb +3 -0
  27. data/lib/google/spanner/v1/spanner_services_pb.rb +9 -17
  28. data/lib/google/spanner/v1/transaction_pb.rb +1 -1
  29. metadata +42 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 77c43b9e9a22d239c163e14d195be8047d33e504b5ce51c355c81756d35671b3
4
- data.tar.gz: 2bccb6e48fec612be8c5b5238940d1279e172cca04909add370e4a2369a328fa
3
+ metadata.gz: bb9356b25e44c40dc9130499d1a5d0f186d4637819ca7ad27d02d7c2456c6c88
4
+ data.tar.gz: 5cfa6241edcbb3530654584587a309843f04bb6d08aeab6d31ba6273c5c95b7e
5
5
  SHA512:
6
- metadata.gz: c93a67b2af771dda520193926b31e411c4c16b4ecb7cb77ec28282cec5eabeb44f20381b6e2701b2f6696835888a3c7a73920ab26bcb072285f3f377c8aa854c
7
- data.tar.gz: a21857fc35d438151589eab2ca73cc7284968eadd33ddf9a3052ba5864466f366ac4a911a0da44bd3da802f872bd98c8751780c5ae1d691f6ed4294d6491af43
6
+ metadata.gz: 44a9560fcc37b55aed30d4a36c8a9eb7f379dc84abf79f838b11ba95f8e3225139ae255558d80f68430fd95845497f491a8ccc28c019cbe43fd0a85fb3daec56
7
+ data.tar.gz: 2de6ab1fc1f7d5b26a79ca5a8f1835d4ce0ba732e188e9c0342897826027c1f59a88b9263cc026d76b245ba59d6b0ad2755542bba49fff32bca73eb7363871ab
@@ -1,5 +1,32 @@
1
1
  # Release History
2
2
 
3
+ ### 1.12.2 / 2019-12-19
4
+
5
+ #### Bug Fixes
6
+
7
+ * Rename endpoint_urls to endpoint_uris
8
+ * Revert #commit mutations to positional in lower-level API
9
+ * Revert breaking change to test_iam_permissions in lower-level API
10
+
11
+ #### Performance Improvements
12
+
13
+ * Add Instance#endpoint_urls and GetInstanceRequest#field_mask in lower-level API
14
+ * Add service address and port for lower-level API clients
15
+
16
+ ### 1.12.1 / 2019-11-12
17
+
18
+ #### Features
19
+
20
+ * Add InstanceConfig#replicas (ReplicaInfo) to the lower-level API.
21
+
22
+ #### Documentation
23
+
24
+ * Update lower-level API documentation.
25
+
26
+ #### Bug Fixes
27
+
28
+ * Update minimum runtime dependencies.
29
+
3
30
  ### 1.12.0 / 2019-10-29
4
31
 
5
32
  This release requires Ruby 2.4 or later.
@@ -175,6 +175,8 @@ module Google
175
175
  scopes: scopes,
176
176
  client_config: client_config,
177
177
  timeout: timeout,
178
+ service_address: service_address,
179
+ service_port: service_port,
178
180
  lib_name: lib_name,
179
181
  lib_version: lib_version,
180
182
  metadata: metadata,
@@ -497,7 +499,7 @@ module Google
497
499
  # @param database [String]
498
500
  # Required. The database to update.
499
501
  # @param statements [Array<String>]
500
- # DDL statements to be applied to the database.
502
+ # Required. DDL statements to be applied to the database.
501
503
  # @param operation_id [String]
502
504
  # If empty, the new update request is assigned an
503
505
  # automatically-generated operation ID. Otherwise, `operation_id`
@@ -645,11 +647,11 @@ module Google
645
647
  @get_database_ddl.call(req, options, &block)
646
648
  end
647
649
 
648
- # Sets the access control policy on a database resource. Replaces any
649
- # existing policy.
650
+ # Sets the access control policy on a database resource.
651
+ # Replaces any existing policy.
650
652
  #
651
- # Authorization requires `spanner.databases.setIamPolicy` permission on
652
- # {Google::Iam::V1::SetIamPolicyRequest#resource resource}.
653
+ # Authorization requires `spanner.databases.setIamPolicy`
654
+ # permission on {Google::Iam::V1::SetIamPolicyRequest#resource resource}.
653
655
  #
654
656
  # @param resource [String]
655
657
  # REQUIRED: The resource for which the policy is being specified.
@@ -692,8 +694,9 @@ module Google
692
694
  @set_iam_policy.call(req, options, &block)
693
695
  end
694
696
 
695
- # Gets the access control policy for a database resource. Returns an empty
696
- # policy if a database exists but does not have a policy set.
697
+ # Gets the access control policy for a database resource.
698
+ # Returns an empty policy if a database exists but does
699
+ # not have a policy set.
697
700
  #
698
701
  # Authorization requires `spanner.databases.getIamPolicy` permission on
699
702
  # {Google::Iam::V1::GetIamPolicyRequest#resource resource}.
@@ -736,10 +739,10 @@ module Google
736
739
 
737
740
  # Returns permissions that the caller has on the specified database resource.
738
741
  #
739
- # Attempting this RPC on a non-existent Cloud Spanner database will result in
740
- # a NOT_FOUND error if the user has `spanner.databases.list` permission on
741
- # the containing Cloud Spanner instance. Otherwise returns an empty set of
742
- # permissions.
742
+ # Attempting this RPC on a non-existent Cloud Spanner database will
743
+ # result in a NOT_FOUND error if the user has
744
+ # `spanner.databases.list` permission on the containing Cloud
745
+ # Spanner instance. Otherwise returns an empty set of permissions.
743
746
  #
744
747
  # @param resource [String]
745
748
  # REQUIRED: The resource for which the policy detail is being requested.
@@ -82,12 +82,13 @@ module Google
82
82
  #
83
83
  # Operations affecting conditional bindings must specify version 3. This can
84
84
  # be either setting a conditional policy, modifying a conditional binding,
85
- # or removing a conditional binding from the stored conditional policy.
85
+ # or removing a binding (conditional or unconditional) from the stored
86
+ # conditional policy.
86
87
  # Operations on non-conditional policies may specify any valid value or
87
88
  # leave the field unset.
88
89
  #
89
- # If no etag is provided in the call to `setIamPolicy`, any version
90
- # compliance checks on the incoming and/or stored policy is skipped.
90
+ # If no etag is provided in the call to `setIamPolicy`, version compliance
91
+ # checks against the stored policy is skipped.
91
92
  # @!attribute [rw] bindings
92
93
  # @return [Array<Google::Iam::V1::Binding>]
93
94
  # Associates a list of `members` to a `role`. Optionally may specify a
@@ -105,8 +106,8 @@ module Google
105
106
  #
106
107
  # If no `etag` is provided in the call to `setIamPolicy`, then the existing
107
108
  # policy is overwritten. Due to blind-set semantics of an etag-less policy,
108
- # 'setIamPolicy' will not fail even if either of incoming or stored policy
109
- # does not meet the version requirements.
109
+ # 'setIamPolicy' will not fail even if the incoming policy version does not
110
+ # meet the requirements for modifying the stored policy.
110
111
  class Policy; end
111
112
 
112
113
  # Associates `members` with a `role`.
@@ -131,7 +131,7 @@ module Google
131
131
  # Required. The database to update.
132
132
  # @!attribute [rw] statements
133
133
  # @return [Array<String>]
134
- # DDL statements to be applied to the database.
134
+ # Required. DDL statements to be applied to the database.
135
135
  # @!attribute [rw] operation_id
136
136
  # @return [String]
137
137
  # If empty, the new update request is assigned an
@@ -82,12 +82,13 @@ module Google
82
82
  #
83
83
  # Operations affecting conditional bindings must specify version 3. This can
84
84
  # be either setting a conditional policy, modifying a conditional binding,
85
- # or removing a conditional binding from the stored conditional policy.
85
+ # or removing a binding (conditional or unconditional) from the stored
86
+ # conditional policy.
86
87
  # Operations on non-conditional policies may specify any valid value or
87
88
  # leave the field unset.
88
89
  #
89
- # If no etag is provided in the call to `setIamPolicy`, any version
90
- # compliance checks on the incoming and/or stored policy is skipped.
90
+ # If no etag is provided in the call to `setIamPolicy`, version compliance
91
+ # checks against the stored policy is skipped.
91
92
  # @!attribute [rw] bindings
92
93
  # @return [Array<Google::Iam::V1::Binding>]
93
94
  # Associates a list of `members` to a `role`. Optionally may specify a
@@ -105,8 +106,8 @@ module Google
105
106
  #
106
107
  # If no `etag` is provided in the call to `setIamPolicy`, then the existing
107
108
  # policy is overwritten. Due to blind-set semantics of an etag-less policy,
108
- # 'setIamPolicy' will not fail even if either of incoming or stored policy
109
- # does not meet the version requirements.
109
+ # 'setIamPolicy' will not fail even if the incoming policy version does not
110
+ # meet the requirements for modifying the stored policy.
110
111
  class Policy; end
111
112
 
112
113
  # Associates `members` with a `role`.
@@ -18,6 +18,54 @@ module Google
18
18
  module Admin
19
19
  module Instance
20
20
  module V1
21
+ # @!attribute [rw] location
22
+ # @return [String]
23
+ # The location of the serving resources, e.g. "us-central1".
24
+ # @!attribute [rw] type
25
+ # @return [Google::Spanner::Admin::Instance::V1::ReplicaInfo::ReplicaType]
26
+ # The type of replica.
27
+ # @!attribute [rw] default_leader_location
28
+ # @return [true, false]
29
+ # If true, this location is designated as the default leader location where
30
+ # leader replicas are placed. See the [region types
31
+ # documentation](https://cloud.google.com/spanner/docs/instances#region_types)
32
+ # for more details.
33
+ class ReplicaInfo
34
+ # Indicates the type of replica. See the [replica types
35
+ # documentation](https://cloud.google.com/spanner/docs/replication#replica_types)
36
+ # for more details.
37
+ module ReplicaType
38
+ # Not specified.
39
+ TYPE_UNSPECIFIED = 0
40
+
41
+ # Read-write replicas support both reads and writes. These replicas:
42
+ #
43
+ # * Maintain a full copy of your data.
44
+ # * Serve reads.
45
+ # * Can vote whether to commit a write.
46
+ # * Participate in leadership election.
47
+ # * Are eligible to become a leader.
48
+ READ_WRITE = 1
49
+
50
+ # Read-only replicas only support reads (not writes). Read-only replicas:
51
+ #
52
+ # * Maintain a full copy of your data.
53
+ # * Serve reads.
54
+ # * Do not participate in voting to commit writes.
55
+ # * Are not eligible to become a leader.
56
+ READ_ONLY = 2
57
+
58
+ # Witness replicas don't support reads but do participate in voting to
59
+ # commit writes. Witness replicas:
60
+ #
61
+ # * Do not maintain a full copy of data.
62
+ # * Do not serve reads.
63
+ # * Vote whether to commit writes.
64
+ # * Participate in leader election but are not eligible to become leader.
65
+ WITNESS = 3
66
+ end
67
+ end
68
+
21
69
  # A possible configuration for a Cloud Spanner instance. Configurations
22
70
  # define the geographic placement of nodes and their replication.
23
71
  # @!attribute [rw] name
@@ -28,6 +76,10 @@ module Google
28
76
  # @!attribute [rw] display_name
29
77
  # @return [String]
30
78
  # The name of this instance configuration as it appears in UIs.
79
+ # @!attribute [rw] replicas
80
+ # @return [Array<Google::Spanner::Admin::Instance::V1::ReplicaInfo>]
81
+ # The geographic placement of nodes in this instance configuration and their
82
+ # replication properties.
31
83
  class InstanceConfig; end
32
84
 
33
85
  # An isolated set of Cloud Spanner resources on which databases can be hosted.
@@ -36,7 +88,7 @@ module Google
36
88
  # Required. A unique identifier for the instance, which cannot be changed
37
89
  # after the instance is created. Values are of the form
38
90
  # `projects/<project>/instances/[a-z][-a-z0-9]*[a-z0-9]`. The final
39
- # segment of the name must be between 6 and 30 characters in length.
91
+ # segment of the name must be between 2 and 64 characters in length.
40
92
  # @!attribute [rw] config
41
93
  # @return [String]
42
94
  # Required. The name of the instance's configuration. Values are of the form
@@ -58,10 +110,10 @@ module Google
58
110
  # @!attribute [rw] state
59
111
  # @return [Google::Spanner::Admin::Instance::V1::Instance::State]
60
112
  # Output only. The current instance state. For
61
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance},
62
- # the state must be either omitted or set to `CREATING`. For
63
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance},
64
- # the state must be either omitted or set to `READY`.
113
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}, the state must be
114
+ # either omitted or set to `CREATING`. For
115
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}, the state must be
116
+ # either omitted or set to `READY`.
65
117
  # @!attribute [rw] labels
66
118
  # @return [Hash{String => String}]
67
119
  # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
@@ -85,6 +137,16 @@ module Google
85
137
  # specific characters being disallowed. For example, representing labels
86
138
  # as the string: name + "_" + value would prove problematic if we were to
87
139
  # allow "_" in a future release.
140
+ # @!attribute [rw] endpoint_uris
141
+ # @return [Array<String>]
142
+ # Output only. The endpoint URIs based on the instance config.
143
+ # For example, instances located in a specific cloud region (or multi region)
144
+ # such as nam3, would have a nam3 specific endpoint URI.
145
+ # This URI is to be used implictly by SDK clients, with fallback to default
146
+ # URI. These endpoints are intended to optimize the network routing between
147
+ # the client and the instance's serving resources.
148
+ # If multiple endpoints are present, client may establish connections using
149
+ # any of the given URIs.
88
150
  class Instance
89
151
  # Indicates the current state of the instance.
90
152
  module State
@@ -102,8 +164,7 @@ module Google
102
164
  end
103
165
  end
104
166
 
105
- # The request for
106
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
167
+ # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
107
168
  # @!attribute [rw] parent
108
169
  # @return [String]
109
170
  # Required. The name of the project for which a list of supported instance
@@ -117,20 +178,18 @@ module Google
117
178
  # @return [String]
118
179
  # If non-empty, `page_token` should contain a
119
180
  # {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse#next_page_token next_page_token}
120
- # from a previous
121
- # {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse ListInstanceConfigsResponse}.
181
+ # from a previous {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse ListInstanceConfigsResponse}.
122
182
  class ListInstanceConfigsRequest; end
123
183
 
124
- # The response for
125
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
184
+ # The response for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
126
185
  # @!attribute [rw] instance_configs
127
186
  # @return [Array<Google::Spanner::Admin::Instance::V1::InstanceConfig>]
128
187
  # The list of requested instance configurations.
129
188
  # @!attribute [rw] next_page_token
130
189
  # @return [String]
131
190
  # `next_page_token` can be sent in a subsequent
132
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}
133
- # call to fetch more of the matching instance configurations.
191
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs} call to
192
+ # fetch more of the matching instance configurations.
134
193
  class ListInstanceConfigsResponse; end
135
194
 
136
195
  # The request for
@@ -141,16 +200,19 @@ module Google
141
200
  # the form `projects/<project>/instanceConfigs/<config>`.
142
201
  class GetInstanceConfigRequest; end
143
202
 
144
- # The request for
145
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::GetInstance GetInstance}.
203
+ # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::GetInstance GetInstance}.
146
204
  # @!attribute [rw] name
147
205
  # @return [String]
148
206
  # Required. The name of the requested instance. Values are of the form
149
207
  # `projects/<project>/instances/<instance>`.
208
+ # @!attribute [rw] field_mask
209
+ # @return [Google::Protobuf::FieldMask]
210
+ # If field_mask is present, specifies the subset of [][google.spanner.admin.instance.v1.Instance] fields that
211
+ # should be returned.
212
+ # If absent, all [][google.spanner.admin.instance.v1.Instance] fields are returned.
150
213
  class GetInstanceRequest; end
151
214
 
152
- # The request for
153
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}.
215
+ # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}.
154
216
  # @!attribute [rw] parent
155
217
  # @return [String]
156
218
  # Required. The name of the project in which to create the instance. Values
@@ -158,7 +220,7 @@ module Google
158
220
  # @!attribute [rw] instance_id
159
221
  # @return [String]
160
222
  # Required. The ID of the instance to create. Valid identifiers are of the
161
- # form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 6 and 30 characters in
223
+ # form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in
162
224
  # length.
163
225
  # @!attribute [rw] instance
164
226
  # @return [Google::Spanner::Admin::Instance::V1::Instance]
@@ -166,8 +228,7 @@ module Google
166
228
  # specified must be `<parent>/instances/<instance_id>`.
167
229
  class CreateInstanceRequest; end
168
230
 
169
- # The request for
170
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
231
+ # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
171
232
  # @!attribute [rw] parent
172
233
  # @return [String]
173
234
  # Required. The name of the project for which a list of instances is
@@ -179,9 +240,8 @@ module Google
179
240
  # @!attribute [rw] page_token
180
241
  # @return [String]
181
242
  # If non-empty, `page_token` should contain a
182
- # {Google::Spanner::Admin::Instance::V1::ListInstancesResponse#next_page_token next_page_token}
183
- # from a previous
184
- # {Google::Spanner::Admin::Instance::V1::ListInstancesResponse ListInstancesResponse}.
243
+ # {Google::Spanner::Admin::Instance::V1::ListInstancesResponse#next_page_token next_page_token} from a
244
+ # previous {Google::Spanner::Admin::Instance::V1::ListInstancesResponse ListInstancesResponse}.
185
245
  # @!attribute [rw] filter
186
246
  # @return [String]
187
247
  # An expression for filtering the results of the request. Filter rules are
@@ -205,38 +265,31 @@ module Google
205
265
  # containing "dev".
206
266
  class ListInstancesRequest; end
207
267
 
208
- # The response for
209
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
268
+ # The response for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
210
269
  # @!attribute [rw] instances
211
270
  # @return [Array<Google::Spanner::Admin::Instance::V1::Instance>]
212
271
  # The list of requested instances.
213
272
  # @!attribute [rw] next_page_token
214
273
  # @return [String]
215
274
  # `next_page_token` can be sent in a subsequent
216
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}
217
- # call to fetch more of the matching instances.
275
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances} call to fetch more
276
+ # of the matching instances.
218
277
  class ListInstancesResponse; end
219
278
 
220
- # The request for
221
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}.
279
+ # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}.
222
280
  # @!attribute [rw] instance
223
281
  # @return [Google::Spanner::Admin::Instance::V1::Instance]
224
282
  # Required. The instance to update, which must always include the instance
225
- # name. Otherwise, only fields mentioned in
226
- # [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need
227
- # be included.
283
+ # name. Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
228
284
  # @!attribute [rw] field_mask
229
285
  # @return [Google::Protobuf::FieldMask]
230
- # Required. A mask specifying which fields in
231
- # [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should
232
- # be updated. The field mask must always be specified; this prevents any
233
- # future fields in
234
- # [][google.spanner.admin.instance.v1.Instance] from being erased
235
- # accidentally by clients that do not know about them.
286
+ # Required. A mask specifying which fields in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated.
287
+ # The field mask must always be specified; this prevents any future fields in
288
+ # [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
289
+ # about them.
236
290
  class UpdateInstanceRequest; end
237
291
 
238
- # The request for
239
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::DeleteInstance DeleteInstance}.
292
+ # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::DeleteInstance DeleteInstance}.
240
293
  # @!attribute [rw] name
241
294
  # @return [String]
242
295
  # Required. The name of the instance to be deleted. Values are of the form
@@ -251,8 +304,8 @@ module Google
251
304
  # @!attribute [rw] start_time
252
305
  # @return [Google::Protobuf::Timestamp]
253
306
  # The time at which the
254
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}
255
- # request was received.
307
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance} request was
308
+ # received.
256
309
  # @!attribute [rw] cancel_time
257
310
  # @return [Google::Protobuf::Timestamp]
258
311
  # The time at which this operation was cancelled. If set, this operation is
@@ -270,8 +323,7 @@ module Google
270
323
  # The desired end state of the update.
271
324
  # @!attribute [rw] start_time
272
325
  # @return [Google::Protobuf::Timestamp]
273
- # The time at which
274
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}
326
+ # The time at which {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}
275
327
  # request was received.
276
328
  # @!attribute [rw] cancel_time
277
329
  # @return [Google::Protobuf::Timestamp]
@@ -208,6 +208,8 @@ module Google
208
208
  scopes: scopes,
209
209
  client_config: client_config,
210
210
  timeout: timeout,
211
+ service_address: service_address,
212
+ service_port: service_port,
211
213
  lib_name: lib_name,
212
214
  lib_version: lib_version,
213
215
  metadata: metadata,
@@ -523,6 +525,12 @@ module Google
523
525
  # @param name [String]
524
526
  # Required. The name of the requested instance. Values are of the form
525
527
  # `projects/<project>/instances/<instance>`.
528
+ # @param field_mask [Google::Protobuf::FieldMask | Hash]
529
+ # If field_mask is present, specifies the subset of [][google.spanner.admin.instance.v1.Instance] fields that
530
+ # should be returned.
531
+ # If absent, all [][google.spanner.admin.instance.v1.Instance] fields are returned.
532
+ # A hash of the same form as `Google::Protobuf::FieldMask`
533
+ # can also be provided.
526
534
  # @param options [Google::Gax::CallOptions]
527
535
  # Overrides the default settings for this call, e.g, timeout,
528
536
  # retries, etc.
@@ -540,10 +548,12 @@ module Google
540
548
 
541
549
  def get_instance \
542
550
  name,
551
+ field_mask: nil,
543
552
  options: nil,
544
553
  &block
545
554
  req = {
546
- name: name
555
+ name: name,
556
+ field_mask: field_mask
547
557
  }.delete_if { |_, v| v.nil? }
548
558
  req = Google::Gax::to_proto(req, Google::Spanner::Admin::Instance::V1::GetInstanceRequest)
549
559
  @get_instance.call(req, options, &block)
@@ -589,7 +599,7 @@ module Google
589
599
  # are of the form `projects/<project>`.
590
600
  # @param instance_id [String]
591
601
  # Required. The ID of the instance to create. Valid identifiers are of the
592
- # form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 6 and 30 characters in
602
+ # form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in
593
603
  # length.
594
604
  # @param instance [Google::Spanner::Admin::Instance::V1::Instance | Hash]
595
605
  # Required. The instance to create. The name may be omitted, but if
@@ -676,9 +686,9 @@ module Google
676
686
  # Until completion of the returned operation:
677
687
  #
678
688
  # * Cancelling the operation sets its metadata's
679
- # {Google::Spanner::Admin::Instance::V1::UpdateInstanceMetadata#cancel_time cancel_time},
680
- # and begins restoring resources to their pre-request values. The
681
- # operation is guaranteed to succeed at undoing all resource changes,
689
+ # {Google::Spanner::Admin::Instance::V1::UpdateInstanceMetadata#cancel_time cancel_time}, and begins
690
+ # restoring resources to their pre-request values. The operation
691
+ # is guaranteed to succeed at undoing all resource changes,
682
692
  # after which point it terminates with a `CANCELLED` status.
683
693
  # * All other attempts to modify the instance are rejected.
684
694
  # * Reading the instance via the API continues to give the pre-request
@@ -705,18 +715,14 @@ module Google
705
715
  #
706
716
  # @param instance [Google::Spanner::Admin::Instance::V1::Instance | Hash]
707
717
  # Required. The instance to update, which must always include the instance
708
- # name. Otherwise, only fields mentioned in
709
- # [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need
710
- # be included.
718
+ # name. Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
711
719
  # A hash of the same form as `Google::Spanner::Admin::Instance::V1::Instance`
712
720
  # can also be provided.
713
721
  # @param field_mask [Google::Protobuf::FieldMask | Hash]
714
- # Required. A mask specifying which fields in
715
- # [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should
716
- # be updated. The field mask must always be specified; this prevents any
717
- # future fields in
718
- # [][google.spanner.admin.instance.v1.Instance] from being erased
719
- # accidentally by clients that do not know about them.
722
+ # Required. A mask specifying which fields in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated.
723
+ # The field mask must always be specified; this prevents any future fields in
724
+ # [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
725
+ # about them.
720
726
  # A hash of the same form as `Google::Protobuf::FieldMask`
721
727
  # can also be provided.
722
728
  # @param options [Google::Gax::CallOptions]