google-cloud-metastore-v1 0.1.0 → 0.2.0
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/AUTHENTICATION.md +8 -8
- data/README.md +1 -1
- data/lib/google/cloud/metastore/v1/dataproc_metastore.rb +2 -2
- data/lib/google/cloud/metastore/v1/dataproc_metastore/client.rb +536 -51
- data/lib/google/cloud/metastore/v1/dataproc_metastore/operations.rb +34 -25
- data/lib/google/cloud/metastore/v1/dataproc_metastore/paths.rb +21 -0
- data/lib/google/cloud/metastore/v1/metastore_pb.rb +82 -0
- data/lib/google/cloud/metastore/v1/metastore_services_pb.rb +12 -2
- data/lib/google/cloud/metastore/v1/version.rb +1 -1
- data/proto_docs/google/api/field_behavior.rb +7 -1
- data/proto_docs/google/cloud/metastore/v1/metastore.rb +280 -1
- data/proto_docs/google/type/dayofweek.rb +9 -9
- metadata +13 -7
@@ -82,7 +82,7 @@ module Google
|
|
82
82
|
# Create credentials
|
83
83
|
credentials = @config.credentials
|
84
84
|
credentials ||= Credentials.default scope: @config.scope
|
85
|
-
if credentials.is_a?(String) || credentials.is_a?(Hash)
|
85
|
+
if credentials.is_a?(::String) || credentials.is_a?(::Hash)
|
86
86
|
credentials = Credentials.new credentials, scope: @config.scope
|
87
87
|
end
|
88
88
|
@quota_project_id = @config.quota_project
|
@@ -169,7 +169,9 @@ module Google
|
|
169
169
|
options.apply_defaults timeout: @config.rpcs.list_operations.timeout,
|
170
170
|
metadata: metadata,
|
171
171
|
retry_policy: @config.rpcs.list_operations.retry_policy
|
172
|
-
|
172
|
+
|
173
|
+
options.apply_defaults timeout: @config.timeout,
|
174
|
+
metadata: @config.metadata,
|
173
175
|
retry_policy: @config.retry_policy
|
174
176
|
|
175
177
|
@operations_stub.call_rpc :list_operations, request, options: options do |response, operation|
|
@@ -239,7 +241,9 @@ module Google
|
|
239
241
|
options.apply_defaults timeout: @config.rpcs.get_operation.timeout,
|
240
242
|
metadata: metadata,
|
241
243
|
retry_policy: @config.rpcs.get_operation.retry_policy
|
242
|
-
|
244
|
+
|
245
|
+
options.apply_defaults timeout: @config.timeout,
|
246
|
+
metadata: @config.metadata,
|
243
247
|
retry_policy: @config.retry_policy
|
244
248
|
|
245
249
|
@operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
|
@@ -309,7 +313,9 @@ module Google
|
|
309
313
|
options.apply_defaults timeout: @config.rpcs.delete_operation.timeout,
|
310
314
|
metadata: metadata,
|
311
315
|
retry_policy: @config.rpcs.delete_operation.retry_policy
|
312
|
-
|
316
|
+
|
317
|
+
options.apply_defaults timeout: @config.timeout,
|
318
|
+
metadata: @config.metadata,
|
313
319
|
retry_policy: @config.retry_policy
|
314
320
|
|
315
321
|
@operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
|
@@ -384,7 +390,9 @@ module Google
|
|
384
390
|
options.apply_defaults timeout: @config.rpcs.cancel_operation.timeout,
|
385
391
|
metadata: metadata,
|
386
392
|
retry_policy: @config.rpcs.cancel_operation.retry_policy
|
387
|
-
|
393
|
+
|
394
|
+
options.apply_defaults timeout: @config.timeout,
|
395
|
+
metadata: @config.metadata,
|
388
396
|
retry_policy: @config.retry_policy
|
389
397
|
|
390
398
|
@operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
|
@@ -396,9 +404,9 @@ module Google
|
|
396
404
|
end
|
397
405
|
|
398
406
|
##
|
399
|
-
# Waits
|
400
|
-
#
|
401
|
-
#
|
407
|
+
# Waits until the specified long-running operation is done or reaches at most
|
408
|
+
# a specified timeout, returning the latest state. If the operation is
|
409
|
+
# already done, the latest state is immediately returned. If the timeout
|
402
410
|
# specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
|
403
411
|
# timeout is used. If the server does not support this method, it returns
|
404
412
|
# `google.rpc.Code.UNIMPLEMENTED`.
|
@@ -456,7 +464,9 @@ module Google
|
|
456
464
|
options.apply_defaults timeout: @config.rpcs.wait_operation.timeout,
|
457
465
|
metadata: metadata,
|
458
466
|
retry_policy: @config.rpcs.wait_operation.retry_policy
|
459
|
-
|
467
|
+
|
468
|
+
options.apply_defaults timeout: @config.timeout,
|
469
|
+
metadata: @config.metadata,
|
460
470
|
retry_policy: @config.retry_policy
|
461
471
|
|
462
472
|
@operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
|
@@ -481,22 +491,21 @@ module Google
|
|
481
491
|
# Configuration can be applied globally to all clients, or to a single client
|
482
492
|
# on construction.
|
483
493
|
#
|
484
|
-
#
|
485
|
-
#
|
486
|
-
#
|
487
|
-
# to 20 seconds,
|
488
|
-
#
|
489
|
-
#
|
490
|
-
#
|
491
|
-
#
|
492
|
-
#
|
493
|
-
#
|
494
|
-
#
|
495
|
-
#
|
496
|
-
#
|
497
|
-
#
|
498
|
-
#
|
499
|
-
# end
|
494
|
+
# @example
|
495
|
+
#
|
496
|
+
# # Modify the global config, setting the timeout for
|
497
|
+
# # list_operations to 20 seconds,
|
498
|
+
# # and all remaining timeouts to 10 seconds.
|
499
|
+
# ::Google::Longrunning::Operations::Client.configure do |config|
|
500
|
+
# config.timeout = 10.0
|
501
|
+
# config.rpcs.list_operations.timeout = 20.0
|
502
|
+
# end
|
503
|
+
#
|
504
|
+
# # Apply the above configuration only to a new client.
|
505
|
+
# client = ::Google::Longrunning::Operations::Client.new do |config|
|
506
|
+
# config.timeout = 10.0
|
507
|
+
# config.rpcs.list_operations.timeout = 20.0
|
508
|
+
# end
|
500
509
|
#
|
501
510
|
# @!attribute [rw] endpoint
|
502
511
|
# The hostname or hostname:port of the service endpoint.
|
@@ -24,6 +24,27 @@ module Google
|
|
24
24
|
module DataprocMetastore
|
25
25
|
# Path helper methods for the DataprocMetastore API.
|
26
26
|
module Paths
|
27
|
+
##
|
28
|
+
# Create a fully-qualified Backup resource string.
|
29
|
+
#
|
30
|
+
# The resource will be in the following format:
|
31
|
+
#
|
32
|
+
# `projects/{project}/locations/{location}/services/{service}/backups/{backup}`
|
33
|
+
#
|
34
|
+
# @param project [String]
|
35
|
+
# @param location [String]
|
36
|
+
# @param service [String]
|
37
|
+
# @param backup [String]
|
38
|
+
#
|
39
|
+
# @return [::String]
|
40
|
+
def backup_path project:, location:, service:, backup:
|
41
|
+
raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
|
42
|
+
raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
|
43
|
+
raise ::ArgumentError, "service cannot contain /" if service.to_s.include? "/"
|
44
|
+
|
45
|
+
"projects/#{project}/locations/#{location}/services/#{service}/backups/#{backup}"
|
46
|
+
end
|
47
|
+
|
27
48
|
##
|
28
49
|
# Create a fully-qualified Location resource string.
|
29
50
|
#
|
@@ -75,12 +75,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
75
75
|
end
|
76
76
|
add_message "google.cloud.metastore.v1.MetadataManagementActivity" do
|
77
77
|
repeated :metadata_exports, :message, 1, "google.cloud.metastore.v1.MetadataExport"
|
78
|
+
repeated :restores, :message, 2, "google.cloud.metastore.v1.Restore"
|
78
79
|
end
|
79
80
|
add_message "google.cloud.metastore.v1.MetadataImport" do
|
80
81
|
optional :name, :string, 1
|
81
82
|
optional :description, :string, 2
|
82
83
|
optional :create_time, :message, 3, "google.protobuf.Timestamp"
|
83
84
|
optional :update_time, :message, 4, "google.protobuf.Timestamp"
|
85
|
+
optional :end_time, :message, 7, "google.protobuf.Timestamp"
|
84
86
|
optional :state, :enum, 5, "google.cloud.metastore.v1.MetadataImport.State"
|
85
87
|
oneof :metadata do
|
86
88
|
optional :database_dump, :message, 6, "google.cloud.metastore.v1.MetadataImport.DatabaseDump"
|
@@ -118,6 +120,43 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
118
120
|
value :FAILED, 3
|
119
121
|
value :CANCELLED, 4
|
120
122
|
end
|
123
|
+
add_message "google.cloud.metastore.v1.Backup" do
|
124
|
+
optional :name, :string, 1
|
125
|
+
optional :create_time, :message, 2, "google.protobuf.Timestamp"
|
126
|
+
optional :end_time, :message, 3, "google.protobuf.Timestamp"
|
127
|
+
optional :state, :enum, 4, "google.cloud.metastore.v1.Backup.State"
|
128
|
+
optional :service_revision, :message, 5, "google.cloud.metastore.v1.Service"
|
129
|
+
optional :description, :string, 6
|
130
|
+
repeated :restoring_services, :string, 7
|
131
|
+
end
|
132
|
+
add_enum "google.cloud.metastore.v1.Backup.State" do
|
133
|
+
value :STATE_UNSPECIFIED, 0
|
134
|
+
value :CREATING, 1
|
135
|
+
value :DELETING, 2
|
136
|
+
value :ACTIVE, 3
|
137
|
+
value :FAILED, 4
|
138
|
+
value :RESTORING, 5
|
139
|
+
end
|
140
|
+
add_message "google.cloud.metastore.v1.Restore" do
|
141
|
+
optional :start_time, :message, 1, "google.protobuf.Timestamp"
|
142
|
+
optional :end_time, :message, 2, "google.protobuf.Timestamp"
|
143
|
+
optional :state, :enum, 3, "google.cloud.metastore.v1.Restore.State"
|
144
|
+
optional :backup, :string, 4
|
145
|
+
optional :type, :enum, 5, "google.cloud.metastore.v1.Restore.RestoreType"
|
146
|
+
optional :details, :string, 6
|
147
|
+
end
|
148
|
+
add_enum "google.cloud.metastore.v1.Restore.State" do
|
149
|
+
value :STATE_UNSPECIFIED, 0
|
150
|
+
value :RUNNING, 1
|
151
|
+
value :SUCCEEDED, 2
|
152
|
+
value :FAILED, 3
|
153
|
+
value :CANCELLED, 4
|
154
|
+
end
|
155
|
+
add_enum "google.cloud.metastore.v1.Restore.RestoreType" do
|
156
|
+
value :RESTORE_TYPE_UNSPECIFIED, 0
|
157
|
+
value :FULL, 1
|
158
|
+
value :METADATA_ONLY, 2
|
159
|
+
end
|
121
160
|
add_message "google.cloud.metastore.v1.ListServicesRequest" do
|
122
161
|
optional :parent, :string, 1
|
123
162
|
optional :page_size, :int32, 2
|
@@ -174,6 +213,31 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
174
213
|
optional :metadata_import, :message, 2, "google.cloud.metastore.v1.MetadataImport"
|
175
214
|
optional :request_id, :string, 3
|
176
215
|
end
|
216
|
+
add_message "google.cloud.metastore.v1.ListBackupsRequest" do
|
217
|
+
optional :parent, :string, 1
|
218
|
+
optional :page_size, :int32, 2
|
219
|
+
optional :page_token, :string, 3
|
220
|
+
optional :filter, :string, 4
|
221
|
+
optional :order_by, :string, 5
|
222
|
+
end
|
223
|
+
add_message "google.cloud.metastore.v1.ListBackupsResponse" do
|
224
|
+
repeated :backups, :message, 1, "google.cloud.metastore.v1.Backup"
|
225
|
+
optional :next_page_token, :string, 2
|
226
|
+
repeated :unreachable, :string, 3
|
227
|
+
end
|
228
|
+
add_message "google.cloud.metastore.v1.GetBackupRequest" do
|
229
|
+
optional :name, :string, 1
|
230
|
+
end
|
231
|
+
add_message "google.cloud.metastore.v1.CreateBackupRequest" do
|
232
|
+
optional :parent, :string, 1
|
233
|
+
optional :backup_id, :string, 2
|
234
|
+
optional :backup, :message, 3, "google.cloud.metastore.v1.Backup"
|
235
|
+
optional :request_id, :string, 4
|
236
|
+
end
|
237
|
+
add_message "google.cloud.metastore.v1.DeleteBackupRequest" do
|
238
|
+
optional :name, :string, 1
|
239
|
+
optional :request_id, :string, 2
|
240
|
+
end
|
177
241
|
add_message "google.cloud.metastore.v1.ExportMetadataRequest" do
|
178
242
|
optional :service, :string, 1
|
179
243
|
optional :request_id, :string, 3
|
@@ -182,6 +246,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
182
246
|
optional :destination_gcs_folder, :string, 2
|
183
247
|
end
|
184
248
|
end
|
249
|
+
add_message "google.cloud.metastore.v1.RestoreServiceRequest" do
|
250
|
+
optional :service, :string, 1
|
251
|
+
optional :backup, :string, 2
|
252
|
+
optional :restore_type, :enum, 3, "google.cloud.metastore.v1.Restore.RestoreType"
|
253
|
+
optional :request_id, :string, 4
|
254
|
+
end
|
185
255
|
add_message "google.cloud.metastore.v1.OperationMetadata" do
|
186
256
|
optional :create_time, :message, 1, "google.protobuf.Timestamp"
|
187
257
|
optional :end_time, :message, 2, "google.protobuf.Timestamp"
|
@@ -203,6 +273,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
203
273
|
add_enum "google.cloud.metastore.v1.DatabaseDumpSpec.Type" do
|
204
274
|
value :TYPE_UNSPECIFIED, 0
|
205
275
|
value :MYSQL, 1
|
276
|
+
value :AVRO, 2
|
206
277
|
end
|
207
278
|
end
|
208
279
|
end
|
@@ -226,6 +297,11 @@ module Google
|
|
226
297
|
MetadataImport::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.MetadataImport.State").enummodule
|
227
298
|
MetadataExport = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.MetadataExport").msgclass
|
228
299
|
MetadataExport::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.MetadataExport.State").enummodule
|
300
|
+
Backup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.Backup").msgclass
|
301
|
+
Backup::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.Backup.State").enummodule
|
302
|
+
Restore = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.Restore").msgclass
|
303
|
+
Restore::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.Restore.State").enummodule
|
304
|
+
Restore::RestoreType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.Restore.RestoreType").enummodule
|
229
305
|
ListServicesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.ListServicesRequest").msgclass
|
230
306
|
ListServicesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.ListServicesResponse").msgclass
|
231
307
|
GetServiceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.GetServiceRequest").msgclass
|
@@ -237,7 +313,13 @@ module Google
|
|
237
313
|
GetMetadataImportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.GetMetadataImportRequest").msgclass
|
238
314
|
CreateMetadataImportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.CreateMetadataImportRequest").msgclass
|
239
315
|
UpdateMetadataImportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.UpdateMetadataImportRequest").msgclass
|
316
|
+
ListBackupsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.ListBackupsRequest").msgclass
|
317
|
+
ListBackupsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.ListBackupsResponse").msgclass
|
318
|
+
GetBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.GetBackupRequest").msgclass
|
319
|
+
CreateBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.CreateBackupRequest").msgclass
|
320
|
+
DeleteBackupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.DeleteBackupRequest").msgclass
|
240
321
|
ExportMetadataRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.ExportMetadataRequest").msgclass
|
322
|
+
RestoreServiceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.RestoreServiceRequest").msgclass
|
241
323
|
OperationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.OperationMetadata").msgclass
|
242
324
|
LocationMetadata = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.LocationMetadata").msgclass
|
243
325
|
LocationMetadata::HiveMetastoreVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.metastore.v1.LocationMetadata.HiveMetastoreVersion").msgclass
|
@@ -25,8 +25,8 @@ module Google
|
|
25
25
|
module V1
|
26
26
|
module DataprocMetastore
|
27
27
|
# Configures and manages metastore services.
|
28
|
-
# Metastore services are fully managed, highly available,
|
29
|
-
#
|
28
|
+
# Metastore services are fully managed, highly available, autoscaled,
|
29
|
+
# autohealing, OSS-native deployments of technical metadata management
|
30
30
|
# software. Each metastore service exposes a network endpoint through which
|
31
31
|
# metadata queries are served. Metadata queries can originate from a variety
|
32
32
|
# of sources, including Apache Hive, Apache Presto, and Apache Spark.
|
@@ -70,6 +70,16 @@ module Google
|
|
70
70
|
rpc :UpdateMetadataImport, ::Google::Cloud::Metastore::V1::UpdateMetadataImportRequest, ::Google::Longrunning::Operation
|
71
71
|
# Exports metadata from a service.
|
72
72
|
rpc :ExportMetadata, ::Google::Cloud::Metastore::V1::ExportMetadataRequest, ::Google::Longrunning::Operation
|
73
|
+
# Restores a service from a backup.
|
74
|
+
rpc :RestoreService, ::Google::Cloud::Metastore::V1::RestoreServiceRequest, ::Google::Longrunning::Operation
|
75
|
+
# Lists backups in a service.
|
76
|
+
rpc :ListBackups, ::Google::Cloud::Metastore::V1::ListBackupsRequest, ::Google::Cloud::Metastore::V1::ListBackupsResponse
|
77
|
+
# Gets details of a single backup.
|
78
|
+
rpc :GetBackup, ::Google::Cloud::Metastore::V1::GetBackupRequest, ::Google::Cloud::Metastore::V1::Backup
|
79
|
+
# Creates a new backup in a given project and location.
|
80
|
+
rpc :CreateBackup, ::Google::Cloud::Metastore::V1::CreateBackupRequest, ::Google::Longrunning::Operation
|
81
|
+
# Deletes a single backup.
|
82
|
+
rpc :DeleteBackup, ::Google::Cloud::Metastore::V1::DeleteBackupRequest, ::Google::Longrunning::Operation
|
73
83
|
end
|
74
84
|
|
75
85
|
Stub = Service.rpc_stub_class
|
@@ -57,9 +57,15 @@ module Google
|
|
57
57
|
|
58
58
|
# Denotes that a (repeated) field is an unordered list.
|
59
59
|
# This indicates that the service may provide the elements of the list
|
60
|
-
# in any arbitrary
|
60
|
+
# in any arbitrary order, rather than the order the user originally
|
61
61
|
# provided. Additionally, the list's order may or may not be stable.
|
62
62
|
UNORDERED_LIST = 6
|
63
|
+
|
64
|
+
# Denotes that this field returns a non-empty default value if not set.
|
65
|
+
# This indicates that if the user provides the empty value in a request,
|
66
|
+
# a non-empty value will be returned. The user will not be aware of what
|
67
|
+
# non-empty value to expect.
|
68
|
+
NON_EMPTY_DEFAULT = 7
|
63
69
|
end
|
64
70
|
end
|
65
71
|
end
|
@@ -235,6 +235,9 @@ module Google
|
|
235
235
|
# @!attribute [r] metadata_exports
|
236
236
|
# @return [::Array<::Google::Cloud::Metastore::V1::MetadataExport>]
|
237
237
|
# Output only. The latest metadata exports of the metastore service.
|
238
|
+
# @!attribute [r] restores
|
239
|
+
# @return [::Array<::Google::Cloud::Metastore::V1::Restore>]
|
240
|
+
# Output only. The latest restores of the metastore service.
|
238
241
|
class MetadataManagementActivity
|
239
242
|
include ::Google::Protobuf::MessageExts
|
240
243
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
@@ -254,10 +257,13 @@ module Google
|
|
254
257
|
# The description of the metadata import.
|
255
258
|
# @!attribute [r] create_time
|
256
259
|
# @return [::Google::Protobuf::Timestamp]
|
257
|
-
# Output only. The time when the metadata import was
|
260
|
+
# Output only. The time when the metadata import was started.
|
258
261
|
# @!attribute [r] update_time
|
259
262
|
# @return [::Google::Protobuf::Timestamp]
|
260
263
|
# Output only. The time when the metadata import was last updated.
|
264
|
+
# @!attribute [r] end_time
|
265
|
+
# @return [::Google::Protobuf::Timestamp]
|
266
|
+
# Output only. The time when the metadata import finished.
|
261
267
|
# @!attribute [r] state
|
262
268
|
# @return [::Google::Cloud::Metastore::V1::MetadataImport::State]
|
263
269
|
# Output only. The current state of the metadata import.
|
@@ -352,6 +358,114 @@ module Google
|
|
352
358
|
end
|
353
359
|
end
|
354
360
|
|
361
|
+
# The details of a backup resource.
|
362
|
+
# @!attribute [rw] name
|
363
|
+
# @return [::String]
|
364
|
+
# Immutable. The relative resource name of the backup, in the following form:
|
365
|
+
#
|
366
|
+
# `projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}`
|
367
|
+
# @!attribute [r] create_time
|
368
|
+
# @return [::Google::Protobuf::Timestamp]
|
369
|
+
# Output only. The time when the backup was started.
|
370
|
+
# @!attribute [r] end_time
|
371
|
+
# @return [::Google::Protobuf::Timestamp]
|
372
|
+
# Output only. The time when the backup finished creating.
|
373
|
+
# @!attribute [r] state
|
374
|
+
# @return [::Google::Cloud::Metastore::V1::Backup::State]
|
375
|
+
# Output only. The current state of the backup.
|
376
|
+
# @!attribute [r] service_revision
|
377
|
+
# @return [::Google::Cloud::Metastore::V1::Service]
|
378
|
+
# Output only. The revision of the service at the time of backup.
|
379
|
+
# @!attribute [rw] description
|
380
|
+
# @return [::String]
|
381
|
+
# The description of the backup.
|
382
|
+
# @!attribute [r] restoring_services
|
383
|
+
# @return [::Array<::String>]
|
384
|
+
# Output only. Services that are restoring from the backup.
|
385
|
+
class Backup
|
386
|
+
include ::Google::Protobuf::MessageExts
|
387
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
388
|
+
|
389
|
+
# The current state of the backup.
|
390
|
+
module State
|
391
|
+
# The state of the backup is unknown.
|
392
|
+
STATE_UNSPECIFIED = 0
|
393
|
+
|
394
|
+
# The backup is being created.
|
395
|
+
CREATING = 1
|
396
|
+
|
397
|
+
# The backup is being deleted.
|
398
|
+
DELETING = 2
|
399
|
+
|
400
|
+
# The backup is active and ready to use.
|
401
|
+
ACTIVE = 3
|
402
|
+
|
403
|
+
# The backup failed.
|
404
|
+
FAILED = 4
|
405
|
+
|
406
|
+
# The backup is being restored.
|
407
|
+
RESTORING = 5
|
408
|
+
end
|
409
|
+
end
|
410
|
+
|
411
|
+
# The details of a metadata restore operation.
|
412
|
+
# @!attribute [r] start_time
|
413
|
+
# @return [::Google::Protobuf::Timestamp]
|
414
|
+
# Output only. The time when the restore started.
|
415
|
+
# @!attribute [r] end_time
|
416
|
+
# @return [::Google::Protobuf::Timestamp]
|
417
|
+
# Output only. The time when the restore ended.
|
418
|
+
# @!attribute [r] state
|
419
|
+
# @return [::Google::Cloud::Metastore::V1::Restore::State]
|
420
|
+
# Output only. The current state of the restore.
|
421
|
+
# @!attribute [r] backup
|
422
|
+
# @return [::String]
|
423
|
+
# Output only. The relative resource name of the metastore service backup to restore
|
424
|
+
# from, in the following form:
|
425
|
+
#
|
426
|
+
# `projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
|
427
|
+
# @!attribute [r] type
|
428
|
+
# @return [::Google::Cloud::Metastore::V1::Restore::RestoreType]
|
429
|
+
# Output only. The type of restore.
|
430
|
+
# @!attribute [r] details
|
431
|
+
# @return [::String]
|
432
|
+
# Output only. The restore details containing the revision of the service to be restored
|
433
|
+
# to, in format of JSON.
|
434
|
+
class Restore
|
435
|
+
include ::Google::Protobuf::MessageExts
|
436
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
437
|
+
|
438
|
+
# The current state of the restore.
|
439
|
+
module State
|
440
|
+
# The state of the metadata restore is unknown.
|
441
|
+
STATE_UNSPECIFIED = 0
|
442
|
+
|
443
|
+
# The metadata restore is running.
|
444
|
+
RUNNING = 1
|
445
|
+
|
446
|
+
# The metadata restore completed successfully.
|
447
|
+
SUCCEEDED = 2
|
448
|
+
|
449
|
+
# The metadata restore failed.
|
450
|
+
FAILED = 3
|
451
|
+
|
452
|
+
# The metadata restore is cancelled.
|
453
|
+
CANCELLED = 4
|
454
|
+
end
|
455
|
+
|
456
|
+
# The type of restore. If unspecified, defaults to `METADATA_ONLY`.
|
457
|
+
module RestoreType
|
458
|
+
# The restore type is unknown.
|
459
|
+
RESTORE_TYPE_UNSPECIFIED = 0
|
460
|
+
|
461
|
+
# The service's metadata and configuration are restored.
|
462
|
+
FULL = 1
|
463
|
+
|
464
|
+
# Only the service's metadata is restored.
|
465
|
+
METADATA_ONLY = 2
|
466
|
+
end
|
467
|
+
end
|
468
|
+
|
355
469
|
# Request message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_services DataprocMetastore.ListServices}.
|
356
470
|
# @!attribute [rw] parent
|
357
471
|
# @return [::String]
|
@@ -648,6 +762,133 @@ module Google
|
|
648
762
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
649
763
|
end
|
650
764
|
|
765
|
+
# Request message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_backups DataprocMetastore.ListBackups}.
|
766
|
+
# @!attribute [rw] parent
|
767
|
+
# @return [::String]
|
768
|
+
# Required. The relative resource name of the service whose backups to
|
769
|
+
# list, in the following form:
|
770
|
+
#
|
771
|
+
# `projects/{project_number}/locations/{location_id}/services/{service_id}/backups`.
|
772
|
+
# @!attribute [rw] page_size
|
773
|
+
# @return [::Integer]
|
774
|
+
# Optional. The maximum number of backups to return. The response may contain less
|
775
|
+
# than the maximum number. If unspecified, no more than 500 backups are
|
776
|
+
# returned. The maximum value is 1000; values above 1000 are changed to 1000.
|
777
|
+
# @!attribute [rw] page_token
|
778
|
+
# @return [::String]
|
779
|
+
# Optional. A page token, received from a previous {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_backups DataprocMetastore.ListBackups}
|
780
|
+
# call. Provide this token to retrieve the subsequent page.
|
781
|
+
#
|
782
|
+
# To retrieve the first page, supply an empty page token.
|
783
|
+
#
|
784
|
+
# When paginating, other parameters provided to
|
785
|
+
# {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_backups DataprocMetastore.ListBackups} must match the call that provided the
|
786
|
+
# page token.
|
787
|
+
# @!attribute [rw] filter
|
788
|
+
# @return [::String]
|
789
|
+
# Optional. The filter to apply to list results.
|
790
|
+
# @!attribute [rw] order_by
|
791
|
+
# @return [::String]
|
792
|
+
# Optional. Specify the ordering of results as described in [Sorting
|
793
|
+
# Order](https://cloud.google.com/apis/design/design_patterns#sorting_order).
|
794
|
+
# If not specified, the results will be sorted in the default order.
|
795
|
+
class ListBackupsRequest
|
796
|
+
include ::Google::Protobuf::MessageExts
|
797
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
798
|
+
end
|
799
|
+
|
800
|
+
# Response message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_backups DataprocMetastore.ListBackups}.
|
801
|
+
# @!attribute [rw] backups
|
802
|
+
# @return [::Array<::Google::Cloud::Metastore::V1::Backup>]
|
803
|
+
# The backups of the specified service.
|
804
|
+
# @!attribute [rw] next_page_token
|
805
|
+
# @return [::String]
|
806
|
+
# A token that can be sent as `page_token` to retrieve the next page. If this
|
807
|
+
# field is omitted, there are no subsequent pages.
|
808
|
+
# @!attribute [rw] unreachable
|
809
|
+
# @return [::Array<::String>]
|
810
|
+
# Locations that could not be reached.
|
811
|
+
class ListBackupsResponse
|
812
|
+
include ::Google::Protobuf::MessageExts
|
813
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
814
|
+
end
|
815
|
+
|
816
|
+
# Request message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#get_backup DataprocMetastore.GetBackup}.
|
817
|
+
# @!attribute [rw] name
|
818
|
+
# @return [::String]
|
819
|
+
# Required. The relative resource name of the backup to retrieve, in the
|
820
|
+
# following form:
|
821
|
+
#
|
822
|
+
# `projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
|
823
|
+
class GetBackupRequest
|
824
|
+
include ::Google::Protobuf::MessageExts
|
825
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
826
|
+
end
|
827
|
+
|
828
|
+
# Request message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#create_backup DataprocMetastore.CreateBackup}.
|
829
|
+
# @!attribute [rw] parent
|
830
|
+
# @return [::String]
|
831
|
+
# Required. The relative resource name of the service in which to create a backup
|
832
|
+
# of the following form:
|
833
|
+
#
|
834
|
+
# `projects/{project_number}/locations/{location_id}/services/{service_id}`.
|
835
|
+
# @!attribute [rw] backup_id
|
836
|
+
# @return [::String]
|
837
|
+
# Required. The ID of the backup, which is used as the final component of the
|
838
|
+
# backup's name.
|
839
|
+
#
|
840
|
+
# This value must be between 1 and 64 characters long, begin with a letter,
|
841
|
+
# end with a letter or number, and consist of alpha-numeric ASCII characters
|
842
|
+
# or hyphens.
|
843
|
+
# @!attribute [rw] backup
|
844
|
+
# @return [::Google::Cloud::Metastore::V1::Backup]
|
845
|
+
# Required. The backup to create. The `name` field is ignored. The ID of the created
|
846
|
+
# backup must be provided in the request's `backup_id` field.
|
847
|
+
# @!attribute [rw] request_id
|
848
|
+
# @return [::String]
|
849
|
+
# Optional. A request ID. Specify a unique request ID to allow the server to ignore the
|
850
|
+
# request if it has completed. The server will ignore subsequent requests
|
851
|
+
# that provide a duplicate request ID for at least 60 minutes after the first
|
852
|
+
# request.
|
853
|
+
#
|
854
|
+
# For example, if an initial request times out, followed by another request
|
855
|
+
# with the same request ID, the server ignores the second request to prevent
|
856
|
+
# the creation of duplicate commitments.
|
857
|
+
#
|
858
|
+
# The request ID must be a valid
|
859
|
+
# [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Format)
|
860
|
+
# A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
|
861
|
+
class CreateBackupRequest
|
862
|
+
include ::Google::Protobuf::MessageExts
|
863
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
864
|
+
end
|
865
|
+
|
866
|
+
# Request message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#delete_backup DataprocMetastore.DeleteBackup}.
|
867
|
+
# @!attribute [rw] name
|
868
|
+
# @return [::String]
|
869
|
+
# Required. The relative resource name of the backup to delete, in the
|
870
|
+
# following form:
|
871
|
+
#
|
872
|
+
# `projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
|
873
|
+
# @!attribute [rw] request_id
|
874
|
+
# @return [::String]
|
875
|
+
# Optional. A request ID. Specify a unique request ID to allow the server to ignore the
|
876
|
+
# request if it has completed. The server will ignore subsequent requests
|
877
|
+
# that provide a duplicate request ID for at least 60 minutes after the first
|
878
|
+
# request.
|
879
|
+
#
|
880
|
+
# For example, if an initial request times out, followed by another request
|
881
|
+
# with the same request ID, the server ignores the second request to prevent
|
882
|
+
# the creation of duplicate commitments.
|
883
|
+
#
|
884
|
+
# The request ID must be a valid
|
885
|
+
# [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Format)
|
886
|
+
# A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
|
887
|
+
class DeleteBackupRequest
|
888
|
+
include ::Google::Protobuf::MessageExts
|
889
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
890
|
+
end
|
891
|
+
|
651
892
|
# Request message for {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#export_metadata DataprocMetastore.ExportMetadata}.
|
652
893
|
# @!attribute [rw] destination_gcs_folder
|
653
894
|
# @return [::String]
|
@@ -682,6 +923,41 @@ module Google
|
|
682
923
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
683
924
|
end
|
684
925
|
|
926
|
+
# Request message for [DataprocMetastore.Restore][].
|
927
|
+
# @!attribute [rw] service
|
928
|
+
# @return [::String]
|
929
|
+
# Required. The relative resource name of the metastore service to run restore, in the
|
930
|
+
# following form:
|
931
|
+
#
|
932
|
+
# `projects/{project_id}/locations/{location_id}/services/{service_id}`.
|
933
|
+
# @!attribute [rw] backup
|
934
|
+
# @return [::String]
|
935
|
+
# Required. The relative resource name of the metastore service backup to restore
|
936
|
+
# from, in the following form:
|
937
|
+
#
|
938
|
+
# `projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
|
939
|
+
# @!attribute [rw] restore_type
|
940
|
+
# @return [::Google::Cloud::Metastore::V1::Restore::RestoreType]
|
941
|
+
# Optional. The type of restore. If unspecified, defaults to `METADATA_ONLY`.
|
942
|
+
# @!attribute [rw] request_id
|
943
|
+
# @return [::String]
|
944
|
+
# Optional. A request ID. Specify a unique request ID to allow the server to ignore the
|
945
|
+
# request if it has completed. The server will ignore subsequent requests
|
946
|
+
# that provide a duplicate request ID for at least 60 minutes after the first
|
947
|
+
# request.
|
948
|
+
#
|
949
|
+
# For example, if an initial request times out, followed by another request
|
950
|
+
# with the same request ID, the server ignores the second request to prevent
|
951
|
+
# the creation of duplicate commitments.
|
952
|
+
#
|
953
|
+
# The request ID must be a valid
|
954
|
+
# [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Format).
|
955
|
+
# A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
|
956
|
+
class RestoreServiceRequest
|
957
|
+
include ::Google::Protobuf::MessageExts
|
958
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
959
|
+
end
|
960
|
+
|
685
961
|
# Represents the metadata of a long-running operation.
|
686
962
|
# @!attribute [r] create_time
|
687
963
|
# @return [::Google::Protobuf::Timestamp]
|
@@ -748,6 +1024,9 @@ module Google
|
|
748
1024
|
|
749
1025
|
# Database dump is a MySQL dump file.
|
750
1026
|
MYSQL = 1
|
1027
|
+
|
1028
|
+
# Database dump contains Avro files.
|
1029
|
+
AVRO = 2
|
751
1030
|
end
|
752
1031
|
end
|
753
1032
|
end
|