google-cloud-spanner-admin-instance-v1 1.0.0 → 1.1.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/client.rb +205 -39
- data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/rest/client.rb +198 -39
- data/lib/google/cloud/spanner/admin/instance/v1/instance_admin/rest/service_stub.rb +60 -0
- data/lib/google/cloud/spanner/admin/instance/v1/version.rb +1 -1
- data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_pb.rb +5 -1
- data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_services_pb.rb +87 -25
- data/proto_docs/google/api/client.rb +31 -10
- data/proto_docs/google/api/resource.rb +7 -2
- data/proto_docs/google/spanner/admin/instance/v1/spanner_instance_admin.rb +105 -37
- metadata +2 -2
@@ -59,38 +59,38 @@ module Google
|
|
59
59
|
rpc :ListInstanceConfigs, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigsRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse
|
60
60
|
# Gets information about a particular instance configuration.
|
61
61
|
rpc :GetInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::GetInstanceConfigRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig
|
62
|
-
# Creates an instance
|
62
|
+
# Creates an instance configuration and begins preparing it to be used. The
|
63
63
|
# returned [long-running operation][google.longrunning.Operation]
|
64
64
|
# can be used to track the progress of preparing the new
|
65
|
-
# instance
|
66
|
-
# named instance
|
67
|
-
# `ALREADY_EXISTS`.
|
65
|
+
# instance configuration. The instance configuration name is assigned by the
|
66
|
+
# caller. If the named instance configuration already exists,
|
67
|
+
# `CreateInstanceConfig` returns `ALREADY_EXISTS`.
|
68
68
|
#
|
69
69
|
# Immediately after the request returns:
|
70
70
|
#
|
71
|
-
# * The instance
|
72
|
-
# attributes. The instance
|
71
|
+
# * The instance configuration is readable via the API, with all requested
|
72
|
+
# attributes. The instance configuration's
|
73
73
|
# [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
|
74
74
|
# field is set to true. Its state is `CREATING`.
|
75
75
|
#
|
76
76
|
# While the operation is pending:
|
77
77
|
#
|
78
|
-
# * Cancelling the operation renders the instance
|
78
|
+
# * Cancelling the operation renders the instance configuration immediately
|
79
79
|
# unreadable via the API.
|
80
80
|
# * Except for deleting the creating resource, all other attempts to modify
|
81
|
-
# the instance
|
81
|
+
# the instance configuration are rejected.
|
82
82
|
#
|
83
83
|
# Upon completion of the returned operation:
|
84
84
|
#
|
85
85
|
# * Instances can be created using the instance configuration.
|
86
|
-
# * The instance
|
86
|
+
# * The instance configuration's
|
87
87
|
# [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
|
88
88
|
# field becomes false. Its state becomes `READY`.
|
89
89
|
#
|
90
90
|
# The returned [long-running operation][google.longrunning.Operation] will
|
91
91
|
# have a name of the format
|
92
92
|
# `<instance_config_name>/operations/<operation_id>` and can be used to track
|
93
|
-
# creation of the instance
|
93
|
+
# creation of the instance configuration. The
|
94
94
|
# [metadata][google.longrunning.Operation.metadata] field type is
|
95
95
|
# [CreateInstanceConfigMetadata][google.spanner.admin.instance.v1.CreateInstanceConfigMetadata].
|
96
96
|
# The [response][google.longrunning.Operation.response] field type is
|
@@ -101,16 +101,16 @@ module Google
|
|
101
101
|
# the resource
|
102
102
|
# [parent][google.spanner.admin.instance.v1.CreateInstanceConfigRequest.parent].
|
103
103
|
rpc :CreateInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::CreateInstanceConfigRequest, ::Google::Longrunning::Operation
|
104
|
-
# Updates an instance
|
104
|
+
# Updates an instance configuration. The returned
|
105
105
|
# [long-running operation][google.longrunning.Operation] can be used to track
|
106
|
-
# the progress of updating the instance. If the named instance
|
107
|
-
# not exist, returns `NOT_FOUND`.
|
106
|
+
# the progress of updating the instance. If the named instance configuration
|
107
|
+
# does not exist, returns `NOT_FOUND`.
|
108
108
|
#
|
109
|
-
# Only user
|
109
|
+
# Only user-managed configurations can be updated.
|
110
110
|
#
|
111
111
|
# Immediately after the request returns:
|
112
112
|
#
|
113
|
-
# * The instance
|
113
|
+
# * The instance configuration's
|
114
114
|
# [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
|
115
115
|
# field is set to true.
|
116
116
|
#
|
@@ -120,23 +120,23 @@ module Google
|
|
120
120
|
# [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata.cancel_time].
|
121
121
|
# The operation is guaranteed to succeed at undoing all changes, after
|
122
122
|
# which point it terminates with a `CANCELLED` status.
|
123
|
-
# * All other attempts to modify the instance
|
124
|
-
# * Reading the instance
|
123
|
+
# * All other attempts to modify the instance configuration are rejected.
|
124
|
+
# * Reading the instance configuration via the API continues to give the
|
125
125
|
# pre-request values.
|
126
126
|
#
|
127
127
|
# Upon completion of the returned operation:
|
128
128
|
#
|
129
129
|
# * Creating instances using the instance configuration uses the new
|
130
130
|
# values.
|
131
|
-
# * The
|
132
|
-
# * The instance
|
131
|
+
# * The new values of the instance configuration are readable via the API.
|
132
|
+
# * The instance configuration's
|
133
133
|
# [reconciling][google.spanner.admin.instance.v1.InstanceConfig.reconciling]
|
134
134
|
# field becomes false.
|
135
135
|
#
|
136
136
|
# The returned [long-running operation][google.longrunning.Operation] will
|
137
137
|
# have a name of the format
|
138
138
|
# `<instance_config_name>/operations/<operation_id>` and can be used to track
|
139
|
-
# the instance
|
139
|
+
# the instance configuration modification. The
|
140
140
|
# [metadata][google.longrunning.Operation.metadata] field type is
|
141
141
|
# [UpdateInstanceConfigMetadata][google.spanner.admin.instance.v1.UpdateInstanceConfigMetadata].
|
142
142
|
# The [response][google.longrunning.Operation.response] field type is
|
@@ -146,18 +146,18 @@ module Google
|
|
146
146
|
# Authorization requires `spanner.instanceConfigs.update` permission on
|
147
147
|
# the resource [name][google.spanner.admin.instance.v1.InstanceConfig.name].
|
148
148
|
rpc :UpdateInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::UpdateInstanceConfigRequest, ::Google::Longrunning::Operation
|
149
|
-
# Deletes the instance
|
149
|
+
# Deletes the instance configuration. Deletion is only allowed when no
|
150
150
|
# instances are using the configuration. If any instances are using
|
151
|
-
# the
|
151
|
+
# the configuration, returns `FAILED_PRECONDITION`.
|
152
152
|
#
|
153
|
-
# Only user
|
153
|
+
# Only user-managed configurations can be deleted.
|
154
154
|
#
|
155
155
|
# Authorization requires `spanner.instanceConfigs.delete` permission on
|
156
156
|
# the resource [name][google.spanner.admin.instance.v1.InstanceConfig.name].
|
157
157
|
rpc :DeleteInstanceConfig, ::Google::Cloud::Spanner::Admin::Instance::V1::DeleteInstanceConfigRequest, ::Google::Protobuf::Empty
|
158
|
-
# Lists the user-managed instance
|
158
|
+
# Lists the user-managed instance configuration [long-running
|
159
159
|
# operations][google.longrunning.Operation] in the given project. An instance
|
160
|
-
#
|
160
|
+
# configuration operation has a name of the form
|
161
161
|
# `projects/<project>/instanceConfigs/<instance_config>/operations/<operation>`.
|
162
162
|
# The long-running operation
|
163
163
|
# [metadata][google.longrunning.Operation.metadata] field type
|
@@ -389,6 +389,68 @@ module Google
|
|
389
389
|
# permission on the resource
|
390
390
|
# [parent][google.spanner.admin.instance.v1.ListInstancePartitionOperationsRequest.parent].
|
391
391
|
rpc :ListInstancePartitionOperations, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstancePartitionOperationsRequest, ::Google::Cloud::Spanner::Admin::Instance::V1::ListInstancePartitionOperationsResponse
|
392
|
+
# Moves an instance to the target instance configuration. You can use the
|
393
|
+
# returned [long-running operation][google.longrunning.Operation] to track
|
394
|
+
# the progress of moving the instance.
|
395
|
+
#
|
396
|
+
# `MoveInstance` returns `FAILED_PRECONDITION` if the instance meets any of
|
397
|
+
# the following criteria:
|
398
|
+
#
|
399
|
+
# * Is undergoing a move to a different instance configuration
|
400
|
+
# * Has backups
|
401
|
+
# * Has an ongoing update
|
402
|
+
# * Contains any CMEK-enabled databases
|
403
|
+
# * Is a free trial instance
|
404
|
+
#
|
405
|
+
# While the operation is pending:
|
406
|
+
#
|
407
|
+
# * All other attempts to modify the instance, including changes to its
|
408
|
+
# compute capacity, are rejected.
|
409
|
+
# * The following database and backup admin operations are rejected:
|
410
|
+
#
|
411
|
+
# * `DatabaseAdmin.CreateDatabase`
|
412
|
+
# * `DatabaseAdmin.UpdateDatabaseDdl` (disabled if default_leader is
|
413
|
+
# specified in the request.)
|
414
|
+
# * `DatabaseAdmin.RestoreDatabase`
|
415
|
+
# * `DatabaseAdmin.CreateBackup`
|
416
|
+
# * `DatabaseAdmin.CopyBackup`
|
417
|
+
#
|
418
|
+
# * Both the source and target instance configurations are subject to
|
419
|
+
# hourly compute and storage charges.
|
420
|
+
# * The instance might experience higher read-write latencies and a higher
|
421
|
+
# transaction abort rate. However, moving an instance doesn't cause any
|
422
|
+
# downtime.
|
423
|
+
#
|
424
|
+
# The returned [long-running operation][google.longrunning.Operation] has
|
425
|
+
# a name of the format
|
426
|
+
# `<instance_name>/operations/<operation_id>` and can be used to track
|
427
|
+
# the move instance operation. The
|
428
|
+
# [metadata][google.longrunning.Operation.metadata] field type is
|
429
|
+
# [MoveInstanceMetadata][google.spanner.admin.instance.v1.MoveInstanceMetadata].
|
430
|
+
# The [response][google.longrunning.Operation.response] field type is
|
431
|
+
# [Instance][google.spanner.admin.instance.v1.Instance],
|
432
|
+
# if successful.
|
433
|
+
# Cancelling the operation sets its metadata's
|
434
|
+
# [cancel_time][google.spanner.admin.instance.v1.MoveInstanceMetadata.cancel_time].
|
435
|
+
# Cancellation is not immediate because it involves moving any data
|
436
|
+
# previously moved to the target instance configuration back to the original
|
437
|
+
# instance configuration. You can use this operation to track the progress of
|
438
|
+
# the cancellation. Upon successful completion of the cancellation, the
|
439
|
+
# operation terminates with `CANCELLED` status.
|
440
|
+
#
|
441
|
+
# If not cancelled, upon completion of the returned operation:
|
442
|
+
#
|
443
|
+
# * The instance successfully moves to the target instance
|
444
|
+
# configuration.
|
445
|
+
# * You are billed for compute and storage in target instance
|
446
|
+
# configuration.
|
447
|
+
#
|
448
|
+
# Authorization requires the `spanner.instances.update` permission on
|
449
|
+
# the resource [instance][google.spanner.admin.instance.v1.Instance].
|
450
|
+
#
|
451
|
+
# For more details, see
|
452
|
+
# [Move an instance](https://cloud.google.com/spanner/docs/move-instance).
|
453
|
+
rpc :MoveInstance, ::Google::Cloud::Spanner::Admin::Instance::V1::MoveInstanceRequest, ::Google::Longrunning::Operation
|
392
454
|
end
|
393
455
|
|
394
456
|
Stub = Service.rpc_stub_class
|
@@ -196,9 +196,26 @@ module Google
|
|
196
196
|
# @!attribute [rw] common
|
197
197
|
# @return [::Google::Api::CommonLanguageSettings]
|
198
198
|
# Some settings.
|
199
|
+
# @!attribute [rw] experimental_features
|
200
|
+
# @return [::Google::Api::PythonSettings::ExperimentalFeatures]
|
201
|
+
# Experimental features to be included during client library generation.
|
199
202
|
class PythonSettings
|
200
203
|
include ::Google::Protobuf::MessageExts
|
201
204
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
205
|
+
|
206
|
+
# Experimental features to be included during client library generation.
|
207
|
+
# These fields will be deprecated once the feature graduates and is enabled
|
208
|
+
# by default.
|
209
|
+
# @!attribute [rw] rest_async_io_enabled
|
210
|
+
# @return [::Boolean]
|
211
|
+
# Enables generation of asynchronous REST clients if `rest` transport is
|
212
|
+
# enabled. By default, asynchronous REST clients will not be generated.
|
213
|
+
# This feature will be enabled by default 1 month after launching the
|
214
|
+
# feature in preview packages.
|
215
|
+
class ExperimentalFeatures
|
216
|
+
include ::Google::Protobuf::MessageExts
|
217
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
218
|
+
end
|
202
219
|
end
|
203
220
|
|
204
221
|
# Settings for Node client libraries.
|
@@ -290,6 +307,13 @@ module Google
|
|
290
307
|
# @return [::String]
|
291
308
|
# The fully qualified name of the method, for which the options below apply.
|
292
309
|
# This is used to find the method to apply the options.
|
310
|
+
#
|
311
|
+
# Example:
|
312
|
+
#
|
313
|
+
# publishing:
|
314
|
+
# method_settings:
|
315
|
+
# - selector: google.storage.control.v2.StorageControl.CreateFolder
|
316
|
+
# # method settings for CreateFolder...
|
293
317
|
# @!attribute [rw] long_running
|
294
318
|
# @return [::Google::Api::MethodSettings::LongRunning]
|
295
319
|
# Describes settings to use for long-running operations when generating
|
@@ -298,17 +322,14 @@ module Google
|
|
298
322
|
#
|
299
323
|
# Example of a YAML configuration::
|
300
324
|
#
|
301
|
-
#
|
302
|
-
#
|
325
|
+
# publishing:
|
326
|
+
# method_settings:
|
303
327
|
# - selector: google.cloud.speech.v2.Speech.BatchRecognize
|
304
328
|
# long_running:
|
305
|
-
# initial_poll_delay:
|
306
|
-
# seconds: 60 # 1 minute
|
329
|
+
# initial_poll_delay: 60s # 1 minute
|
307
330
|
# poll_delay_multiplier: 1.5
|
308
|
-
# max_poll_delay:
|
309
|
-
#
|
310
|
-
# total_poll_timeout:
|
311
|
-
# seconds: 54000 # 90 minutes
|
331
|
+
# max_poll_delay: 360s # 6 minutes
|
332
|
+
# total_poll_timeout: 54000s # 90 minutes
|
312
333
|
# @!attribute [rw] auto_populated_fields
|
313
334
|
# @return [::Array<::String>]
|
314
335
|
# List of top-level fields of the request message, that should be
|
@@ -317,8 +338,8 @@ module Google
|
|
317
338
|
#
|
318
339
|
# Example of a YAML configuration:
|
319
340
|
#
|
320
|
-
#
|
321
|
-
#
|
341
|
+
# publishing:
|
342
|
+
# method_settings:
|
322
343
|
# - selector: google.example.v1.ExampleService.CreateExample
|
323
344
|
# auto_populated_fields:
|
324
345
|
# - request_id
|
@@ -124,8 +124,13 @@ module Google
|
|
124
124
|
# @return [::String]
|
125
125
|
# The plural name used in the resource name and permission names, such as
|
126
126
|
# 'projects' for the resource name of 'projects/\\{project}' and the permission
|
127
|
-
# name of 'cloudresourcemanager.googleapis.com/projects.get'.
|
128
|
-
#
|
127
|
+
# name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
|
128
|
+
# to this is for Nested Collections that have stuttering names, as defined
|
129
|
+
# in [AIP-122](https://google.aip.dev/122#nested-collections), where the
|
130
|
+
# collection ID in the resource name pattern does not necessarily directly
|
131
|
+
# match the `plural` value.
|
132
|
+
#
|
133
|
+
# It is the same concept of the `plural` field in k8s CRD spec
|
129
134
|
# https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
|
130
135
|
#
|
131
136
|
# Note: The plural form is required even for singleton resources. See
|
@@ -81,13 +81,15 @@ module Google
|
|
81
81
|
# A unique identifier for the instance configuration. Values
|
82
82
|
# are of the form
|
83
83
|
# `projects/<project>/instanceConfigs/[a-z][-a-z0-9]*`.
|
84
|
+
#
|
85
|
+
# User instance configuration must start with `custom-`.
|
84
86
|
# @!attribute [rw] display_name
|
85
87
|
# @return [::String]
|
86
88
|
# The name of this instance configuration as it appears in UIs.
|
87
89
|
# @!attribute [r] config_type
|
88
90
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig::Type]
|
89
|
-
# Output only. Whether this instance
|
90
|
-
#
|
91
|
+
# Output only. Whether this instance configuration is a Google-managed or
|
92
|
+
# user-managed configuration.
|
91
93
|
# @!attribute [rw] replicas
|
92
94
|
# @return [::Array<::Google::Cloud::Spanner::Admin::Instance::V1::ReplicaInfo>]
|
93
95
|
# The geographic placement of nodes in this instance configuration and their
|
@@ -128,26 +130,29 @@ module Google
|
|
128
130
|
# @!attribute [rw] etag
|
129
131
|
# @return [::String]
|
130
132
|
# etag is used for optimistic concurrency control as a way
|
131
|
-
# to help prevent simultaneous updates of a instance
|
132
|
-
# each other. It is strongly suggested that systems make use of
|
133
|
-
# the read-modify-write cycle to perform instance
|
134
|
-
# avoid race conditions: An etag is returned in the
|
135
|
-
# instance
|
136
|
-
# to
|
137
|
-
# the same version of the instance
|
138
|
-
# If no etag is provided in the call to update instance
|
139
|
-
# existing instance
|
133
|
+
# to help prevent simultaneous updates of a instance configuration from
|
134
|
+
# overwriting each other. It is strongly suggested that systems make use of
|
135
|
+
# the etag in the read-modify-write cycle to perform instance configuration
|
136
|
+
# updates in order to avoid race conditions: An etag is returned in the
|
137
|
+
# response which contains instance configurations, and systems are expected
|
138
|
+
# to put that etag in the request to update instance configuration to ensure
|
139
|
+
# that their change is applied to the same version of the instance
|
140
|
+
# configuration. If no etag is provided in the call to update the instance
|
141
|
+
# configuration, then the existing instance configuration is overwritten
|
142
|
+
# blindly.
|
140
143
|
# @!attribute [rw] leader_options
|
141
144
|
# @return [::Array<::String>]
|
142
145
|
# Allowed values of the "default_leader" schema option for databases in
|
143
146
|
# instances that use this instance configuration.
|
144
147
|
# @!attribute [r] reconciling
|
145
148
|
# @return [::Boolean]
|
146
|
-
# Output only. If true, the instance
|
147
|
-
# false, there are no ongoing operations for the instance
|
149
|
+
# Output only. If true, the instance configuration is being created or
|
150
|
+
# updated. If false, there are no ongoing operations for the instance
|
151
|
+
# configuration.
|
148
152
|
# @!attribute [r] state
|
149
153
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig::State]
|
150
|
-
# Output only. The current instance
|
154
|
+
# Output only. The current instance configuration state. Applicable only for
|
155
|
+
# `USER_MANAGED` configurations.
|
151
156
|
class InstanceConfig
|
152
157
|
include ::Google::Protobuf::MessageExts
|
153
158
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -173,21 +178,21 @@ module Google
|
|
173
178
|
USER_MANAGED = 2
|
174
179
|
end
|
175
180
|
|
176
|
-
# Indicates the current state of the instance
|
181
|
+
# Indicates the current state of the instance configuration.
|
177
182
|
module State
|
178
183
|
# Not specified.
|
179
184
|
STATE_UNSPECIFIED = 0
|
180
185
|
|
181
|
-
# The instance
|
186
|
+
# The instance configuration is still being created.
|
182
187
|
CREATING = 1
|
183
188
|
|
184
|
-
# The instance
|
185
|
-
# instances.
|
189
|
+
# The instance configuration is fully created and ready to be used to
|
190
|
+
# create instances.
|
186
191
|
READY = 2
|
187
192
|
end
|
188
193
|
end
|
189
194
|
|
190
|
-
# Autoscaling
|
195
|
+
# Autoscaling configuration for an instance.
|
191
196
|
# @!attribute [rw] autoscaling_limits
|
192
197
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::AutoscalingConfig::AutoscalingLimits]
|
193
198
|
# Required. Autoscaling limits for an instance.
|
@@ -334,6 +339,9 @@ module Google
|
|
334
339
|
# @!attribute [r] update_time
|
335
340
|
# @return [::Google::Protobuf::Timestamp]
|
336
341
|
# Output only. The time at which the instance was most recently updated.
|
342
|
+
# @!attribute [rw] edition
|
343
|
+
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::Instance::Edition]
|
344
|
+
# Optional. The `Edition` of the current instance.
|
337
345
|
class Instance
|
338
346
|
include ::Google::Protobuf::MessageExts
|
339
347
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -361,6 +369,22 @@ module Google
|
|
361
369
|
# creating databases.
|
362
370
|
READY = 2
|
363
371
|
end
|
372
|
+
|
373
|
+
# The edition selected for this instance. Different editions provide
|
374
|
+
# different capabilities at different price points.
|
375
|
+
module Edition
|
376
|
+
# Edition not specified.
|
377
|
+
EDITION_UNSPECIFIED = 0
|
378
|
+
|
379
|
+
# Standard edition.
|
380
|
+
STANDARD = 1
|
381
|
+
|
382
|
+
# Enterprise edition.
|
383
|
+
ENTERPRISE = 2
|
384
|
+
|
385
|
+
# Enterprise Plus edition.
|
386
|
+
ENTERPRISE_PLUS = 3
|
387
|
+
end
|
364
388
|
end
|
365
389
|
|
366
390
|
# The request for
|
@@ -415,14 +439,14 @@ module Google
|
|
415
439
|
# [CreateInstanceConfigRequest][InstanceAdmin.CreateInstanceConfigRequest].
|
416
440
|
# @!attribute [rw] parent
|
417
441
|
# @return [::String]
|
418
|
-
# Required. The name of the project in which to create the instance
|
419
|
-
# Values are of the form `projects/<project>`.
|
442
|
+
# Required. The name of the project in which to create the instance
|
443
|
+
# configuration. Values are of the form `projects/<project>`.
|
420
444
|
# @!attribute [rw] instance_config_id
|
421
445
|
# @return [::String]
|
422
|
-
# Required. The ID of the instance
|
423
|
-
# of the form `custom-[-a-z0-9]*[a-z0-9]` and must be between 2 and 64
|
446
|
+
# Required. The ID of the instance configuration to create. Valid identifiers
|
447
|
+
# are of the form `custom-[-a-z0-9]*[a-z0-9]` and must be between 2 and 64
|
424
448
|
# characters in length. The `custom-` prefix is required to avoid name
|
425
|
-
# conflicts with Google
|
449
|
+
# conflicts with Google-managed configurations.
|
426
450
|
# @!attribute [rw] instance_config
|
427
451
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig]
|
428
452
|
# Required. The InstanceConfig proto of the configuration to create.
|
@@ -443,8 +467,9 @@ module Google
|
|
443
467
|
# [UpdateInstanceConfigRequest][InstanceAdmin.UpdateInstanceConfigRequest].
|
444
468
|
# @!attribute [rw] instance_config
|
445
469
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig]
|
446
|
-
# Required. The user instance
|
447
|
-
# instance
|
470
|
+
# Required. The user instance configuration to update, which must always
|
471
|
+
# include the instance configuration name. Otherwise, only fields mentioned
|
472
|
+
# in
|
448
473
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::UpdateInstanceConfigRequest#update_mask update_mask}
|
449
474
|
# need be included. To prevent conflicts of concurrent updates,
|
450
475
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig#reconciling etag} can
|
@@ -476,12 +501,12 @@ module Google
|
|
476
501
|
# @!attribute [rw] etag
|
477
502
|
# @return [::String]
|
478
503
|
# Used for optimistic concurrency control as a way to help prevent
|
479
|
-
# simultaneous deletes of an instance
|
504
|
+
# simultaneous deletes of an instance configuration from overwriting each
|
480
505
|
# other. If not empty, the API
|
481
|
-
# only deletes the instance
|
482
|
-
# status of the requested instance
|
483
|
-
#
|
484
|
-
#
|
506
|
+
# only deletes the instance configuration when the etag provided matches the
|
507
|
+
# current status of the requested instance configuration. Otherwise, deletes
|
508
|
+
# the instance configuration without checking the current status of the
|
509
|
+
# requested instance configuration.
|
485
510
|
# @!attribute [rw] validate_only
|
486
511
|
# @return [::Boolean]
|
487
512
|
# An option to validate, but not actually execute, a request,
|
@@ -495,7 +520,7 @@ module Google
|
|
495
520
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#list_instance_config_operations ListInstanceConfigOperations}.
|
496
521
|
# @!attribute [rw] parent
|
497
522
|
# @return [::String]
|
498
|
-
# Required. The project of the instance
|
523
|
+
# Required. The project of the instance configuration operations.
|
499
524
|
# Values are of the form `projects/<project>`.
|
500
525
|
# @!attribute [rw] filter
|
501
526
|
# @return [::String]
|
@@ -539,7 +564,7 @@ module Google
|
|
539
564
|
# `(error:*)` - Return operations where:
|
540
565
|
# * The operation's metadata type is
|
541
566
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::CreateInstanceConfigMetadata CreateInstanceConfigMetadata}.
|
542
|
-
# * The instance
|
567
|
+
# * The instance configuration name contains "custom-config".
|
543
568
|
# * The operation started before 2021-03-28T14:50:00Z.
|
544
569
|
# * The operation resulted in an error.
|
545
570
|
# @!attribute [rw] page_size
|
@@ -562,9 +587,9 @@ module Google
|
|
562
587
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#list_instance_config_operations ListInstanceConfigOperations}.
|
563
588
|
# @!attribute [rw] operations
|
564
589
|
# @return [::Array<::Google::Longrunning::Operation>]
|
565
|
-
# The list of matching instance
|
590
|
+
# The list of matching instance configuration [long-running
|
566
591
|
# operations][google.longrunning.Operation]. Each operation's name will be
|
567
|
-
# prefixed by the instance
|
592
|
+
# prefixed by the name of the instance configuration. The operation's
|
568
593
|
# {::Google::Longrunning::Operation#metadata metadata} field type
|
569
594
|
# `metadata.type_url` describes the type of the metadata.
|
570
595
|
# @!attribute [rw] next_page_token
|
@@ -772,7 +797,7 @@ module Google
|
|
772
797
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#create_instance_config CreateInstanceConfig}.
|
773
798
|
# @!attribute [rw] instance_config
|
774
799
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig]
|
775
|
-
# The target instance
|
800
|
+
# The target instance configuration end state.
|
776
801
|
# @!attribute [rw] progress
|
777
802
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::OperationProgress]
|
778
803
|
# The progress of the
|
@@ -790,7 +815,7 @@ module Google
|
|
790
815
|
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#update_instance_config UpdateInstanceConfig}.
|
791
816
|
# @!attribute [rw] instance_config
|
792
817
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::InstanceConfig]
|
793
|
-
# The desired instance
|
818
|
+
# The desired instance configuration after updating.
|
794
819
|
# @!attribute [rw] progress
|
795
820
|
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::OperationProgress]
|
796
821
|
# The progress of the
|
@@ -1163,6 +1188,49 @@ module Google
|
|
1163
1188
|
include ::Google::Protobuf::MessageExts
|
1164
1189
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1165
1190
|
end
|
1191
|
+
|
1192
|
+
# The request for
|
1193
|
+
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#move_instance MoveInstance}.
|
1194
|
+
# @!attribute [rw] name
|
1195
|
+
# @return [::String]
|
1196
|
+
# Required. The instance to move.
|
1197
|
+
# Values are of the form `projects/<project>/instances/<instance>`.
|
1198
|
+
# @!attribute [rw] target_config
|
1199
|
+
# @return [::String]
|
1200
|
+
# Required. The target instance configuration where to move the instance.
|
1201
|
+
# Values are of the form `projects/<project>/instanceConfigs/<config>`.
|
1202
|
+
class MoveInstanceRequest
|
1203
|
+
include ::Google::Protobuf::MessageExts
|
1204
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1205
|
+
end
|
1206
|
+
|
1207
|
+
# The response for
|
1208
|
+
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#move_instance MoveInstance}.
|
1209
|
+
class MoveInstanceResponse
|
1210
|
+
include ::Google::Protobuf::MessageExts
|
1211
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1212
|
+
end
|
1213
|
+
|
1214
|
+
# Metadata type for the operation returned by
|
1215
|
+
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#move_instance MoveInstance}.
|
1216
|
+
# @!attribute [rw] target_config
|
1217
|
+
# @return [::String]
|
1218
|
+
# The target instance configuration where to move the instance.
|
1219
|
+
# Values are of the form `projects/<project>/instanceConfigs/<config>`.
|
1220
|
+
# @!attribute [rw] progress
|
1221
|
+
# @return [::Google::Cloud::Spanner::Admin::Instance::V1::OperationProgress]
|
1222
|
+
# The progress of the
|
1223
|
+
# {::Google::Cloud::Spanner::Admin::Instance::V1::InstanceAdmin::Client#move_instance MoveInstance}
|
1224
|
+
# operation.
|
1225
|
+
# {::Google::Cloud::Spanner::Admin::Instance::V1::OperationProgress#progress_percent progress_percent}
|
1226
|
+
# is reset when cancellation is requested.
|
1227
|
+
# @!attribute [rw] cancel_time
|
1228
|
+
# @return [::Google::Protobuf::Timestamp]
|
1229
|
+
# The time at which this operation was cancelled.
|
1230
|
+
class MoveInstanceMetadata
|
1231
|
+
include ::Google::Protobuf::MessageExts
|
1232
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1233
|
+
end
|
1166
1234
|
end
|
1167
1235
|
end
|
1168
1236
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-spanner-admin-instance-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.1.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2024-
|
11
|
+
date: 2024-08-30 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|