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

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

Google::Cloud::Dataplex::V1::DataScanService::Paths

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

config (Client::Configuration)

Returns

(Client::Configuration)

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

config (Client::Configuration)

Returns

(Client::Configuration)

#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

result (::Google::Cloud::Dataplex::V1::DataScan)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dataplex::V1::DataScan)

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

result (::Google::Cloud::Dataplex::V1::DataScanJob)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dataplex::V1::DataScanJob)

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

config (Client::Configuration)

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, filter: 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, filter: 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.
filter (::String) — Optional. An expression for filtering the results of the ListDataScanJobs request.

If unspecified, all datascan jobs will be returned. Multiple filters can be applied (with AND, OR logical operators). Filters are case-sensitive.

Allowed fields are:
- start_time
- end_time
start_time and end_time expect RFC-3339 formatted strings (e.g. 2018-10-08T18:30:00-07:00).

For instance, 'start_time > 2018-10-08T00:00:00.123456789Z AND end_time < 2018-10-09T00:00:00.123456789Z' limits results to DataScanJobs between specified start and end times.

Yields

(result, operation) — Access the result along with the TransportOperation object

Yield Parameters

result (::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dataplex::V1::DataScanJob>)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Gapic::Rest::PagedEnumerable<::Google::Cloud::Dataplex::V1::DataScanJob>)

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

result (::Google::Cloud::Dataplex::V1::ListDataScansResponse)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dataplex::V1::ListDataScansResponse)

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

(::Google::Cloud::Dataplex::V1::DataScanService::Rest::Operations)

#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

result (::Google::Cloud::Dataplex::V1::RunDataScanResponse)
operation (::Gapic::Rest::TransportOperation)

Returns

(::Google::Cloud::Dataplex::V1::RunDataScanResponse)

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.