DataConnector

Gestisce la connessione a origini dati esterne per tutti i datastore raggruppati in un Collection. È una risorsa singleton di Collection. L'inizializzazione è supportata solo tramite il metodo DataConnectorService.SetUpDataConnector, che creerà un nuovo Collection e inizializzerà il relativo DataConnector.

Rappresentazione JSON 
{
  "name": string,
  "state": enum (State),
  "dataSource": string,
  "removeParamKeys": [
    string
  ],
  "refreshInterval": string,
  "nextSyncTime": {
    object (DateTime)
  },
  "entities": [
    {
      object (SourceEntity)
    }
  ],
  "createTime": string,
  "latestPauseTime": string,
  "lastSyncTime": string,
  "updateTime": string,
  "errors": [
    {
      object (Status)
    }
  ],
  "syncMode": enum (SyncMode),
  "kmsKeyName": string,
  "destinationConfigs": [
    {
      object (DestinationConfig)
    }
  ],
  "actionState": enum (State),
  "actionConfig": {
    object (ActionConfig)
  },
  "endUserConfig": {
    object (EndUserConfig)
  },
  "federatedConfig": {
    object (FederatedConfig)
  },
  "connectorModes": [
    enum (ConnectorMode)
  ],
  "staticIpEnabled": boolean,
  "staticIpAddresses": [
    string
  ],
  "blockingReasons": [
    enum (BlockingReason)
  ],
  "identityRefreshInterval": string,
  "identityScheduleConfig": {
    object (IdentityScheduleConfig)
  },
  "privateConnectivityProjectId": string,
  "bapConfig": {
    object (BAPConfig)
  },
  "connectorType": enum (ConnectorType),
  "realtimeState": enum (State),
  "alertPolicyConfigs": [
    {
      object (AlertPolicyConfig)
    }
  ],
  "realtimeSyncConfig": {
    object (RealtimeSyncConfig)
  },
  "aclEnabled": boolean,
  "createEuaSaas": boolean,
  "autoRunDisabled": boolean,
  "incrementalSyncDisabled": boolean,
  "incrementalRefreshInterval": string,
  "hybridIngestionDisabled": boolean,

  // Union field data_connector_params can be only one of the following:
  "params": {
    object
  },
  "jsonParams": string
  // End of list of possible types for union field data_connector_params.
}
Campi
name

string

Solo output. Il nome completo della risorsa del connettore dati. Formato: projects/*/locations/*/collections/*/dataConnector.
state

enum (State)

Solo output. Stato del connettore.
dataSource

string

Obbligatorio. Il nome dell'origine dati. Valori supportati: salesforce, jira, confluence, bigquery.
removeParamKeys[]

string

Facoltativo. Specifica le chiavi da rimuovere dal campo "params". Questa opzione è attiva solo quando "params" è incluso in "updateMask" in una UpdateDataConnectorRequest. L'eliminazione ha la precedenza se una chiave è presente sia in "removeParamKeys" sia nel campo "params" della richiesta.
refreshInterval

string (Duration format)

Obbligatorio. L'intervallo di aggiornamento per la sincronizzazione dei dati. Se la durata è impostata su 0, i dati vengono sincronizzati in tempo reale. La funzionalità di streaming non è ancora supportata. Il valore minimo è 30 minuti e il valore massimo è 7 giorni. Quando l'intervallo di aggiornamento è impostato sullo stesso valore dell'intervallo di aggiornamento incrementale, la sincronizzazione incrementale viene disattivata.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
nextSyncTime

object (DateTime)

Definisce l'ora pianificata per la successiva sincronizzazione dei dati. Questo campo richiede ora, minuti e fuso orario dal database dei fusi orari IANA. Questo viene utilizzato quando il connettore dati ha un intervallo di aggiornamento superiore a 1 giorno. Se non vengono specificati ore o minuti, verrà considerato un orario di sincronizzazione di 00:00. L'utente deve fornire un fuso orario per evitare ambiguità.
entities[]

object (SourceEntity)

Elenco delle entità dell'origine dati connessa da importare.
createTime

string (Timestamp format)

Solo output. Timestamp della creazione di DataConnector.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
latestPauseTime

string (Timestamp format)

Solo output. Il timestamp più recente in cui questo DataConnector è stato messo in pausa, con conseguenze su tutte le funzionalità, come la sincronizzazione dei dati. La sospensione di un connettore ha i seguenti effetti: - Tutte le funzionalità, inclusa la sincronizzazione dei dati, vengono interrotte. - Qualsiasi job di sincronizzazione dei dati in corso verrà annullato. - Non verranno pianificate né attivate esecuzioni future di sincronizzazione dei dati.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastSyncTime

string (Timestamp format)

Solo output. Solo per i connettori periodici, l'ultima volta che è stata completata una sincronizzazione dei dati.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento di DataConnector.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
errors[]

object (Status)

Solo output. Gli errori di inizializzazione o dell'ultima esecuzione del connettore.
syncMode

enum (SyncMode)

La modalità di sincronizzazione dei dati supportata dal connettore dati.
kmsKeyName

string

Solo input. La chiave KMS da utilizzare per proteggere i datastore gestiti da questo connettore.

Deve essere impostato per le richieste che devono essere conformi alle protezioni delle policy dell'organizzazione CMEK.

Se questo campo è impostato ed elaborato correttamente, i Data Store creati da questo connettore saranno protetti dalla chiave KMS.
destinationConfigs[]

object (DestinationConfig)

Facoltativo. Qualsiasi destinazione di destinazione utilizzata per connettersi a servizi di terze parti.
actionState

enum (State)

Solo output. Stato del connettore di azione. Indica se il connettore di azioni è in fase di inizializzazione, attivo o ha riscontrato errori.
actionConfig

object (ActionConfig)

Facoltativo. Configurazioni delle azioni per fare in modo che il connettore supporti le azioni.
endUserConfig

object (EndUserConfig)

Facoltativo. Qualsiasi parametro e credenziale utilizzati specificamente per i connettori EUA.
federatedConfig

object (FederatedConfig)

Facoltativo. Qualsiasi parametro e credenziale utilizzato specificamente per i connettori ibridi che supportano la modalità FEDERATED. Questo campo deve essere impostato solo se il connettore è un connettore ibrido e vogliamo attivare la modalità FEDERATED.
connectorModes[]

enum (ConnectorMode)

Facoltativo. Le modalità abilitate per questo connettore. Lo stato predefinito è CONNECTOR_MODE_UNSPECIFIED.
staticIpEnabled

boolean

Facoltativo. Indica se il cliente ha abilitato gli indirizzi IP statici per questo connettore.
staticIpAddresses[]

string

Solo output. Gli indirizzi IP statici utilizzati da questo connettore.
blockingReasons[]

enum (BlockingReason)

Solo output. Azioni dell'utente che devono essere completate prima che il connettore possa iniziare a sincronizzare i dati.
identityRefreshInterval
(deprecated)

string (Duration format)

L'intervallo di aggiornamento per sincronizzare le informazioni dell'elenco di controllo dell'accesso per i documenti importati da questo connettore. Se non viene impostato, l'elenco di controllo dell'accesso verrà aggiornato all'intervallo predefinito di 30 minuti. L'intervallo di aggiornamento dell'identità può essere di almeno 30 minuti e al massimo 7 giorni.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
identityScheduleConfig

object (IdentityScheduleConfig)

La configurazione delle esecuzioni della sincronizzazione dei dati delle identità. Contiene l'intervallo di aggiornamento per sincronizzare le informazioni dell'elenco di controllo dell'accesso per i documenti inseriti da questo connettore.
privateConnectivityProjectId

string

Solo output. L'ID progetto tenant associato ai connettori di connettività privata. Perché il connettore funzioni, questo progetto deve essere incluso nella lista consentita.
bapConfig

object (BAPConfig)

Facoltativo. La configurazione per stabilire una connessione BAP.
connectorType

enum (ConnectorType)

Solo output. Il tipo di connettore. Ogni origine può essere mappata a un solo tipo. Ad esempio, Salesforce, Confluence e Jira hanno il tipo di connettore THIRD_PARTY. Una volta impostato dal sistema, non è modificabile.
realtimeState

enum (State)

Solo output. Stato di sincronizzazione in tempo reale
alertPolicyConfigs[]

object (AlertPolicyConfig)

Facoltativo. Configurazione degli avvisi a livello di connettore.
realtimeSyncConfig

object (RealtimeSyncConfig)

Facoltativo. La configurazione per la sincronizzazione in tempo reale.
aclEnabled

boolean

Facoltativo. Indica se il connettore verrà creato con una configurazione ACL. Al momento, questo campo influisce solo sui connettori Cloud Storage e BigQuery.
createEuaSaas

boolean

Facoltativo. Indica se il connettore END USER AUTHENTICATION è stato creato in SaaS.
autoRunDisabled

boolean

Facoltativo. Indica se il connettore è disattivato per l'esecuzione automatica. Può essere utilizzato per mettere in pausa la sincronizzazione periodica e in tempo reale. Aggiornamento: con l'introduzione di incrementalSyncDisabled, autoRunDisabled viene utilizzato per mettere in pausa/disattivare solo le sincronizzazioni complete
incrementalSyncDisabled

boolean

Facoltativo. Indica se le sincronizzazioni incrementali sono sospese per questo connettore. Questa impostazione è indipendente da autoRunDisabled. Applicabile solo ai connettori di terze parti. Quando l'intervallo di aggiornamento è impostato sullo stesso valore dell'intervallo di aggiornamento incrementale, la sincronizzazione incrementale viene disattivata, ovvero impostata su true.
incrementalRefreshInterval

string (Duration format)

Facoltativo. L'intervallo di aggiornamento specifico per le sincronizzazioni incrementali dei dati. Se non viene configurato, le sincronizzazioni incrementali utilizzeranno il valore predefinito dell'ambiente, impostato su 3 ore. Il valore minimo è 30 minuti e il valore massimo è 7 giorni. Applicabile solo ai connettori di terze parti. Quando l'intervallo di aggiornamento è impostato sullo stesso valore dell'intervallo di aggiornamento incrementale, la sincronizzazione incrementale viene disattivata.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
hybridIngestionDisabled

boolean

Facoltativo. Se il connettore è un connettore ibrido, determina se l'importazione è abilitata e se viene eseguito il provisioning delle risorse appropriate durante la creazione del connettore. Se il connettore non è un connettore ibrido, questo campo viene ignorato.

Campo unione data_connector_params. Parametri necessari per accedere alla sorgente nel formato di coppie (chiave, valore). I valori stringa con il formato projects/*/[locations/*/]secrets/*/versions/* verranno letti da Secret Manager.

Parametri obbligatori per tutte le origini dati:

  • Chiave: instance_uri
  • Valore: digita STRING. L'URI per accedere all'origine dati.

Parametri obbligatori per le origini che supportano OAUTH, ad es. salesforce:

  • Chiave: client_id
  • Valore: digita STRING. L'ID client del fornitore di servizi di terze parti per identificare la tua applicazione.
  • Chiave: client_secret
  • Valore:tipo STRING. Il client secret generato dal server di autorizzazione di terze parti.
  • Chiave: access_token
  • Valore: digita STRING. Token OAuth per UCS per accedere alla risorsa protetta.
  • Chiave: refresh_token
  • Valore: digita STRING. Token di aggiornamento OAuth per UCS per ottenere un nuovo token di accesso senza interazione da parte dell'utente.

Parametri obbligatori per le origini che supportano l'autenticazione di base con token API, ad esempio jira, confluence:

  • Chiave: user_account
  • Valore: digita STRING. Il nome utente o l'email con la fonte.
  • Chiave: api_token
  • Valore: digita STRING. Il token API generato per l'account di origine, che viene utilizzato per l'autenticazione ovunque avresti utilizzato una password.

Esempio:

{
                                "instance_uri": "https://xxx.atlassian.net",
                                "user_account": "xxxx.xxx@xxx.com",
                                "api_token": "test-token"
                              }

Parametro facoltativo per specificare il tipo di autorizzazione da utilizzare per il supporto di più tipi di autorizzazione:

  • Chiave: auth_type
  • Valore: digita STRING. Il tipo di autorizzazione per l'origine dati. Valori supportati: BASIC_AUTH, OAUTH, OAUTH_ACCESS_TOKEN, OAUTH_TWO_LEGGED, OAUTH_JWT_BEARER, OAUTH_PASSWORD_GRANT, JWT, API_TOKEN, FEDERATED_CREDENTIAL. data_connector_params può essere solo uno dei seguenti tipi:
params

object (Struct format)

Parametri del connettore dati obbligatori in formato JSON strutturato.
jsonParams

string

Parametri del connettore dati obbligatori in formato stringa JSON.

Stato

Lo stato del connettore.

Enum
STATE_UNSPECIFIED Valore predefinito.
CREATING Il connettore è in fase di configurazione.
ACTIVE Il connettore è stato configurato correttamente ed è in attesa della prossima esecuzione della sincronizzazione.
FAILED Il connettore è in errore. I dettagli dell'errore sono disponibili in DataConnector.errors. Se l'errore non è risolvibile, DataConnector può essere eliminato dall'API CollectionService.DeleteCollection.
RUNNING Il connettore sta sincronizzando attivamente i record dall'origine dati.
WARNING Il connettore ha completato un'esecuzione della sincronizzazione, ma ha riscontrato errori non irreversibili.
INITIALIZATION_FAILED Inizializzazione del connettore non riuscita. Le potenziali cause includono errori di runtime o problemi nella pipeline asincrona, che impediscono alla richiesta di raggiungere i servizi downstream (ad eccezione di alcuni tipi di connettori).
UPDATING Il connettore è in fase di aggiornamento.

SourceEntity

Rappresenta un'entità nell'origine dati. Ad esempio, l'oggetto Account in Salesforce.

Rappresentazione JSON 
{
  "entityName": string,
  "keyPropertyMappings": {
    string: string,
    ...
  },
  "dataStore": string,
  "startingSchema": {
    object (Schema)
  },
  "healthcareFhirConfig": {
    object (HealthcareFhirConfig)
  },

  // Union field entity_params can be only one of the following:
  "params": {
    object
  },
  "jsonParams": string
  // End of list of possible types for union field entity_params.
}
Campi
entityName

string

Il nome dell'entità. Valori supportati per origine dati:

  • Salesforce: Lead, Opportunity, Contact, Account, Case, Contract, Campaign
  • Jira: Issue
  • Confluence: Content, Space
keyPropertyMappings

map (key: string, value: string)

Attributi per l'indicizzazione. Chiave: nome del campo. Valore: la proprietà della chiave a cui mappare un campo, ad esempio title e description. Proprietà principali supportate:

  • title: il titolo del record di dati. Queste informazioni verranno visualizzate nei risultati di ricerca.
  • description: la descrizione del record di dati. Queste informazioni verranno visualizzate nei risultati di ricerca.
dataStore

string

Solo output. Il nome completo della risorsa del datastore associato per l'entità di origine. Formato: projects/*/locations/*/collections/*/dataStores/*. Quando il connettore viene inizializzato dal metodo DataConnectorService.SetUpDataConnector, viene creato automaticamente un DataStore per ogni entità di origine.
startingSchema

object (Schema)

Facoltativo. Lo schema di avvio da utilizzare per l'intent DataStore creato da questa SourceEntity. Se non impostato, verrà utilizzato uno schema verticale specializzato predefinito.

Questo campo viene utilizzato solo dall'API SetUpDataConnector e verrà ignorato se utilizzato in altre API. Questo campo verrà omesso da tutte le risposte dell'API, inclusa l'API GetDataConnector. Per recuperare uno schema di un DataStore, utilizza l'API SchemaService.GetSchema.

Lo schema fornito verrà convalidato in base a determinate regole dello schema. Scopri di più in questo documento.
healthcareFhirConfig

object (HealthcareFhirConfig)

Facoltativo. Configurazione per la verticale HEALTHCARE_FHIR.

Campo unione entity_params. I parametri per l'entità per facilitare l'importazione dati. Ad esempio, per i connettori BigQuery:

  • Chiave: document_id_column
  • Valore: digita STRING. Il valore dell'ID colonna. entity_params può essere solo uno dei seguenti tipi:
params

object (Struct format)

I parametri per l'entità per facilitare l'importazione dati in formato JSON strutturato.
jsonParams

string

I parametri per l'entità per facilitare l'importazione dati in formato stringa JSON.

SyncMode

Definisce la modalità di sincronizzazione dei dati supportata dal connettore dati.

Enum
PERIODIC Il connettore sincronizzerà i dati periodicamente in base a refreshInterval. Utilizzalo con autoRunDisabled per mettere in pausa la sincronizzazione periodica o indicare una sincronizzazione una tantum.
STREAMING I dati verranno sincronizzati in tempo reale.
UNSPECIFIED Il connettore che non importa dati avrà questo valore

DestinationConfig

Definisce gli endpoint di destinazione utilizzati per connettersi a origini di terze parti.

Rappresentazione JSON 
{
  "key": string,
  "destinations": [
    {
      object (Destination)
    }
  ],

  // Union field destination_config_params can be only one of the following:
  "params": {
    object
  },
  "jsonParams": string
  // End of list of possible types for union field destination_config_params.
}
Campi
key

string

Facoltativo. Identificatore univoco della destinazione supportato dal connettore.
destinations[]

object (Destination)

Facoltativo. Le destinazioni per la chiave corrispondente.
Campo unione destination_config_params. Parametri aggiuntivi per questa configurazione della destinazione. destination_config_params può essere solo uno dei seguenti tipi:
params

object (Struct format)

Facoltativo. Parametri aggiuntivi per questa configurazione della destinazione in formato JSON strutturato.
jsonParams

string

Parametri aggiuntivi per questa configurazione della destinazione in formato stringa JSON.

Destinazione

Definisce un endpoint di destinazione

Rappresentazione JSON 
{
  "port": integer,

  // Union field destination can be only one of the following:
  "host": string
  // End of list of possible types for union field destination.
}
Campi
port

integer

Facoltativo. Numero di porta di destinazione accettato dalla destinazione.
Campo unione destination. La destinazione dell'endpoint. destination può essere solo uno dei seguenti tipi:
host

string

Host instradabile pubblicamente.

ActionConfig

Informazioni per supportare le azioni sul connettore.

Rappresentazione JSON 
{
  "isActionConfigured": boolean,
  "serviceName": string,
  "useStaticSecrets": boolean,

  // Union field action_config_params can be only one of the following:
  "actionParams": {
    object
  },
  "jsonActionParams": string
  // End of list of possible types for union field action_config_params.
}
Campi
isActionConfigured

boolean

Solo output. Il connettore contiene i parametri necessari ed è configurato per supportare le azioni.
serviceName

string

Facoltativo. Il nome della risorsa Service Directory (projects/*/locations/*/namespaces/*/services/*) che rappresenta un endpoint di rete VPC utilizzato per connettersi a instanceUri dell'origine dati, definito in DataConnector.params.

Obbligatorio quando i Controlli di servizio VPC sono abilitati.
useStaticSecrets

boolean

Facoltativo. Indica se utilizzare secret statici per il connettore. Se il valore è vero, i secret forniti in actionParams verranno ignorati.

Campo unione action_config_params. Parametri necessari per supportare le azioni nel formato di coppie (chiave, valore). I valori stringa con il formato projects/*/[locations/*/]secrets/*/versions/* verranno letti da Secret Manager.

Parametri obbligatori per le origini che supportano OAUTH, ad es. gmail, google_calendar, jira, workday, salesforce, confluence:

  • Chiave: client_id
  • Valore: digita STRING. L'ID client del service provider per identificare la tua applicazione.
  • Chiave: client_secret
  • Valore:tipo STRING. Il client secret generato dal server di autorizzazione dell'applicazione. action_config_params può essere solo uno dei seguenti tipi:
actionParams

object (Struct format)

Facoltativo. Parametri dell'azione in formato JSON strutturato.
jsonActionParams

string

Facoltativo. Parametri dell'azione in formato stringa JSON.

EndUserConfig

Qualsiasi parametro e credenziale utilizzati specificamente per i connettori EUA.

Rappresentazione JSON 
{
  "additionalParams": {
    object
  },
  "tenant": {
    object (Tenant)
  },

  // Union field auth_config can be only one of the following:
  "authParams": {
    object
  },
  "jsonAuthParams": string
  // End of list of possible types for union field auth_config.
}
Campi
additionalParams

object (Struct format)

Facoltativo. Eventuali parametri aggiuntivi necessari per l'EUA.
tenant

object (Tenant)

Facoltativo. Il progetto tenant a cui è connesso il connettore.
Campo unione auth_config. Configurazione dell'autenticazione per i connettori EULA. auth_config può essere solo uno dei seguenti tipi:
authParams

object (Struct format)

Facoltativo. Eventuali parametri di autenticazione specifici per i connettori EUA.
jsonAuthParams

string

Facoltativo. Eventuali parametri di autenticazione specifici per i connettori EUA in formato stringa JSON.

Tenant

Informazioni sul tenant per un'origine connettore. Sono incluse alcune delle stesse informazioni memorizzate nel messaggio Credenziali, ma limitate solo a ciò che è necessario per fornire all'utente un elenco di tenant accessibili.

Rappresentazione JSON 
{
  "id": string,
  "uri": string,
  "displayName": string
}
Campi
id

string

L'ID istanza del tenant. Esempi: Jira ("8594f221-9797-5f78-1fa4-485e198d7cd0"), Slack ("T123456").
uri

string

L'URI del tenant, se applicabile. Ad esempio, l'URI di un'istanza Jira è https://my-jira-instance.atlassian.net, mentre un tenant Slack non ha un URI.
displayName

string

Nome visualizzato facoltativo per il tenant, ad esempio "Il mio team Slack".

FederatedConfig

Qualsiasi parametro e credenziale utilizzato specificamente per i connettori ibridi che supportano la modalità FEDERATED.

Rappresentazione JSON 
{
  "additionalParams": {
    object
  },

  // Union field auth_config can be only one of the following:
  "authParams": {
    object
  },
  "jsonAuthParams": string
  // End of list of possible types for union field auth_config.
}
Campi
additionalParams

object (Struct format)

Facoltativo. Eventuali parametri aggiuntivi necessari per FEDERATED.
Campo unione auth_config. Configurazione dell'autenticazione per i connettori FEDERATED. auth_config può essere solo uno dei seguenti tipi:
authParams

object (Struct format)

Facoltativo. Eventuali parametri di autenticazione specifici per i connettori FEDERATED.
jsonAuthParams

string

Facoltativo. Qualsiasi parametro di autenticazione specifico per i connettori FEDERATED in formato stringa JSON.

ConnectorMode

Le modalità abilitate per questo connettore. INGESTION, ACTIONS, FEDERATED, OR EUA

Enum
CONNECTOR_MODE_UNSPECIFIED Modalità connettore non specificata.
DATA_INGESTION Connettore utilizzato per importazione dati.
ACTIONS Connettore utilizzato per le azioni.
FEDERATED Connettore utilizzato per la ricerca federata.
EUA Connettore utilizzato per l'autenticazione dell'utente finale.
FEDERATED_AND_EUA Connettore ibrido utilizzato per la ricerca federata e l'autenticazione dell'utente finale.

BlockingReason

Azioni dell'utente che devono essere completate prima che il connettore possa iniziare a sincronizzare i dati.

Enum
BLOCKING_REASON_UNSPECIFIED Valore predefinito.
ALLOWLIST_STATIC_IP Il connettore richiede al cliente di inserire gli IP statici nella lista consentita.
ALLOWLIST_IN_SERVICE_ATTACHMENT Il connettore richiede al cliente di inserire il nostro progetto nella lista consentita nel collegamento del servizio.
ALLOWLIST_SERVICE_ACCOUNT Il connettore richiede che il cliente inserisca nella lista consentita account di servizio nel suo progetto.

IdentityScheduleConfig

La configurazione delle esecuzioni della sincronizzazione dei dati delle identità.

Rappresentazione JSON 
{
  "refreshInterval": string,
  "nextSyncTime": {
    object (DateTime)
  }
}
Campi
refreshInterval

string (Duration format)

Facoltativo. L'intervallo di aggiornamento per sincronizzare le informazioni dell'elenco di controllo dell'accesso per i documenti importati da questo connettore. Se non viene impostato, l'elenco di controllo dell'accesso verrà aggiornato all'intervallo predefinito di 30 minuti. L'intervallo di aggiornamento dell'identità può essere di almeno 30 minuti e al massimo 7 giorni.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
nextSyncTime

object (DateTime)

Facoltativo. L'ora UTC in cui è previsto l'inizio della successiva sincronizzazione dei dati per il connettore dati. I clienti possono specificare solo l'ora e il minuto per pianificare la sincronizzazione dei dati. Questo viene utilizzato quando il connettore dati ha un intervallo di aggiornamento superiore a 1 giorno.

BAPConfig

La configurazione del connettore BAP.

Rappresentazione JSON 
{
  "supportedConnectorModes": [
    enum (ConnectorMode)
  ],
  "enabledActions": [
    string
  ]
}
Campi
supportedConnectorModes[]

enum (ConnectorMode)

Obbligatorio. Le modalità del connettore supportate per la connessione BAP associata.
enabledActions[]

string

Facoltativo. Le azioni abilitate nella connessione BAP associata.

ConnectorMode

Casi d'uso supportati da questo connettore BAP.

Enum
CONNECTOR_MODE_UNSPECIFIED Modalità connettore non specificata.
DATA_INGESTION Connettore utilizzato per importazione dati.
ACTIONS Connettore utilizzato per le azioni
END_USER_AUTHENTICATION Connettore utilizzato per l'autenticazione dell'utente finale.

ConnectorType

Il tipo di connettore. In futuro potrebbero essere aggiunti nuovi valori a questa enumerazione.

Enum
CONNECTOR_TYPE_UNSPECIFIED Valore predefinito.
THIRD_PARTY Connettore di terze parti per connettersi all'applicazione di terze parti.
GCP_FHIR Il connettore dati si connette tra l'archivio FHIR e il datastore VAIS.
BIG_QUERY Connettore BigQuery.
GCS Connettore Google Cloud Storage.
GOOGLE_MAIL Connettore Gmail.
GOOGLE_CALENDAR Connettore Google Calendar.
GOOGLE_DRIVE Connettore Google Drive.
NATIVE_CLOUD_IDENTITY Connettore Cloud Identity nativo per la ricerca di persone basata sull'API People.
THIRD_PARTY_FEDERATED Connettore federato, un connettore di terze parti che non importa dati e la ricerca è basata sull'API dell'applicazione di terze parti.
THIRD_PARTY_EUA Connettore utilizzato per le funzionalità di autenticazione dell'utente finale.
GCNV Connettore Google Cloud NetApp Volumes.
GOOGLE_CHAT Connettore Google Chat.

AlertPolicyConfig

Configurazione degli avvisi a livello di connettore.

Rappresentazione JSON 
{
  "alertPolicyName": string,
  "alertEnrollments": [
    {
      object (AlertEnrollment)
    }
  ]
}
Campi
alertPolicyName

string

Immutabile. Il nome risorsa completo di AlertPolicy.
alertEnrollments[]

object (AlertEnrollment)

Facoltativo. Gli stati di registrazione di ogni avviso.

AlertEnrollment

Lo stato di registrazione dell'avviso.

Rappresentazione JSON 
{
  "alertId": string,
  "enrollState": enum (EnrollStates)
}
Campi
alertId

string

Immutabile. L'ID di un avviso.
enrollState

enum (EnrollStates)

Obbligatorio. Lo stato di registrazione di un cliente.

EnrollStates

L'enumerazione dello stato di registrazione per l'avviso.

Enum
ENROLL_STATES_UNSPECIFIED Valore predefinito. Utilizzato per i clienti che non hanno risposto al criterio di avviso.
ENROLLED Il cliente è registrato a queste norme.
DECLINED Il cliente ha rifiutato queste norme.

RealtimeSyncConfig

La configurazione per la sincronizzazione in tempo reale per memorizzare parametri aggiuntivi per la sincronizzazione in tempo reale.

Rappresentazione JSON 
{
  "webhookUri": string,
  "realtimeSyncSecret": string,
  "streamingError": {
    object (StreamingError)
  }
}
Campi
webhookUri

string

Facoltativo. URL webhook per il connettore per specificare parametri aggiuntivi per la sincronizzazione in tempo reale.
realtimeSyncSecret

string

Facoltativo. L'ID del secret di Secret Manager utilizzato per il secret del webhook.
streamingError

object (StreamingError)

Facoltativo. Dettagli dell'errore di streaming.

StreamingError

Dettagli dell'errore di streaming.

Rappresentazione JSON 
{
  "streamingErrorReason": enum (StreamingErrorReason),
  "error": {
    object (Status)
  }
}
Campi
streamingErrorReason

enum (StreamingErrorReason)

Facoltativo. Errore di streaming.
error

object (Status)

Facoltativo. Dettagli errore.

StreamingErrorReason

Tipi generali di errori di streaming.

Enum
STREAMING_ERROR_REASON_UNSPECIFIED Motivo dell'errore di streaming non specificato.
STREAMING_SETUP_ERROR Si è verificato un errore durante la configurazione delle risorse per la sincronizzazione in tempo reale.
STREAMING_SYNC_ERROR Si è verificato un errore durante l'esecuzione della sincronizzazione in tempo reale per il connettore.
INGRESS_ENDPOINT_REQUIRED L'endpoint in entrata è obbligatorio quando si configura la sincronizzazione in tempo reale nella connettività privata.