google-cloud-spanner-admin-instance-v1 1.0.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +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
|