published on Thursday, Mar 12, 2026 by Pulumi
published on Thursday, Mar 12, 2026 by Pulumi
DataConnector 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.
To get more information about DataConnector, see:
- API documentation
- How-to Guides
Example Usage
Discoveryengine Dataconnector Servicenow Basic
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const servicenow_basic = new gcp.discoveryengine.DataConnector("servicenow-basic", {
location: "global",
collectionId: "collection-id",
collectionDisplayName: "tf-test-dataconnector-servicenow",
dataSource: "servicenow",
params: {
auth_type: "OAUTH_PASSWORD_GRANT",
instance_uri: "https://gcpconnector1.service-now.com/",
client_id: "SECRET_MANAGER_RESOURCE_NAME",
client_secret: "SECRET_MANAGER_RESOURCE_NAME",
static_ip_enabled: "false",
user_account: "connectorsuserqa@google.com",
password: "SECRET_MANAGER_RESOURCE_NAME",
},
refreshInterval: "86400s",
incrementalRefreshInterval: "21600s",
entities: [
{
entityName: "catalog",
params: JSON.stringify({
inclusion_filters: {
knowledgeBaseSysId: ["123"],
},
}),
},
{
entityName: "incident",
params: JSON.stringify({
inclusion_filters: {
knowledgeBaseSysId: ["123"],
},
}),
},
{
entityName: "knowledge_base",
params: JSON.stringify({
inclusion_filters: {
knowledgeBaseSysId: ["123"],
},
}),
},
],
staticIpEnabled: false,
connectorModes: ["DATA_INGESTION"],
syncMode: "PERIODIC",
});
import pulumi
import json
import pulumi_gcp as gcp
servicenow_basic = gcp.discoveryengine.DataConnector("servicenow-basic",
location="global",
collection_id="collection-id",
collection_display_name="tf-test-dataconnector-servicenow",
data_source="servicenow",
params={
"auth_type": "OAUTH_PASSWORD_GRANT",
"instance_uri": "https://gcpconnector1.service-now.com/",
"client_id": "SECRET_MANAGER_RESOURCE_NAME",
"client_secret": "SECRET_MANAGER_RESOURCE_NAME",
"static_ip_enabled": "false",
"user_account": "connectorsuserqa@google.com",
"password": "SECRET_MANAGER_RESOURCE_NAME",
},
refresh_interval="86400s",
incremental_refresh_interval="21600s",
entities=[
{
"entity_name": "catalog",
"params": json.dumps({
"inclusion_filters": {
"knowledgeBaseSysId": ["123"],
},
}),
},
{
"entity_name": "incident",
"params": json.dumps({
"inclusion_filters": {
"knowledgeBaseSysId": ["123"],
},
}),
},
{
"entity_name": "knowledge_base",
"params": json.dumps({
"inclusion_filters": {
"knowledgeBaseSysId": ["123"],
},
}),
},
],
static_ip_enabled=False,
connector_modes=["DATA_INGESTION"],
sync_mode="PERIODIC")
package main
import (
"encoding/json"
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/discoveryengine"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
tmpJSON0, err := json.Marshal(map[string]interface{}{
"inclusion_filters": map[string]interface{}{
"knowledgeBaseSysId": []string{
"123",
},
},
})
if err != nil {
return err
}
json0 := string(tmpJSON0)
tmpJSON1, err := json.Marshal(map[string]interface{}{
"inclusion_filters": map[string]interface{}{
"knowledgeBaseSysId": []string{
"123",
},
},
})
if err != nil {
return err
}
json1 := string(tmpJSON1)
tmpJSON2, err := json.Marshal(map[string]interface{}{
"inclusion_filters": map[string]interface{}{
"knowledgeBaseSysId": []string{
"123",
},
},
})
if err != nil {
return err
}
json2 := string(tmpJSON2)
_, err = discoveryengine.NewDataConnector(ctx, "servicenow-basic", &discoveryengine.DataConnectorArgs{
Location: pulumi.String("global"),
CollectionId: pulumi.String("collection-id"),
CollectionDisplayName: pulumi.String("tf-test-dataconnector-servicenow"),
DataSource: pulumi.String("servicenow"),
Params: pulumi.StringMap{
"auth_type": pulumi.String("OAUTH_PASSWORD_GRANT"),
"instance_uri": pulumi.String("https://gcpconnector1.service-now.com/"),
"client_id": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"client_secret": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"static_ip_enabled": pulumi.String("false"),
"user_account": pulumi.String("connectorsuserqa@google.com"),
"password": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
},
RefreshInterval: pulumi.String("86400s"),
IncrementalRefreshInterval: pulumi.String("21600s"),
Entities: discoveryengine.DataConnectorEntityArray{
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("catalog"),
Params: pulumi.String(json0),
},
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("incident"),
Params: pulumi.String(json1),
},
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("knowledge_base"),
Params: pulumi.String(json2),
},
},
StaticIpEnabled: pulumi.Bool(false),
ConnectorModes: pulumi.StringArray{
pulumi.String("DATA_INGESTION"),
},
SyncMode: pulumi.String("PERIODIC"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using System.Text.Json;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var servicenow_basic = new Gcp.DiscoveryEngine.DataConnector("servicenow-basic", new()
{
Location = "global",
CollectionId = "collection-id",
CollectionDisplayName = "tf-test-dataconnector-servicenow",
DataSource = "servicenow",
Params =
{
{ "auth_type", "OAUTH_PASSWORD_GRANT" },
{ "instance_uri", "https://gcpconnector1.service-now.com/" },
{ "client_id", "SECRET_MANAGER_RESOURCE_NAME" },
{ "client_secret", "SECRET_MANAGER_RESOURCE_NAME" },
{ "static_ip_enabled", "false" },
{ "user_account", "connectorsuserqa@google.com" },
{ "password", "SECRET_MANAGER_RESOURCE_NAME" },
},
RefreshInterval = "86400s",
IncrementalRefreshInterval = "21600s",
Entities = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "catalog",
Params = JsonSerializer.Serialize(new Dictionary<string, object?>
{
["inclusion_filters"] = new Dictionary<string, object?>
{
["knowledgeBaseSysId"] = new[]
{
"123",
},
},
}),
},
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "incident",
Params = JsonSerializer.Serialize(new Dictionary<string, object?>
{
["inclusion_filters"] = new Dictionary<string, object?>
{
["knowledgeBaseSysId"] = new[]
{
"123",
},
},
}),
},
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "knowledge_base",
Params = JsonSerializer.Serialize(new Dictionary<string, object?>
{
["inclusion_filters"] = new Dictionary<string, object?>
{
["knowledgeBaseSysId"] = new[]
{
"123",
},
},
}),
},
},
StaticIpEnabled = false,
ConnectorModes = new[]
{
"DATA_INGESTION",
},
SyncMode = "PERIODIC",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.discoveryengine.DataConnector;
import com.pulumi.gcp.discoveryengine.DataConnectorArgs;
import com.pulumi.gcp.discoveryengine.inputs.DataConnectorEntityArgs;
import static com.pulumi.codegen.internal.Serialization.*;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var servicenow_basic = new DataConnector("servicenow-basic", DataConnectorArgs.builder()
.location("global")
.collectionId("collection-id")
.collectionDisplayName("tf-test-dataconnector-servicenow")
.dataSource("servicenow")
.params(Map.ofEntries(
Map.entry("auth_type", "OAUTH_PASSWORD_GRANT"),
Map.entry("instance_uri", "https://gcpconnector1.service-now.com/"),
Map.entry("client_id", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("client_secret", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("static_ip_enabled", "false"),
Map.entry("user_account", "connectorsuserqa@google.com"),
Map.entry("password", "SECRET_MANAGER_RESOURCE_NAME")
))
.refreshInterval("86400s")
.incrementalRefreshInterval("21600s")
.entities(
DataConnectorEntityArgs.builder()
.entityName("catalog")
.params(serializeJson(
jsonObject(
jsonProperty("inclusion_filters", jsonObject(
jsonProperty("knowledgeBaseSysId", jsonArray("123"))
))
)))
.build(),
DataConnectorEntityArgs.builder()
.entityName("incident")
.params(serializeJson(
jsonObject(
jsonProperty("inclusion_filters", jsonObject(
jsonProperty("knowledgeBaseSysId", jsonArray("123"))
))
)))
.build(),
DataConnectorEntityArgs.builder()
.entityName("knowledge_base")
.params(serializeJson(
jsonObject(
jsonProperty("inclusion_filters", jsonObject(
jsonProperty("knowledgeBaseSysId", jsonArray("123"))
))
)))
.build())
.staticIpEnabled(false)
.connectorModes("DATA_INGESTION")
.syncMode("PERIODIC")
.build());
}
}
resources:
servicenow-basic:
type: gcp:discoveryengine:DataConnector
properties:
location: global
collectionId: collection-id
collectionDisplayName: tf-test-dataconnector-servicenow
dataSource: servicenow
params:
auth_type: OAUTH_PASSWORD_GRANT
instance_uri: https://gcpconnector1.service-now.com/
client_id: SECRET_MANAGER_RESOURCE_NAME
client_secret: SECRET_MANAGER_RESOURCE_NAME
static_ip_enabled: 'false'
user_account: connectorsuserqa@google.com
password: SECRET_MANAGER_RESOURCE_NAME
refreshInterval: 86400s
incrementalRefreshInterval: 21600s
entities:
- entityName: catalog
params:
fn::toJSON:
inclusion_filters:
knowledgeBaseSysId:
- '123'
- entityName: incident
params:
fn::toJSON:
inclusion_filters:
knowledgeBaseSysId:
- '123'
- entityName: knowledge_base
params:
fn::toJSON:
inclusion_filters:
knowledgeBaseSysId:
- '123'
staticIpEnabled: false
connectorModes:
- DATA_INGESTION
syncMode: PERIODIC
Discoveryengine Dataconnector Jira With Actions
import * as pulumi from "@pulumi/pulumi";
import * as gcp from "@pulumi/gcp";
const jira_with_actions = new gcp.discoveryengine.DataConnector("jira-with-actions", {
location: "global",
collectionId: "collection-id",
collectionDisplayName: "Jira Federated",
dataSource: "jira",
dataSourceVersion: 3,
params: {
instance_uri: "https://example.atlassian.net",
instance_id: "SECRET_MANAGER_RESOURCE_NAME",
client_id: "SECRET_MANAGER_RESOURCE_NAME",
client_secret: "SECRET_MANAGER_RESOURCE_NAME",
refresh_token: "SECRET_MANAGER_RESOURCE_NAME",
auth_type: "OAUTH",
},
refreshInterval: "86400s",
entities: [
{
entityName: "project",
},
{
entityName: "issue",
},
{
entityName: "comment",
},
{
entityName: "attachment",
},
],
staticIpEnabled: false,
destinationConfigs: [{
key: "url",
destinations: [{
host: "https://example.atlassian.net",
}],
}],
connectorModes: [
"FEDERATED",
"ACTIONS",
],
syncMode: "PERIODIC",
autoRunDisabled: true,
incrementalSyncDisabled: true,
actionConfig: {
actionParams: {
instance_uri: "https://example.atlassian.net",
instance_id: "SECRET_MANAGER_RESOURCE_NAME",
client_id: "SECRET_MANAGER_RESOURCE_NAME",
client_secret: "SECRET_MANAGER_RESOURCE_NAME",
auth_type: "OAUTH",
},
createBapConnection: true,
},
bapConfig: {
supportedConnectorModes: ["ACTIONS"],
enabledActions: [
"create_issue",
"update_issue",
"change_issue_status",
"create_comment",
"update_comment",
"upload_attachment",
],
},
});
import pulumi
import pulumi_gcp as gcp
jira_with_actions = gcp.discoveryengine.DataConnector("jira-with-actions",
location="global",
collection_id="collection-id",
collection_display_name="Jira Federated",
data_source="jira",
data_source_version=3,
params={
"instance_uri": "https://example.atlassian.net",
"instance_id": "SECRET_MANAGER_RESOURCE_NAME",
"client_id": "SECRET_MANAGER_RESOURCE_NAME",
"client_secret": "SECRET_MANAGER_RESOURCE_NAME",
"refresh_token": "SECRET_MANAGER_RESOURCE_NAME",
"auth_type": "OAUTH",
},
refresh_interval="86400s",
entities=[
{
"entity_name": "project",
},
{
"entity_name": "issue",
},
{
"entity_name": "comment",
},
{
"entity_name": "attachment",
},
],
static_ip_enabled=False,
destination_configs=[{
"key": "url",
"destinations": [{
"host": "https://example.atlassian.net",
}],
}],
connector_modes=[
"FEDERATED",
"ACTIONS",
],
sync_mode="PERIODIC",
auto_run_disabled=True,
incremental_sync_disabled=True,
action_config={
"action_params": {
"instance_uri": "https://example.atlassian.net",
"instance_id": "SECRET_MANAGER_RESOURCE_NAME",
"client_id": "SECRET_MANAGER_RESOURCE_NAME",
"client_secret": "SECRET_MANAGER_RESOURCE_NAME",
"auth_type": "OAUTH",
},
"create_bap_connection": True,
},
bap_config={
"supported_connector_modes": ["ACTIONS"],
"enabled_actions": [
"create_issue",
"update_issue",
"change_issue_status",
"create_comment",
"update_comment",
"upload_attachment",
],
})
package main
import (
"github.com/pulumi/pulumi-gcp/sdk/v9/go/gcp/discoveryengine"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := discoveryengine.NewDataConnector(ctx, "jira-with-actions", &discoveryengine.DataConnectorArgs{
Location: pulumi.String("global"),
CollectionId: pulumi.String("collection-id"),
CollectionDisplayName: pulumi.String("Jira Federated"),
DataSource: pulumi.String("jira"),
DataSourceVersion: pulumi.Int(3),
Params: pulumi.StringMap{
"instance_uri": pulumi.String("https://example.atlassian.net"),
"instance_id": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"client_id": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"client_secret": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"refresh_token": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"auth_type": pulumi.String("OAUTH"),
},
RefreshInterval: pulumi.String("86400s"),
Entities: discoveryengine.DataConnectorEntityArray{
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("project"),
},
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("issue"),
},
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("comment"),
},
&discoveryengine.DataConnectorEntityArgs{
EntityName: pulumi.String("attachment"),
},
},
StaticIpEnabled: pulumi.Bool(false),
DestinationConfigs: discoveryengine.DataConnectorDestinationConfigArray{
&discoveryengine.DataConnectorDestinationConfigArgs{
Key: pulumi.String("url"),
Destinations: discoveryengine.DataConnectorDestinationConfigDestinationArray{
&discoveryengine.DataConnectorDestinationConfigDestinationArgs{
Host: pulumi.String("https://example.atlassian.net"),
},
},
},
},
ConnectorModes: pulumi.StringArray{
pulumi.String("FEDERATED"),
pulumi.String("ACTIONS"),
},
SyncMode: pulumi.String("PERIODIC"),
AutoRunDisabled: pulumi.Bool(true),
IncrementalSyncDisabled: pulumi.Bool(true),
ActionConfig: &discoveryengine.DataConnectorActionConfigArgs{
ActionParams: pulumi.StringMap{
"instance_uri": pulumi.String("https://example.atlassian.net"),
"instance_id": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"client_id": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"client_secret": pulumi.String("SECRET_MANAGER_RESOURCE_NAME"),
"auth_type": pulumi.String("OAUTH"),
},
CreateBapConnection: pulumi.Bool(true),
},
BapConfig: &discoveryengine.DataConnectorBapConfigArgs{
SupportedConnectorModes: pulumi.StringArray{
pulumi.String("ACTIONS"),
},
EnabledActions: pulumi.StringArray{
pulumi.String("create_issue"),
pulumi.String("update_issue"),
pulumi.String("change_issue_status"),
pulumi.String("create_comment"),
pulumi.String("update_comment"),
pulumi.String("upload_attachment"),
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcp = Pulumi.Gcp;
return await Deployment.RunAsync(() =>
{
var jira_with_actions = new Gcp.DiscoveryEngine.DataConnector("jira-with-actions", new()
{
Location = "global",
CollectionId = "collection-id",
CollectionDisplayName = "Jira Federated",
DataSource = "jira",
DataSourceVersion = 3,
Params =
{
{ "instance_uri", "https://example.atlassian.net" },
{ "instance_id", "SECRET_MANAGER_RESOURCE_NAME" },
{ "client_id", "SECRET_MANAGER_RESOURCE_NAME" },
{ "client_secret", "SECRET_MANAGER_RESOURCE_NAME" },
{ "refresh_token", "SECRET_MANAGER_RESOURCE_NAME" },
{ "auth_type", "OAUTH" },
},
RefreshInterval = "86400s",
Entities = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "project",
},
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "issue",
},
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "comment",
},
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
EntityName = "attachment",
},
},
StaticIpEnabled = false,
DestinationConfigs = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorDestinationConfigArgs
{
Key = "url",
Destinations = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorDestinationConfigDestinationArgs
{
Host = "https://example.atlassian.net",
},
},
},
},
ConnectorModes = new[]
{
"FEDERATED",
"ACTIONS",
},
SyncMode = "PERIODIC",
AutoRunDisabled = true,
IncrementalSyncDisabled = true,
ActionConfig = new Gcp.DiscoveryEngine.Inputs.DataConnectorActionConfigArgs
{
ActionParams =
{
{ "instance_uri", "https://example.atlassian.net" },
{ "instance_id", "SECRET_MANAGER_RESOURCE_NAME" },
{ "client_id", "SECRET_MANAGER_RESOURCE_NAME" },
{ "client_secret", "SECRET_MANAGER_RESOURCE_NAME" },
{ "auth_type", "OAUTH" },
},
CreateBapConnection = true,
},
BapConfig = new Gcp.DiscoveryEngine.Inputs.DataConnectorBapConfigArgs
{
SupportedConnectorModes = new[]
{
"ACTIONS",
},
EnabledActions = new[]
{
"create_issue",
"update_issue",
"change_issue_status",
"create_comment",
"update_comment",
"upload_attachment",
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcp.discoveryengine.DataConnector;
import com.pulumi.gcp.discoveryengine.DataConnectorArgs;
import com.pulumi.gcp.discoveryengine.inputs.DataConnectorEntityArgs;
import com.pulumi.gcp.discoveryengine.inputs.DataConnectorDestinationConfigArgs;
import com.pulumi.gcp.discoveryengine.inputs.DataConnectorActionConfigArgs;
import com.pulumi.gcp.discoveryengine.inputs.DataConnectorBapConfigArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var jira_with_actions = new DataConnector("jira-with-actions", DataConnectorArgs.builder()
.location("global")
.collectionId("collection-id")
.collectionDisplayName("Jira Federated")
.dataSource("jira")
.dataSourceVersion(3)
.params(Map.ofEntries(
Map.entry("instance_uri", "https://example.atlassian.net"),
Map.entry("instance_id", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("client_id", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("client_secret", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("refresh_token", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("auth_type", "OAUTH")
))
.refreshInterval("86400s")
.entities(
DataConnectorEntityArgs.builder()
.entityName("project")
.build(),
DataConnectorEntityArgs.builder()
.entityName("issue")
.build(),
DataConnectorEntityArgs.builder()
.entityName("comment")
.build(),
DataConnectorEntityArgs.builder()
.entityName("attachment")
.build())
.staticIpEnabled(false)
.destinationConfigs(DataConnectorDestinationConfigArgs.builder()
.key("url")
.destinations(DataConnectorDestinationConfigDestinationArgs.builder()
.host("https://example.atlassian.net")
.build())
.build())
.connectorModes(
"FEDERATED",
"ACTIONS")
.syncMode("PERIODIC")
.autoRunDisabled(true)
.incrementalSyncDisabled(true)
.actionConfig(DataConnectorActionConfigArgs.builder()
.actionParams(Map.ofEntries(
Map.entry("instance_uri", "https://example.atlassian.net"),
Map.entry("instance_id", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("client_id", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("client_secret", "SECRET_MANAGER_RESOURCE_NAME"),
Map.entry("auth_type", "OAUTH")
))
.createBapConnection(true)
.build())
.bapConfig(DataConnectorBapConfigArgs.builder()
.supportedConnectorModes("ACTIONS")
.enabledActions(
"create_issue",
"update_issue",
"change_issue_status",
"create_comment",
"update_comment",
"upload_attachment")
.build())
.build());
}
}
resources:
jira-with-actions:
type: gcp:discoveryengine:DataConnector
properties:
location: global
collectionId: collection-id
collectionDisplayName: Jira Federated
dataSource: jira
dataSourceVersion: 3
params:
instance_uri: https://example.atlassian.net
instance_id: SECRET_MANAGER_RESOURCE_NAME
client_id: SECRET_MANAGER_RESOURCE_NAME
client_secret: SECRET_MANAGER_RESOURCE_NAME
refresh_token: SECRET_MANAGER_RESOURCE_NAME
auth_type: OAUTH
refreshInterval: 86400s
entities:
- entityName: project
- entityName: issue
- entityName: comment
- entityName: attachment
staticIpEnabled: false
destinationConfigs:
- key: url
destinations:
- host: https://example.atlassian.net
connectorModes:
- FEDERATED
- ACTIONS
syncMode: PERIODIC
autoRunDisabled: true
incrementalSyncDisabled: true
actionConfig:
actionParams:
instance_uri: https://example.atlassian.net
instance_id: SECRET_MANAGER_RESOURCE_NAME
client_id: SECRET_MANAGER_RESOURCE_NAME
client_secret: SECRET_MANAGER_RESOURCE_NAME
auth_type: OAUTH
createBapConnection: true
bapConfig:
supportedConnectorModes:
- ACTIONS
enabledActions:
- create_issue
- update_issue
- change_issue_status
- create_comment
- update_comment
- upload_attachment
Create DataConnector Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DataConnector(name: string, args: DataConnectorArgs, opts?: CustomResourceOptions);@overload
def DataConnector(resource_name: str,
args: DataConnectorArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DataConnector(resource_name: str,
opts: Optional[ResourceOptions] = None,
data_source: Optional[str] = None,
refresh_interval: Optional[str] = None,
location: Optional[str] = None,
collection_display_name: Optional[str] = None,
collection_id: Optional[str] = None,
incremental_refresh_interval: Optional[str] = None,
json_params: Optional[str] = None,
data_source_version: Optional[int] = None,
destination_configs: Optional[Sequence[DataConnectorDestinationConfigArgs]] = None,
entities: Optional[Sequence[DataConnectorEntityArgs]] = None,
action_config: Optional[DataConnectorActionConfigArgs] = None,
incremental_sync_disabled: Optional[bool] = None,
connector_modes: Optional[Sequence[str]] = None,
kms_key_name: Optional[str] = None,
bap_config: Optional[DataConnectorBapConfigArgs] = None,
params: Optional[Mapping[str, str]] = None,
project: Optional[str] = None,
auto_run_disabled: Optional[bool] = None,
static_ip_enabled: Optional[bool] = None,
sync_mode: Optional[str] = None)func NewDataConnector(ctx *Context, name string, args DataConnectorArgs, opts ...ResourceOption) (*DataConnector, error)public DataConnector(string name, DataConnectorArgs args, CustomResourceOptions? opts = null)
public DataConnector(String name, DataConnectorArgs args)
public DataConnector(String name, DataConnectorArgs args, CustomResourceOptions options)
type: gcp:discoveryengine:DataConnector
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DataConnectorArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DataConnectorArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DataConnectorArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DataConnectorArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DataConnectorArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var dataConnectorResource = new Gcp.DiscoveryEngine.DataConnector("dataConnectorResource", new()
{
DataSource = "string",
RefreshInterval = "string",
Location = "string",
CollectionDisplayName = "string",
CollectionId = "string",
IncrementalRefreshInterval = "string",
JsonParams = "string",
DataSourceVersion = 0,
DestinationConfigs = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorDestinationConfigArgs
{
Destinations = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorDestinationConfigDestinationArgs
{
Host = "string",
},
},
Key = "string",
},
},
Entities = new[]
{
new Gcp.DiscoveryEngine.Inputs.DataConnectorEntityArgs
{
DataStore = "string",
EntityName = "string",
KeyPropertyMappings =
{
{ "string", "string" },
},
Params = "string",
},
},
ActionConfig = new Gcp.DiscoveryEngine.Inputs.DataConnectorActionConfigArgs
{
ActionParams =
{
{ "string", "string" },
},
CreateBapConnection = false,
IsActionConfigured = false,
},
IncrementalSyncDisabled = false,
ConnectorModes = new[]
{
"string",
},
KmsKeyName = "string",
BapConfig = new Gcp.DiscoveryEngine.Inputs.DataConnectorBapConfigArgs
{
EnabledActions = new[]
{
"string",
},
SupportedConnectorModes = new[]
{
"string",
},
},
Params =
{
{ "string", "string" },
},
Project = "string",
AutoRunDisabled = false,
StaticIpEnabled = false,
SyncMode = "string",
});
example, err := discoveryengine.NewDataConnector(ctx, "dataConnectorResource", &discoveryengine.DataConnectorArgs{
DataSource: pulumi.String("string"),
RefreshInterval: pulumi.String("string"),
Location: pulumi.String("string"),
CollectionDisplayName: pulumi.String("string"),
CollectionId: pulumi.String("string"),
IncrementalRefreshInterval: pulumi.String("string"),
JsonParams: pulumi.String("string"),
DataSourceVersion: pulumi.Int(0),
DestinationConfigs: discoveryengine.DataConnectorDestinationConfigArray{
&discoveryengine.DataConnectorDestinationConfigArgs{
Destinations: discoveryengine.DataConnectorDestinationConfigDestinationArray{
&discoveryengine.DataConnectorDestinationConfigDestinationArgs{
Host: pulumi.String("string"),
},
},
Key: pulumi.String("string"),
},
},
Entities: discoveryengine.DataConnectorEntityArray{
&discoveryengine.DataConnectorEntityArgs{
DataStore: pulumi.String("string"),
EntityName: pulumi.String("string"),
KeyPropertyMappings: pulumi.StringMap{
"string": pulumi.String("string"),
},
Params: pulumi.String("string"),
},
},
ActionConfig: &discoveryengine.DataConnectorActionConfigArgs{
ActionParams: pulumi.StringMap{
"string": pulumi.String("string"),
},
CreateBapConnection: pulumi.Bool(false),
IsActionConfigured: pulumi.Bool(false),
},
IncrementalSyncDisabled: pulumi.Bool(false),
ConnectorModes: pulumi.StringArray{
pulumi.String("string"),
},
KmsKeyName: pulumi.String("string"),
BapConfig: &discoveryengine.DataConnectorBapConfigArgs{
EnabledActions: pulumi.StringArray{
pulumi.String("string"),
},
SupportedConnectorModes: pulumi.StringArray{
pulumi.String("string"),
},
},
Params: pulumi.StringMap{
"string": pulumi.String("string"),
},
Project: pulumi.String("string"),
AutoRunDisabled: pulumi.Bool(false),
StaticIpEnabled: pulumi.Bool(false),
SyncMode: pulumi.String("string"),
})
var dataConnectorResource = new DataConnector("dataConnectorResource", DataConnectorArgs.builder()
.dataSource("string")
.refreshInterval("string")
.location("string")
.collectionDisplayName("string")
.collectionId("string")
.incrementalRefreshInterval("string")
.jsonParams("string")
.dataSourceVersion(0)
.destinationConfigs(DataConnectorDestinationConfigArgs.builder()
.destinations(DataConnectorDestinationConfigDestinationArgs.builder()
.host("string")
.build())
.key("string")
.build())
.entities(DataConnectorEntityArgs.builder()
.dataStore("string")
.entityName("string")
.keyPropertyMappings(Map.of("string", "string"))
.params("string")
.build())
.actionConfig(DataConnectorActionConfigArgs.builder()
.actionParams(Map.of("string", "string"))
.createBapConnection(false)
.isActionConfigured(false)
.build())
.incrementalSyncDisabled(false)
.connectorModes("string")
.kmsKeyName("string")
.bapConfig(DataConnectorBapConfigArgs.builder()
.enabledActions("string")
.supportedConnectorModes("string")
.build())
.params(Map.of("string", "string"))
.project("string")
.autoRunDisabled(false)
.staticIpEnabled(false)
.syncMode("string")
.build());
data_connector_resource = gcp.discoveryengine.DataConnector("dataConnectorResource",
data_source="string",
refresh_interval="string",
location="string",
collection_display_name="string",
collection_id="string",
incremental_refresh_interval="string",
json_params="string",
data_source_version=0,
destination_configs=[{
"destinations": [{
"host": "string",
}],
"key": "string",
}],
entities=[{
"data_store": "string",
"entity_name": "string",
"key_property_mappings": {
"string": "string",
},
"params": "string",
}],
action_config={
"action_params": {
"string": "string",
},
"create_bap_connection": False,
"is_action_configured": False,
},
incremental_sync_disabled=False,
connector_modes=["string"],
kms_key_name="string",
bap_config={
"enabled_actions": ["string"],
"supported_connector_modes": ["string"],
},
params={
"string": "string",
},
project="string",
auto_run_disabled=False,
static_ip_enabled=False,
sync_mode="string")
const dataConnectorResource = new gcp.discoveryengine.DataConnector("dataConnectorResource", {
dataSource: "string",
refreshInterval: "string",
location: "string",
collectionDisplayName: "string",
collectionId: "string",
incrementalRefreshInterval: "string",
jsonParams: "string",
dataSourceVersion: 0,
destinationConfigs: [{
destinations: [{
host: "string",
}],
key: "string",
}],
entities: [{
dataStore: "string",
entityName: "string",
keyPropertyMappings: {
string: "string",
},
params: "string",
}],
actionConfig: {
actionParams: {
string: "string",
},
createBapConnection: false,
isActionConfigured: false,
},
incrementalSyncDisabled: false,
connectorModes: ["string"],
kmsKeyName: "string",
bapConfig: {
enabledActions: ["string"],
supportedConnectorModes: ["string"],
},
params: {
string: "string",
},
project: "string",
autoRunDisabled: false,
staticIpEnabled: false,
syncMode: "string",
});
type: gcp:discoveryengine:DataConnector
properties:
actionConfig:
actionParams:
string: string
createBapConnection: false
isActionConfigured: false
autoRunDisabled: false
bapConfig:
enabledActions:
- string
supportedConnectorModes:
- string
collectionDisplayName: string
collectionId: string
connectorModes:
- string
dataSource: string
dataSourceVersion: 0
destinationConfigs:
- destinations:
- host: string
key: string
entities:
- dataStore: string
entityName: string
keyPropertyMappings:
string: string
params: string
incrementalRefreshInterval: string
incrementalSyncDisabled: false
jsonParams: string
kmsKeyName: string
location: string
params:
string: string
project: string
refreshInterval: string
staticIpEnabled: false
syncMode: string
DataConnector Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The DataConnector resource accepts the following input properties:
- Collection
Display stringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- Collection
Id string - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- Data
Source string - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - Location string
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- Refresh
Interval string - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- Action
Config DataConnector Action Config - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- Auto
Run boolDisabled - Indicates whether full syncs are paused for this connector
- Bap
Config DataConnector Bap Config - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- Connector
Modes List<string> - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- Data
Source intVersion - The version of the data source. For example,
3for Jira v3. - Destination
Configs List<DataConnector Destination Config> - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- Entities
List<Data
Connector Entity> - List of entities from the connected data source to ingest. Structure is documented below.
- Incremental
Refresh stringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- Incremental
Sync boolDisabled - Indicates whether incremental syncs are paused for this connector.
- Json
Params string - Params needed to access the source in the format of json string.
- Kms
Key stringName - 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.
- Params Dictionary<string, string>
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Static
Ip boolEnabled - Whether customer has enabled static IP addresses for this connector.
- Sync
Mode string - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- Collection
Display stringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- Collection
Id string - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- Data
Source string - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - Location string
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- Refresh
Interval string - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- Action
Config DataConnector Action Config Args - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- Auto
Run boolDisabled - Indicates whether full syncs are paused for this connector
- Bap
Config DataConnector Bap Config Args - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- Connector
Modes []string - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- Data
Source intVersion - The version of the data source. For example,
3for Jira v3. - Destination
Configs []DataConnector Destination Config Args - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- Entities
[]Data
Connector Entity Args - List of entities from the connected data source to ingest. Structure is documented below.
- Incremental
Refresh stringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- Incremental
Sync boolDisabled - Indicates whether incremental syncs are paused for this connector.
- Json
Params string - Params needed to access the source in the format of json string.
- Kms
Key stringName - 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.
- Params map[string]string
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Static
Ip boolEnabled - Whether customer has enabled static IP addresses for this connector.
- Sync
Mode string - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- collection
Display StringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection
Id String - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- data
Source String - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - location String
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- refresh
Interval String - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- action
Config DataConnector Action Config - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- auto
Run BooleanDisabled - Indicates whether full syncs are paused for this connector
- bap
Config DataConnector Bap Config - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- connector
Modes List<String> - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- data
Source IntegerVersion - The version of the data source. For example,
3for Jira v3. - destination
Configs List<DataConnector Destination Config> - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities
List<Data
Connector Entity> - List of entities from the connected data source to ingest. Structure is documented below.
- incremental
Refresh StringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental
Sync BooleanDisabled - Indicates whether incremental syncs are paused for this connector.
- json
Params String - Params needed to access the source in the format of json string.
- kms
Key StringName - 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.
- params Map<String,String>
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- static
Ip BooleanEnabled - Whether customer has enabled static IP addresses for this connector.
- sync
Mode String - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- collection
Display stringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection
Id string - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- data
Source string - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - location string
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- refresh
Interval string - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- action
Config DataConnector Action Config - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- auto
Run booleanDisabled - Indicates whether full syncs are paused for this connector
- bap
Config DataConnector Bap Config - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- connector
Modes string[] - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- data
Source numberVersion - The version of the data source. For example,
3for Jira v3. - destination
Configs DataConnector Destination Config[] - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities
Data
Connector Entity[] - List of entities from the connected data source to ingest. Structure is documented below.
- incremental
Refresh stringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental
Sync booleanDisabled - Indicates whether incremental syncs are paused for this connector.
- json
Params string - Params needed to access the source in the format of json string.
- kms
Key stringName - 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.
- params {[key: string]: string}
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- static
Ip booleanEnabled - Whether customer has enabled static IP addresses for this connector.
- sync
Mode string - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- collection_
display_ strname - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection_
id str - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- data_
source str - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - location str
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- refresh_
interval str - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- action_
config DataConnector Action Config Args - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- auto_
run_ booldisabled - Indicates whether full syncs are paused for this connector
- bap_
config DataConnector Bap Config Args - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- connector_
modes Sequence[str] - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- data_
source_ intversion - The version of the data source. For example,
3for Jira v3. - destination_
configs Sequence[DataConnector Destination Config Args] - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities
Sequence[Data
Connector Entity Args] - List of entities from the connected data source to ingest. Structure is documented below.
- incremental_
refresh_ strinterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental_
sync_ booldisabled - Indicates whether incremental syncs are paused for this connector.
- json_
params str - Params needed to access the source in the format of json string.
- kms_
key_ strname - 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.
- params Mapping[str, str]
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- static_
ip_ boolenabled - Whether customer has enabled static IP addresses for this connector.
- sync_
mode str - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- collection
Display StringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection
Id String - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- data
Source String - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - location String
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- refresh
Interval String - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- action
Config Property Map - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- auto
Run BooleanDisabled - Indicates whether full syncs are paused for this connector
- bap
Config Property Map - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- connector
Modes List<String> - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- data
Source NumberVersion - The version of the data source. For example,
3for Jira v3. - destination
Configs List<Property Map> - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities List<Property Map>
- List of entities from the connected data source to ingest. Structure is documented below.
- incremental
Refresh StringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental
Sync BooleanDisabled - Indicates whether incremental syncs are paused for this connector.
- json
Params String - Params needed to access the source in the format of json string.
- kms
Key StringName - 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.
- params Map<String>
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- static
Ip BooleanEnabled - Whether customer has enabled static IP addresses for this connector.
- sync
Mode String - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
Outputs
All input properties are implicitly available as output properties. Additionally, the DataConnector resource produces the following output properties:
- Action
State string - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Blocking
Reasons List<string> - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- Connector
Type string - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- Create
Time string - Timestamp when the DataConnector was created.
- Errors
List<Data
Connector Error> - The errors from initialization or from the latest connector run. Structure is documented below.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Sync stringTime - For periodic connectors only, the last time a data sync was completed.
- Latest
Pause stringTime - 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.
- Name string
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - Private
Connectivity stringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- Realtime
State string - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- State string
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Static
Ip List<string>Addresses - The static IP addresses used by this connector.
- Update
Time string - Timestamp when the DataConnector was updated.
- Action
State string - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Blocking
Reasons []string - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- Connector
Type string - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- Create
Time string - Timestamp when the DataConnector was created.
- Errors
[]Data
Connector Error - The errors from initialization or from the latest connector run. Structure is documented below.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Sync stringTime - For periodic connectors only, the last time a data sync was completed.
- Latest
Pause stringTime - 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.
- Name string
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - Private
Connectivity stringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- Realtime
State string - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- State string
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Static
Ip []stringAddresses - The static IP addresses used by this connector.
- Update
Time string - Timestamp when the DataConnector was updated.
- action
State String - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- blocking
Reasons List<String> - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- connector
Type String - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create
Time String - Timestamp when the DataConnector was created.
- errors
List<Data
Connector Error> - The errors from initialization or from the latest connector run. Structure is documented below.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Sync StringTime - For periodic connectors only, the last time a data sync was completed.
- latest
Pause StringTime - 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.
- name String
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - private
Connectivity StringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- realtime
State String - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- state String
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static
Ip List<String>Addresses - The static IP addresses used by this connector.
- update
Time String - Timestamp when the DataConnector was updated.
- action
State string - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- blocking
Reasons string[] - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- connector
Type string - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create
Time string - Timestamp when the DataConnector was created.
- errors
Data
Connector Error[] - The errors from initialization or from the latest connector run. Structure is documented below.
- id string
- The provider-assigned unique ID for this managed resource.
- last
Sync stringTime - For periodic connectors only, the last time a data sync was completed.
- latest
Pause stringTime - 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.
- name string
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - private
Connectivity stringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- realtime
State string - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- state string
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static
Ip string[]Addresses - The static IP addresses used by this connector.
- update
Time string - Timestamp when the DataConnector was updated.
- action_
state str - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- blocking_
reasons Sequence[str] - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- connector_
type str - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create_
time str - Timestamp when the DataConnector was created.
- errors
Sequence[Data
Connector Error] - The errors from initialization or from the latest connector run. Structure is documented below.
- id str
- The provider-assigned unique ID for this managed resource.
- last_
sync_ strtime - For periodic connectors only, the last time a data sync was completed.
- latest_
pause_ strtime - 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.
- name str
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - private_
connectivity_ strproject_ id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- realtime_
state str - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- state str
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static_
ip_ Sequence[str]addresses - The static IP addresses used by this connector.
- update_
time str - Timestamp when the DataConnector was updated.
- action
State String - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- blocking
Reasons List<String> - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- connector
Type String - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create
Time String - Timestamp when the DataConnector was created.
- errors List<Property Map>
- The errors from initialization or from the latest connector run. Structure is documented below.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Sync StringTime - For periodic connectors only, the last time a data sync was completed.
- latest
Pause StringTime - 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.
- name String
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - private
Connectivity StringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- realtime
State String - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- state String
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static
Ip List<String>Addresses - The static IP addresses used by this connector.
- update
Time String - Timestamp when the DataConnector was updated.
Look up Existing DataConnector Resource
Get an existing DataConnector resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: DataConnectorState, opts?: CustomResourceOptions): DataConnector@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
action_config: Optional[DataConnectorActionConfigArgs] = None,
action_state: Optional[str] = None,
auto_run_disabled: Optional[bool] = None,
bap_config: Optional[DataConnectorBapConfigArgs] = None,
blocking_reasons: Optional[Sequence[str]] = None,
collection_display_name: Optional[str] = None,
collection_id: Optional[str] = None,
connector_modes: Optional[Sequence[str]] = None,
connector_type: Optional[str] = None,
create_time: Optional[str] = None,
data_source: Optional[str] = None,
data_source_version: Optional[int] = None,
destination_configs: Optional[Sequence[DataConnectorDestinationConfigArgs]] = None,
entities: Optional[Sequence[DataConnectorEntityArgs]] = None,
errors: Optional[Sequence[DataConnectorErrorArgs]] = None,
incremental_refresh_interval: Optional[str] = None,
incremental_sync_disabled: Optional[bool] = None,
json_params: Optional[str] = None,
kms_key_name: Optional[str] = None,
last_sync_time: Optional[str] = None,
latest_pause_time: Optional[str] = None,
location: Optional[str] = None,
name: Optional[str] = None,
params: Optional[Mapping[str, str]] = None,
private_connectivity_project_id: Optional[str] = None,
project: Optional[str] = None,
realtime_state: Optional[str] = None,
refresh_interval: Optional[str] = None,
state: Optional[str] = None,
static_ip_addresses: Optional[Sequence[str]] = None,
static_ip_enabled: Optional[bool] = None,
sync_mode: Optional[str] = None,
update_time: Optional[str] = None) -> DataConnectorfunc GetDataConnector(ctx *Context, name string, id IDInput, state *DataConnectorState, opts ...ResourceOption) (*DataConnector, error)public static DataConnector Get(string name, Input<string> id, DataConnectorState? state, CustomResourceOptions? opts = null)public static DataConnector get(String name, Output<String> id, DataConnectorState state, CustomResourceOptions options)resources: _: type: gcp:discoveryengine:DataConnector get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Action
Config DataConnector Action Config - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- Action
State string - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Auto
Run boolDisabled - Indicates whether full syncs are paused for this connector
- Bap
Config DataConnector Bap Config - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- Blocking
Reasons List<string> - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- Collection
Display stringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- Collection
Id string - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- Connector
Modes List<string> - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- Connector
Type string - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- Create
Time string - Timestamp when the DataConnector was created.
- Data
Source string - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - Data
Source intVersion - The version of the data source. For example,
3for Jira v3. - Destination
Configs List<DataConnector Destination Config> - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- Entities
List<Data
Connector Entity> - List of entities from the connected data source to ingest. Structure is documented below.
- Errors
List<Data
Connector Error> - The errors from initialization or from the latest connector run. Structure is documented below.
- Incremental
Refresh stringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- Incremental
Sync boolDisabled - Indicates whether incremental syncs are paused for this connector.
- Json
Params string - Params needed to access the source in the format of json string.
- Kms
Key stringName - 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.
- Last
Sync stringTime - For periodic connectors only, the last time a data sync was completed.
- Latest
Pause stringTime - 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.
- Location string
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- Name string
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - Params Dictionary<string, string>
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- Private
Connectivity stringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Realtime
State string - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Refresh
Interval string - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- State string
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Static
Ip List<string>Addresses - The static IP addresses used by this connector.
- Static
Ip boolEnabled - Whether customer has enabled static IP addresses for this connector.
- Sync
Mode string - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- Update
Time string - Timestamp when the DataConnector was updated.
- Action
Config DataConnector Action Config Args - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- Action
State string - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Auto
Run boolDisabled - Indicates whether full syncs are paused for this connector
- Bap
Config DataConnector Bap Config Args - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- Blocking
Reasons []string - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- Collection
Display stringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- Collection
Id string - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- Connector
Modes []string - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- Connector
Type string - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- Create
Time string - Timestamp when the DataConnector was created.
- Data
Source string - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - Data
Source intVersion - The version of the data source. For example,
3for Jira v3. - Destination
Configs []DataConnector Destination Config Args - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- Entities
[]Data
Connector Entity Args - List of entities from the connected data source to ingest. Structure is documented below.
- Errors
[]Data
Connector Error Args - The errors from initialization or from the latest connector run. Structure is documented below.
- Incremental
Refresh stringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- Incremental
Sync boolDisabled - Indicates whether incremental syncs are paused for this connector.
- Json
Params string - Params needed to access the source in the format of json string.
- Kms
Key stringName - 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.
- Last
Sync stringTime - For periodic connectors only, the last time a data sync was completed.
- Latest
Pause stringTime - 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.
- Location string
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- Name string
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - Params map[string]string
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- Private
Connectivity stringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- Project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- Realtime
State string - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Refresh
Interval string - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- State string
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- Static
Ip []stringAddresses - The static IP addresses used by this connector.
- Static
Ip boolEnabled - Whether customer has enabled static IP addresses for this connector.
- Sync
Mode string - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- Update
Time string - Timestamp when the DataConnector was updated.
- action
Config DataConnector Action Config - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- action
State String - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- auto
Run BooleanDisabled - Indicates whether full syncs are paused for this connector
- bap
Config DataConnector Bap Config - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- blocking
Reasons List<String> - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- collection
Display StringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection
Id String - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- connector
Modes List<String> - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- connector
Type String - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create
Time String - Timestamp when the DataConnector was created.
- data
Source String - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - data
Source IntegerVersion - The version of the data source. For example,
3for Jira v3. - destination
Configs List<DataConnector Destination Config> - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities
List<Data
Connector Entity> - List of entities from the connected data source to ingest. Structure is documented below.
- errors
List<Data
Connector Error> - The errors from initialization or from the latest connector run. Structure is documented below.
- incremental
Refresh StringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental
Sync BooleanDisabled - Indicates whether incremental syncs are paused for this connector.
- json
Params String - Params needed to access the source in the format of json string.
- kms
Key StringName - 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.
- last
Sync StringTime - For periodic connectors only, the last time a data sync was completed.
- latest
Pause StringTime - 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.
- location String
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- name String
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - params Map<String,String>
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- private
Connectivity StringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- realtime
State String - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- refresh
Interval String - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- state String
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static
Ip List<String>Addresses - The static IP addresses used by this connector.
- static
Ip BooleanEnabled - Whether customer has enabled static IP addresses for this connector.
- sync
Mode String - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- update
Time String - Timestamp when the DataConnector was updated.
- action
Config DataConnector Action Config - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- action
State string - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- auto
Run booleanDisabled - Indicates whether full syncs are paused for this connector
- bap
Config DataConnector Bap Config - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- blocking
Reasons string[] - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- collection
Display stringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection
Id string - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- connector
Modes string[] - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- connector
Type string - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create
Time string - Timestamp when the DataConnector was created.
- data
Source string - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - data
Source numberVersion - The version of the data source. For example,
3for Jira v3. - destination
Configs DataConnector Destination Config[] - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities
Data
Connector Entity[] - List of entities from the connected data source to ingest. Structure is documented below.
- errors
Data
Connector Error[] - The errors from initialization or from the latest connector run. Structure is documented below.
- incremental
Refresh stringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental
Sync booleanDisabled - Indicates whether incremental syncs are paused for this connector.
- json
Params string - Params needed to access the source in the format of json string.
- kms
Key stringName - 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.
- last
Sync stringTime - For periodic connectors only, the last time a data sync was completed.
- latest
Pause stringTime - 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.
- location string
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- name string
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - params {[key: string]: string}
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- private
Connectivity stringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- project string
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- realtime
State string - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- refresh
Interval string - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- state string
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static
Ip string[]Addresses - The static IP addresses used by this connector.
- static
Ip booleanEnabled - Whether customer has enabled static IP addresses for this connector.
- sync
Mode string - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- update
Time string - Timestamp when the DataConnector was updated.
- action_
config DataConnector Action Config Args - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- action_
state str - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- auto_
run_ booldisabled - Indicates whether full syncs are paused for this connector
- bap_
config DataConnector Bap Config Args - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- blocking_
reasons Sequence[str] - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- collection_
display_ strname - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection_
id str - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- connector_
modes Sequence[str] - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- connector_
type str - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create_
time str - Timestamp when the DataConnector was created.
- data_
source str - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - data_
source_ intversion - The version of the data source. For example,
3for Jira v3. - destination_
configs Sequence[DataConnector Destination Config Args] - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities
Sequence[Data
Connector Entity Args] - List of entities from the connected data source to ingest. Structure is documented below.
- errors
Sequence[Data
Connector Error Args] - The errors from initialization or from the latest connector run. Structure is documented below.
- incremental_
refresh_ strinterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental_
sync_ booldisabled - Indicates whether incremental syncs are paused for this connector.
- json_
params str - Params needed to access the source in the format of json string.
- kms_
key_ strname - 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.
- last_
sync_ strtime - For periodic connectors only, the last time a data sync was completed.
- latest_
pause_ strtime - 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.
- location str
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- name str
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - params Mapping[str, str]
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- private_
connectivity_ strproject_ id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- project str
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- realtime_
state str - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- refresh_
interval str - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- state str
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static_
ip_ Sequence[str]addresses - The static IP addresses used by this connector.
- static_
ip_ boolenabled - Whether customer has enabled static IP addresses for this connector.
- sync_
mode str - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- update_
time str - Timestamp when the DataConnector was updated.
- action
Config Property Map - Action configuration for the data connector. Configures action capabilities for connectors that support the ACTIONS connector mode. Structure is documented below.
- action
State String - State of the action connector. This reflects whether the action connector is initializing, active or has encountered errors. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- auto
Run BooleanDisabled - Indicates whether full syncs are paused for this connector
- bap
Config Property Map - BAP (Business Application Platform) configuration for the data connector. Controls which actions are enabled for connectors using the ACTIONS connector mode. Structure is documented below.
- blocking
Reasons List<String> - User actions that must be completed before the connector can start syncing data. The possible values can be: 'ALLOWLIST_STATIC_IP', 'ALLOWLIST_IN_SERVICE_ATTACHMENT'.
- collection
Display StringName - The display name of the Collection. Should be human readable, used to display collections in the Console Dashboard. UTF-8 encoded string with limit of 1024 characters.
- collection
Id String - The ID to use for the Collection, which will become the final component of the Collection's resource name. A new Collection is created as part of the DataConnector setup. DataConnector is a singleton resource under Collection, managing all DataStores of the Collection. This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.
- connector
Modes List<String> - The modes enabled for this connector. The possible value can be: 'DATA_INGESTION', 'ACTIONS', 'FEDERATED' 'EUA', 'FEDERATED_AND_EUA'.
- connector
Type String - The type of connector. Each source can only map to one type. For example, salesforce, confluence and jira have THIRD_PARTY connector type. It is not mutable once set by system. The possible value can be: 'CONNECTOR_TYPE_UNSPECIFIED', 'THIRD_PARTY', 'GCP_FHIR', 'BIG_QUERY', 'GCS', 'GOOGLE_MAIL', 'GOOGLE_CALENDAR', 'GOOGLE_DRIVE', 'NATIVE_CLOUD_IDENTITY', 'THIRD_PARTY_FEDERATED', 'THIRD_PARTY_EUA', 'GCNV'.
- create
Time String - Timestamp when the DataConnector was created.
- data
Source String - The name of the data source.
Supported values:
salesforce,jira,confluence,bigquery. - data
Source NumberVersion - The version of the data source. For example,
3for Jira v3. - destination
Configs List<Property Map> - Destination connector configurations for the data connector, used to configure where data is served. Structure is documented below.
- entities List<Property Map>
- List of entities from the connected data source to ingest. Structure is documented below.
- errors List<Property Map>
- The errors from initialization or from the latest connector run. Structure is documented below.
- incremental
Refresh StringInterval - The refresh interval specifically for incremental data syncs. If unset, incremental syncs will use the default from env, set to 3hrs. The minimum is 30 minutes and maximum is 7 days. Applicable to only 3P connectors. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- incremental
Sync BooleanDisabled - Indicates whether incremental syncs are paused for this connector.
- json
Params String - Params needed to access the source in the format of json string.
- kms
Key StringName - 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.
- last
Sync StringTime - For periodic connectors only, the last time a data sync was completed.
- latest
Pause StringTime - 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.
- location String
- The geographic location where the data store should reside. The value can only be one of "global", "us" and "eu".
- name String
- The full resource name of the Data Connector.
Format:
projects/*/locations/*/collections/*/dataConnector. - params Map<String>
- Params needed to access the source in the format of String-to-String (Key, Value) pairs.
- private
Connectivity StringProject Id - The tenant project ID associated with private connectivity connectors. This project must be allowlisted by in order for the connector to function.
- project String
- The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
- realtime
State String - The real-time sync state. The possible values can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- refresh
Interval String - 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. When the refresh interval is set to the same value as the incremental refresh interval, incremental sync will be disabled.
- state String
- The state of connector. The possible value can be: 'STATE_UNSPECIFIED', 'CREATING', 'ACTIVE', 'FAILED', 'RUNNING', 'WARNING', 'INITIALIZATION_FAILED', 'UPDATING'.
- static
Ip List<String>Addresses - The static IP addresses used by this connector.
- static
Ip BooleanEnabled - Whether customer has enabled static IP addresses for this connector.
- sync
Mode String - The data synchronization mode supported by the data connector. The possible value can be: 'PERIODIC', 'STREAMING'.
- update
Time String - Timestamp when the DataConnector was updated.
Supporting Types
DataConnectorActionConfig, DataConnectorActionConfigArgs
- Action
Params Dictionary<string, string> - Params needed to configure the actions in the format of String-to-String (Key, Value) pairs. Contains connection credentials and configuration for the action connector.
- Create
Bap boolConnection - Whether to create a BAP (Business Application Platform) connection for this action connector.
- Is
Action boolConfigured - (Output) Whether the action connector is fully configured. Set by the system after the action configuration is validated.
- Action
Params map[string]string - Params needed to configure the actions in the format of String-to-String (Key, Value) pairs. Contains connection credentials and configuration for the action connector.
- Create
Bap boolConnection - Whether to create a BAP (Business Application Platform) connection for this action connector.
- Is
Action boolConfigured - (Output) Whether the action connector is fully configured. Set by the system after the action configuration is validated.
- action
Params Map<String,String> - Params needed to configure the actions in the format of String-to-String (Key, Value) pairs. Contains connection credentials and configuration for the action connector.
- create
Bap BooleanConnection - Whether to create a BAP (Business Application Platform) connection for this action connector.
- is
Action BooleanConfigured - (Output) Whether the action connector is fully configured. Set by the system after the action configuration is validated.
- action
Params {[key: string]: string} - Params needed to configure the actions in the format of String-to-String (Key, Value) pairs. Contains connection credentials and configuration for the action connector.
- create
Bap booleanConnection - Whether to create a BAP (Business Application Platform) connection for this action connector.
- is
Action booleanConfigured - (Output) Whether the action connector is fully configured. Set by the system after the action configuration is validated.
- action_
params Mapping[str, str] - Params needed to configure the actions in the format of String-to-String (Key, Value) pairs. Contains connection credentials and configuration for the action connector.
- create_
bap_ boolconnection - Whether to create a BAP (Business Application Platform) connection for this action connector.
- is_
action_ boolconfigured - (Output) Whether the action connector is fully configured. Set by the system after the action configuration is validated.
- action
Params Map<String> - Params needed to configure the actions in the format of String-to-String (Key, Value) pairs. Contains connection credentials and configuration for the action connector.
- create
Bap BooleanConnection - Whether to create a BAP (Business Application Platform) connection for this action connector.
- is
Action BooleanConfigured - (Output) Whether the action connector is fully configured. Set by the system after the action configuration is validated.
DataConnectorBapConfig, DataConnectorBapConfigArgs
- Enabled
Actions List<string> - The list of enabled actions for this connector. Supported
values include:
create_issue,update_issue,change_issue_status,create_comment,update_comment,upload_attachment. - Supported
Connector List<string>Modes - The connector modes supported by the BAP configuration.
The possible values include:
ACTIONS.
- Enabled
Actions []string - The list of enabled actions for this connector. Supported
values include:
create_issue,update_issue,change_issue_status,create_comment,update_comment,upload_attachment. - Supported
Connector []stringModes - The connector modes supported by the BAP configuration.
The possible values include:
ACTIONS.
- enabled
Actions List<String> - The list of enabled actions for this connector. Supported
values include:
create_issue,update_issue,change_issue_status,create_comment,update_comment,upload_attachment. - supported
Connector List<String>Modes - The connector modes supported by the BAP configuration.
The possible values include:
ACTIONS.
- enabled
Actions string[] - The list of enabled actions for this connector. Supported
values include:
create_issue,update_issue,change_issue_status,create_comment,update_comment,upload_attachment. - supported
Connector string[]Modes - The connector modes supported by the BAP configuration.
The possible values include:
ACTIONS.
- enabled_
actions Sequence[str] - The list of enabled actions for this connector. Supported
values include:
create_issue,update_issue,change_issue_status,create_comment,update_comment,upload_attachment. - supported_
connector_ Sequence[str]modes - The connector modes supported by the BAP configuration.
The possible values include:
ACTIONS.
- enabled
Actions List<String> - The list of enabled actions for this connector. Supported
values include:
create_issue,update_issue,change_issue_status,create_comment,update_comment,upload_attachment. - supported
Connector List<String>Modes - The connector modes supported by the BAP configuration.
The possible values include:
ACTIONS.
DataConnectorDestinationConfig, DataConnectorDestinationConfigArgs
- Destinations
List<Data
Connector Destination Config Destination> - The list of destinations for this configuration. Structure is documented below.
- Key string
- The key of the destination configuration, for example
url.
- Destinations
[]Data
Connector Destination Config Destination - The list of destinations for this configuration. Structure is documented below.
- Key string
- The key of the destination configuration, for example
url.
- destinations
List<Data
Connector Destination Config Destination> - The list of destinations for this configuration. Structure is documented below.
- key String
- The key of the destination configuration, for example
url.
- destinations
Data
Connector Destination Config Destination[] - The list of destinations for this configuration. Structure is documented below.
- key string
- The key of the destination configuration, for example
url.
- destinations
Sequence[Data
Connector Destination Config Destination] - The list of destinations for this configuration. Structure is documented below.
- key str
- The key of the destination configuration, for example
url.
- destinations List<Property Map>
- The list of destinations for this configuration. Structure is documented below.
- key String
- The key of the destination configuration, for example
url.
DataConnectorDestinationConfigDestination, DataConnectorDestinationConfigDestinationArgs
- Host string
- The host of the destination, for example
https://example.atlassian.net.
- Host string
- The host of the destination, for example
https://example.atlassian.net.
- host String
- The host of the destination, for example
https://example.atlassian.net.
- host string
- The host of the destination, for example
https://example.atlassian.net.
- host str
- The host of the destination, for example
https://example.atlassian.net.
- host String
- The host of the destination, for example
https://example.atlassian.net.
DataConnectorEntity, DataConnectorEntityArgs
- Data
Store string - (Output)
The full resource name of the associated data store for the source
entity.
Format:
projects/*/locations/*/collections/*/dataStores/*. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity. - Entity
Name string - The name of the entity. Supported values by data source:
- Salesforce:
Lead,Opportunity,Contact,Account,Case,Contract,Campaign - Jira: project, issue, attachment, comment, worklog
- Confluence:
Content,Space
- Salesforce:
- Key
Property Dictionary<string, string>Mappings - Attributes for indexing.
Key: Field name.
Value: The key property to map a field to, such as
title, anddescription. Supported key properties: - Params string
- The parameters for the entity to facilitate data ingestion.
- Data
Store string - (Output)
The full resource name of the associated data store for the source
entity.
Format:
projects/*/locations/*/collections/*/dataStores/*. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity. - Entity
Name string - The name of the entity. Supported values by data source:
- Salesforce:
Lead,Opportunity,Contact,Account,Case,Contract,Campaign - Jira: project, issue, attachment, comment, worklog
- Confluence:
Content,Space
- Salesforce:
- Key
Property map[string]stringMappings - Attributes for indexing.
Key: Field name.
Value: The key property to map a field to, such as
title, anddescription. Supported key properties: - Params string
- The parameters for the entity to facilitate data ingestion.
- data
Store String - (Output)
The full resource name of the associated data store for the source
entity.
Format:
projects/*/locations/*/collections/*/dataStores/*. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity. - entity
Name String - The name of the entity. Supported values by data source:
- Salesforce:
Lead,Opportunity,Contact,Account,Case,Contract,Campaign - Jira: project, issue, attachment, comment, worklog
- Confluence:
Content,Space
- Salesforce:
- key
Property Map<String,String>Mappings - Attributes for indexing.
Key: Field name.
Value: The key property to map a field to, such as
title, anddescription. Supported key properties: - params String
- The parameters for the entity to facilitate data ingestion.
- data
Store string - (Output)
The full resource name of the associated data store for the source
entity.
Format:
projects/*/locations/*/collections/*/dataStores/*. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity. - entity
Name string - The name of the entity. Supported values by data source:
- Salesforce:
Lead,Opportunity,Contact,Account,Case,Contract,Campaign - Jira: project, issue, attachment, comment, worklog
- Confluence:
Content,Space
- Salesforce:
- key
Property {[key: string]: string}Mappings - Attributes for indexing.
Key: Field name.
Value: The key property to map a field to, such as
title, anddescription. Supported key properties: - params string
- The parameters for the entity to facilitate data ingestion.
- data_
store str - (Output)
The full resource name of the associated data store for the source
entity.
Format:
projects/*/locations/*/collections/*/dataStores/*. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity. - entity_
name str - The name of the entity. Supported values by data source:
- Salesforce:
Lead,Opportunity,Contact,Account,Case,Contract,Campaign - Jira: project, issue, attachment, comment, worklog
- Confluence:
Content,Space
- Salesforce:
- key_
property_ Mapping[str, str]mappings - Attributes for indexing.
Key: Field name.
Value: The key property to map a field to, such as
title, anddescription. Supported key properties: - params str
- The parameters for the entity to facilitate data ingestion.
- data
Store String - (Output)
The full resource name of the associated data store for the source
entity.
Format:
projects/*/locations/*/collections/*/dataStores/*. When the connector is initialized by the DataConnectorService.SetUpDataConnector method, a DataStore is automatically created for each source entity. - entity
Name String - The name of the entity. Supported values by data source:
- Salesforce:
Lead,Opportunity,Contact,Account,Case,Contract,Campaign - Jira: project, issue, attachment, comment, worklog
- Confluence:
Content,Space
- Salesforce:
- key
Property Map<String>Mappings - Attributes for indexing.
Key: Field name.
Value: The key property to map a field to, such as
title, anddescription. Supported key properties: - params String
- The parameters for the entity to facilitate data ingestion.
DataConnectorError, DataConnectorErrorArgs
Import
DataConnector can be imported using any of these accepted formats:
projects/{{project}}/locations/{{location}}/collections/{{collection_id}}/dataConnector{{project}}/{{location}}/{{collection_id}}{{location}}/{{collection_id}}
When using the pulumi import command, DataConnector can be imported using one of the formats above. For example:
$ pulumi import gcp:discoveryengine/dataConnector:DataConnector default projects/{{project}}/locations/{{location}}/collections/{{collection_id}}/dataConnector
$ pulumi import gcp:discoveryengine/dataConnector:DataConnector default {{project}}/{{location}}/{{collection_id}}
$ pulumi import gcp:discoveryengine/dataConnector:DataConnector default {{location}}/{{collection_id}}
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-betaTerraform Provider.
published on Thursday, Mar 12, 2026 by Pulumi
