Dataplex V1 API - Class Google::Cloud::Dataplex::V1::DataScanService::Rest::Client (v0.9.0)

Reference documentation and code samples for the Dataplex V1 API class Google::Cloud::Dataplex::V1::DataScanService::Rest::Client.

REST client for the DataScanService service.

DataScanService manages DataScan resources which can be configured to run various types of data scanning workload and generate enriched metadata (e.g. Data Profile, Data Quality) for the data source.

Inherits

  • Object

Includes

Methods

.configure

def self.configure() { |config| ... } -> Client::Configuration

Configure the DataScanService Client class.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Returns
Example 
# Modify the configuration for all DataScanService clients ::Google::Cloud::Dataplex::V1::DataScanService::Rest::Client.configure do |config|  config.timeout = 10.0 end

#configure

def configure() { |config| ... } -> Client::Configuration

Configure the DataScanService Client instance.

The configuration is set to the derived mode, meaning that values can be changed, but structural changes (adding new fields, etc.) are not allowed. Structural changes should be made on Client.configure.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Returns

#create_data_scan

def create_data_scan(request, options = nil) -> ::Gapic::Operation def create_data_scan(parent: nil, data_scan: nil, data_scan_id: nil, validate_only: nil) -> ::Gapic::Operation

Creates a DataScan resource.

Overloads 
def create_data_scan(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_data_scan via a request object, either of type CreateDataScanRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::CreateDataScanRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_data_scan(parent: nil, data_scan: nil, data_scan_id: nil, validate_only: nil) -> ::Gapic::Operation
Pass arguments to create_data_scan 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).
Parameters
  • parent (::String) — Required. The resource name of the parent location: projects/{project}/locations/{location_id} where project refers to a project_id or project_number and location_id refers to a GCP region.
  • data_scan (::Google::Cloud::Dataplex::V1::DataScan, ::Hash) — Required. DataScan resource.
  • data_scan_id (::String) —

    Required. DataScan identifier.

    • Must contain only lowercase letters, numbers and hyphens.
    • Must start with a letter.
    • Must end with a number or a letter.
    • Must be between 1-63 characters.
    • Must be unique within the customer project / location.
  • validate_only (::Boolean) — Optional. Only validate the request, but do not perform mutations. The default is false.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#delete_data_scan

def delete_data_scan(request, options = nil) -> ::Gapic::Operation def delete_data_scan(name: nil) -> ::Gapic::Operation

Deletes a DataScan resource.

Overloads 
def delete_data_scan(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_data_scan via a request object, either of type Google::Cloud::Dataplex::V1::DeleteDataScanRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::DeleteDataScanRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_data_scan(name: nil) -> ::Gapic::Operation
Pass arguments to delete_data_scan 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).
Parameter
  • name (::String) — Required. The resource name of the dataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#get_data_scan

def get_data_scan(request, options = nil) -> ::Google::Cloud::Dataplex::V1::DataScan def get_data_scan(name: nil, view: nil) -> ::Google::Cloud::Dataplex::V1::DataScan

Gets a DataScan resource.

Overloads 
def get_data_scan(request, options = nil) -> ::Google::Cloud::Dataplex::V1::DataScan
Pass arguments to get_data_scan via a request object, either of type GetDataScanRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::GetDataScanRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_data_scan(name: nil, view: nil) -> ::Google::Cloud::Dataplex::V1::DataScan
Pass arguments to get_data_scan 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).
Parameters
  • name (::String) — Required. The resource name of the dataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.
  • view (::Google::Cloud::Dataplex::V1::GetDataScanRequest::DataScanView) — Optional. Select the DataScan view to return. Defaults to BASIC.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#get_data_scan_job

def get_data_scan_job(request, options = nil) -> ::Google::Cloud::Dataplex::V1::DataScanJob def get_data_scan_job(name: nil, view: nil) -> ::Google::Cloud::Dataplex::V1::DataScanJob

Gets a DataScanJob resource.

Overloads 
def get_data_scan_job(request, options = nil) -> ::Google::Cloud::Dataplex::V1::DataScanJob
Pass arguments to get_data_scan_job via a request object, either of type GetDataScanJobRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::GetDataScanJobRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_data_scan_job(name: nil, view: nil) -> ::Google::Cloud::Dataplex::V1::DataScanJob
Pass arguments to get_data_scan_job 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).
Parameters
  • name (::String) — Required. The resource name of the DataScanJob: projects/{project}/locations/{location_id}/dataScans/{data_scan_id}/jobs/{data_scan_job_id} where project refers to a project_id or project_number and location_id refers to a GCP region.
  • view (::Google::Cloud::Dataplex::V1::GetDataScanJobRequest::DataScanJobView) — Optional. Select the DataScanJob view to return. Defaults to BASIC.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#iam_policy_client

def iam_policy_client() -> Google::Iam::V1::IAMPolicy::Rest::Client

Get the associated client for mix-in of the IAMPolicy.

Returns
  • (Google::Iam::V1::IAMPolicy::Rest::Client)

#initialize

def initialize() { |config| ... } -> Client

Create a new DataScanService REST client object.

Yields
  • (config) — Configure the DataScanService client.
Yield Parameter
Returns
  • (Client) — a new instance of Client
Example 
# Create a client using the default configuration client = ::Google::Cloud::Dataplex::V1::DataScanService::Rest::Client.new # Create a client using a custom configuration client = ::Google::Cloud::Dataplex::V1::DataScanService::Rest::Client.new do |config|  config.timeout = 10.0 end

#list_data_scan_jobs

def list_data_scan_jobs(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dataplex::V1::DataScanJob> def list_data_scan_jobs(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dataplex::V1::DataScanJob>

Lists DataScanJobs under the given DataScan.

Overloads 
def list_data_scan_jobs(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dataplex::V1::DataScanJob>
Pass arguments to list_data_scan_jobs via a request object, either of type ListDataScanJobsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::ListDataScanJobsRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_data_scan_jobs(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dataplex::V1::DataScanJob>
Pass arguments to list_data_scan_jobs 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).
Parameters
  • parent (::String) — Required. The resource name of the parent environment: projects/{project}/locations/{location_id}/dataScans/{data_scan_id} where project refers to a project_id or project_number and location_id refers to a GCP region.
  • page_size (::Integer) — Optional. Maximum number of DataScanJobs to return. The service may return fewer than this value. If unspecified, at most 10 DataScanJobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
  • page_token (::String) — Optional. Page token received from a previous ListDataScanJobs call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataScanJobs must match the call that provided the page token.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#list_data_scans

def list_data_scans(request, options = nil) -> ::Google::Cloud::Dataplex::V1::ListDataScansResponse def list_data_scans(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Google::Cloud::Dataplex::V1::ListDataScansResponse

Lists DataScans.

Overloads 
def list_data_scans(request, options = nil) -> ::Google::Cloud::Dataplex::V1::ListDataScansResponse
Pass arguments to list_data_scans via a request object, either of type ListDataScansRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::ListDataScansRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_data_scans(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Google::Cloud::Dataplex::V1::ListDataScansResponse
Pass arguments to list_data_scans 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).
Parameters
  • parent (::String) — Required. The resource name of the parent location: projects/{project}/locations/{location_id} where project refers to a project_id or project_number and location_id refers to a GCP region.
  • page_size (::Integer) — Optional. Maximum number of dataScans to return. The service may return fewer than this value. If unspecified, at most 500 scans will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
  • page_token (::String) — Optional. Page token received from a previous ListDataScans call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to ListDataScans must match the call that provided the page token.
  • filter (::String) — Optional. Filter request.
  • order_by (::String) — Optional. Order by fields (name or create_time) for the result. If not specified, the ordering is undefined.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#location_client

def location_client() -> Google::Cloud::Location::Locations::Rest::Client

Get the associated client for mix-in of the Locations.

Returns
  • (Google::Cloud::Location::Locations::Rest::Client)

#operations_client

def operations_client() -> ::Google::Cloud::Dataplex::V1::DataScanService::Rest::Operations

Get the associated client for long-running operations.

Returns

#run_data_scan

def run_data_scan(request, options = nil) -> ::Google::Cloud::Dataplex::V1::RunDataScanResponse def run_data_scan(name: nil) -> ::Google::Cloud::Dataplex::V1::RunDataScanResponse

Runs an on-demand execution of a DataScan

Overloads 
def run_data_scan(request, options = nil) -> ::Google::Cloud::Dataplex::V1::RunDataScanResponse
Pass arguments to run_data_scan via a request object, either of type RunDataScanRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::RunDataScanRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def run_data_scan(name: nil) -> ::Google::Cloud::Dataplex::V1::RunDataScanResponse
Pass arguments to run_data_scan 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).
Parameter
  • name (::String) — Required. The resource name of the DataScan: projects/{project}/locations/{location_id}/dataScans/{data_scan_id}. where project refers to a project_id or project_number and location_id refers to a GCP region.

    Only OnDemand data scans are allowed.

Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.

#update_data_scan

def update_data_scan(request, options = nil) -> ::Gapic::Operation def update_data_scan(data_scan: nil, update_mask: nil, validate_only: nil) -> ::Gapic::Operation

Updates a DataScan resource.

Overloads 
def update_data_scan(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_data_scan via a request object, either of type UpdateDataScanRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Dataplex::V1::UpdateDataScanRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_data_scan(data_scan: nil, update_mask: nil, validate_only: nil) -> ::Gapic::Operation
Pass arguments to update_data_scan 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).
Parameters
  • data_scan (::Google::Cloud::Dataplex::V1::DataScan, ::Hash) — Required. DataScan resource to be updated.

    Only fields specified in update_mask are updated.

  • update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. Mask of fields to update.
  • validate_only (::Boolean) — Optional. Only validate the request, but do not perform mutations. The default is false.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.