Class: Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaDataConnector

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/discoveryengine_v1/classes.rb,
lib/google/apis/discoveryengine_v1/representations.rb,
lib/google/apis/discoveryengine_v1/representations.rb

Overview

Manages the connection to external data sources for all data stores grouped under a Collection. It's a singleton resource of Collection. The initialization is only supported through DataConnectorService. SetUpDataConnector method, which will create a new Collection and initialize its DataConnector.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ GoogleCloudDiscoveryengineV1alphaDataConnector

Returns a new instance of GoogleCloudDiscoveryengineV1alphaDataConnector.



12504
12505
12506
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12504

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#action_config ⇒ Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaActionConfig

Informations to support actions on the connector. Corresponds to the JSON property actionConfig

Returns:



12337
12338
12339
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12337

def action_config
  @action_config
end

#auto_run_disabled ⇒ Boolean Also known as: auto_run_disabled?

Indicates whether the connector is disabled for auto run. It can be used to pause periodical and real time sync. Corresponds to the JSON property autoRunDisabled

Returns:

  • (Boolean) 


12343
12344
12345
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12343

def auto_run_disabled
  @auto_run_disabled
end

#blocking_reasons ⇒ Array<String>

Output only. User actions that must be completed before the connector can start syncing data. Corresponds to the JSON property blockingReasons

Returns:

  • (Array<String>) 


12350
12351
12352
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12350

def blocking_reasons
  @blocking_reasons
end

#create_time ⇒ String

Output only. Timestamp the DataConnector was created at. Corresponds to the JSON property createTime

Returns:

  • (String) 


12355
12356
12357
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12355

def create_time
  @create_time
end

#data_source ⇒ String

Required. The name of the data source. Supported values: salesforce, jira, confluence, bigquery. Corresponds to the JSON property dataSource

Returns:

  • (String) 


12361
12362
12363
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12361

def data_source
  @data_source
end

#destination_configs ⇒ Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaDestinationConfig>

Optional. Any target destinations used to connect to third-party services. Corresponds to the JSON property destinationConfigs

Returns:



12366
12367
12368
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12366

def destination_configs
  @destination_configs
end

#entities ⇒ Array<Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaDataConnectorSourceEntity>

List of entities from the connected data source to ingest. Corresponds to the JSON property entities

Returns:



12371
12372
12373
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12371

def entities
  @entities
end

#errors ⇒ Array<Google::Apis::DiscoveryengineV1::GoogleRpcStatus>

Output only. The errors from initialization or from the latest connector run. Corresponds to the JSON property errors

Returns:



12376
12377
12378
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12376

def errors
  @errors
end

#identity_refresh_interval ⇒ String

The refresh interval to sync the Access Control List information for the documents ingested by this connector. If not set, the access control list will be refreshed at the default interval of 30 minutes. The identity refresh interval can be at least 30 minutes and at most 7 days. Corresponds to the JSON property identityRefreshInterval

Returns:

  • (String) 


12384
12385
12386
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12384

def identity_refresh_interval
  @identity_refresh_interval
end

#identity_schedule_config ⇒ Google::Apis::DiscoveryengineV1::GoogleCloudDiscoveryengineV1alphaIdentityScheduleConfig

The configuration for the identity data synchronization runs. Corresponds to the JSON property identityScheduleConfig

Returns:



12389
12390
12391
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12389

def identity_schedule_config
  @identity_schedule_config
end

#kms_key_name ⇒ String

Input only. The KMS key to be used to protect the DataStores managed by this connector. Must be set for requests that need to comply with CMEK Org Policy protections. If this field is set and processed successfully, the DataStores created by this connector will be protected by the KMS key. Corresponds to the JSON property kmsKeyName

Returns:

  • (String) 


12397
12398
12399
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12397

def kms_key_name
  @kms_key_name
end

#last_sync_time ⇒ String

Output only. For periodic connectors only, the last time a data sync was completed. Corresponds to the JSON property lastSyncTime

Returns:

  • (String) 


12403
12404
12405
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12403

def last_sync_time
  @last_sync_time
end

#latest_pause_time ⇒ String

Output only. The most recent timestamp when this DataConnector was paused, affecting all functionalities such as data synchronization. Pausing a connector has the following effects: - All functionalities, including data synchronization, are halted. - Any ongoing data synchronization job will be canceled. - No future data synchronization runs will be scheduled nor can be triggered. Corresponds to the JSON property latestPauseTime

Returns:

  • (String) 


12413
12414
12415
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12413

def latest_pause_time
  @latest_pause_time
end

#name ⇒ String

Output only. The full resource name of the Data Connector. Format: projects/*/ locations/*/collections/*/dataConnector. Corresponds to the JSON property name

Returns:

  • (String) 


12419
12420
12421
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12419

def name
  @name
end

#next_sync_time ⇒ Google::Apis::DiscoveryengineV1::GoogleTypeDateTime

Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the time_offset oneof is set. Consider using Timestamp message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations. Corresponds to the JSON property nextSyncTime

Returns:



12437
12438
12439
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12437

def next_sync_time
  @next_sync_time
end

#params ⇒ Hash<String,Object>

Required. Params needed to access the source in the format of (Key, Value) pairs. Required parameters for all data sources: * Key: instance_uri * Value: type STRING. The uri to access the data source. Required parameters for sources that support OAUTH, i.e. salesforce: * Key: client_id * Value: type STRING. The client id for the third party service provider to identify your application. * Key: client_secret * Value:type STRING. The client secret generated by the third party authorization server. * Key: access_token

  • Value: type STRING. OAuth token for UCS to access to the protected resource.
  • Key: refresh_token * Value: type STRING. OAuth refresh token for UCS to obtain a new access token without user interaction. Required parameters for sources that support basic API token auth, i.e. jira, confluence: * Key: user_account * Value: type STRING. The username or email with the source. * Key: api_token * Value: type STRING. The API token generated for the source account, that is used for authenticating anywhere where you would have used a password. Example: json ` "instance_uri": "https://xxx.atlassian.net", " user_account": "xxxx.xxx@xxx.com", "api_token": "test-token" ` Optional parameter to specify the authorization type to use for multiple authorization types support: * Key: auth_type * Value: type STRING. The authorization type for the data source. Supported values: BASIC_AUTH, OAUTH, OAUTH_ACCESS_TOKEN, OAUTH_TWO_LEGGED, OAUTH_JWT_BEARER, OAUTH_PASSWORD_GRANT, JWT, API_TOKEN, FEDERATED_CREDENTIAL. Corresponds to the JSON property params

Returns:

  • (Hash<String,Object>) 


12462
12463
12464
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12462

def params
  @params
end

#private_connectivity_project_id ⇒ String

Output only. The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function. Corresponds to the JSON property privateConnectivityProjectId

Returns:

  • (String) 


12469
12470
12471
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12469

def private_connectivity_project_id
  @private_connectivity_project_id
end

#refresh_interval ⇒ String

Required. The refresh interval for data sync. If duration is set to 0, the data will be synced in real time. The streaming feature is not supported yet. The minimum is 30 minutes and maximum is 7 days. Corresponds to the JSON property refreshInterval

Returns:

  • (String) 


12476
12477
12478
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12476

def refresh_interval
  @refresh_interval
end

#state ⇒ String

Output only. State of the connector. Corresponds to the JSON property state

Returns:

  • (String) 


12481
12482
12483
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12481

def state
  @state
end

#static_ip_addresses ⇒ Array<String>

Output only. The static IP addresses used by this connector. Corresponds to the JSON property staticIpAddresses

Returns:

  • (Array<String>) 


12486
12487
12488
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12486

def static_ip_addresses
  @static_ip_addresses
end

#static_ip_enabled ⇒ Boolean Also known as: static_ip_enabled?

Optional. Whether customer has enabled static IP addresses for this connector. Corresponds to the JSON property staticIpEnabled

Returns:

  • (Boolean) 


12491
12492
12493
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12491

def static_ip_enabled
  @static_ip_enabled
end

#sync_mode ⇒ String

The data synchronization mode supported by the data connector. Corresponds to the JSON property syncMode

Returns:

  • (String) 


12497
12498
12499
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12497

def sync_mode
  @sync_mode
end

#update_time ⇒ String

Output only. Timestamp the DataConnector was last updated. Corresponds to the JSON property updateTime

Returns:

  • (String) 


12502
12503
12504
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12502

def update_time
  @update_time
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



12509
12510
12511
12512
12513
12514
12515
12516
12517
12518
12519
12520
12521
12522
12523
12524
12525
12526
12527
12528
12529
12530
12531
12532
12533
 
# File 'lib/google/apis/discoveryengine_v1/classes.rb', line 12509

def update!(**args)
  @action_config = args[:action_config] if args.key?(:action_config)
  @auto_run_disabled = args[:auto_run_disabled] if args.key?(:auto_run_disabled)
  @blocking_reasons = args[:blocking_reasons] if args.key?(:blocking_reasons)
  @create_time = args[:create_time] if args.key?(:create_time)
  @data_source = args[:data_source] if args.key?(:data_source)
  @destination_configs = args[:destination_configs] if args.key?(:destination_configs)
  @entities = args[:entities] if args.key?(:entities)
  @errors = args[:errors] if args.key?(:errors)
  @identity_refresh_interval = args[:identity_refresh_interval] if args.key?(:identity_refresh_interval)
  @identity_schedule_config = args[:identity_schedule_config] if args.key?(:identity_schedule_config)
  @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
  @last_sync_time = args[:last_sync_time] if args.key?(:last_sync_time)
  @latest_pause_time = args[:latest_pause_time] if args.key?(:latest_pause_time)
  @name = args[:name] if args.key?(:name)
  @next_sync_time = args[:next_sync_time] if args.key?(:next_sync_time)
  @params = args[:params] if args.key?(:params)
  @private_connectivity_project_id = args[:private_connectivity_project_id] if args.key?(:private_connectivity_project_id)
  @refresh_interval = args[:refresh_interval] if args.key?(:refresh_interval)
  @state = args[:state] if args.key?(:state)
  @static_ip_addresses = args[:static_ip_addresses] if args.key?(:static_ip_addresses)
  @static_ip_enabled = args[:static_ip_enabled] if args.key?(:static_ip_enabled)
  @sync_mode = args[:sync_mode] if args.key?(:sync_mode)
  @update_time = args[:update_time] if args.key?(:update_time)
end