---
title: "POST /v1/{+parent}/goldengateConnections"
method: POST
path: "/v1/{+parent}/goldengateConnections"
tags: ["projects"]
---

# POST /v1/{+parent}/goldengateConnections

`POST /v1/{+parent}/goldengateConnections`

Creates a new GoldengateConnection in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `goldengateConnectionId` string
- `requestId` string

## Request body

- GoldengateConnection — Details of the GoldengateConnection resource.
  - `createTime` string, google-datetime — Output only. The date and time that the GoldengateConnection was created.
  - `odbNetwork` string — Optional. The name of the OdbNetwork associated with the GoldengateConnection. The format is projects/{project}/locations/{location}/odbNetworks/{odb_network}. It is optional but if specified, this should match the parent ODBNetwork of the OdbSubnet.
  - `gcpOracleZone` string — Optional. The GCP Oracle zone where Oracle GoldengateConnection is hosted. Example: us-east4-b-r2. If not specified, the system will pick a zone based on availability.
  - `ociUrl` string — Output only. HTTPS link to OCI resources exposed to Customer via UI Interface.
  - `labels` object — Optional. The labels or tags associated with the GoldengateConnection.
  - `entitlementId` string — Output only. The ID of the subscription entitlement associated with the GoldengateConnection.
  - `properties` GoldengateConnectionProperties — The properties of a GoldengateConnection.
    - `icebergConnectionProperties` GoldengateIcebergConnectionProperties — The properties of GoldengateIcebergConnection.
      - `storage` IcebergStorage — The Iceberg storage details.
        - `googleCloudStorageIcebergStorage` GoogleCloudStorageIcebergStorage — The Google Cloud Storage Iceberg storage.
          - `projectId` string — Required. The project ID of Google Cloud Storage.
          - `serviceAccountKeyFile` string — Optional. The base64 encoded content of the service account key file of Google Cloud Storage.
          - `bucket` string — Required. The bucket of Google Cloud Storage.
        - `storageType` 'STORAGE_TYPE_UNSPECIFIED' | 'AMAZON_S3' | 'GOOGLE_CLOUD_STORAGE' | 'AZURE_DATA_LAKE_STORAGE' — Required. The type of Iceberg storage.
        - `amazonS3IcebergStorage` AmazonS3IcebergStorage — The Amazon S3 Iceberg storage.
          - `endpoint` string — Optional. The endpoint of Amazon S3.
          - `schemeType` 'SCHEME_TYPE_UNSPECIFIED' | 'S3' | 'S3A' — Required. The scheme type of Amazon S3.
          - `accessKeyId` string — Required. The access key ID of Amazon S3.
          - `region` string — Required. The region of Amazon S3.
          - `bucket` string — Required. The bucket of Amazon S3.
          - `secretAccessKeySecret` string — Optional. The secret access key of Amazon S3.
        - `azureDataLakeStorageIcebergStorage` AzureDataLakeStorageIcebergStorage — The Azure Data Lake Storage Iceberg storage.
          - `endpoint` string — Optional. The endpoint of Azure Data Lake Storage.
          - `azureAccount` string — Required. The account of Azure Data Lake Storage.
          - `container` string — Required. The container of Azure Data Lake Storage.
          - `accountKeySecret` string — Optional. The account key of Azure Data Lake Storage.
      - `technologyType` string — Required. The technology type of Iceberg connection.
      - `catalog` IcebergCatalog — The Iceberg catalog details.
        - `glueIcebergCatalog` GlueIcebergCatalog — The Glue Iceberg catalog.
          - `glueId` string — Required. The catalog ID of Glue.
        - `restIcebergCatalog` RestIcebergCatalog — The REST Iceberg catalog.
          - `uri` string — Required. The REST uri.
          - `properties` string — Optional. The base64 encoded content of the configuration file containing additional properties for the REST catalog.
        - `nessieIcebergCatalog` NessieIcebergCatalog — The Nessie Iceberg catalog.
          - `uri` string — Required. The Nessie uri.
          - `branch` string — Required. The Nessie branch.
        - `polarisIcebergCatalog` PolarisIcebergCatalog — The Polaris Iceberg catalog.
          - `principalRole` string — Required. The Polaris principal role.
          - `clientSecret` string — Optional. The Polaris client secret.
          - `uri` string — Required. The Polaris uri.
          - `polarisCatalog` string — Required. The catalog name within Polaris.
          - `clientId` string — Required. The Polaris client ID.
        - `catalogType` 'CATALOG_TYPE_UNSPECIFIED' | 'GLUE' | 'HADOOP' | 'NESSIE' | 'POLARIS' | 'REST' — Required. The type of Iceberg catalog.
    - `databricksConnectionProperties` GoldengateDatabricksConnectionProperties — The properties of GoldengateDatabricksConnection.
      - `authenticationType` 'DATABRICKS_AUTHENTICATION_TYPE_UNSPECIFIED' | 'PERSONAL_ACCESS_TOKEN' | 'OAUTH_M2M' — Optional. Authentication type for Databricks.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password used to connect to Databricks. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `storageCredential` string — Optional. External storage credential name to access files on object storage such as ADLS Gen2, S3 or Cloud Storage.
      - `connectionUrl` string — Optional. Connection URL. e.g.: 'jdbc:databricks://adb-33934.4.azuredatabricks.net:443/default;transportMode=http;ssl=1;httpPath=sql/protocolv1/o/3393########44/0##3-7-hlrb'
      - `clientId` string — Optional. OAuth client id, only applicable for authentication_type == OAUTH_M2M
      - `clientSecret` string — Optional. OAuth client secret, only applicable for authentication_type == OAUTH_M2M
      - `password` string — Optional. Input only. The password used to connect to Databricks in plain text.
      - `technologyType` string — Optional. The technology type of DatabricksConnection.
    - `mysqlConnectionProperties` GoldengateMysqlConnectionProperties — Properties of GoldengateMysqlConnection.
      - `sslMode` 'SSL_MODE_UNSPECIFIED' | 'DISABLED' | 'PREFERRED' | 'REQUIRED' | 'VERIFY_CA' | 'VERIFY_IDENTITY' — Optional. SSL modes for MySQL.
      - `sslCrlFile` string — Optional. The base64 encoded list of certificates revoked by the trusted certificate authorities (Trusted CA).
      - `sslCaFile` string — Optional. Database Certificate - The base64 encoded content of a .pem or .crt file containing the server public key (for 1 and 2-way SSL).
      - `technologyType` string — Optional. The technology type of MysqlConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `host` string — Optional. The name or address of a host.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect to MySQL. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses to connect to MySQL in plain text.
      - `port` integer — Optional. The port of an endpoint usually specified for a connection.
      - `database` string — Optional. The name of the database.
      - `additionalAttributes` NameValuePair[] — Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
        - `key` string — Required. The name of the property entry.
        - `value` string — Required. The value of the property entry.
      - `sslCertFile` string — Optional. Client Certificate - The base64 encoded content of a .pem or .crt file containing the client public key (for 2-way SSL).
      - `sslKeyFile` string — Optional. Client Key - The base64 encoded content of a .pem or .crt file containing the client private key (for 2-way SSL).
      - `dbSystemId` string — Optional. The OCID of the database system being referenced.
      - `securityProtocol` 'MYSQL_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' | 'MTLS' — Optional. Security Type for MySQL.
    - `description` string — Optional. Metadata about this specific object.
    - `displayName` string — Required. An object's Display Name.
    - `googleBigQueryConnectionProperties` GoldengateGoogleBigQueryConnectionProperties — The properties of GoldengateGoogleBigQueryConnectionProperties.
      - `technologyType` string — Optional. The technology type.
      - `serviceAccountKeyFile` string — Optional. The base64 encoded content of the service account key file containing the credentials required to use Google BigQuery.
    - `mongodbConnectionProperties` GoldengateMongodbConnectionProperties — The properties of GoldengateMongodbConnection.
      - `tlsCertificateKeyFilePassword` string — Optional. Input only. The Client Certificate key file password in plain text.
      - `connectionString` string — Optional. MongoDB connection string. e.g.: 'mongodb://mongodb0.example.com:27017/recordsrecords'
      - `password` string — Optional. Input only. The password Oracle Goldengate uses to connect the Mongodb connection in plain text.
      - `tlsCaFile` string — Optional. Database Certificate - The base64 encoded content of a .pem file, containing the server public key (for 1 and 2-way SSL).
      - `tlsCertificateKeyFile` string — Optional. Client Certificate - The base64 encoded content of a .pem file, containing the client public key (for 2-way SSL).
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect the Mongodb connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `tlsCertificateKeyFilePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the Client Certificate key file password in Secret Manager. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `securityProtocol` 'MONGODB_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' | 'MTLS' — Optional. Security Type for MongoDB.
      - `databaseId` string — Optional. The OCID of the Oracle Autonomous Json Database.
      - `technologyType` string — Optional. The technology type of MongodbConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect to the database.
    - `connectionType` 'GOLDENGATE_CONNECTION_TYPE_UNSPECIFIED' | 'GOLDENGATE' | 'KAFKA' | 'KAFKA_SCHEMA_REGISTRY' | 'MYSQL' | 'JAVA_MESSAGE_SERVICE' | 'MICROSOFT_SQLSERVER' | 'OCI_OBJECT_STORAGE' | 'ORACLE' | 'AZURE_DATA_LAKE_STORAGE' | 'POSTGRESQL' | 'AZURE_SYNAPSE_ANALYTICS' | 'SNOWFLAKE' | 'AMAZON_S3' | 'HDFS' | 'ORACLE_AI_DATA_PLATFORM' | 'ORACLE_NOSQL' | 'MONGODB' | 'AMAZON_KINESIS' | 'AMAZON_REDSHIFT' | 'DB2' | 'REDIS' | 'ELASTICSEARCH' | 'GENERIC' | 'GOOGLE_CLOUD_STORAGE' | 'GOOGLE_BIGQUERY' | 'DATABRICKS' | 'GOOGLE_PUBSUB' | 'MICROSOFT_FABRIC' | 'ICEBERG' — Required. The connection type.
    - `snowflakeConnectionProperties` GoldengateSnowflakeConnectionProperties — The properties of GoldengateSnowflakeConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect to Snowflake.
      - `connectionUrl` string — Optional. JDBC connection URL. e.g.: 'jdbc:snowflake://.snowflakecomputing.com/?warehouse=&db='
      - `password` string — Optional. Input only. The password Oracle Goldengate uses to connect to Snowflake platform in plain text.
      - `technologyType` string — Optional. The technology type of SnowflakeConnection.
      - `privateKeyPassphraseSecret` string — Optional. Password if the private key file is encrypted.
      - `privateKeyFile` string — Optional. The content of private key file in PEM format.
      - `authenticationType` 'AUTHENTICATION_TYPE_UNSPECIFIED' | 'BASIC' | 'KEY_PAIR' — Optional. Used authentication mechanism to access Snowflake.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect to Snowflake platform. Format: projects/{project}/secrets/{secret}/versions/{version}.
    - `oracleAiDataPlatformConnectionProperties` GoldengateOracleAIDataPlatformConnectionProperties — The properties of GoldengateOracleAIDataPlatformConnection.
      - `privateKeyPassphraseSecret` string — Optional. The passphrase of the private key.
      - `useResourcePrincipal` boolean — Optional. Specifies that the user intends to authenticate to the instance using a resource principal.
      - `tenancyId` string — Optional. The OCID of the related OCI tenancy.
      - `privateKeyFile` string — Optional. The content of the private key file (PEM file) corresponding to the API key of the fingerprint.
      - `region` string — Optional. The name of the region. e.g.: us-ashburn-1
      - `userId` string — Optional. The OCID of the OCI user who will access.
      - `technologyType` string — Optional. The technology type of OracleAiDataPlatformConnection.
      - `connectionUrl` string — Optional. Connection URL. It must start with 'jdbc:spark://'
      - `publicKeyFingerprint` string — Optional. The fingerprint of the API Key of the user specified by the user_id.
    - `postgresqlConnectionProperties` GoldengatePostgresqlConnectionProperties — The properties of GoldengatePostgresqlConnection.
      - `sslCaFile` string — Optional. The base64 encoded certificate of the trusted certificate authorities (Trusted CA) for PostgreSQL.
      - `sslMode` 'POSTGRESQL_SSL_MODE_UNSPECIFIED' | 'PREFER' | 'REQUIRE' | 'VERIFY_CA' | 'VERIFY_FULL' — Optional. SSL modes for PostgreSQL.
      - `sslCrlFile` string — Optional. The base64 encoded list of certificates revoked by the trusted certificate authorities (Trusted CA).
      - `technologyType` string — Optional. The technology type of PostgresqlConnection.
      - `host` string — Optional. The name or address of a host.
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for PostgreSQL connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for PostgreSQL connection in plain text.
      - `port` integer — Optional. The port of an endpoint usually specified for a connection.
      - `database` string — Optional. The name of the database.
      - `additionalAttributes` NameValuePair[] — Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
        - `key` string — Required. The name of the property entry.
        - `value` string — Required. The value of the property entry.
      - `sslKeyFile` string — Optional. The base64 encoded private key of the PostgreSQL server.
      - `sslCertFile` string — Optional. The base64 encoded certificate of the PostgreSQL server.
      - `dbSystemId` string — Optional. The OCID of the database system being referenced.
      - `securityProtocol` 'POSTGRESQL_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' | 'MTLS' — Optional. Security protocol for PostgreSQL.
    - `lifecycleDetails` string — Output only. Describes the object's current state in detail. For example, it can be used to provide actionable information for a resource in a Failed state.
    - `googleCloudStorageConnectionProperties` GoldengateGoogleCloudStorageConnectionProperties — The properties of GoldengateGoogleCloudStorageConnectionProperties.
      - `technologyType` string — Optional. The technology type.
      - `serviceAccountKeyFile` string — Optional. The base64 encoded content of the service account key file containing the credentials required to use Google Cloud Storage.
    - `routingMethod` 'GOLDENGATE_CONNECTION_ROUTING_METHOD_UNSPECIFIED' | 'SHARED_DEPLOYMENT_ENDPOINT' | 'DEDICATED_ENDPOINT' — Optional. The routing method for the GoldengateConnection.
    - `oracleConnectionProperties` GoldengateOracleConnectionProperties — The properties of Goldengate Oracle Database Connection.
      - `sessionMode` 'SESSION_MODE_UNSPECIFIED' | 'DIRECT' | 'REDIRECT' — Optional. The mode of the database connection session to be established by the data client.
      - `connectionString` string — Optional. Connect descriptor or Easy Connect Naming method used to connect to a database.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses in plain text.
      - `authenticationMode` 'ORACLE_AUTHENTICATION_MODE_UNSPECIFIED' | 'TLS' | 'MTLS' — Optional. Authentication mode.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `username` string — Optional. The username Oracle Goldengate uses to connect.
      - `gcpOracleDatabaseId` string — Optional. Autonomous AI Database instance id of database in Oracle Database @ Google Cloud. If gcp_oracle_database_id is provided, connection_string must be empty. Format: projects/{project}/locations/{location}/autonomousDatabases/{autonomous_database}
      - `walletFile` string — Optional. The wallet contents Oracle Goldengate uses to make connections to a database. This attribute is expected to be base64 encoded.
      - `technologyType` string — Optional. The technology type.
    - `goldengateConnectionProperties` GoldengateGoldengateConnectionProperties — The properties of GoldengateGoldengateConnectionProperties.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password used to connect to the Oracle Goldengate. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `port` integer — Optional. The port of the GoldengateConnection.
      - `password` string — Optional. Input only. The password used to connect to the Oracle Goldengate in plain text.
      - `technologyType` string — Optional. The technology type.
      - `goldengateDeploymentId` string — Optional. The name of the GoldengateDeployment associated with the GoldengateConnection. Format: projects/{project}/locations/{location}/goldengateDeployments/{goldengate_deployment}
      - `host` string — Optional. The host of the GoldengateConnection.
      - `username` string — Optional. The username credential.
    - `microsoftSqlserverConnectionProperties` GoldengateMicrosoftSqlserverConnectionProperties — The properties of GoldengateMicrosoftSqlserverConnection.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Microsoft SQL Server connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `securityProtocol` 'MICROSOFT_SQLSERVER_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' — Optional. Security Type for Microsoft SQL Server.
      - `technologyType` string — Optional. The technology type of MicrosoftSqlserverConnection.
      - `host` string — Optional. The name or address of a host.
      - `username` string — Optional. The username Oracle Goldengate uses to connect to the Microsoft SQL Server.
      - `port` integer — Optional. The port of an endpoint usually specified for a connection.
      - `database` string — Optional. The name of the database.
      - `additionalAttributes` NameValuePair[] — Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
        - `key` string — Required. The name of the property entry.
        - `value` string — Required. The value of the property entry.
      - `sslCaFile` string — Optional. Database Certificate - The base64 encoded content of a .pem or .crt file containing the server public key (for 1-way SSL).
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for Microsoft SQL Server connection in plain text.
      - `serverCertificateValidationRequired` boolean — Optional. If set to true, the driver validates the certificate that is sent by the database server.
    - `genericConnectionProperties` GoldengateGenericConnectionProperties — The properties of GoldengateGenericConnectionProperties.
      - `technologyType` string — Optional. The technology type.
      - `host` string — Optional. The host of the GenericConnection.
    - `azureDataLakeStorageConnectionProperties` GoldengateAzureDataLakeStorageConnectionProperties — The properties of GoldengateAzureDataLakeStorageConnection.
      - `account` string — Optional. Sets the Azure storage account name.
      - `sasTokenSecret` string — Optional. Credential that uses a shared access signature (SAS) to authenticate to an Azure Service.
      - `azureAuthorityHost` string — Optional. The endpoint used for authentication with Microsoft Entra ID (formerly Azure Active Directory). Default value: https://login.microsoftonline.com
      - `clientId` string — Optional. Azure client ID of the application. This property is required when 'authentication_type' is set to 'AZURE_ACTIVE_DIRECTORY'.
      - `endpoint` string — Optional. Azure Storage service endpoint. e.g: https://test.blob.core.windows.net
      - `clientSecret` string — Optional. Azure client secret (aka application password) for authentication.
      - `technologyType` string — Optional. The technology type of AzureDataLakeStorageConnection.
      - `authenticationType` 'AUTHENTICATION_TYPE_UNSPECIFIED' | 'SHARED_KEY' | 'SHARED_ACCESS_SIGNATURE' | 'AZURE_ACTIVE_DIRECTORY' — Optional. Authentication mechanism to access Azure Data Lake Storage.
      - `azureTenantId` string — Optional. Azure tenant ID of the application. This property is required when 'authentication_type' is set to 'AZURE_ACTIVE_DIRECTORY'.
      - `accountKeySecret` string — Optional. Azure storage account key. This property is required when 'authentication_type' is set to 'SHARED_KEY'.
    - `kafkaConnectionProperties` GoldengateKafkaConnectionProperties — The properties of GoldengateKafkaConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `clusterId` string — Optional. The OCID of the Kafka cluster being referenced from OCI Streaming with Apache Kafka.
      - `technologyType` string — Optional. The technology type of KafkaConnection.
      - `consumerPropertiesFile` string — Optional. The base64 encoded content of the consumer.properties file.
      - `keyStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for Kafka basic/SASL auth. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `keyStorePassword` string — Optional. Input only. The KeyStore password in plain text.
      - `useResourcePrincipal` boolean — Optional. Specifies that the user intends to authenticate to the instance using a resource principal. Applicable only for OCI Streaming connections.
      - `producerPropertiesFile` string — Optional. The base64 encoded content of the producer.properties file.
      - `keyStoreFile` string — Optional. The base64 encoded content of the KeyStore file.
      - `sslKeyPassword` string — Optional. Input only. The password for the cert inside of the KeyStore in plain text.
      - `sslKeyPasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for the cert inside of the KeyStore. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `trustStoreFile` string — Optional. The base64 encoded content of the TrustStore file.
      - `bootstrapServers` KafkaBootstrapServer[] — Optional. Kafka bootstrap. Equivalent of bootstrap.servers configuration property in Kafka: list of KafkaBootstrapServer objects specified by host/port. Used for establishing the initial connection to the Kafka cluster. Example: "server1.example.com:9092,server2.example.com:9092"
        - `host` string — Required. The name or address of a host.
        - `privateIpAddress` string — Optional. The private IP address of the connection's endpoint in the customer's VCN, typically a database endpoint or a big data endpoint (e.g. Kafka bootstrap server). In case the privateIp is provided, the subnetId must also be provided. In case the privateIp (and the subnetId) is not provided it is assumed the datasource is publicly accessible. In case the connection is accessible only privately, the lack of privateIp will result in not being able to access the connection.
        - `port` integer — Optional. The port of an endpoint usually specified for a connection.
      - `securityProtocol` 'KAFKA_SECURITY_PROTOCOL_UNSPECIFIED' | 'SSL' | 'SASL_SSL' | 'PLAINTEXT' | 'SASL_PLAINTEXT' — Optional. Security Type for Kafka.
      - `trustStorePassword` string — Optional. Input only. The TrustStore password in plain text.
      - `trustStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `password` string — Optional. Input only. The password for Kafka basic/SASL auth in plain text.
      - `streamPoolId` string — Optional. The OCID of the stream pool being referenced.
    - `hdfsConnectionProperties` GoldengateHdfsConnectionProperties — The properties of GoldengateHdfsConnection.
      - `technologyType` string — Optional. The technology type of HdfsConnection.
      - `coreSiteXml` string — Optional. The content of the Hadoop Distributed File System configuration file (core-site.xml).
    - `googlePubsubConnectionProperties` GoldengateGooglePubsubConnectionProperties — The properties of GoldengateGooglePubsubConnection.
      - `technologyType` string — Optional. The technology type of GooglePubsubConnection.
      - `serviceAccountKeyFile` string — Optional. The base64 encoded content of the service account key file containing the credentials required to use Google Pub/Sub.
    - `kafkaSchemaRegistryConnectionProperties` GoldengateKafkaSchemaRegistryConnectionProperties — The properties of GoldengateKafkaSchemaRegistryConnection.
      - `password` string — Optional. Input only. The password to access Schema Registry in plain text.
      - `trustStorePassword` string — Optional. Input only. The TrustStore password in plain text.
      - `trustStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `trustStoreFile` string — Optional. The base64 encoded content of the TrustStore file.
      - `url` string — Optional. Kafka Schema Registry URL. e.g.: 'https://server1.us.oracle.com:8081'
      - `sslKeyPassword` string — Optional. Input only. The password for the cert inside the KeyStore in plain text.
      - `sslKeyPasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for the cert inside the KeyStore. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `keyStoreFile` string — Optional. The base64 encoded content of the KeyStore file.
      - `technologyType` string — Optional. The technology type of KafkaSchemaRegistryConnection.
      - `username` string — Optional. The username to access Schema Registry using basic authentication. This value is injected into 'schema.registry.basic.auth.user.info=user:password' configuration property.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password to access Schema Registry using basic authentication. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `keyStorePassword` string — Optional. Input only. The KeyStore password in plain text.
      - `keyStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `authenticationType` 'AUTHENTICATION_TYPE_UNSPECIFIED' | 'NONE' | 'BASIC' | 'MUTUAL' — Optional. Used authentication mechanism to access Schema Registry.
    - `azureSynapseAnalyticsConnectionProperties` GoldengateAzureSynapseAnalyticsConnectionProperties — The properties of GoldengateAzureSynapseAnalyticsConnection.
      - `connectionString` string — Optional. JDBC connection string. e.g.: 'jdbc:sqlserver://.sql.azuresynapse.net:1433;database=;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.sql.azuresynapse.net;loginTimeout=300;'
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for Azure Synapse Analytics connection in plain text.
      - `technologyType` string — Optional. The technology type of AzureSynapseAnalyticsConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Azure Synapse Analytics connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
    - `oracleNosqlConnectionProperties` GoldengateOracleNosqlConnectionProperties — The properties of GoldengateOracleNosqlConnection.
      - `tenancyId` string — Optional. The OCID of the OCI tenancy.
      - `privateKeyFile` string — Optional. The content of the private key file (PEM file) corresponding to the API key of the fingerprint.
      - `region` string — Optional. The name of the region. e.g.: us-ashburn-1
      - `userId` string — Optional. The OCID of the OCI user who will access the Oracle NoSQL database.
      - `technologyType` string — Optional. The technology type of OracleNosqlConnection.
      - `privateKeyPassphraseSecret` string — Optional. The passphrase of the private key.
      - `useResourcePrincipal` boolean — Optional. Specifies that the user intends to authenticate to the instance using a resource principal.
      - `publicKeyFingerprint` string — Optional. The fingerprint of the API Key of the user specified by the userId.
    - `ocid` string — Output only. The [OCID] of the connection being referenced.
    - `redisConnectionProperties` GoldengateRedisConnectionProperties — The properties of GoldengateRedisConnection.
      - `keyStoreFile` string — Optional. The base64 encoded content of the KeyStore file.
      - `servers` string — Optional. Comma separated list of Redis server addresses, specified as host:port entries, where :port is optional. If port is not specified, it defaults to 6379. Example: "server1.example.com:6379,server2.example.com:6379"
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Redis connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `keyStorePassword` string — Optional. Input only. The KeyStore password in plain text.
      - `keyStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `authenticationType` 'REDIS_AUTHENTICATION_TYPE_UNSPECIFIED' | 'NONE' | 'BASIC' — Optional. Authentication type for Redis.
      - `technologyType` string — Optional. The technology type of RedisConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `trustStorePassword` string — Optional. Input only. The TrustStore password in plain text.
      - `trustStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for Redis connection in plain text.
      - `securityProtocol` 'REDIS_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' | 'MTLS' — Optional. Security protocol for Redis.
      - `trustStoreFile` string — Optional. The base64 encoded content of the TrustStore file.
      - `redisClusterId` string — Optional. The OCID of the Redis cluster.
    - `amazonS3ConnectionProperties` GoldengateAmazonS3ConnectionProperties — The properties of GoldengateAmazonS3Connection.
      - `secretAccessKeySecret` string — Optional. Secret access key to access the Amazon S3 bucket.
      - `technologyType` string — Optional. The technology type of AmazonS3Connection.
      - `accessKeyId` string — Optional. Access key ID to access the Amazon S3 bucket.
      - `region` string — Optional. The name of the AWS region where the bucket is created.
      - `endpoint` string — Optional. The Amazon Endpoint for S3.
    - `javaMessageServiceConnectionProperties` GoldengateJavaMessageServiceConnectionProperties — The properties of GoldengateJavaMessageServiceConnection.
      - `jndiSecurityPrincipal` string — Optional. Specifies the identity of the principal (user) to be authenticated.
      - `jndiInitialContextFactory` string — Optional. The implementation of javax.naming.spi.InitialContextFactory interface used to obtain initial naming context.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses to connect the Java Message Service in plain text.
      - `trustStorePassword` string — Optional. Input only. The TrustStore password in plain text.
      - `trustStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the TrustStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `securityProtocol` 'JMS_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' | 'MTLS' — Optional. Security protocol for Java Message Service.
      - `connectionFactory` string — Optional. The Java class implementing javax.jms.ConnectionFactory interface supplied by the JMS provider.
      - `trustStoreFile` string — Optional. The base64 encoded content of the TrustStore file.
      - `sslKeyPassword` string — Optional. Input only. The password for the cert inside of the KeyStore in plain text.
      - `sslKeyPasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password for the cert inside of the KeyStore. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `jndiSecurityCredentialsSecret` string — Optional. The password associated to the principal.
      - `keyStoreFile` string — Optional. The base64 encoded content of the KeyStore file.
      - `keyStorePasswordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the KeyStore password. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `useJndi` boolean — Optional. If set to true, Java Naming and Directory Interface (JNDI) properties should be provided.
      - `authenticationType` 'JMS_AUTHENTICATION_TYPE_UNSPECIFIED' | 'NONE' | 'BASIC' — Optional. Authentication type for Java Message Service.
      - `jndiConnectionFactory` string — Optional. The Connection Factory can be looked up using this name. e.g.: 'ConnectionFactory'
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses to connect the associated Java Message Service. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `keyStorePassword` string — Optional. Input only. The KeyStore password in plain text.
      - `username` string — Optional. The username Oracle Goldengate uses to connect to the Java Message Service.
      - `connectionUrl` string — Optional. Connection URL of the Java Message Service, specifying the protocol, host, and port. e.g.: 'mq://myjms.host.domain:7676'
      - `technologyType` string — Optional. The technology type of JavaMessageServiceConnection.
      - `jndiProviderUrl` string — Optional. The URL that Java Message Service will use to contact the JNDI provider. e.g.: 'tcp://myjms.host.domain:61616?jms.prefetchPolicy.all=1000'
    - `ingressIpAddresses` string[] — Output only. The Ingress IPs of the GoldengateConnection.
    - `elasticsearchConnectionProperties` GoldengateElasticsearchConnectionProperties — The properties of GoldengateElasticsearchConnection.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for Elastic Search connection in plain text.
      - `technologyType` string — Optional. The technology type of ElasticsearchConnection.
      - `servers` string — Optional. Comma separated list of Elasticsearch server addresses, specified as host:port entries, where :port is optional. If port is not specified, it defaults to 9200. Example: "server1.example.com:4000,server2.example.com:4000"
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `fingerprint` string — Optional. Fingerprint required by TLS security protocol. Eg.: '6152b2dfbff200f973c5074a5b91d06ab3b472c07c09a1ea57bb7fd406cdce9c'
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Elastic Search connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `securityProtocol` 'ELASTICSEARCH_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' — Optional. Security protocol for Elasticsearch.
      - `authenticationType` 'ELASTICSEARCH_AUTHENTICATION_TYPE_UNSPECIFIED' | 'NONE' | 'BASIC' — Optional. Authentication type for Elasticsearch.
    - `ociObjectStorageConnectionProperties` GoldengateOciObjectStorageConnectionProperties — The properties of GoldengateOciObjectStorageConnection.
      - `tenancyId` string — Optional. The OCID of the related OCI tenancy.
      - `privateKeyFile` string — Optional. The content of the private key file (PEM file) corresponding to the API key of the fingerprint.
      - `technologyType` string — Optional. The technology type of OciObjectStorageConnection.
      - `privateKeyPassphraseSecret` string — Optional. The passphrase of the private key.
      - `region` string — Optional. The name of the region of OCI Object Storage. e.g.: us-ashburn-1 If the region is not provided, backend will default to the default region.
      - `userId` string — Optional. The OCID of the OCI user who will access the Object Storage. The user must have write access to the bucket they want to connect to.
      - `publicKeyFingerprint` string — Optional. The fingerprint of the API Key of the user specified by the userId.
      - `useResourcePrincipal` boolean — Optional. Specifies that the user intends to authenticate to the instance using a resource principal.
    - `amazonKinesisConnectionProperties` GoldengateAmazonKinesisConnectionProperties — The properties of GoldengateAmazonKinesisConnection.
      - `technologyType` string — Optional. The technology type of AmazonKinesisConnection.
      - `accessKeyId` string — Optional. Access key ID to access the Amazon Kinesis.
      - `endpoint` string — Optional. The endpoint URL of the Amazon Kinesis service. e.g.: 'https://kinesis.us-east-1.amazonaws.com' If not provided, Goldengate will default to 'https://kinesis..amazonaws.com'.
      - `secretAccessKeySecret` string — Optional. Secret access key to access the Amazon Kinesis.
      - `awsRegion` string — Optional. The name of the AWS region. If not provided, Goldengate will default to 'us-west-1'.
    - `microsoftFabricConnectionProperties` GoldengateMicrosoftFabricConnectionProperties — The properties of GoldengateMicrosoftFabricConnection.
      - `technologyType` string — Optional. The technology type of MicrosoftFabricConnection.
      - `tenantId` string — Optional. Azure tenant ID of the application.
      - `clientSecret` string — Optional. Client secret associated with the client id.
      - `endpoint` string — Optional. Optional Microsoft Fabric service endpoint. Default value: https://onelake.dfs.fabric.microsoft.com
      - `clientId` string — Optional. Azure client ID of the application.
    - `lifecycleState` 'GOLDENGATE_CONNECTION_LIFECYCLE_STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'DELETED' | 'FAILED' — Output only. The lifecycle state of the connection.
    - `updateTime` string, google-datetime — Output only. The time the resource was last updated.
    - `db2ConnectionProperties` GoldengateDb2ConnectionProperties — The properties of GoldengateDb2Connection.
      - `technologyType` string — Optional. The technology type of Db2Connection.
      - `host` string — Optional. The name or address of a host.
      - `username` string — Optional. The username Oracle Goldengate uses to connect to the DB2 database.
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Db2 connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
      - `sslClientKeystashFile` string — Optional. The keystash file which contains the encrypted password to the key database file. Not supported for IBM Db2 for i.
      - `securityProtocol` 'DB2_SECURITY_PROTOCOL_UNSPECIFIED' | 'PLAIN' | 'TLS' — Optional. Security protocol for the DB2 database.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for Db2 connection in plain text.
      - `sslClientKeystoredbFile` string — Optional. The keystore file created at the client containing the server certificate / CA root certificate. Not supported for IBM Db2 for i.
      - `sslServerCertificateFile` string — Optional. The file which contains the self-signed server certificate / Certificate Authority (CA) certificate.
      - `port` integer — Optional. The port of an endpoint usually specified for a connection.
      - `database` string — Optional. The name of the database.
      - `additionalAttributes` NameValuePair[] — Optional. An array of name-value pair attribute entries. Used as additional parameters in connection string.
        - `key` string — Required. The name of the property entry.
        - `value` string — Required. The value of the property entry.
    - `amazonRedshiftConnectionProperties` GoldengateAmazonRedshiftConnectionProperties — The properties of GoldengateAmazonRedshiftConnection.
      - `password` string — Optional. Input only. The password Oracle Goldengate uses for Amazon Redshift connection in plain text.
      - `technologyType` string — Optional. The technology type of AmazonRedshiftConnection.
      - `username` string — Optional. The username Oracle Goldengate uses to connect the associated system of the given technology.
      - `connectionUrl` string — Optional. Connection URL. e.g.: 'jdbc:redshift://aws-redshift-instance.aaaaaaaaaaaa.us-east-2.redshift.amazonaws.com:5439/mydb'
      - `passwordSecretVersion` string — Optional. Input only. The resource name of a secret version in Secret Manager which contains the password Oracle Goldengate uses for Amazon Redshift connection. Format: projects/{project}/secrets/{secret}/versions/{version}.
  - `odbSubnet` string — Optional. The name of the OdbSubnet associated with the GoldengateConnection for IP allocation. Format: projects/{project}/locations/{location}/odbNetworks/{odb_network}/odbSubnets/{odb_subnet}
  - `name` string — Identifier. The name of the GoldengateConnection resource in the following format: projects/{project}/locations/{region}/goldengateConnections/{goldengate_connection}

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/oracledatabase.md) · [All operations](https://skmtc.net/google/apis/oracledatabase/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/oracledatabase/revisions/120ce7891e09/schema)
