google-cloud-data_catalog-v1 0.9.1 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +11 -6
  3. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +394 -5
  4. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +8 -2
  5. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  6. data/lib/google/cloud/data_catalog/v1.rb +2 -0
  7. data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb +2 -1
  8. data/lib/google/cloud/datacatalog/v1/common_pb.rb +8 -1
  9. data/lib/google/cloud/datacatalog/v1/data_source_pb.rb +11 -1
  10. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +56 -2
  11. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +20 -0
  12. data/lib/google/cloud/datacatalog/v1/dataplex_spec_pb.rb +45 -0
  13. data/lib/google/cloud/datacatalog/v1/gcs_fileset_spec_pb.rb +2 -1
  14. data/lib/google/cloud/datacatalog/v1/physical_schema_pb.rb +50 -0
  15. data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +2 -1
  16. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +3 -3
  17. data/lib/google/cloud/datacatalog/v1/schema_pb.rb +2 -1
  18. data/lib/google/cloud/datacatalog/v1/search_pb.rb +2 -1
  19. data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb +2 -1
  20. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +2 -1
  21. data/lib/google/cloud/datacatalog/v1/timestamps_pb.rb +2 -1
  22. data/lib/google/cloud/datacatalog/v1/usage_pb.rb +2 -1
  23. data/proto_docs/google/cloud/datacatalog/v1/common.rb +15 -0
  24. data/proto_docs/google/cloud/datacatalog/v1/data_source.rb +37 -0
  25. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +151 -12
  26. data/proto_docs/google/cloud/datacatalog/v1/dataplex_spec.rb +99 -0
  27. data/proto_docs/google/cloud/datacatalog/v1/physical_schema.rb +96 -0
  28. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +2 -0
  29. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +5 -26
  30. data/proto_docs/google/iam/v1/iam_policy.rb +8 -1
  31. data/proto_docs/google/iam/v1/options.rb +14 -4
  32. data/proto_docs/google/iam/v1/policy.rb +208 -38
  33. metadata +20 -22
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8a311e5a10026572c0e92fe24e6c88e88aefcc45721a71e665e22b294e05073b
4
- data.tar.gz: befa1ec6aebee3e381eb38c635f28395ac78bcf0e923920df0f2d62bf3d94594
3
+ metadata.gz: '0833c987609adaf473aca4a9db8656504ad5e08d53cc6c66e8c9837934c9c1b7'
4
+ data.tar.gz: 2b9ad2d30d214a9a6629cff7199926d7a564d5e98b3b8b85805fb7446a3731e3
5
5
  SHA512:
6
- metadata.gz: 43cfc151fed16cb0a1232e5e1389486b8af28915a745f1092f077b879cb8b2b64a0eed8c8a92ffc010034e0d22d609de89cd20605579efeffbc2b74164191be8
7
- data.tar.gz: ffaa0bb1e5aa359f042ff0d27ac31e67e33979d981cf34b05c0648ae61c1774b240a1cab6eb2526b20c11419b60b02faf1b93d36b7c229736308766e3f4077a7
6
+ metadata.gz: e60e9588dae474a472eed368616e3f95cec9979feefdb713d14831f44762a454255c5a71bad009498ad83d3a291318f4ad6a96b2a3a00df3615a986dea37be24
7
+ data.tar.gz: e4553a603364c5651482de0d7b1b18d73ca340afe8bf4eb8ed3f8446bf302e9a496df861eebc1da0f5b0256cd4ca5e88f7ce76c32774f55fa7779205df2ac862
data/README.md CHANGED
@@ -37,7 +37,7 @@ request = ::Google::Cloud::DataCatalog::V1::SearchCatalogRequest.new # (request
37
37
  response = client.search_catalog request
38
38
  ```
39
39
 
40
- View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-data_catalog-v1/latest)
40
+ View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-data_catalog-v1/latest)
41
41
  for class and method documentation.
42
42
 
43
43
  See also the [Product Documentation](https://cloud.google.com/data-catalog)
@@ -69,16 +69,21 @@ module GRPC
69
69
  end
70
70
  ```
71
71
 
72
+
73
+ ## Google Cloud Samples
74
+
75
+ To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
76
+
72
77
  ## Supported Ruby Versions
73
78
 
74
- This library is supported on Ruby 2.5+.
79
+ This library is supported on Ruby 2.6+.
75
80
 
76
81
  Google provides official support for Ruby versions that are actively supported
77
82
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
78
- in security maintenance, and not end of life. Currently, this means Ruby 2.5
79
- and later. Older versions of Ruby _may_ still work, but are unsupported and not
80
- recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
81
- about the Ruby support schedule.
83
+ in security maintenance, and not end of life. Older versions of Ruby _may_
84
+ still work, but are unsupported and not recommended. See
85
+ https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
86
+ support schedule.
82
87
 
83
88
  ## Which client should I use?
84
89
 
@@ -260,6 +260,7 @@ module Google
260
260
  #
261
261
  # * `relevance` that can only be descending
262
262
  # * `last_modified_timestamp [asc|desc]` with descending (`desc`) as default
263
+ # * `default` that can only be descending
263
264
  #
264
265
  # If this parameter is omitted, it defaults to the descending `relevance`.
265
266
  #
@@ -1456,6 +1457,188 @@ module Google
1456
1457
  raise ::Google::Cloud::Error.from_error(e)
1457
1458
  end
1458
1459
 
1460
+ ##
1461
+ # Modifies entry overview, part of the business context of an
1462
+ # {::Google::Cloud::DataCatalog::V1::Entry Entry}.
1463
+ #
1464
+ # To call this method, you must have the `datacatalog.entries.updateOverview`
1465
+ # IAM permission on the corresponding project.
1466
+ #
1467
+ # @overload modify_entry_overview(request, options = nil)
1468
+ # Pass arguments to `modify_entry_overview` via a request object, either of type
1469
+ # {::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest} or an equivalent Hash.
1470
+ #
1471
+ # @param request [::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest, ::Hash]
1472
+ # A request object representing the call parameters. Required. To specify no
1473
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1474
+ # @param options [::Gapic::CallOptions, ::Hash]
1475
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1476
+ #
1477
+ # @overload modify_entry_overview(name: nil, entry_overview: nil)
1478
+ # Pass arguments to `modify_entry_overview` via keyword arguments. Note that at
1479
+ # least one keyword argument is required. To specify no parameters, or to keep all
1480
+ # the default parameter values, pass an empty Hash as a request object (see above).
1481
+ #
1482
+ # @param name [::String]
1483
+ # Required. The full resource name of the entry.
1484
+ # @param entry_overview [::Google::Cloud::DataCatalog::V1::EntryOverview, ::Hash]
1485
+ # Required. The new value for the Entry Overview.
1486
+ #
1487
+ # @yield [response, operation] Access the result along with the RPC operation
1488
+ # @yieldparam response [::Google::Cloud::DataCatalog::V1::EntryOverview]
1489
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1490
+ #
1491
+ # @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
1492
+ #
1493
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1494
+ #
1495
+ # @example Basic example
1496
+ # require "google/cloud/data_catalog/v1"
1497
+ #
1498
+ # # Create a client object. The client can be reused for multiple calls.
1499
+ # client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
1500
+ #
1501
+ # # Create a request. To set request fields, pass in keyword arguments.
1502
+ # request = Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest.new
1503
+ #
1504
+ # # Call the modify_entry_overview method.
1505
+ # result = client.modify_entry_overview request
1506
+ #
1507
+ # # The returned object is of type Google::Cloud::DataCatalog::V1::EntryOverview.
1508
+ # p result
1509
+ #
1510
+ def modify_entry_overview request, options = nil
1511
+ raise ::ArgumentError, "request must be provided" if request.nil?
1512
+
1513
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest
1514
+
1515
+ # Converts hash and nil to an options object
1516
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1517
+
1518
+ # Customize the options with defaults
1519
+ metadata = @config.rpcs.modify_entry_overview.metadata.to_h
1520
+
1521
+ # Set x-goog-api-client and x-goog-user-project headers
1522
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1523
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1524
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
1525
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1526
+
1527
+ header_params = {}
1528
+ if request.name
1529
+ header_params["name"] = request.name
1530
+ end
1531
+
1532
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1533
+ metadata[:"x-goog-request-params"] ||= request_params_header
1534
+
1535
+ options.apply_defaults timeout: @config.rpcs.modify_entry_overview.timeout,
1536
+ metadata: metadata,
1537
+ retry_policy: @config.rpcs.modify_entry_overview.retry_policy
1538
+
1539
+ options.apply_defaults timeout: @config.timeout,
1540
+ metadata: @config.metadata,
1541
+ retry_policy: @config.retry_policy
1542
+
1543
+ @data_catalog_stub.call_rpc :modify_entry_overview, request, options: options do |response, operation|
1544
+ yield response, operation if block_given?
1545
+ return response
1546
+ end
1547
+ rescue ::GRPC::BadStatus => e
1548
+ raise ::Google::Cloud::Error.from_error(e)
1549
+ end
1550
+
1551
+ ##
1552
+ # Modifies contacts, part of the business context of an
1553
+ # {::Google::Cloud::DataCatalog::V1::Entry Entry}.
1554
+ #
1555
+ # To call this method, you must have the `datacatalog.entries.updateContacts`
1556
+ # IAM permission on the corresponding project.
1557
+ #
1558
+ # @overload modify_entry_contacts(request, options = nil)
1559
+ # Pass arguments to `modify_entry_contacts` via a request object, either of type
1560
+ # {::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest} or an equivalent Hash.
1561
+ #
1562
+ # @param request [::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest, ::Hash]
1563
+ # A request object representing the call parameters. Required. To specify no
1564
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1565
+ # @param options [::Gapic::CallOptions, ::Hash]
1566
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1567
+ #
1568
+ # @overload modify_entry_contacts(name: nil, contacts: nil)
1569
+ # Pass arguments to `modify_entry_contacts` via keyword arguments. Note that at
1570
+ # least one keyword argument is required. To specify no parameters, or to keep all
1571
+ # the default parameter values, pass an empty Hash as a request object (see above).
1572
+ #
1573
+ # @param name [::String]
1574
+ # Required. The full resource name of the entry.
1575
+ # @param contacts [::Google::Cloud::DataCatalog::V1::Contacts, ::Hash]
1576
+ # Required. The new value for the Contacts.
1577
+ #
1578
+ # @yield [response, operation] Access the result along with the RPC operation
1579
+ # @yieldparam response [::Google::Cloud::DataCatalog::V1::Contacts]
1580
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1581
+ #
1582
+ # @return [::Google::Cloud::DataCatalog::V1::Contacts]
1583
+ #
1584
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1585
+ #
1586
+ # @example Basic example
1587
+ # require "google/cloud/data_catalog/v1"
1588
+ #
1589
+ # # Create a client object. The client can be reused for multiple calls.
1590
+ # client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
1591
+ #
1592
+ # # Create a request. To set request fields, pass in keyword arguments.
1593
+ # request = Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest.new
1594
+ #
1595
+ # # Call the modify_entry_contacts method.
1596
+ # result = client.modify_entry_contacts request
1597
+ #
1598
+ # # The returned object is of type Google::Cloud::DataCatalog::V1::Contacts.
1599
+ # p result
1600
+ #
1601
+ def modify_entry_contacts request, options = nil
1602
+ raise ::ArgumentError, "request must be provided" if request.nil?
1603
+
1604
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest
1605
+
1606
+ # Converts hash and nil to an options object
1607
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1608
+
1609
+ # Customize the options with defaults
1610
+ metadata = @config.rpcs.modify_entry_contacts.metadata.to_h
1611
+
1612
+ # Set x-goog-api-client and x-goog-user-project headers
1613
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1614
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1615
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
1616
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1617
+
1618
+ header_params = {}
1619
+ if request.name
1620
+ header_params["name"] = request.name
1621
+ end
1622
+
1623
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1624
+ metadata[:"x-goog-request-params"] ||= request_params_header
1625
+
1626
+ options.apply_defaults timeout: @config.rpcs.modify_entry_contacts.timeout,
1627
+ metadata: metadata,
1628
+ retry_policy: @config.rpcs.modify_entry_contacts.retry_policy
1629
+
1630
+ options.apply_defaults timeout: @config.timeout,
1631
+ metadata: @config.metadata,
1632
+ retry_policy: @config.retry_policy
1633
+
1634
+ @data_catalog_stub.call_rpc :modify_entry_contacts, request, options: options do |response, operation|
1635
+ yield response, operation if block_given?
1636
+ return response
1637
+ end
1638
+ rescue ::GRPC::BadStatus => e
1639
+ raise ::Google::Cloud::Error.from_error(e)
1640
+ end
1641
+
1459
1642
  ##
1460
1643
  # Creates a tag template.
1461
1644
  #
@@ -1677,9 +1860,7 @@ module Google
1677
1860
  # request body, their values are emptied.
1678
1861
  #
1679
1862
  # Note: Updating the `is_publicly_readable` field may require up to 12
1680
- # hours to take effect in search results. Additionally, it also requires
1681
- # the `tagTemplates.getIamPolicy` and `tagTemplates.setIamPolicy`
1682
- # permissions.
1863
+ # hours to take effect in search results.
1683
1864
  #
1684
1865
  # @yield [response, operation] Access the result along with the RPC operation
1685
1866
  # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplate]
@@ -2607,6 +2788,8 @@ module Google
2607
2788
 
2608
2789
  ##
2609
2790
  # Lists tags assigned to an {::Google::Cloud::DataCatalog::V1::Entry Entry}.
2791
+ # The {::Google::Cloud::DataCatalog::V1::Tag#column columns} in the response are
2792
+ # lowercased.
2610
2793
  #
2611
2794
  # @overload list_tags(request, options = nil)
2612
2795
  # Pass arguments to `list_tags` via a request object, either of type
@@ -2706,6 +2889,178 @@ module Google
2706
2889
  raise ::Google::Cloud::Error.from_error(e)
2707
2890
  end
2708
2891
 
2892
+ ##
2893
+ # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as starred by
2894
+ # the current user. Starring information is private to each user.
2895
+ #
2896
+ # @overload star_entry(request, options = nil)
2897
+ # Pass arguments to `star_entry` via a request object, either of type
2898
+ # {::Google::Cloud::DataCatalog::V1::StarEntryRequest} or an equivalent Hash.
2899
+ #
2900
+ # @param request [::Google::Cloud::DataCatalog::V1::StarEntryRequest, ::Hash]
2901
+ # A request object representing the call parameters. Required. To specify no
2902
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2903
+ # @param options [::Gapic::CallOptions, ::Hash]
2904
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2905
+ #
2906
+ # @overload star_entry(name: nil)
2907
+ # Pass arguments to `star_entry` via keyword arguments. Note that at
2908
+ # least one keyword argument is required. To specify no parameters, or to keep all
2909
+ # the default parameter values, pass an empty Hash as a request object (see above).
2910
+ #
2911
+ # @param name [::String]
2912
+ # Required. The name of the entry to mark as starred.
2913
+ #
2914
+ # @yield [response, operation] Access the result along with the RPC operation
2915
+ # @yieldparam response [::Google::Cloud::DataCatalog::V1::StarEntryResponse]
2916
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2917
+ #
2918
+ # @return [::Google::Cloud::DataCatalog::V1::StarEntryResponse]
2919
+ #
2920
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2921
+ #
2922
+ # @example Basic example
2923
+ # require "google/cloud/data_catalog/v1"
2924
+ #
2925
+ # # Create a client object. The client can be reused for multiple calls.
2926
+ # client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
2927
+ #
2928
+ # # Create a request. To set request fields, pass in keyword arguments.
2929
+ # request = Google::Cloud::DataCatalog::V1::StarEntryRequest.new
2930
+ #
2931
+ # # Call the star_entry method.
2932
+ # result = client.star_entry request
2933
+ #
2934
+ # # The returned object is of type Google::Cloud::DataCatalog::V1::StarEntryResponse.
2935
+ # p result
2936
+ #
2937
+ def star_entry request, options = nil
2938
+ raise ::ArgumentError, "request must be provided" if request.nil?
2939
+
2940
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::StarEntryRequest
2941
+
2942
+ # Converts hash and nil to an options object
2943
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2944
+
2945
+ # Customize the options with defaults
2946
+ metadata = @config.rpcs.star_entry.metadata.to_h
2947
+
2948
+ # Set x-goog-api-client and x-goog-user-project headers
2949
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2950
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2951
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
2952
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2953
+
2954
+ header_params = {}
2955
+ if request.name
2956
+ header_params["name"] = request.name
2957
+ end
2958
+
2959
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2960
+ metadata[:"x-goog-request-params"] ||= request_params_header
2961
+
2962
+ options.apply_defaults timeout: @config.rpcs.star_entry.timeout,
2963
+ metadata: metadata,
2964
+ retry_policy: @config.rpcs.star_entry.retry_policy
2965
+
2966
+ options.apply_defaults timeout: @config.timeout,
2967
+ metadata: @config.metadata,
2968
+ retry_policy: @config.retry_policy
2969
+
2970
+ @data_catalog_stub.call_rpc :star_entry, request, options: options do |response, operation|
2971
+ yield response, operation if block_given?
2972
+ return response
2973
+ end
2974
+ rescue ::GRPC::BadStatus => e
2975
+ raise ::Google::Cloud::Error.from_error(e)
2976
+ end
2977
+
2978
+ ##
2979
+ # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as NOT starred by
2980
+ # the current user. Starring information is private to each user.
2981
+ #
2982
+ # @overload unstar_entry(request, options = nil)
2983
+ # Pass arguments to `unstar_entry` via a request object, either of type
2984
+ # {::Google::Cloud::DataCatalog::V1::UnstarEntryRequest} or an equivalent Hash.
2985
+ #
2986
+ # @param request [::Google::Cloud::DataCatalog::V1::UnstarEntryRequest, ::Hash]
2987
+ # A request object representing the call parameters. Required. To specify no
2988
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2989
+ # @param options [::Gapic::CallOptions, ::Hash]
2990
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2991
+ #
2992
+ # @overload unstar_entry(name: nil)
2993
+ # Pass arguments to `unstar_entry` via keyword arguments. Note that at
2994
+ # least one keyword argument is required. To specify no parameters, or to keep all
2995
+ # the default parameter values, pass an empty Hash as a request object (see above).
2996
+ #
2997
+ # @param name [::String]
2998
+ # Required. The name of the entry to mark as **not** starred.
2999
+ #
3000
+ # @yield [response, operation] Access the result along with the RPC operation
3001
+ # @yieldparam response [::Google::Cloud::DataCatalog::V1::UnstarEntryResponse]
3002
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
3003
+ #
3004
+ # @return [::Google::Cloud::DataCatalog::V1::UnstarEntryResponse]
3005
+ #
3006
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
3007
+ #
3008
+ # @example Basic example
3009
+ # require "google/cloud/data_catalog/v1"
3010
+ #
3011
+ # # Create a client object. The client can be reused for multiple calls.
3012
+ # client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
3013
+ #
3014
+ # # Create a request. To set request fields, pass in keyword arguments.
3015
+ # request = Google::Cloud::DataCatalog::V1::UnstarEntryRequest.new
3016
+ #
3017
+ # # Call the unstar_entry method.
3018
+ # result = client.unstar_entry request
3019
+ #
3020
+ # # The returned object is of type Google::Cloud::DataCatalog::V1::UnstarEntryResponse.
3021
+ # p result
3022
+ #
3023
+ def unstar_entry request, options = nil
3024
+ raise ::ArgumentError, "request must be provided" if request.nil?
3025
+
3026
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UnstarEntryRequest
3027
+
3028
+ # Converts hash and nil to an options object
3029
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3030
+
3031
+ # Customize the options with defaults
3032
+ metadata = @config.rpcs.unstar_entry.metadata.to_h
3033
+
3034
+ # Set x-goog-api-client and x-goog-user-project headers
3035
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3036
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3037
+ gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
3038
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3039
+
3040
+ header_params = {}
3041
+ if request.name
3042
+ header_params["name"] = request.name
3043
+ end
3044
+
3045
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
3046
+ metadata[:"x-goog-request-params"] ||= request_params_header
3047
+
3048
+ options.apply_defaults timeout: @config.rpcs.unstar_entry.timeout,
3049
+ metadata: metadata,
3050
+ retry_policy: @config.rpcs.unstar_entry.retry_policy
3051
+
3052
+ options.apply_defaults timeout: @config.timeout,
3053
+ metadata: @config.metadata,
3054
+ retry_policy: @config.retry_policy
3055
+
3056
+ @data_catalog_stub.call_rpc :unstar_entry, request, options: options do |response, operation|
3057
+ yield response, operation if block_given?
3058
+ return response
3059
+ end
3060
+ rescue ::GRPC::BadStatus => e
3061
+ raise ::Google::Cloud::Error.from_error(e)
3062
+ end
3063
+
2709
3064
  ##
2710
3065
  # Sets an access control policy for a resource. Replaces any existing
2711
3066
  # policy.
@@ -2735,7 +3090,7 @@ module Google
2735
3090
  # @param options [::Gapic::CallOptions, ::Hash]
2736
3091
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2737
3092
  #
2738
- # @overload set_iam_policy(resource: nil, policy: nil)
3093
+ # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
2739
3094
  # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
2740
3095
  # least one keyword argument is required. To specify no parameters, or to keep all
2741
3096
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -2748,6 +3103,12 @@ module Google
2748
3103
  # the policy is limited to a few 10s of KB. An empty policy is a
2749
3104
  # valid policy but certain Cloud Platform services (such as Projects)
2750
3105
  # might reject them.
3106
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3107
+ # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
3108
+ # the fields in the mask will be modified. If no mask is provided, the
3109
+ # following default mask is used:
3110
+ #
3111
+ # `paths: "bindings, etag"`
2751
3112
  #
2752
3113
  # @yield [response, operation] Access the result along with the RPC operation
2753
3114
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -2856,7 +3217,7 @@ module Google
2856
3217
  # See the operation documentation for the appropriate value for this field.
2857
3218
  # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
2858
3219
  # OPTIONAL: A `GetPolicyOptions` object for specifying options to
2859
- # `GetIamPolicy`. This field is only used by Cloud IAM.
3220
+ # `GetIamPolicy`.
2860
3221
  #
2861
3222
  # @yield [response, operation] Access the result along with the RPC operation
2862
3223
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -3222,6 +3583,16 @@ module Google
3222
3583
  #
3223
3584
  attr_reader :list_entries
3224
3585
  ##
3586
+ # RPC-specific configuration for `modify_entry_overview`
3587
+ # @return [::Gapic::Config::Method]
3588
+ #
3589
+ attr_reader :modify_entry_overview
3590
+ ##
3591
+ # RPC-specific configuration for `modify_entry_contacts`
3592
+ # @return [::Gapic::Config::Method]
3593
+ #
3594
+ attr_reader :modify_entry_contacts
3595
+ ##
3225
3596
  # RPC-specific configuration for `create_tag_template`
3226
3597
  # @return [::Gapic::Config::Method]
3227
3598
  #
@@ -3287,6 +3658,16 @@ module Google
3287
3658
  #
3288
3659
  attr_reader :list_tags
3289
3660
  ##
3661
+ # RPC-specific configuration for `star_entry`
3662
+ # @return [::Gapic::Config::Method]
3663
+ #
3664
+ attr_reader :star_entry
3665
+ ##
3666
+ # RPC-specific configuration for `unstar_entry`
3667
+ # @return [::Gapic::Config::Method]
3668
+ #
3669
+ attr_reader :unstar_entry
3670
+ ##
3290
3671
  # RPC-specific configuration for `set_iam_policy`
3291
3672
  # @return [::Gapic::Config::Method]
3292
3673
  #
@@ -3328,6 +3709,10 @@ module Google
3328
3709
  @lookup_entry = ::Gapic::Config::Method.new lookup_entry_config
3329
3710
  list_entries_config = parent_rpcs.list_entries if parent_rpcs.respond_to? :list_entries
3330
3711
  @list_entries = ::Gapic::Config::Method.new list_entries_config
3712
+ modify_entry_overview_config = parent_rpcs.modify_entry_overview if parent_rpcs.respond_to? :modify_entry_overview
3713
+ @modify_entry_overview = ::Gapic::Config::Method.new modify_entry_overview_config
3714
+ modify_entry_contacts_config = parent_rpcs.modify_entry_contacts if parent_rpcs.respond_to? :modify_entry_contacts
3715
+ @modify_entry_contacts = ::Gapic::Config::Method.new modify_entry_contacts_config
3331
3716
  create_tag_template_config = parent_rpcs.create_tag_template if parent_rpcs.respond_to? :create_tag_template
3332
3717
  @create_tag_template = ::Gapic::Config::Method.new create_tag_template_config
3333
3718
  get_tag_template_config = parent_rpcs.get_tag_template if parent_rpcs.respond_to? :get_tag_template
@@ -3354,6 +3739,10 @@ module Google
3354
3739
  @delete_tag = ::Gapic::Config::Method.new delete_tag_config
3355
3740
  list_tags_config = parent_rpcs.list_tags if parent_rpcs.respond_to? :list_tags
3356
3741
  @list_tags = ::Gapic::Config::Method.new list_tags_config
3742
+ star_entry_config = parent_rpcs.star_entry if parent_rpcs.respond_to? :star_entry
3743
+ @star_entry = ::Gapic::Config::Method.new star_entry_config
3744
+ unstar_entry_config = parent_rpcs.unstar_entry if parent_rpcs.respond_to? :unstar_entry
3745
+ @unstar_entry = ::Gapic::Config::Method.new unstar_entry_config
3357
3746
  set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
3358
3747
  @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
3359
3748
  get_iam_policy_config = parent_rpcs.get_iam_policy if parent_rpcs.respond_to? :get_iam_policy
@@ -1090,7 +1090,7 @@ module Google
1090
1090
  # See the operation documentation for the appropriate value for this field.
1091
1091
  # @param options [::Google::Iam::V1::GetPolicyOptions, ::Hash]
1092
1092
  # OPTIONAL: A `GetPolicyOptions` object for specifying options to
1093
- # `GetIamPolicy`. This field is only used by Cloud IAM.
1093
+ # `GetIamPolicy`.
1094
1094
  #
1095
1095
  # @yield [response, operation] Access the result along with the RPC operation
1096
1096
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -1169,7 +1169,7 @@ module Google
1169
1169
  # @param options [::Gapic::CallOptions, ::Hash]
1170
1170
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1171
1171
  #
1172
- # @overload set_iam_policy(resource: nil, policy: nil)
1172
+ # @overload set_iam_policy(resource: nil, policy: nil, update_mask: nil)
1173
1173
  # Pass arguments to `set_iam_policy` via keyword arguments. Note that at
1174
1174
  # least one keyword argument is required. To specify no parameters, or to keep all
1175
1175
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -1182,6 +1182,12 @@ module Google
1182
1182
  # the policy is limited to a few 10s of KB. An empty policy is a
1183
1183
  # valid policy but certain Cloud Platform services (such as Projects)
1184
1184
  # might reject them.
1185
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1186
+ # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
1187
+ # the fields in the mask will be modified. If no mask is provided, the
1188
+ # following default mask is used:
1189
+ #
1190
+ # `paths: "bindings, etag"`
1185
1191
  #
1186
1192
  # @yield [response, operation] Access the result along with the RPC operation
1187
1193
  # @yieldparam response [::Google::Iam::V1::Policy]
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module DataCatalog
23
23
  module V1
24
- VERSION = "0.9.1"
24
+ VERSION = "0.12.0"
25
25
  end
26
26
  end
27
27
  end
@@ -27,6 +27,8 @@ module Google
27
27
  ##
28
28
  # To load this package, including all its services, and instantiate a client:
29
29
  #
30
+ # @example
31
+ #
30
32
  # require "google/cloud/data_catalog/v1"
31
33
  # client = ::Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
32
34
  #
@@ -1,9 +1,10 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/datacatalog/v1/bigquery.proto
3
3
 
4
- require 'google/api/field_behavior_pb'
5
4
  require 'google/protobuf'
6
5
 
6
+ require 'google/api/field_behavior_pb'
7
+
7
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
9
  add_file("google/cloud/datacatalog/v1/bigquery.proto", :syntax => :proto3) do
9
10
  add_message "google.cloud.datacatalog.v1.BigQueryConnectionSpec" do
@@ -1,16 +1,22 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/datacatalog/v1/common.proto
3
3
 
4
- require 'google/protobuf/timestamp_pb'
5
4
  require 'google/protobuf'
6
5
 
6
+ require 'google/protobuf/timestamp_pb'
7
+
7
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
9
  add_file("google/cloud/datacatalog/v1/common.proto", :syntax => :proto3) do
10
+ add_message "google.cloud.datacatalog.v1.PersonalDetails" do
11
+ optional :starred, :bool, 1
12
+ optional :star_time, :message, 2, "google.protobuf.Timestamp"
13
+ end
9
14
  add_enum "google.cloud.datacatalog.v1.IntegratedSystem" do
10
15
  value :INTEGRATED_SYSTEM_UNSPECIFIED, 0
11
16
  value :BIGQUERY, 1
12
17
  value :CLOUD_PUBSUB, 2
13
18
  value :DATAPROC_METASTORE, 3
19
+ value :DATAPLEX, 4
14
20
  end
15
21
  end
16
22
  end
@@ -19,6 +25,7 @@ module Google
19
25
  module Cloud
20
26
  module DataCatalog
21
27
  module V1
28
+ PersonalDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.PersonalDetails").msgclass
22
29
  IntegratedSystem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.IntegratedSystem").enummodule
23
30
  end
24
31
  end
@@ -1,20 +1,29 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/datacatalog/v1/data_source.proto
3
3
 
4
- require 'google/api/field_behavior_pb'
5
4
  require 'google/protobuf'
6
5
 
6
+ require 'google/api/field_behavior_pb'
7
+
7
8
  Google::Protobuf::DescriptorPool.generated_pool.build do
8
9
  add_file("google/cloud/datacatalog/v1/data_source.proto", :syntax => :proto3) do
9
10
  add_message "google.cloud.datacatalog.v1.DataSource" do
10
11
  optional :service, :enum, 1, "google.cloud.datacatalog.v1.DataSource.Service"
11
12
  optional :resource, :string, 2
13
+ optional :source_entry, :string, 3
14
+ oneof :properties do
15
+ optional :storage_properties, :message, 4, "google.cloud.datacatalog.v1.StorageProperties"
16
+ end
12
17
  end
13
18
  add_enum "google.cloud.datacatalog.v1.DataSource.Service" do
14
19
  value :SERVICE_UNSPECIFIED, 0
15
20
  value :CLOUD_STORAGE, 1
16
21
  value :BIGQUERY, 2
17
22
  end
23
+ add_message "google.cloud.datacatalog.v1.StorageProperties" do
24
+ repeated :file_pattern, :string, 1
25
+ optional :file_type, :string, 2
26
+ end
18
27
  end
19
28
  end
20
29
 
@@ -24,6 +33,7 @@ module Google
24
33
  module V1
25
34
  DataSource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.DataSource").msgclass
26
35
  DataSource::Service = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.DataSource.Service").enummodule
36
+ StorageProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.StorageProperties").msgclass
27
37
  end
28
38
  end
29
39
  end