google-cloud-metastore-v1 0.1.3 → 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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7f7f56a8e15c2b75964822e728a5d9d0742decf75e7fb377ad82b5f3ea14695a
4
- data.tar.gz: 9e59b1d247a7fb5c75972f0eb786585295a2ded625f8c7f5aac41711a397a334
3
+ metadata.gz: 392784d5b3f5dc4fccffe9cbbfd599e6a57afe1ea632be69ce58dcc997299f9b
4
+ data.tar.gz: 8d00d1efbc2986bad4ab62e8a9b5700f29312d89fa93c62cdcafd055b20a0dc0
5
5
  SHA512:
6
- metadata.gz: f1fa65423a4de0ded7d1a57d57811fd9b049ba77ce09f87993b1d8bd6f9fa872d5c7b6a55c2897904d9dc4d1d90d25c661c012eb2259b812caa248085341d9a7
7
- data.tar.gz: 9653d6c19fbf5cdc2c2cdd6a02e346b16cd341699ded1ca14f96346b02a5f39a9b4d909bb6803bb854292f3aa66af2251a67e55b2989b234b804ad786dc587bd
6
+ metadata.gz: 4b3c274ffdb0c7b14099b7002ddfcfe0f46ad6cafb840a313b55a3700820e4a3f02c71f9ca5ced8fe0c844965d681f7b554a233027d4ef0345b26c251c1af71b
7
+ data.tar.gz: 4c469984519c40097dc03505d6e620762833825b933c7d059f08f313070c54d7515e9a00fe28d407fdfe69f47c0b855c389ed54b33215984bcf71fb3e1837eb7
@@ -33,8 +33,8 @@ module Google
33
33
  module V1
34
34
  ##
35
35
  # Configures and manages metastore services.
36
- # Metastore services are fully managed, highly available, auto-scaled,
37
- # auto-healing, OSS-native deployments of technical metadata management
36
+ # Metastore services are fully managed, highly available, autoscaled,
37
+ # autohealing, OSS-native deployments of technical metadata management
38
38
  # software. Each metastore service exposes a network endpoint through which
39
39
  # metadata queries are served. Metadata queries can originate from a variety
40
40
  # of sources, including Apache Hive, Apache Presto, and Apache Spark.
@@ -28,8 +28,8 @@ module Google
28
28
  # Client for the DataprocMetastore service.
29
29
  #
30
30
  # Configures and manages metastore services.
31
- # Metastore services are fully managed, highly available, auto-scaled,
32
- # auto-healing, OSS-native deployments of technical metadata management
31
+ # Metastore services are fully managed, highly available, autoscaled,
32
+ # autohealing, OSS-native deployments of technical metadata management
33
33
  # software. Each metastore service exposes a network endpoint through which
34
34
  # metadata queries are served. Metadata queries can originate from a variety
35
35
  # of sources, including Apache Hive, Apache Presto, and Apache Spark.
@@ -97,6 +97,12 @@ module Google
97
97
 
98
98
  default_config.rpcs.export_metadata.timeout = 60.0
99
99
 
100
+ default_config.rpcs.restore_service.timeout = 60.0
101
+
102
+ default_config.rpcs.create_backup.timeout = 60.0
103
+
104
+ default_config.rpcs.delete_backup.timeout = 60.0
105
+
100
106
  default_config
101
107
  end
102
108
  yield @configure if block_given?
@@ -1064,6 +1070,440 @@ module Google
1064
1070
  raise ::Google::Cloud::Error.from_error(e)
1065
1071
  end
1066
1072
 
1073
+ ##
1074
+ # Restores a service from a backup.
1075
+ #
1076
+ # @overload restore_service(request, options = nil)
1077
+ # Pass arguments to `restore_service` via a request object, either of type
1078
+ # {::Google::Cloud::Metastore::V1::RestoreServiceRequest} or an equivalent Hash.
1079
+ #
1080
+ # @param request [::Google::Cloud::Metastore::V1::RestoreServiceRequest, ::Hash]
1081
+ # A request object representing the call parameters. Required. To specify no
1082
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1083
+ # @param options [::Gapic::CallOptions, ::Hash]
1084
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1085
+ #
1086
+ # @overload restore_service(service: nil, backup: nil, restore_type: nil, request_id: nil)
1087
+ # Pass arguments to `restore_service` via keyword arguments. Note that at
1088
+ # least one keyword argument is required. To specify no parameters, or to keep all
1089
+ # the default parameter values, pass an empty Hash as a request object (see above).
1090
+ #
1091
+ # @param service [::String]
1092
+ # Required. The relative resource name of the metastore service to run restore, in the
1093
+ # following form:
1094
+ #
1095
+ # `projects/{project_id}/locations/{location_id}/services/{service_id}`.
1096
+ # @param backup [::String]
1097
+ # Required. The relative resource name of the metastore service backup to restore
1098
+ # from, in the following form:
1099
+ #
1100
+ # `projects/{project_id}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
1101
+ # @param restore_type [::Google::Cloud::Metastore::V1::Restore::RestoreType]
1102
+ # Optional. The type of restore. If unspecified, defaults to `METADATA_ONLY`.
1103
+ # @param request_id [::String]
1104
+ # Optional. A request ID. Specify a unique request ID to allow the server to ignore the
1105
+ # request if it has completed. The server will ignore subsequent requests
1106
+ # that provide a duplicate request ID for at least 60 minutes after the first
1107
+ # request.
1108
+ #
1109
+ # For example, if an initial request times out, followed by another request
1110
+ # with the same request ID, the server ignores the second request to prevent
1111
+ # the creation of duplicate commitments.
1112
+ #
1113
+ # The request ID must be a valid
1114
+ # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Format).
1115
+ # A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
1116
+ #
1117
+ # @yield [response, operation] Access the result along with the RPC operation
1118
+ # @yieldparam response [::Gapic::Operation]
1119
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1120
+ #
1121
+ # @return [::Gapic::Operation]
1122
+ #
1123
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1124
+ #
1125
+ def restore_service request, options = nil
1126
+ raise ::ArgumentError, "request must be provided" if request.nil?
1127
+
1128
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Metastore::V1::RestoreServiceRequest
1129
+
1130
+ # Converts hash and nil to an options object
1131
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1132
+
1133
+ # Customize the options with defaults
1134
+ metadata = @config.rpcs.restore_service.metadata.to_h
1135
+
1136
+ # Set x-goog-api-client and x-goog-user-project headers
1137
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1138
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1139
+ gapic_version: ::Google::Cloud::Metastore::V1::VERSION
1140
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1141
+
1142
+ header_params = {
1143
+ "service" => request.service
1144
+ }
1145
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1146
+ metadata[:"x-goog-request-params"] ||= request_params_header
1147
+
1148
+ options.apply_defaults timeout: @config.rpcs.restore_service.timeout,
1149
+ metadata: metadata,
1150
+ retry_policy: @config.rpcs.restore_service.retry_policy
1151
+
1152
+ options.apply_defaults timeout: @config.timeout,
1153
+ metadata: @config.metadata,
1154
+ retry_policy: @config.retry_policy
1155
+
1156
+ @dataproc_metastore_stub.call_rpc :restore_service, request, options: options do |response, operation|
1157
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1158
+ yield response, operation if block_given?
1159
+ return response
1160
+ end
1161
+ rescue ::GRPC::BadStatus => e
1162
+ raise ::Google::Cloud::Error.from_error(e)
1163
+ end
1164
+
1165
+ ##
1166
+ # Lists backups in a service.
1167
+ #
1168
+ # @overload list_backups(request, options = nil)
1169
+ # Pass arguments to `list_backups` via a request object, either of type
1170
+ # {::Google::Cloud::Metastore::V1::ListBackupsRequest} or an equivalent Hash.
1171
+ #
1172
+ # @param request [::Google::Cloud::Metastore::V1::ListBackupsRequest, ::Hash]
1173
+ # A request object representing the call parameters. Required. To specify no
1174
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1175
+ # @param options [::Gapic::CallOptions, ::Hash]
1176
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1177
+ #
1178
+ # @overload list_backups(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1179
+ # Pass arguments to `list_backups` via keyword arguments. Note that at
1180
+ # least one keyword argument is required. To specify no parameters, or to keep all
1181
+ # the default parameter values, pass an empty Hash as a request object (see above).
1182
+ #
1183
+ # @param parent [::String]
1184
+ # Required. The relative resource name of the service whose backups to
1185
+ # list, in the following form:
1186
+ #
1187
+ # `projects/{project_number}/locations/{location_id}/services/{service_id}/backups`.
1188
+ # @param page_size [::Integer]
1189
+ # Optional. The maximum number of backups to return. The response may contain less
1190
+ # than the maximum number. If unspecified, no more than 500 backups are
1191
+ # returned. The maximum value is 1000; values above 1000 are changed to 1000.
1192
+ # @param page_token [::String]
1193
+ # Optional. A page token, received from a previous {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_backups DataprocMetastore.ListBackups}
1194
+ # call. Provide this token to retrieve the subsequent page.
1195
+ #
1196
+ # To retrieve the first page, supply an empty page token.
1197
+ #
1198
+ # When paginating, other parameters provided to
1199
+ # {::Google::Cloud::Metastore::V1::DataprocMetastore::Client#list_backups DataprocMetastore.ListBackups} must match the call that provided the
1200
+ # page token.
1201
+ # @param filter [::String]
1202
+ # Optional. The filter to apply to list results.
1203
+ # @param order_by [::String]
1204
+ # Optional. Specify the ordering of results as described in [Sorting
1205
+ # Order](https://cloud.google.com/apis/design/design_patterns#sorting_order).
1206
+ # If not specified, the results will be sorted in the default order.
1207
+ #
1208
+ # @yield [response, operation] Access the result along with the RPC operation
1209
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Metastore::V1::Backup>]
1210
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1211
+ #
1212
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::Metastore::V1::Backup>]
1213
+ #
1214
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1215
+ #
1216
+ def list_backups request, options = nil
1217
+ raise ::ArgumentError, "request must be provided" if request.nil?
1218
+
1219
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Metastore::V1::ListBackupsRequest
1220
+
1221
+ # Converts hash and nil to an options object
1222
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1223
+
1224
+ # Customize the options with defaults
1225
+ metadata = @config.rpcs.list_backups.metadata.to_h
1226
+
1227
+ # Set x-goog-api-client and x-goog-user-project headers
1228
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1229
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1230
+ gapic_version: ::Google::Cloud::Metastore::V1::VERSION
1231
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1232
+
1233
+ header_params = {
1234
+ "parent" => request.parent
1235
+ }
1236
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1237
+ metadata[:"x-goog-request-params"] ||= request_params_header
1238
+
1239
+ options.apply_defaults timeout: @config.rpcs.list_backups.timeout,
1240
+ metadata: metadata,
1241
+ retry_policy: @config.rpcs.list_backups.retry_policy
1242
+
1243
+ options.apply_defaults timeout: @config.timeout,
1244
+ metadata: @config.metadata,
1245
+ retry_policy: @config.retry_policy
1246
+
1247
+ @dataproc_metastore_stub.call_rpc :list_backups, request, options: options do |response, operation|
1248
+ response = ::Gapic::PagedEnumerable.new @dataproc_metastore_stub, :list_backups, request, response, operation, options
1249
+ yield response, operation if block_given?
1250
+ return response
1251
+ end
1252
+ rescue ::GRPC::BadStatus => e
1253
+ raise ::Google::Cloud::Error.from_error(e)
1254
+ end
1255
+
1256
+ ##
1257
+ # Gets details of a single backup.
1258
+ #
1259
+ # @overload get_backup(request, options = nil)
1260
+ # Pass arguments to `get_backup` via a request object, either of type
1261
+ # {::Google::Cloud::Metastore::V1::GetBackupRequest} or an equivalent Hash.
1262
+ #
1263
+ # @param request [::Google::Cloud::Metastore::V1::GetBackupRequest, ::Hash]
1264
+ # A request object representing the call parameters. Required. To specify no
1265
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1266
+ # @param options [::Gapic::CallOptions, ::Hash]
1267
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1268
+ #
1269
+ # @overload get_backup(name: nil)
1270
+ # Pass arguments to `get_backup` via keyword arguments. Note that at
1271
+ # least one keyword argument is required. To specify no parameters, or to keep all
1272
+ # the default parameter values, pass an empty Hash as a request object (see above).
1273
+ #
1274
+ # @param name [::String]
1275
+ # Required. The relative resource name of the backup to retrieve, in the
1276
+ # following form:
1277
+ #
1278
+ # `projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
1279
+ #
1280
+ # @yield [response, operation] Access the result along with the RPC operation
1281
+ # @yieldparam response [::Google::Cloud::Metastore::V1::Backup]
1282
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1283
+ #
1284
+ # @return [::Google::Cloud::Metastore::V1::Backup]
1285
+ #
1286
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1287
+ #
1288
+ def get_backup request, options = nil
1289
+ raise ::ArgumentError, "request must be provided" if request.nil?
1290
+
1291
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Metastore::V1::GetBackupRequest
1292
+
1293
+ # Converts hash and nil to an options object
1294
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1295
+
1296
+ # Customize the options with defaults
1297
+ metadata = @config.rpcs.get_backup.metadata.to_h
1298
+
1299
+ # Set x-goog-api-client and x-goog-user-project headers
1300
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1301
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1302
+ gapic_version: ::Google::Cloud::Metastore::V1::VERSION
1303
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1304
+
1305
+ header_params = {
1306
+ "name" => request.name
1307
+ }
1308
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1309
+ metadata[:"x-goog-request-params"] ||= request_params_header
1310
+
1311
+ options.apply_defaults timeout: @config.rpcs.get_backup.timeout,
1312
+ metadata: metadata,
1313
+ retry_policy: @config.rpcs.get_backup.retry_policy
1314
+
1315
+ options.apply_defaults timeout: @config.timeout,
1316
+ metadata: @config.metadata,
1317
+ retry_policy: @config.retry_policy
1318
+
1319
+ @dataproc_metastore_stub.call_rpc :get_backup, request, options: options do |response, operation|
1320
+ yield response, operation if block_given?
1321
+ return response
1322
+ end
1323
+ rescue ::GRPC::BadStatus => e
1324
+ raise ::Google::Cloud::Error.from_error(e)
1325
+ end
1326
+
1327
+ ##
1328
+ # Creates a new backup in a given project and location.
1329
+ #
1330
+ # @overload create_backup(request, options = nil)
1331
+ # Pass arguments to `create_backup` via a request object, either of type
1332
+ # {::Google::Cloud::Metastore::V1::CreateBackupRequest} or an equivalent Hash.
1333
+ #
1334
+ # @param request [::Google::Cloud::Metastore::V1::CreateBackupRequest, ::Hash]
1335
+ # A request object representing the call parameters. Required. To specify no
1336
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1337
+ # @param options [::Gapic::CallOptions, ::Hash]
1338
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1339
+ #
1340
+ # @overload create_backup(parent: nil, backup_id: nil, backup: nil, request_id: nil)
1341
+ # Pass arguments to `create_backup` via keyword arguments. Note that at
1342
+ # least one keyword argument is required. To specify no parameters, or to keep all
1343
+ # the default parameter values, pass an empty Hash as a request object (see above).
1344
+ #
1345
+ # @param parent [::String]
1346
+ # Required. The relative resource name of the service in which to create a backup
1347
+ # of the following form:
1348
+ #
1349
+ # `projects/{project_number}/locations/{location_id}/services/{service_id}`.
1350
+ # @param backup_id [::String]
1351
+ # Required. The ID of the backup, which is used as the final component of the
1352
+ # backup's name.
1353
+ #
1354
+ # This value must be between 1 and 64 characters long, begin with a letter,
1355
+ # end with a letter or number, and consist of alpha-numeric ASCII characters
1356
+ # or hyphens.
1357
+ # @param backup [::Google::Cloud::Metastore::V1::Backup, ::Hash]
1358
+ # Required. The backup to create. The `name` field is ignored. The ID of the created
1359
+ # backup must be provided in the request's `backup_id` field.
1360
+ # @param request_id [::String]
1361
+ # Optional. A request ID. Specify a unique request ID to allow the server to ignore the
1362
+ # request if it has completed. The server will ignore subsequent requests
1363
+ # that provide a duplicate request ID for at least 60 minutes after the first
1364
+ # request.
1365
+ #
1366
+ # For example, if an initial request times out, followed by another request
1367
+ # with the same request ID, the server ignores the second request to prevent
1368
+ # the creation of duplicate commitments.
1369
+ #
1370
+ # The request ID must be a valid
1371
+ # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Format)
1372
+ # A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
1373
+ #
1374
+ # @yield [response, operation] Access the result along with the RPC operation
1375
+ # @yieldparam response [::Gapic::Operation]
1376
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1377
+ #
1378
+ # @return [::Gapic::Operation]
1379
+ #
1380
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1381
+ #
1382
+ def create_backup request, options = nil
1383
+ raise ::ArgumentError, "request must be provided" if request.nil?
1384
+
1385
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Metastore::V1::CreateBackupRequest
1386
+
1387
+ # Converts hash and nil to an options object
1388
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1389
+
1390
+ # Customize the options with defaults
1391
+ metadata = @config.rpcs.create_backup.metadata.to_h
1392
+
1393
+ # Set x-goog-api-client and x-goog-user-project headers
1394
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1395
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1396
+ gapic_version: ::Google::Cloud::Metastore::V1::VERSION
1397
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1398
+
1399
+ header_params = {
1400
+ "parent" => request.parent
1401
+ }
1402
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1403
+ metadata[:"x-goog-request-params"] ||= request_params_header
1404
+
1405
+ options.apply_defaults timeout: @config.rpcs.create_backup.timeout,
1406
+ metadata: metadata,
1407
+ retry_policy: @config.rpcs.create_backup.retry_policy
1408
+
1409
+ options.apply_defaults timeout: @config.timeout,
1410
+ metadata: @config.metadata,
1411
+ retry_policy: @config.retry_policy
1412
+
1413
+ @dataproc_metastore_stub.call_rpc :create_backup, request, options: options do |response, operation|
1414
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1415
+ yield response, operation if block_given?
1416
+ return response
1417
+ end
1418
+ rescue ::GRPC::BadStatus => e
1419
+ raise ::Google::Cloud::Error.from_error(e)
1420
+ end
1421
+
1422
+ ##
1423
+ # Deletes a single backup.
1424
+ #
1425
+ # @overload delete_backup(request, options = nil)
1426
+ # Pass arguments to `delete_backup` via a request object, either of type
1427
+ # {::Google::Cloud::Metastore::V1::DeleteBackupRequest} or an equivalent Hash.
1428
+ #
1429
+ # @param request [::Google::Cloud::Metastore::V1::DeleteBackupRequest, ::Hash]
1430
+ # A request object representing the call parameters. Required. To specify no
1431
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1432
+ # @param options [::Gapic::CallOptions, ::Hash]
1433
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1434
+ #
1435
+ # @overload delete_backup(name: nil, request_id: nil)
1436
+ # Pass arguments to `delete_backup` via keyword arguments. Note that at
1437
+ # least one keyword argument is required. To specify no parameters, or to keep all
1438
+ # the default parameter values, pass an empty Hash as a request object (see above).
1439
+ #
1440
+ # @param name [::String]
1441
+ # Required. The relative resource name of the backup to delete, in the
1442
+ # following form:
1443
+ #
1444
+ # `projects/{project_number}/locations/{location_id}/services/{service_id}/backups/{backup_id}`.
1445
+ # @param request_id [::String]
1446
+ # Optional. A request ID. Specify a unique request ID to allow the server to ignore the
1447
+ # request if it has completed. The server will ignore subsequent requests
1448
+ # that provide a duplicate request ID for at least 60 minutes after the first
1449
+ # request.
1450
+ #
1451
+ # For example, if an initial request times out, followed by another request
1452
+ # with the same request ID, the server ignores the second request to prevent
1453
+ # the creation of duplicate commitments.
1454
+ #
1455
+ # The request ID must be a valid
1456
+ # [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Format)
1457
+ # A zero UUID (00000000-0000-0000-0000-000000000000) is not supported.
1458
+ #
1459
+ # @yield [response, operation] Access the result along with the RPC operation
1460
+ # @yieldparam response [::Gapic::Operation]
1461
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1462
+ #
1463
+ # @return [::Gapic::Operation]
1464
+ #
1465
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1466
+ #
1467
+ def delete_backup request, options = nil
1468
+ raise ::ArgumentError, "request must be provided" if request.nil?
1469
+
1470
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Metastore::V1::DeleteBackupRequest
1471
+
1472
+ # Converts hash and nil to an options object
1473
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1474
+
1475
+ # Customize the options with defaults
1476
+ metadata = @config.rpcs.delete_backup.metadata.to_h
1477
+
1478
+ # Set x-goog-api-client and x-goog-user-project headers
1479
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1480
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1481
+ gapic_version: ::Google::Cloud::Metastore::V1::VERSION
1482
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1483
+
1484
+ header_params = {
1485
+ "name" => request.name
1486
+ }
1487
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1488
+ metadata[:"x-goog-request-params"] ||= request_params_header
1489
+
1490
+ options.apply_defaults timeout: @config.rpcs.delete_backup.timeout,
1491
+ metadata: metadata,
1492
+ retry_policy: @config.rpcs.delete_backup.retry_policy
1493
+
1494
+ options.apply_defaults timeout: @config.timeout,
1495
+ metadata: @config.metadata,
1496
+ retry_policy: @config.retry_policy
1497
+
1498
+ @dataproc_metastore_stub.call_rpc :delete_backup, request, options: options do |response, operation|
1499
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1500
+ yield response, operation if block_given?
1501
+ return response
1502
+ end
1503
+ rescue ::GRPC::BadStatus => e
1504
+ raise ::Google::Cloud::Error.from_error(e)
1505
+ end
1506
+
1067
1507
  ##
1068
1508
  # Configuration class for the DataprocMetastore API.
1069
1509
  #
@@ -1249,6 +1689,31 @@ module Google
1249
1689
  # @return [::Gapic::Config::Method]
1250
1690
  #
1251
1691
  attr_reader :export_metadata
1692
+ ##
1693
+ # RPC-specific configuration for `restore_service`
1694
+ # @return [::Gapic::Config::Method]
1695
+ #
1696
+ attr_reader :restore_service
1697
+ ##
1698
+ # RPC-specific configuration for `list_backups`
1699
+ # @return [::Gapic::Config::Method]
1700
+ #
1701
+ attr_reader :list_backups
1702
+ ##
1703
+ # RPC-specific configuration for `get_backup`
1704
+ # @return [::Gapic::Config::Method]
1705
+ #
1706
+ attr_reader :get_backup
1707
+ ##
1708
+ # RPC-specific configuration for `create_backup`
1709
+ # @return [::Gapic::Config::Method]
1710
+ #
1711
+ attr_reader :create_backup
1712
+ ##
1713
+ # RPC-specific configuration for `delete_backup`
1714
+ # @return [::Gapic::Config::Method]
1715
+ #
1716
+ attr_reader :delete_backup
1252
1717
 
1253
1718
  # @private
1254
1719
  def initialize parent_rpcs = nil
@@ -1272,6 +1737,16 @@ module Google
1272
1737
  @update_metadata_import = ::Gapic::Config::Method.new update_metadata_import_config
1273
1738
  export_metadata_config = parent_rpcs.export_metadata if parent_rpcs.respond_to? :export_metadata
1274
1739
  @export_metadata = ::Gapic::Config::Method.new export_metadata_config
1740
+ restore_service_config = parent_rpcs.restore_service if parent_rpcs.respond_to? :restore_service
1741
+ @restore_service = ::Gapic::Config::Method.new restore_service_config
1742
+ list_backups_config = parent_rpcs.list_backups if parent_rpcs.respond_to? :list_backups
1743
+ @list_backups = ::Gapic::Config::Method.new list_backups_config
1744
+ get_backup_config = parent_rpcs.get_backup if parent_rpcs.respond_to? :get_backup
1745
+ @get_backup = ::Gapic::Config::Method.new get_backup_config
1746
+ create_backup_config = parent_rpcs.create_backup if parent_rpcs.respond_to? :create_backup
1747
+ @create_backup = ::Gapic::Config::Method.new create_backup_config
1748
+ delete_backup_config = parent_rpcs.delete_backup if parent_rpcs.respond_to? :delete_backup
1749
+ @delete_backup = ::Gapic::Config::Method.new delete_backup_config
1275
1750
 
1276
1751
  yield self if block_given?
1277
1752
  end
@@ -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, auto-scaled,
29
- # auto-healing, OSS-native deployments of technical metadata management
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
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Metastore
23
23
  module V1
24
- VERSION = "0.1.3"
24
+ VERSION = "0.2.0"
25
25
  end
26
26
  end
27
27
  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 created.
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
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-metastore-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.3
4
+ version: 0.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-08-11 00:00:00.000000000 Z
11
+ date: 2021-08-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common