Class: Google::Cloud::Dataplex::V1::MetadataJob

Inherits:
Object
  • Object
show all
Extended by:
Protobuf::MessageExts::ClassMethods
Includes:
Protobuf::MessageExts
Defined in:
proto_docs/google/cloud/dataplex/v1/catalog.rb

Overview

A metadata job resource.

Defined Under Namespace

Modules: Type Classes: ExportJobResult, ExportJobSpec, ImportJobResult, ImportJobSpec, LabelsEntry, Status

Instance Attribute Summary collapse

Instance Attribute Details

#create_time ⇒ ::Google::Protobuf::Timestamp (readonly)

Returns Output only. The time when the metadata job was created.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#export_result ⇒ ::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobResult (readonly)

Returns Output only. Export job result.

Note: The following fields are mutually exclusive: export_result, import_result. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#export_spec ⇒ ::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec

Returns Export job specification.

Note: The following fields are mutually exclusive: export_spec, import_spec. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#import_result ⇒ ::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobResult (readonly)

Returns Output only. Import job result.

Note: The following fields are mutually exclusive: import_result, export_result. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#import_spec ⇒ ::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec

Returns Import job specification.

Note: The following fields are mutually exclusive: import_spec, export_spec. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#labels ⇒ ::Google::Protobuf::Map{::String => ::String}

Returns Optional. User-defined labels.

Returns:

  • (::Google::Protobuf::Map{::String => ::String}) —

    Optional. User-defined labels.



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#name ⇒ ::String (readonly)

Returns Output only. Identifier. The name of the resource that the configuration is applied to, in the format projects/{project_number}/locations/{location_id}/metadataJobs/{metadata_job_id}.

Returns:

  • (::String) —

    Output only. Identifier. The name of the resource that the configuration is applied to, in the format projects/{project_number}/locations/{location_id}/metadataJobs/{metadata_job_id}.



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#status ⇒ ::Google::Cloud::Dataplex::V1::MetadataJob::Status (readonly)

Returns Output only. Metadata job status.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#type ⇒ ::Google::Cloud::Dataplex::V1::MetadataJob::Type

Returns Required. Metadata job type.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#uid ⇒ ::String (readonly)

Returns Output only. A system-generated, globally unique ID for the metadata job. If the metadata job is deleted and then re-created with the same name, this ID is different.

Returns:

  • (::String) —

    Output only. A system-generated, globally unique ID for the metadata job. If the metadata job is deleted and then re-created with the same name, this ID is different.



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end

#update_time ⇒ ::Google::Protobuf::Timestamp (readonly)

Returns Output only. The time when the metadata job was updated.

Returns:



1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
 
# File 'proto_docs/google/cloud/dataplex/v1/catalog.rb', line 1332

class MetadataJob
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Results from a metadata import job.
  # @!attribute [r] deleted_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were deleted.
  # @!attribute [r] updated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were updated.
  # @!attribute [r] created_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were created.
  # @!attribute [r] unchanged_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were unchanged.
  # @!attribute [r] recreated_entries
  #   @return [::Integer]
  #     Output only. The total number of entries that were recreated.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class ImportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Export Job Results. The result is based on the snapshot at the time when
  # the job is created.
  # @!attribute [r] exported_entries
  #   @return [::Integer]
  #     Output only. The number of entries that have been exported.
  # @!attribute [r] error_message
  #   @return [::String]
  #     Output only. The error message if the export job failed.
  class ExportJobResult
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Job specification for a metadata import job.
  #
  # You can run the following kinds of metadata import jobs:
  #
  # * Full sync of entries with incremental import of their aspects.
  # Supported for custom entries.
  # * Incremental import of aspects only. Supported for aspects that belong
  # to custom entries and system entries. For custom entries, you can modify
  # both optional aspects and required aspects. For system entries, you can
  # modify optional aspects.
  # @!attribute [rw] source_storage_uri
  #   @return [::String]
  #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
  #     `gs://` and ending with `/`) that contains the metadata import files for
  #     this job.
  #
  #     A metadata import file defines the values to set for each of the entries
  #     and aspects in a metadata job. For more information about how to create a
  #     metadata import file and the file requirements, see [Metadata import
  #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
  #
  #     You can provide multiple metadata import files in the same metadata job.
  #     The bucket or folder must contain at least one metadata import file, in
  #     JSON Lines format (either `.json` or `.jsonl` file extension).
  #
  #     In `FULL` entry sync mode, don't save the metadata import file in a
  #     folder named `SOURCE_STORAGE_URI/deletions/`.
  #
  #     **Caution**: If the metadata import file contains no data, all entries
  #     and aspects that belong to the job's scope are deleted.
  # @!attribute [rw] source_create_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Optional. The time when the process that created the metadata import
  #     files began.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
  #     Required. A boundary on the scope of impact that the metadata import job
  #     can have.
  # @!attribute [rw] entry_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for entries.
  # @!attribute [rw] aspect_sync_mode
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
  #     Required. The sync mode for aspects.
  # @!attribute [rw] log_level
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
  #     Optional. The level of logs to write to Cloud Logging for this job.
  #
  #     Debug-level logs provide highly-detailed information for
  #     troubleshooting, but their increased verbosity could incur [additional
  #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
  #     merited for all jobs.
  #
  #     If unspecified, defaults to `INFO`.
  class ImportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A boundary on the scope of impact that the metadata import job can have.
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     Required. The entry group that is in scope for the import job,
    #     specified as a relative resource name in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
    #     Only entries and aspects that belong to the specified entry group are
    #     affected by the job.
    #
    #     Must contain exactly one element. The entry group and the job
    #     must be in the same location.
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     Required. The entry types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
    #     The job modifies only the entries and aspects that belong to these
    #     entry types.
    #
    #     If the metadata import file attempts to modify an entry whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an entry type must either match the location of the
    #     job, or the entry type must be global.
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     Optional. The aspect types that are in scope for the import job,
    #     specified as relative resource names in the format
    #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
    #     The job modifies only the aspects that belong to these aspect types.
    #
    #     This field is required when creating an aspect-only import job.
    #
    #     If the metadata import file attempts to modify an aspect whose type
    #     isn't included in this list, the import job is halted before modifying
    #     any entries or aspects.
    #
    #     The location of an aspect type must either match the location of the
    #     job, or the aspect type must be global.
    class ImportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Specifies how the entries and aspects in a metadata job are updated. For
    # more information, see [Sync
    # mode](https://cloud.google.com/dataplex/docs/import-metadata#sync-mode).
    module SyncMode
      # Sync mode unspecified.
      SYNC_MODE_UNSPECIFIED = 0

      # All resources in the job's scope are modified. If a resource exists in
      # Dataplex but isn't included in the metadata import file, the resource
      # is deleted when you run the metadata job. Use this mode to perform a
      # full sync of the set of entries in the job scope.
      #
      # This sync mode is supported for entries.
      FULL = 1

      # Only the resources that are explicitly included in the
      # metadata import file are modified. Use this mode to modify a subset of
      # resources while leaving unreferenced resources unchanged.
      #
      # This sync mode is supported for aspects.
      INCREMENTAL = 2

      # If entry sync mode is `NONE`, then aspects are modified according
      # to the aspect sync mode. Other metadata that belongs to entries in the
      # job's scope isn't modified.
      #
      # This sync mode is supported for entries.
      NONE = 3
    end

    # The level of logs to write to Cloud Logging for this job.
    module LogLevel
      # Log level unspecified.
      LOG_LEVEL_UNSPECIFIED = 0

      # Debug-level logging. Captures detailed logs for each import item. Use
      # debug-level logging to troubleshoot issues with specific import items.
      # For example, use debug-level logging to identify resources that are
      # missing from the job scope, entries or aspects that don't conform to
      # the associated entry type or aspect type, or other misconfigurations
      # with the metadata import file.
      #
      # Depending on the size of your metadata job and the number of logs that
      # are generated, debug-level logging might incur
      # [additional costs](https://cloud.google.com/stackdriver/pricing).
      DEBUG = 1

      # Info-level logging. Captures logs at the overall job level. Includes
      # aggregate logs about import items, but doesn't specify which import
      # item has an error.
      INFO = 2
    end
  end

  # Export job specification.
  # @!attribute [rw] scope
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ExportJobSpec::ExportJobScope]
  #     Required. Selects the entries to be exported by this job.
  # @!attribute [rw] output_path
  #   @return [::String]
  #     Required. The root path of the exported metadata.
  #     Must be in the format: "gs://<bucket_id>"
  #     Or specify a customized prefix after the bucket:
  #     "gs://<bucket_id>/<folder1>/<folder2>/.../".
  #     The length limit of the customized prefix is 128 characters.
  #     The bucket must be in the same VPC-SC perimeter with the job.
  class ExportJobSpec
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Scope of the export job.
    # @!attribute [rw] organization_level
    #   @return [::Boolean]
    #     Indicating if it is an organization level export job.
    #     - When set to true, exports all entries from entry groups and projects
    #     sharing the same organization id of the Metadata Job. Only projects and
    #     entry groups in the VPC-SC perimeter will be exported. The projects and
    #     entry groups are ignored.
    #     - When set to false, one of the projects or entry groups must be
    #     specified.
    #     - Default to false.
    # @!attribute [rw] projects
    #   @return [::Array<::String>]
    #     The projects that are in the scope of the export job. Can either be
    #     project numbers or project IDs. If specified, only the entries from the
    #     specified projects will be exported. The projects must be in the same
    #     organization and in the VPC-SC perimeter. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false.
    #     Must follow the format: "projects/<project_id_or_number>"
    # @!attribute [rw] entry_groups
    #   @return [::Array<::String>]
    #     The entry groups that are in scope for the export job. Optional. If
    #     specified, only entries in the specified entry groups will be exported
    #     by the job. Must be in the VPC-SC perimeter of the job. The location of
    #     the entry groups must be the same as the job. Either projects or
    #     entry_groups can be specified when organization_level_export is set to
    #     false. Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryGroups/<entry_group_id>"
    # @!attribute [rw] entry_types
    #   @return [::Array<::String>]
    #     If specified, only entries of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/entryTypes/<entry_type_id>"
    # @!attribute [rw] aspect_types
    #   @return [::Array<::String>]
    #     The aspect types that are in scope for the export job.
    #     Optional. If specified, only aspects of the specified types will be
    #     affected by the job.
    #     Must follow the format:
    #     "projects/<project_id_or_number>/locations/<location>/aspectTypes/<aspect_type_id>"
    class ExportJobScope
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Metadata job status.
  # @!attribute [r] state
  #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
  #     Output only. State of the metadata job.
  # @!attribute [r] message
  #   @return [::String]
  #     Output only. Message relating to the progression of a metadata job.
  # @!attribute [r] completion_percent
  #   @return [::Integer]
  #     Output only. Progress tracking.
  # @!attribute [r] update_time
  #   @return [::Google::Protobuf::Timestamp]
  #     Output only. The time when the status was updated.
  class Status
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # State of a metadata job.
    module State
      # State unspecified.
      STATE_UNSPECIFIED = 0

      # The job is queued.
      QUEUED = 1

      # The job is running.
      RUNNING = 2

      # The job is being canceled.
      CANCELING = 3

      # The job is canceled.
      CANCELED = 4

      # The job succeeded.
      SUCCEEDED = 5

      # The job failed.
      FAILED = 6

      # The job completed with some errors.
      SUCCEEDED_WITH_ERRORS = 7
    end
  end

  # @!attribute [rw] key
  #   @return [::String]
  # @!attribute [rw] value
  #   @return [::String]
  class LabelsEntry
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Metadata job type.
  module Type
    # Unspecified.
    TYPE_UNSPECIFIED = 0

    # Import job.
    IMPORT = 1

    # Export job type.
    EXPORT = 2
  end
end