- Representação JSON
- Estado
- SourceEntity
- SyncMode
- DestinationConfig
- Destino
- ActionConfig
- EndUserConfig
- Inquilino
- FederatedConfig
- ConnectorMode
- BlockingReason
- IdentityScheduleConfig
- BAPConfig
- ConnectorMode
- ConnectorType
- AlertPolicyConfig
- AlertEnrollment
- EnrollStates
- RealtimeSyncConfig
- StreamingError
- StreamingErrorReason
Gerencia a conexão com fontes de dados externas para todos os repositórios de dados agrupados em um Collection
. É um recurso singleton de Collection
. A inicialização só é compatível com o método DataConnectorService.SetUpDataConnector
, que cria um novo Collection
e inicializa o DataConnector
dele.
Representação JSON |
---|
{ "name": string, "state": enum ( |
Campos | |
---|---|
name |
Apenas saída. O nome completo do recurso do conector de dados. Formato: |
state |
Apenas saída. Estado do conector. |
dataSource |
Obrigatório. O nome da fonte de dados. Valores aceitos: |
removeParamKeys[] |
Opcional. Especifica as chaves a serem removidas do campo "params". Isso só fica ativo quando "params" está incluído no "updateMask" em um UpdateDataConnectorRequest. A exclusão tem precedência se uma chave estiver em "removeParamKeys" e presente no campo "params" da solicitação. |
refreshInterval |
Obrigatório. O intervalo de atualização para a sincronização de dados. Se a duração for definida como 0, os dados serão sincronizados em tempo real. O recurso de streaming ainda não está disponível. O mínimo é de 30 minutos e o máximo é de 7 dias. Quando o intervalo de atualização é definido com o mesmo valor do intervalo de atualização incremental, a sincronização incremental é desativada. Duração em segundos com até nove dígitos fracionários, terminando em " |
nextSyncTime |
Define o horário programado para a próxima sincronização de dados. Esse campo exige hora, minuto e fuso horário do banco de dados de fuso horário da IANA. Isso é usado quando o conector de dados tem um intervalo de atualização maior que um dia. Quando as horas ou os minutos não são especificados, presumimos um horário de sincronização de 0:00. O usuário precisa informar um fuso horário para evitar ambiguidade. |
entities[] |
Lista de entidades da fonte de dados conectada a serem ingeridas. |
createTime |
Apenas saída. Carimbo de data/hora em que o Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: |
latestPauseTime |
Apenas saída. O carimbo de data/hora mais recente em que este Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: |
lastSyncTime |
Apenas saída. Somente para conectores periódicos, a última vez que uma sincronização de dados foi concluída. Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: |
updateTime |
Apenas saída. Carimbo de data/hora da última atualização do Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: |
errors[] |
Apenas saída. Os erros da inicialização ou da execução mais recente do conector. |
syncMode |
O modo de sincronização de dados compatível com o conector de dados. |
kmsKeyName |
Somente entrada. A chave do KMS a ser usada para proteger os DataStores gerenciados por este conector. Precisa ser definido para solicitações que precisam obedecer às proteções da política da organização da CMEK. Se esse campo for definido e processado com sucesso, os DataStores criados por esse conector serão protegidos pela chave do KMS. |
destinationConfigs[] |
Opcional. Qualquer destino usado para se conectar a serviços de terceiros. |
actionState |
Somente saída. Estado do conector de ação. Isso reflete se o conector de ação está sendo inicializado, ativo ou encontrou erros. |
actionConfig |
Opcional. Configurações de ação para que o conector ofereça suporte a ações. |
endUserConfig |
Opcional. Parâmetros e credenciais usados especificamente para conectores da UEA. |
federatedConfig |
Opcional. Todos os parâmetros e credenciais usados especificamente para conectores híbridos que oferecem suporte ao modo FEDERATED. Esse campo só deve ser definido se o conector for híbrido e quisermos ativar o modo FEDERATED. |
connectorModes[] |
Opcional. Os modos ativados para este conector. O estado padrão é CONNECTOR_MODE_UNSPECIFIED. |
staticIpEnabled |
Opcional. Indica se o cliente ativou endereços IP estáticos para este conector. |
staticIpAddresses[] |
Apenas saída. Os endereços IP estáticos usados por esse conector. |
blockingReasons[] |
Apenas saída. Ações do usuário que precisam ser concluídas antes que o conector possa começar a sincronizar dados. |
identityRefreshInterval |
O intervalo de atualização para sincronizar as informações da lista de controle de acesso dos documentos ingeridos por esse conector. Se não for definida, a lista de controle de acesso será atualizada no intervalo padrão de 30 minutos. O intervalo de atualização da identidade pode ser de no mínimo 30 minutos e no máximo 7 dias. Duração em segundos com até nove dígitos fracionários, terminando em " |
identityScheduleConfig |
A configuração das execuções de sincronização de dados de identidade. Contém o intervalo de atualização para sincronizar as informações da lista de controle de acesso dos documentos ingeridos por esse conector. |
privateConnectivityProjectId |
Apenas saída. O ID do projeto do locatário associado aos conectores de conectividade particular. Esse projeto precisa estar na lista de permissões para que o conector funcione. |
bapConfig |
Opcional. A configuração para estabelecer uma conexão BAP. |
connectorType |
Apenas saída. O tipo de conector. Cada origem só pode ser mapeada para um tipo. Por exemplo, o Salesforce, o Confluence e o Jira têm o tipo de conector THIRD_PARTY. Ele não pode ser mudado depois de definido pelo sistema. |
realtimeState |
Apenas saída. Estado da sincronização em tempo real |
alertPolicyConfigs[] |
Opcional. A configuração de alerta no nível do conector. |
realtimeSyncConfig |
Opcional. A configuração para sincronização em tempo real. |
aclEnabled |
Opcional. Se o conector será criado com uma configuração de ACL. No momento, esse campo só afeta os conectores do Cloud Storage e do BigQuery. |
createEuaSaas |
Opcional. Se o conector END USER AUTHENTICATION foi criado no SaaS. |
autoRunDisabled |
Opcional. Indica se o conector está desativado para execução automática. Ele pode ser usado para pausar a sincronização periódica e em tempo real. Atualização: com a introdução de incrementalSyncDisabled, autoRunDisabled é usado para pausar/desativar apenas sincronizações completas. |
incrementalSyncDisabled |
Opcional. Indica se as sincronizações incrementais estão pausadas para esse conector. Isso é independente de "autoRunDisabled". Aplicável apenas a conectores de terceiros. Quando o intervalo de atualização é definido com o mesmo valor do intervalo de atualização incremental, a sincronização incremental é desativada, ou seja, definida como "true". |
incrementalRefreshInterval |
Opcional. O intervalo de atualização específico para sincronizações de dados incrementais. Se não for definido, as sincronizações incrementais usarão o padrão do ambiente, definido como 3 horas. O mínimo é de 30 minutos e o máximo é de 7 dias. Aplicável apenas a conectores de terceiros. Quando o intervalo de atualização é definido com o mesmo valor do intervalo de atualização incremental, a sincronização incremental é desativada. Duração em segundos com até nove dígitos fracionários, terminando em " |
hybridIngestionDisabled |
Opcional. Se o conector for híbrido, determina se a ingestão está ativada e se os recursos adequados são provisionados durante a criação do conector. Se o conector não for híbrido, esse campo será ignorado. |
Campo de união Parâmetros obrigatórios para todas as fontes de dados:
Parâmetros obrigatórios para fontes que aceitam OAUTH, ou seja,
Parâmetros obrigatórios para fontes que aceitam autenticação básica de token de API, ou seja,
Exemplo:
Parâmetro opcional para especificar o tipo de autorização a ser usado para suporte a vários tipos de autorização:
|
|
params |
Parâmetros obrigatórios do conector de dados no formato JSON estruturado. |
jsonParams |
Parâmetros obrigatórios do conector de dados no formato de string JSON. |
Estado
O estado do conector.
Tipos enumerados | |
---|---|
STATE_UNSPECIFIED |
Valor padrão. |
CREATING |
O conector está sendo configurado. |
ACTIVE |
O conector foi configurado e está aguardando a próxima execução de sincronização. |
FAILED |
O conector está com erro. Os detalhes do erro podem ser encontrados em DataConnector.errors . Se o erro não puder ser corrigido, o DataConnector poderá ser excluído pela API [CollectionService.DeleteCollection]. |
RUNNING |
O conector está sincronizando ativamente os registros da fonte de dados. |
WARNING |
O conector concluiu uma execução de sincronização, mas encontrou erros não fatais. |
INITIALIZATION_FAILED |
Falha na inicialização do conector. As possíveis causas incluem erros de tempo de execução ou problemas no pipeline assíncrono, impedindo que a solicitação chegue aos serviços downstream (exceto alguns tipos de conector). |
UPDATING |
O conector está em processo de atualização. |
SourceEntity
Representa uma entidade na fonte de dados. Por exemplo, o objeto Account
no Salesforce.
Representação JSON |
---|
{ "entityName": string, "keyPropertyMappings": { string: string, ... }, "dataStore": string, "startingSchema": { object ( |
Campos | |
---|---|
entityName |
É o nome da entidade. Valores compatíveis por fonte de dados:
|
keyPropertyMappings |
Atributos para indexação. Chave: nome do campo. Valor: a propriedade de chave para mapear um campo, como
|
dataStore |
Apenas saída. O nome completo do recurso do repositório de dados associado à entidade de origem. Formato: |
startingSchema |
Opcional. O esquema inicial a ser usado para o Esse campo é usado apenas pela API [SetUpDataConnector][] e será ignorado se usado em outras APIs. Esse campo será omitido de todas as respostas da API, incluindo a API [GetDataConnector][]. Para recuperar um esquema de um O esquema fornecido será validado de acordo com determinadas regras. Saiba mais neste documento. |
healthcareFhirConfig |
Opcional. Configuração para a categoria |
Campo de união
|
|
params |
Os parâmetros da entidade para facilitar a ingestão de dados no formato JSON estruturado. |
jsonParams |
Os parâmetros da entidade para facilitar a ingestão de dados no formato de string JSON. |
SyncMode
Define o modo de sincronização de dados compatível com o conector de dados.
Tipos enumerados | |
---|---|
PERIODIC |
O conector vai sincronizar os dados periodicamente com base no refreshInterval. Use com autoRunDisabled para pausar a sincronização periódica ou indicar uma sincronização única. |
STREAMING |
Os dados serão sincronizados em tempo real. |
UNSPECIFIED |
Conectores que não ingerem dados terão esse valor |
DestinationConfig
Define endpoints de destino usados para se conectar a fontes de terceiros.
Representação JSON |
---|
{ "key": string, "destinations": [ { object ( |
Campos | |
---|---|
key |
Opcional. Identificador exclusivo do destino compatível com o conector. |
destinations[] |
Opcional. Os destinos da chave correspondente. |
Campo de união destination_config_params . Parâmetros adicionais para essa configuração de destino. destination_config_params pode ser apenas de um dos tipos a seguir: |
|
params |
Opcional. Parâmetros adicionais para essa configuração de destino no formato JSON estruturado. |
jsonParams |
Parâmetros adicionais para essa configuração de destino no formato de string JSON. |
Destino
Define um endpoint de destino.
Representação JSON |
---|
{ "port": integer, // Union field |
Campos | |
---|---|
port |
Opcional. Número da porta de destino aceita pelo destino. |
Campo de união destination . O destino do endpoint. destination pode ser apenas de um dos tipos a seguir: |
|
host |
Host roteável publicamente. |
ActionConfig
Informações para apoiar ações no conector.
Representação JSON |
---|
{ "isActionConfigured": boolean, "serviceName": string, "useStaticSecrets": boolean, // Union field |
Campos | |
---|---|
isActionConfigured |
Apenas saída. O conector tem os parâmetros necessários e está configurado para oferecer suporte a ações. |
serviceName |
Opcional. O nome do recurso do Service Directory (projects/*/locations/*/namespaces/*/services/*) que representa um endpoint de rede VPC usado para se conectar ao Obrigatório quando o VPC Service Controls está ativado. |
useStaticSecrets |
Opcional. Se é para usar secrets estáticos para o conector. Se for "true", os secrets fornecidos em "actionParams" serão ignorados. |
Campo de união Parâmetros obrigatórios para fontes que aceitam OAuth, ou seja,
|
|
actionParams |
Opcional. Parâmetros de ação em formato JSON estruturado. |
jsonActionParams |
Opcional. Parâmetros de ação no formato de string JSON. |
EndUserConfig
Parâmetros e credenciais usados especificamente para conectores da UEA.
Representação JSON |
---|
{ "additionalParams": { object }, "tenant": { object ( |
Campos | |
---|---|
additionalParams |
Opcional. Outros parâmetros necessários para os EUA. |
tenant |
Opcional. O projeto de locatário a que o conector está conectado. |
Campo de união auth_config . Configuração de autenticação para conectores da EUA. auth_config pode ser apenas de um dos tipos a seguir: |
|
authParams |
Opcional. Parâmetros de autenticação específicos para conectores da EUA. |
jsonAuthParams |
Opcional. Parâmetros de autenticação específicos para conectores da EUA no formato de string JSON. |
Locatário
Informações do locatário para uma origem de conector. Isso inclui algumas das mesmas informações armazenadas na mensagem de credencial, mas se limita apenas ao que é necessário para fornecer uma lista de locatários acessíveis ao usuário.
Representação JSON |
---|
{ "id": string, "uri": string, "displayName": string } |
Campos | |
---|---|
id |
O ID da instância do locatário. Exemplos: Jira ("8594f221-9797-5f78-1fa4-485e198d7cd0"), Slack ("T123456"). |
uri |
O URI do locatário, se aplicável. Por exemplo, o URI de uma instância do Jira é https://my-jira-instance.atlassian.net, e um locatário do Slack não tem um URI. |
displayName |
Nome de exibição opcional para o locatário, por exemplo, "Minha equipe do Slack". |
FederatedConfig
Todos os parâmetros e credenciais usados especificamente para conectores híbridos que oferecem suporte ao modo FEDERATED.
Representação JSON |
---|
{ "additionalParams": { object }, // Union field |
Campos | |
---|---|
additionalParams |
Opcional. Todos os parâmetros adicionais necessários para FEDERATED. |
Campo de união auth_config . Configuração de autenticação para conectores FEDERADOS. auth_config pode ser apenas de um dos tipos a seguir: |
|
authParams |
Opcional. Parâmetros de autenticação específicos para conectores FEDERATED. |
jsonAuthParams |
Opcional. Parâmetros de autenticação específicos para conectores FEDERATED no formato de string JSON. |
ConnectorMode
Os modos ativados para este conector. INGESTION, ACTIONS, FEDERATED, OR EUA
Tipos enumerados | |
---|---|
CONNECTOR_MODE_UNSPECIFIED |
Modo de conector não especificado. |
DATA_INGESTION |
Conector usado para ingestão de dados. |
ACTIONS |
Conector usado para ações. |
FEDERATED |
Conector usado para pesquisa federada. |
EUA |
Conector usado para autenticação de usuário final. |
FEDERATED_AND_EUA |
Conector híbrido usado para pesquisa federada e autenticação de usuário final. |
BlockingReason
Ações do usuário que precisam ser concluídas antes que o conector possa começar a sincronizar dados.
Tipos enumerados | |
---|---|
BLOCKING_REASON_UNSPECIFIED |
Valor padrão. |
ALLOWLIST_STATIC_IP |
O conector exige que o cliente coloque IPs estáticos na lista de permissões. |
ALLOWLIST_IN_SERVICE_ATTACHMENT |
O conector exige que o cliente adicione nosso projeto à lista de permissões no anexo de serviço. |
ALLOWLIST_SERVICE_ACCOUNT |
O conector exige que o cliente coloque a conta de serviço na lista de permissões do projeto. |
IdentityScheduleConfig
A configuração das execuções de sincronização de dados de identidade.
Representação JSON |
---|
{
"refreshInterval": string,
"nextSyncTime": {
object ( |
Campos | |
---|---|
refreshInterval |
Opcional. O intervalo de atualização para sincronizar as informações da lista de controle de acesso dos documentos ingeridos por esse conector. Se não for definida, a lista de controle de acesso será atualizada no intervalo padrão de 30 minutos. O intervalo de atualização da identidade pode ser de no mínimo 30 minutos e no máximo 7 dias. Duração em segundos com até nove dígitos fracionários, terminando em " |
nextSyncTime |
Opcional. O horário UTC em que a próxima sincronização de dados deve começar para o conector de dados. Os clientes só podem especificar a hora e o minuto para programar a sincronização de dados. Isso é usado quando o conector de dados tem um intervalo de atualização maior que um dia. |
BAPConfig
A configuração do conector BAP.
Representação JSON |
---|
{
"supportedConnectorModes": [
enum ( |
Campos | |
---|---|
supportedConnectorModes[] |
Obrigatório. Os modos de conector compatíveis com a conexão BAP associada. |
enabledActions[] |
Opcional. As ações ativadas na conexão do BAP associada. |
ConnectorMode
Casos de uso compatíveis com esse conector BAP.
Tipos enumerados | |
---|---|
CONNECTOR_MODE_UNSPECIFIED |
Modo de conector não especificado. |
DATA_INGESTION |
Conector usado para ingestão de dados. |
ACTIONS |
Conector usado para ações |
END_USER_AUTHENTICATION |
Conector usado para autenticação de usuário final. |
ConnectorType
O tipo de conector.
Tipos enumerados | |
---|---|
CONNECTOR_TYPE_UNSPECIFIED |
Valor padrão. |
THIRD_PARTY |
Conector de terceiros para aplicativo de terceiros. |
GCP_FHIR |
O conector de dados faz a conexão entre o armazenamento FHIR e o armazenamento de dados do VAIS. |
BIG_QUERY |
Conector do BigQuery. |
GCS |
Conector do Google Cloud Storage. |
GOOGLE_MAIL |
Conector do Gmail. |
GOOGLE_CALENDAR |
Conector do Google Agenda. |
GOOGLE_DRIVE |
Conector do Google Drive. |
NATIVE_CLOUD_IDENTITY |
Conector nativo do Cloud Identity para pesquisa de pessoas com tecnologia da API People. |
THIRD_PARTY_FEDERATED |
Conector federado, que é um conector de terceiros que não ingere dados, e a pesquisa é feita pela API do aplicativo de terceiros. |
THIRD_PARTY_EUA |
Conector usado para recursos de autenticação de usuário final. |
GCNV |
Conector do Google Cloud NetApp Volumes. |
AlertPolicyConfig
A configuração de alerta no nível do conector.
Representação JSON |
---|
{
"alertPolicyName": string,
"alertEnrollments": [
{
object ( |
Campos | |
---|---|
alertPolicyName |
Imutável. O nome totalmente qualificado do recurso AlertPolicy. |
alertEnrollments[] |
Opcional. Os estados de inscrição de cada alerta. |
AlertEnrollment
O status de inscrição do alerta.
Representação JSON |
---|
{
"alertId": string,
"enrollState": enum ( |
Campos | |
---|---|
alertId |
Imutável. O ID de um alerta. |
enrollState |
Obrigatório. O status de inscrição de um cliente. |
EnrollStates
A enumeração do status de inscrição do alerta.
Tipos enumerados | |
---|---|
ENROLL_STATES_UNSPECIFIED |
Valor padrão. Usado para clientes que não responderam à política de alertas. |
ENROLLED |
O cliente está inscrito nessa política. |
DECLINED |
O cliente recusou esta política. |
RealtimeSyncConfig
A configuração para sincronização em tempo real que armazena parâmetros adicionais para esse tipo de sincronização.
Representação JSON |
---|
{
"webhookUri": string,
"realtimeSyncSecret": string,
"streamingError": {
object ( |
Campos | |
---|---|
webhookUri |
Opcional. URL do webhook para o conector especificar parâmetros adicionais para a sincronização em tempo real. |
realtimeSyncSecret |
Opcional. O ID do secret do Secret Manager usado para o secret do webhook. |
streamingError |
Opcional. Detalhes do erro de streaming. |
StreamingError
Detalhes do erro de streaming.
Representação JSON |
---|
{ "streamingErrorReason": enum ( |
Campos | |
---|---|
streamingErrorReason |
Opcional. Erro de streaming. |
error |
Opcional. Detalhes do erro. |
StreamingErrorReason
Tipos gerais de erros de streaming.
Tipos enumerados | |
---|---|
STREAMING_ERROR_REASON_UNSPECIFIED |
Motivo do erro de transmissão não especificado. |
STREAMING_SETUP_ERROR |
Ocorreu um erro ao configurar recursos para a sincronização em tempo real. |
STREAMING_SYNC_ERROR |
Ocorreu um erro ao executar a sincronização em tempo real para o conector. |
INGRESS_ENDPOINT_REQUIRED |
O endpoint de entrada é obrigatório ao configurar a sincronização em tempo real na conectividade particular. |