google-cloud-data_catalog-v1 1.0.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9b4e3d575053cbca1e9a8ee849ca70432e06eb34cf80c1fd07e0be2bbd0e131e
-  data.tar.gz: 16b4c10c3eb37c2164e8b058f56045cc50094652d58c88a192ca5f16422f6439
+  metadata.gz: 990f9830aae1710a4d8c96c06665881c16a853281770e82e0a497ee403c2da93
+  data.tar.gz: 397def9fde3c20b1978bce38d97e4d1ce607bf4860fda2fd9a1db862643c130b
 SHA512:
-  metadata.gz: b9208e1a6a9e2d0a328069eb26b750a42091bdbf92d31cbd68b658d2bc813b09b69ee41a5fa34ad12d2a28236826dafcc8d558720690f09aa27b2741f104841a
-  data.tar.gz: '078e25d188a5d815e2e07e3095974324085ed2aa77b672d712353b03aa5127acc6ad0f17f29268e403da5d1a3198bcfff593fa7014c7162e12bc9df8f9ac9829'
+  metadata.gz: 8c7dff149b1d6fae5acb40b9070e73c4bcd2cd86821bf04106b7c184b2305724e146c3bf86fd3e68c0921fe483f22171c332e58f6cd523a79ec51b5f4dfe5ef1
+  data.tar.gz: d0f33019b41d8fc8fa79e13d73eb09d208cdae5013ee92d7d5b3b919ddea46c6150450aa6af0f0675fd75c33e0ec80f64e4c1c5513adb7d7417df96dfe921477

data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb

@@ -3681,6 +3681,275 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Sets the configuration related to the migration to Dataplex for an
+            # organization or project.
+            #
+            # @overload set_config(request, options = nil)
+            #   Pass arguments to `set_config` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::SetConfigRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::SetConfigRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload set_config(name: nil, tag_template_migration: nil, catalog_ui_experience: nil)
+            #   Pass arguments to `set_config` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The organization or project whose config is being specified.
+            #   @param tag_template_migration [::Google::Cloud::DataCatalog::V1::TagTemplateMigration]
+            #     Opt-in status for the migration of Tag Templates to Dataplex.
+            #   @param catalog_ui_experience [::Google::Cloud::DataCatalog::V1::CatalogUIExperience]
+            #     Opt-in status for the UI switch to Dataplex.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::SetConfigRequest.new
+            #
+            #   # Call the set_config method.
+            #   result = client.set_config request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::MigrationConfig.
+            #   p result
+            #
+            def set_config request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::SetConfigRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.set_config.metadata.to_h
+
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.set_config.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.set_config.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :set_config, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Retrieves the configuration related to the migration from Data Catalog to
+            # Dataplex for a specific organization, including all the projects under it
+            # which have a separate configuration set.
+            #
+            # @overload retrieve_config(request, options = nil)
+            #   Pass arguments to `retrieve_config` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::RetrieveConfigRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::RetrieveConfigRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload retrieve_config(name: nil)
+            #   Pass arguments to `retrieve_config` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The organization whose config is being retrieved.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::OrganizationConfig]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::OrganizationConfig]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::RetrieveConfigRequest.new
+            #
+            #   # Call the retrieve_config method.
+            #   result = client.retrieve_config request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::OrganizationConfig.
+            #   p result
+            #
+            def retrieve_config request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RetrieveConfigRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.retrieve_config.metadata.to_h
+
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.retrieve_config.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.retrieve_config.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :retrieve_config, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Retrieves the effective configuration related to the migration from Data
+            # Catalog to Dataplex for a specific organization or project. If there is no
+            # specific configuration set for the resource, the setting is checked
+            # hierarchicahlly through the ancestors of the resource, starting from the
+            # resource itself.
+            #
+            # @overload retrieve_effective_config(request, options = nil)
+            #   Pass arguments to `retrieve_effective_config` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload retrieve_effective_config(name: nil)
+            #   Pass arguments to `retrieve_effective_config` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The resource whose effective config is being retrieved.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest.new
+            #
+            #   # Call the retrieve_effective_config method.
+            #   result = client.retrieve_effective_config request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::MigrationConfig.
+            #   p result
+            #
+            def retrieve_effective_config request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.retrieve_effective_config.metadata.to_h
+
+              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.retrieve_effective_config.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.retrieve_effective_config.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :retrieve_effective_config, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the DataCatalog API.
             #
@@ -4004,6 +4273,21 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :import_entries
+                ##
+                # RPC-specific configuration for `set_config`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :set_config
+                ##
+                # RPC-specific configuration for `retrieve_config`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :retrieve_config
+                ##
+                # RPC-specific configuration for `retrieve_effective_config`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :retrieve_effective_config
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -4075,6 +4359,12 @@ module Google
                   @test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
                   import_entries_config = parent_rpcs.import_entries if parent_rpcs.respond_to? :import_entries
                   @import_entries = ::Gapic::Config::Method.new import_entries_config
+                  set_config_config = parent_rpcs.set_config if parent_rpcs.respond_to? :set_config
+                  @set_config = ::Gapic::Config::Method.new set_config_config
+                  retrieve_config_config = parent_rpcs.retrieve_config if parent_rpcs.respond_to? :retrieve_config
+                  @retrieve_config = ::Gapic::Config::Method.new retrieve_config_config
+                  retrieve_effective_config_config = parent_rpcs.retrieve_effective_config if parent_rpcs.respond_to? :retrieve_effective_config
+                  @retrieve_effective_config = ::Gapic::Config::Method.new retrieve_effective_config_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/data_catalog/v1/data_catalog/operations.rb

@@ -124,14 +124,6 @@ module Google
             # Lists operations that match the specified filter in the request. If the
             # server doesn't support this method, it returns `UNIMPLEMENTED`.
             #
-            # NOTE: the `name` binding allows API services to override the binding
-            # to use different resource name schemes, such as `users/*/operations`. To
-            # override the binding, API services can add a binding such as
-            # `"/v1/{name=users/*}/operations"` to their service configuration.
-            # For backwards compatibility, the default name includes the operations
-            # collection id, however overriding users must ensure the name binding
-            # is the parent resource, without the operations collection id.
-            #
             # @overload list_operations(request, options = nil)
             #   Pass arguments to `list_operations` via a request object, either of type
             #   {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -421,8 +413,9 @@ module Google
             # other methods to check whether the cancellation succeeded or whether the
             # operation completed despite cancellation. On successful cancellation,
             # the operation is not deleted; instead, it becomes an operation with
-            # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-            # corresponding to `Code.CANCELLED`.
+            # an {::Google::Longrunning::Operation#error Operation.error} value with a
+            # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
+            # `Code.CANCELLED`.
             #
             # @overload cancel_operation(request, options = nil)
             #   Pass arguments to `cancel_operation` via a request object, either of type

data/lib/google/cloud/data_catalog/v1/data_catalog/rest/client.rb

@@ -3451,6 +3451,254 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Sets the configuration related to the migration to Dataplex for an
+              # organization or project.
+              #
+              # @overload set_config(request, options = nil)
+              #   Pass arguments to `set_config` via a request object, either of type
+              #   {::Google::Cloud::DataCatalog::V1::SetConfigRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DataCatalog::V1::SetConfigRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload set_config(name: nil, tag_template_migration: nil, catalog_ui_experience: nil)
+              #   Pass arguments to `set_config` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param name [::String]
+              #     Required. The organization or project whose config is being specified.
+              #   @param tag_template_migration [::Google::Cloud::DataCatalog::V1::TagTemplateMigration]
+              #     Opt-in status for the migration of Tag Templates to Dataplex.
+              #   @param catalog_ui_experience [::Google::Cloud::DataCatalog::V1::CatalogUIExperience]
+              #     Opt-in status for the UI switch to Dataplex.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/data_catalog/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DataCatalog::V1::SetConfigRequest.new
+              #
+              #   # Call the set_config method.
+              #   result = client.set_config request
+              #
+              #   # The returned object is of type Google::Cloud::DataCatalog::V1::MigrationConfig.
+              #   p result
+              #
+              def set_config request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::SetConfigRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.set_config.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.set_config.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.set_config.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @data_catalog_stub.set_config request, options do |result, operation|
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Retrieves the configuration related to the migration from Data Catalog to
+              # Dataplex for a specific organization, including all the projects under it
+              # which have a separate configuration set.
+              #
+              # @overload retrieve_config(request, options = nil)
+              #   Pass arguments to `retrieve_config` via a request object, either of type
+              #   {::Google::Cloud::DataCatalog::V1::RetrieveConfigRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DataCatalog::V1::RetrieveConfigRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload retrieve_config(name: nil)
+              #   Pass arguments to `retrieve_config` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param name [::String]
+              #     Required. The organization whose config is being retrieved.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DataCatalog::V1::OrganizationConfig]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DataCatalog::V1::OrganizationConfig]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/data_catalog/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DataCatalog::V1::RetrieveConfigRequest.new
+              #
+              #   # Call the retrieve_config method.
+              #   result = client.retrieve_config request
+              #
+              #   # The returned object is of type Google::Cloud::DataCatalog::V1::OrganizationConfig.
+              #   p result
+              #
+              def retrieve_config request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RetrieveConfigRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.retrieve_config.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.retrieve_config.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.retrieve_config.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @data_catalog_stub.retrieve_config request, options do |result, operation|
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Retrieves the effective configuration related to the migration from Data
+              # Catalog to Dataplex for a specific organization or project. If there is no
+              # specific configuration set for the resource, the setting is checked
+              # hierarchicahlly through the ancestors of the resource, starting from the
+              # resource itself.
+              #
+              # @overload retrieve_effective_config(request, options = nil)
+              #   Pass arguments to `retrieve_effective_config` via a request object, either of type
+              #   {::Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @overload retrieve_effective_config(name: nil)
+              #   Pass arguments to `retrieve_effective_config` via keyword arguments. Note that at
+              #   least one keyword argument is required. To specify no parameters, or to keep all
+              #   the default parameter values, pass an empty Hash as a request object (see above).
+              #
+              #   @param name [::String]
+              #     Required. The resource whose effective config is being retrieved.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DataCatalog::V1::MigrationConfig]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/data_catalog/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest.new
+              #
+              #   # Call the retrieve_effective_config method.
+              #   result = client.retrieve_effective_config request
+              #
+              #   # The returned object is of type Google::Cloud::DataCatalog::V1::MigrationConfig.
+              #   p result
+              #
+              def retrieve_effective_config request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::RetrieveEffectiveConfigRequest
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                call_metadata = @config.rpcs.retrieve_effective_config.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.retrieve_effective_config.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.retrieve_effective_config.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @data_catalog_stub.retrieve_effective_config request, options do |result, operation|
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Configuration class for the DataCatalog REST API.
               #
@@ -3754,6 +4002,21 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :import_entries
+                  ##
+                  # RPC-specific configuration for `set_config`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :set_config
+                  ##
+                  # RPC-specific configuration for `retrieve_config`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :retrieve_config
+                  ##
+                  # RPC-specific configuration for `retrieve_effective_config`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :retrieve_effective_config
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -3825,6 +4088,12 @@ module Google
                     @test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
                     import_entries_config = parent_rpcs.import_entries if parent_rpcs.respond_to? :import_entries
                     @import_entries = ::Gapic::Config::Method.new import_entries_config
+                    set_config_config = parent_rpcs.set_config if parent_rpcs.respond_to? :set_config
+                    @set_config = ::Gapic::Config::Method.new set_config_config
+                    retrieve_config_config = parent_rpcs.retrieve_config if parent_rpcs.respond_to? :retrieve_config
+                    @retrieve_config = ::Gapic::Config::Method.new retrieve_config_config
+                    retrieve_effective_config_config = parent_rpcs.retrieve_effective_config if parent_rpcs.respond_to? :retrieve_effective_config
+                    @retrieve_effective_config = ::Gapic::Config::Method.new retrieve_effective_config_config
 
                     yield self if block_given?
                   end

data/lib/google/cloud/data_catalog/v1/data_catalog/rest/operations.rb

@@ -115,14 +115,6 @@ module Google
               # Lists operations that match the specified filter in the request. If the
               # server doesn't support this method, it returns `UNIMPLEMENTED`.
               #
-              # NOTE: the `name` binding allows API services to override the binding
-              # to use different resource name schemes, such as `users/*/operations`. To
-              # override the binding, API services can add a binding such as
-              # `"/v1/{name=users/*}/operations"` to their service configuration.
-              # For backwards compatibility, the default name includes the operations
-              # collection id, however overriding users must ensure the name binding
-              # is the parent resource, without the operations collection id.
-              #
               # @overload list_operations(request, options = nil)
               #   Pass arguments to `list_operations` via a request object, either of type
               #   {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -390,8 +382,9 @@ module Google
               # other methods to check whether the cancellation succeeded or whether the
               # operation completed despite cancellation. On successful cancellation,
               # the operation is not deleted; instead, it becomes an operation with
-              # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
-              # corresponding to `Code.CANCELLED`.
+              # an {::Google::Longrunning::Operation#error Operation.error} value with a
+              # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
+              # `Code.CANCELLED`.
               #
               # @overload cancel_operation(request, options = nil)
               #   Pass arguments to `cancel_operation` via a request object, either of type