google-cloud-spanner 1.8.0 → 1.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (39) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +9 -1
  3. data/lib/google/cloud/spanner/admin/database/v1/database_admin_client.rb +12 -9
  4. data/lib/google/cloud/spanner/admin/database/v1/doc/google/rpc/status.rb +17 -14
  5. data/lib/google/cloud/spanner/admin/database/v1/doc/google/spanner/admin/database/v1/spanner_database_admin.rb +29 -19
  6. data/lib/google/cloud/spanner/admin/instance/v1/doc/google/rpc/status.rb +17 -14
  7. data/lib/google/cloud/spanner/admin/instance/v1/doc/google/spanner/admin/instance/v1/spanner_instance_admin.rb +44 -28
  8. data/lib/google/cloud/spanner/admin/instance/v1/instance_admin_client.rb +12 -8
  9. data/lib/google/cloud/spanner/batch_client.rb +1 -1
  10. data/lib/google/cloud/spanner/batch_update.rb +168 -0
  11. data/lib/google/cloud/spanner/client.rb +3 -3
  12. data/lib/google/cloud/spanner/commit.rb +4 -4
  13. data/lib/google/cloud/spanner/database/list.rb +1 -1
  14. data/lib/google/cloud/spanner/errors.rb +27 -0
  15. data/lib/google/cloud/spanner/fields.rb +1 -1
  16. data/lib/google/cloud/spanner/instance/config/list.rb +1 -1
  17. data/lib/google/cloud/spanner/instance/list.rb +1 -1
  18. data/lib/google/cloud/spanner/partition.rb +2 -2
  19. data/lib/google/cloud/spanner/pool.rb +1 -1
  20. data/lib/google/cloud/spanner/service.rb +22 -1
  21. data/lib/google/cloud/spanner/session.rb +38 -1
  22. data/lib/google/cloud/spanner/transaction.rb +65 -1
  23. data/lib/google/cloud/spanner/v1/doc/google/protobuf/any.rb +130 -0
  24. data/lib/google/cloud/spanner/v1/doc/google/rpc/status.rb +87 -0
  25. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/keys.rb +4 -3
  26. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/mutation.rb +24 -17
  27. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/query_plan.rb +21 -18
  28. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/result_set.rb +23 -19
  29. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/spanner.rb +147 -35
  30. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/transaction.rb +14 -6
  31. data/lib/google/cloud/spanner/v1/doc/google/spanner/v1/type.rb +13 -9
  32. data/lib/google/cloud/spanner/v1/spanner_client.rb +209 -82
  33. data/lib/google/cloud/spanner/v1/spanner_client_config.json +5 -0
  34. data/lib/google/cloud/spanner/version.rb +1 -1
  35. data/lib/google/spanner/admin/database/v1/spanner_database_admin_services_pb.rb +4 -3
  36. data/lib/google/spanner/admin/instance/v1/spanner_instance_admin_services_pb.rb +3 -3
  37. data/lib/google/spanner/v1/spanner_pb.rb +19 -0
  38. data/lib/google/spanner/v1/spanner_services_pb.rb +58 -28
  39. metadata +7 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9cdc8609a61a6ce46864733a2c198de769dd2f3beda97aafc6d9b773a50a5ea2
4
- data.tar.gz: c53ef071e5d935771a703c1fea673f061244d78a9d944947d710b9a4331c0893
3
+ metadata.gz: e5c589e7b5b2fab89d1674e002e9db6f7ce100aa97b0f7490955757437040618
4
+ data.tar.gz: d3cf3ff3735eec3ecef646c8f31af7a09bc373a083e1ffa4bff82aa4ec4f2083
5
5
  SHA512:
6
- metadata.gz: c71857ed1ccaef1df8e6371614819a0b83692e3479c48db6f8513604498fd3e301253ecc75a94bc522810364def32ceb75685c1e8b738b4e6dad2869cd308a3f
7
- data.tar.gz: 499025a401168ebd81e4e557a1be5c958d2e3bebf987af38689bf82728dbab552fa207535ca6e539434277f62eaf93cdc08b0f19958d1a4ed440ce3f5eb65342
6
+ metadata.gz: fcb394cbded603e3fb52dbc2e606d66478111432f1b23271c12cbe445436af800762f5e79eeb2fe3a728a64d56260b0473d1811fdaca4c99c330c52839636a92
7
+ data.tar.gz: 3700d8c37a6062e37b90213c3961958e58141b9cf2026a3a53b1f73d59681ac4416058a8fc02362602a1b75c3a6e0f687d664e33601fff004596a0fdce0bcf9e
@@ -1,5 +1,13 @@
1
1
  # Release History
2
2
 
3
+ ### 1.9.0 / 2019-03-08
4
+
5
+ * Spanner Batch DML.
6
+ * Add Transaction#batch_update.
7
+ * Add BatchUpdate.
8
+ * Add BatchUpdateError.
9
+ * Add SpannerClient#execute_batch_dml.
10
+
3
11
  ### 1.8.0 / 2019-02-01
4
12
 
5
13
  * Make use of Credentials#project_id
@@ -8,7 +16,7 @@
8
16
  This value was added in googleauth 0.7.0.
9
17
  * Loosen googleauth dependency
10
18
  Allow for new releases up to 0.10.
11
- The googleauth devs have committed to maintanining the current API
19
+ The googleauth devs have committed to maintaining the current API
12
20
  and will not make backwards compatible changes before 0.10.
13
21
  * Performance improvements for Data#to_h
14
22
  * Add Data skip_dup_check optional arg
@@ -338,8 +338,8 @@ module Google
338
338
  # have a name of the format `<database_name>/operations/<operation_id>` and
339
339
  # can be used to track preparation of the database. The
340
340
  # {Google::Longrunning::Operation#metadata metadata} field type is
341
- # {Google::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}. The
342
- # {Google::Longrunning::Operation#response response} field type is
341
+ # {Google::Spanner::Admin::Database::V1::CreateDatabaseMetadata CreateDatabaseMetadata}.
342
+ # The {Google::Longrunning::Operation#response response} field type is
343
343
  # {Google::Spanner::Admin::Database::V1::Database Database}, if successful.
344
344
  #
345
345
  # @param parent [String]
@@ -456,7 +456,8 @@ module Google
456
456
  # the format `<database_name>/operations/<operation_id>` and can be used to
457
457
  # track execution of the schema change(s). The
458
458
  # {Google::Longrunning::Operation#metadata metadata} field type is
459
- # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}. The operation has no response.
459
+ # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlMetadata UpdateDatabaseDdlMetadata}.
460
+ # The operation has no response.
460
461
  #
461
462
  # @param database [String]
462
463
  # Required. The database to update.
@@ -470,18 +471,20 @@ module Google
470
471
  #
471
472
  # Specifying an explicit operation ID simplifies determining
472
473
  # whether the statements were executed in the event that the
473
- # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} call is replayed,
474
- # or the return value is otherwise lost: the {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database} and
475
- # `operation_id` fields can be combined to form the
474
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl}
475
+ # call is replayed, or the return value is otherwise lost: the
476
+ # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database}
477
+ # and `operation_id` fields can be combined to form the
476
478
  # {Google::Longrunning::Operation#name name} of the resulting
477
- # {Google::Longrunning::Operation longrunning::Operation}: `<database>/operations/<operation_id>`.
479
+ # {Google::Longrunning::Operation longrunning::Operation}:
480
+ # `<database>/operations/<operation_id>`.
478
481
  #
479
482
  # `operation_id` should be unique within the database, and must be
480
483
  # a valid identifier: `[a-z][a-z0-9_]*`. Note that
481
484
  # automatically-generated operation IDs always begin with an
482
485
  # underscore. If the named operation already exists,
483
- # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} returns
484
- # `ALREADY_EXISTS`.
486
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl}
487
+ # returns `ALREADY_EXISTS`.
485
488
  # @param options [Google::Gax::CallOptions]
486
489
  # Overrides the default settings for this call, e.g, timeout,
487
490
  # retries, etc.
@@ -15,24 +15,25 @@
15
15
 
16
16
  module Google
17
17
  module Rpc
18
- # The `Status` type defines a logical error model that is suitable for different
19
- # programming environments, including REST APIs and RPC APIs. It is used by
20
- # [gRPC](https://github.com/grpc). The error model is designed to be:
18
+ # The `Status` type defines a logical error model that is suitable for
19
+ # different programming environments, including REST APIs and RPC APIs. It is
20
+ # used by [gRPC](https://github.com/grpc). The error model is designed to be:
21
21
  #
22
22
  # * Simple to use and understand for most users
23
23
  # * Flexible enough to meet unexpected needs
24
24
  #
25
25
  # = Overview
26
26
  #
27
- # The `Status` message contains three pieces of data: error code, error message,
28
- # and error details. The error code should be an enum value of
29
- # {Google::Rpc::Code}, but it may accept additional error codes if needed. The
30
- # error message should be a developer-facing English message that helps
31
- # developers *understand* and *resolve* the error. If a localized user-facing
32
- # error message is needed, put the localized message in the error details or
33
- # localize it in the client. The optional error details may contain arbitrary
34
- # information about the error. There is a predefined set of error detail types
35
- # in the package `google.rpc` that can be used for common error conditions.
27
+ # The `Status` message contains three pieces of data: error code, error
28
+ # message, and error details. The error code should be an enum value of
29
+ # {Google::Rpc::Code}, but it may accept additional error codes
30
+ # if needed. The error message should be a developer-facing English message
31
+ # that helps developers *understand* and *resolve* the error. If a localized
32
+ # user-facing error message is needed, put the localized message in the error
33
+ # details or localize it in the client. The optional error details may contain
34
+ # arbitrary information about the error. There is a predefined set of error
35
+ # detail types in the package `google.rpc` that can be used for common error
36
+ # conditions.
36
37
  #
37
38
  # = Language mapping
38
39
  #
@@ -69,12 +70,14 @@ module Google
69
70
  # be used directly after any stripping needed for security/privacy reasons.
70
71
  # @!attribute [rw] code
71
72
  # @return [Integer]
72
- # The status code, which should be an enum value of {Google::Rpc::Code}.
73
+ # The status code, which should be an enum value of
74
+ # {Google::Rpc::Code}.
73
75
  # @!attribute [rw] message
74
76
  # @return [String]
75
77
  # A developer-facing error message, which should be in English. Any
76
78
  # user-facing error message should be localized and sent in the
77
- # {Google::Rpc::Status#details} field, or localized by the client.
79
+ # {Google::Rpc::Status#details} field, or localized
80
+ # by the client.
78
81
  # @!attribute [rw] details
79
82
  # @return [Array<Google::Protobuf::Any>]
80
83
  # A list of messages that carry the error details. There is a common set of
@@ -44,7 +44,8 @@ module Google
44
44
  end
45
45
  end
46
46
 
47
- # The request for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::ListDatabases ListDatabases}.
47
+ # The request for
48
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::ListDatabases ListDatabases}.
48
49
  # @!attribute [rw] parent
49
50
  # @return [String]
50
51
  # Required. The instance whose databases should be listed.
@@ -56,22 +57,25 @@ module Google
56
57
  # @!attribute [rw] page_token
57
58
  # @return [String]
58
59
  # If non-empty, `page_token` should contain a
59
- # {Google::Spanner::Admin::Database::V1::ListDatabasesResponse#next_page_token next_page_token} from a
60
- # previous {Google::Spanner::Admin::Database::V1::ListDatabasesResponse ListDatabasesResponse}.
60
+ # {Google::Spanner::Admin::Database::V1::ListDatabasesResponse#next_page_token next_page_token}
61
+ # from a previous
62
+ # {Google::Spanner::Admin::Database::V1::ListDatabasesResponse ListDatabasesResponse}.
61
63
  class ListDatabasesRequest; end
62
64
 
63
- # The response for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::ListDatabases ListDatabases}.
65
+ # The response for
66
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::ListDatabases ListDatabases}.
64
67
  # @!attribute [rw] databases
65
68
  # @return [Array<Google::Spanner::Admin::Database::V1::Database>]
66
69
  # Databases that matched the request.
67
70
  # @!attribute [rw] next_page_token
68
71
  # @return [String]
69
72
  # `next_page_token` can be sent in a subsequent
70
- # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::ListDatabases ListDatabases} call to fetch more
71
- # of the matching databases.
73
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::ListDatabases ListDatabases}
74
+ # call to fetch more of the matching databases.
72
75
  class ListDatabasesResponse; end
73
76
 
74
- # The request for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::CreateDatabase CreateDatabase}.
77
+ # The request for
78
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::CreateDatabase CreateDatabase}.
75
79
  # @!attribute [rw] parent
76
80
  # @return [String]
77
81
  # Required. The name of the instance that will serve the new database.
@@ -98,7 +102,8 @@ module Google
98
102
  # The database being created.
99
103
  class CreateDatabaseMetadata; end
100
104
 
101
- # The request for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::GetDatabase GetDatabase}.
105
+ # The request for
106
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::GetDatabase GetDatabase}.
102
107
  # @!attribute [rw] name
103
108
  # @return [String]
104
109
  # Required. The name of the requested database. Values are of the form
@@ -119,8 +124,8 @@ module Google
119
124
  # Each batch of statements is assigned a name which can be used with
120
125
  # the {Google::Longrunning::Operations Operations} API to monitor
121
126
  # progress. See the
122
- # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#operation_id operation_id} field for more
123
- # details.
127
+ # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#operation_id operation_id}
128
+ # field for more details.
124
129
  # @!attribute [rw] database
125
130
  # @return [String]
126
131
  # Required. The database to update.
@@ -136,18 +141,20 @@ module Google
136
141
  #
137
142
  # Specifying an explicit operation ID simplifies determining
138
143
  # whether the statements were executed in the event that the
139
- # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} call is replayed,
140
- # or the return value is otherwise lost: the {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database} and
141
- # `operation_id` fields can be combined to form the
144
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl}
145
+ # call is replayed, or the return value is otherwise lost: the
146
+ # {Google::Spanner::Admin::Database::V1::UpdateDatabaseDdlRequest#database database}
147
+ # and `operation_id` fields can be combined to form the
142
148
  # {Google::Longrunning::Operation#name name} of the resulting
143
- # {Google::Longrunning::Operation longrunning::Operation}: `<database>/operations/<operation_id>`.
149
+ # {Google::Longrunning::Operation longrunning::Operation}:
150
+ # `<database>/operations/<operation_id>`.
144
151
  #
145
152
  # `operation_id` should be unique within the database, and must be
146
153
  # a valid identifier: `[a-z][a-z0-9_]*`. Note that
147
154
  # automatically-generated operation IDs always begin with an
148
155
  # underscore. If the named operation already exists,
149
- # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl} returns
150
- # `ALREADY_EXISTS`.
156
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::UpdateDatabaseDdl UpdateDatabaseDdl}
157
+ # returns `ALREADY_EXISTS`.
151
158
  class UpdateDatabaseDdlRequest; end
152
159
 
153
160
  # Metadata type for the operation returned by
@@ -166,19 +173,22 @@ module Google
166
173
  # timestamp for the statement `statements[i]`.
167
174
  class UpdateDatabaseDdlMetadata; end
168
175
 
169
- # The request for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::DropDatabase DropDatabase}.
176
+ # The request for
177
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::DropDatabase DropDatabase}.
170
178
  # @!attribute [rw] database
171
179
  # @return [String]
172
180
  # Required. The database to be dropped.
173
181
  class DropDatabaseRequest; end
174
182
 
175
- # The request for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::GetDatabaseDdl GetDatabaseDdl}.
183
+ # The request for
184
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::GetDatabaseDdl GetDatabaseDdl}.
176
185
  # @!attribute [rw] database
177
186
  # @return [String]
178
187
  # Required. The database whose schema we wish to get.
179
188
  class GetDatabaseDdlRequest; end
180
189
 
181
- # The response for {Google::Spanner::Admin::Database::V1::DatabaseAdmin::GetDatabaseDdl GetDatabaseDdl}.
190
+ # The response for
191
+ # {Google::Spanner::Admin::Database::V1::DatabaseAdmin::GetDatabaseDdl GetDatabaseDdl}.
182
192
  # @!attribute [rw] statements
183
193
  # @return [Array<String>]
184
194
  # A list of formatted DDL statements defining the schema of the database
@@ -15,24 +15,25 @@
15
15
 
16
16
  module Google
17
17
  module Rpc
18
- # The `Status` type defines a logical error model that is suitable for different
19
- # programming environments, including REST APIs and RPC APIs. It is used by
20
- # [gRPC](https://github.com/grpc). The error model is designed to be:
18
+ # The `Status` type defines a logical error model that is suitable for
19
+ # different programming environments, including REST APIs and RPC APIs. It is
20
+ # used by [gRPC](https://github.com/grpc). The error model is designed to be:
21
21
  #
22
22
  # * Simple to use and understand for most users
23
23
  # * Flexible enough to meet unexpected needs
24
24
  #
25
25
  # = Overview
26
26
  #
27
- # The `Status` message contains three pieces of data: error code, error message,
28
- # and error details. The error code should be an enum value of
29
- # {Google::Rpc::Code}, but it may accept additional error codes if needed. The
30
- # error message should be a developer-facing English message that helps
31
- # developers *understand* and *resolve* the error. If a localized user-facing
32
- # error message is needed, put the localized message in the error details or
33
- # localize it in the client. The optional error details may contain arbitrary
34
- # information about the error. There is a predefined set of error detail types
35
- # in the package `google.rpc` that can be used for common error conditions.
27
+ # The `Status` message contains three pieces of data: error code, error
28
+ # message, and error details. The error code should be an enum value of
29
+ # {Google::Rpc::Code}, but it may accept additional error codes
30
+ # if needed. The error message should be a developer-facing English message
31
+ # that helps developers *understand* and *resolve* the error. If a localized
32
+ # user-facing error message is needed, put the localized message in the error
33
+ # details or localize it in the client. The optional error details may contain
34
+ # arbitrary information about the error. There is a predefined set of error
35
+ # detail types in the package `google.rpc` that can be used for common error
36
+ # conditions.
36
37
  #
37
38
  # = Language mapping
38
39
  #
@@ -69,12 +70,14 @@ module Google
69
70
  # be used directly after any stripping needed for security/privacy reasons.
70
71
  # @!attribute [rw] code
71
72
  # @return [Integer]
72
- # The status code, which should be an enum value of {Google::Rpc::Code}.
73
+ # The status code, which should be an enum value of
74
+ # {Google::Rpc::Code}.
73
75
  # @!attribute [rw] message
74
76
  # @return [String]
75
77
  # A developer-facing error message, which should be in English. Any
76
78
  # user-facing error message should be localized and sent in the
77
- # {Google::Rpc::Status#details} field, or localized by the client.
79
+ # {Google::Rpc::Status#details} field, or localized
80
+ # by the client.
78
81
  # @!attribute [rw] details
79
82
  # @return [Array<Google::Protobuf::Any>]
80
83
  # A list of messages that carry the error details. There is a common set of
@@ -52,15 +52,16 @@ module Google
52
52
  # Required. The number of nodes allocated to this instance. This may be zero
53
53
  # in API responses for instances that are not yet in state `READY`.
54
54
  #
55
- # See [the documentation](https://cloud.google.com/spanner/docs/instances#node_count)
55
+ # See [the
56
+ # documentation](https://cloud.google.com/spanner/docs/instances#node_count)
56
57
  # for more information about nodes.
57
58
  # @!attribute [rw] state
58
59
  # @return [Google::Spanner::Admin::Instance::V1::Instance::State]
59
60
  # Output only. The current instance state. For
60
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}, the state must be
61
- # either omitted or set to `CREATING`. For
62
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}, the state must be
63
- # either omitted or set to `READY`.
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`.
64
65
  # @!attribute [rw] labels
65
66
  # @return [Hash{String => String}]
66
67
  # Cloud Labels are a flexible and lightweight mechanism for organizing cloud
@@ -101,7 +102,8 @@ module Google
101
102
  end
102
103
  end
103
104
 
104
- # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
105
+ # The request for
106
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
105
107
  # @!attribute [rw] parent
106
108
  # @return [String]
107
109
  # Required. The name of the project for which a list of supported instance
@@ -115,18 +117,20 @@ module Google
115
117
  # @return [String]
116
118
  # If non-empty, `page_token` should contain a
117
119
  # {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse#next_page_token next_page_token}
118
- # from a previous {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse ListInstanceConfigsResponse}.
120
+ # from a previous
121
+ # {Google::Spanner::Admin::Instance::V1::ListInstanceConfigsResponse ListInstanceConfigsResponse}.
119
122
  class ListInstanceConfigsRequest; end
120
123
 
121
- # The response for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
124
+ # The response for
125
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}.
122
126
  # @!attribute [rw] instance_configs
123
127
  # @return [Array<Google::Spanner::Admin::Instance::V1::InstanceConfig>]
124
128
  # The list of requested instance configurations.
125
129
  # @!attribute [rw] next_page_token
126
130
  # @return [String]
127
131
  # `next_page_token` can be sent in a subsequent
128
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs} call to
129
- # fetch more of the matching instance configurations.
132
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstanceConfigs ListInstanceConfigs}
133
+ # call to fetch more of the matching instance configurations.
130
134
  class ListInstanceConfigsResponse; end
131
135
 
132
136
  # The request for
@@ -137,14 +141,16 @@ module Google
137
141
  # the form `projects/<project>/instanceConfigs/<config>`.
138
142
  class GetInstanceConfigRequest; end
139
143
 
140
- # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::GetInstance GetInstance}.
144
+ # The request for
145
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::GetInstance GetInstance}.
141
146
  # @!attribute [rw] name
142
147
  # @return [String]
143
148
  # Required. The name of the requested instance. Values are of the form
144
149
  # `projects/<project>/instances/<instance>`.
145
150
  class GetInstanceRequest; end
146
151
 
147
- # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}.
152
+ # The request for
153
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}.
148
154
  # @!attribute [rw] parent
149
155
  # @return [String]
150
156
  # Required. The name of the project in which to create the instance. Values
@@ -160,7 +166,8 @@ module Google
160
166
  # specified must be `<parent>/instances/<instance_id>`.
161
167
  class CreateInstanceRequest; end
162
168
 
163
- # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
169
+ # The request for
170
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
164
171
  # @!attribute [rw] parent
165
172
  # @return [String]
166
173
  # Required. The name of the project for which a list of instances is
@@ -172,8 +179,9 @@ module Google
172
179
  # @!attribute [rw] page_token
173
180
  # @return [String]
174
181
  # If non-empty, `page_token` should contain a
175
- # {Google::Spanner::Admin::Instance::V1::ListInstancesResponse#next_page_token next_page_token} from a
176
- # previous {Google::Spanner::Admin::Instance::V1::ListInstancesResponse ListInstancesResponse}.
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}.
177
185
  # @!attribute [rw] filter
178
186
  # @return [String]
179
187
  # An expression for filtering the results of the request. Filter rules are
@@ -197,31 +205,38 @@ module Google
197
205
  # containing "dev".
198
206
  class ListInstancesRequest; end
199
207
 
200
- # The response for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
208
+ # The response for
209
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}.
201
210
  # @!attribute [rw] instances
202
211
  # @return [Array<Google::Spanner::Admin::Instance::V1::Instance>]
203
212
  # The list of requested instances.
204
213
  # @!attribute [rw] next_page_token
205
214
  # @return [String]
206
215
  # `next_page_token` can be sent in a subsequent
207
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances} call to fetch more
208
- # of the matching instances.
216
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::ListInstances ListInstances}
217
+ # call to fetch more of the matching instances.
209
218
  class ListInstancesResponse; end
210
219
 
211
- # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}.
220
+ # The request for
221
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}.
212
222
  # @!attribute [rw] instance
213
223
  # @return [Google::Spanner::Admin::Instance::V1::Instance]
214
224
  # Required. The instance to update, which must always include the instance
215
- # name. Otherwise, only fields mentioned in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
225
+ # name. Otherwise, only fields mentioned in
226
+ # [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need
227
+ # be included.
216
228
  # @!attribute [rw] field_mask
217
229
  # @return [Google::Protobuf::FieldMask]
218
- # Required. A mask specifying which fields in [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated.
219
- # The field mask must always be specified; this prevents any future fields in
220
- # [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know
221
- # about them.
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.
222
236
  class UpdateInstanceRequest; end
223
237
 
224
- # The request for {Google::Spanner::Admin::Instance::V1::InstanceAdmin::DeleteInstance DeleteInstance}.
238
+ # The request for
239
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::DeleteInstance DeleteInstance}.
225
240
  # @!attribute [rw] name
226
241
  # @return [String]
227
242
  # Required. The name of the instance to be deleted. Values are of the form
@@ -236,8 +251,8 @@ module Google
236
251
  # @!attribute [rw] start_time
237
252
  # @return [Google::Protobuf::Timestamp]
238
253
  # The time at which the
239
- # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance} request was
240
- # received.
254
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::CreateInstance CreateInstance}
255
+ # request was received.
241
256
  # @!attribute [rw] cancel_time
242
257
  # @return [Google::Protobuf::Timestamp]
243
258
  # The time at which this operation was cancelled. If set, this operation is
@@ -255,7 +270,8 @@ module Google
255
270
  # The desired end state of the update.
256
271
  # @!attribute [rw] start_time
257
272
  # @return [Google::Protobuf::Timestamp]
258
- # The time at which {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}
273
+ # The time at which
274
+ # {Google::Spanner::Admin::Instance::V1::InstanceAdmin::UpdateInstance UpdateInstance}
259
275
  # request was received.
260
276
  # @!attribute [rw] cancel_time
261
277
  # @return [Google::Protobuf::Timestamp]