Learn to create a connection to Amazon S3 to use as a target for OCI GoldenGate.

1. From the OCI GoldenGate Overview page, click Connections.
   You can also click Create Connection under the Get started section and skip to step 3.
2. On the Connections page, click Create Connection.
3. On the Create Connection page, complete the fields as follows:
   1. For Name, enter a name for the connection.
   2. (Optional) For Description, enter a description that helps you distinguish this connection from others.
   3. (For GoldenGate on Multicloud only) Select your Subscription, and then complete the following fields.
      1. From the Compartment dropdown, select the compartment in which the Resource Anchor resides.
      2. Select the Multicloud partner region.
      3. Select your Partner availability zone. The available options populate based on the selected Multicloud partner region.
   4. For Compartment, select the compartment in which to create the connection.
   5. For Type, select Amazon S3.
   6. For Access key id, enter the Amazon S3 access key ID.

      Note:

      The Access key id must contain only alphanumeric characters and underscores, and be 16 to 128 characters in length.
   7. Select the Secret access key secret. If located in a different compartment, use the dropdown to change compartments.

      Note:

      • Secrets are credentials such as passwords, certificates, SSH keys, or authentication tokens that you use with OCI services. To create a secret, see Creating a secret. Ensure that you:
        • Select Manual secret generation.
        • Paste the credentials into Secret contents.
      • If you prefer not to use password secrets, ensure that you deselect Use secrets in vault in the Security section under Advanced Options, located at the bottom of this form.
   8. For Region, enter the name of the region where the bucket resides.
   9. For Endpoint, enter the Amazon VPC endpoint for S3.
   10. Expand Show advanced options. You can configure the following options:
       • Security
         • Deselect Use vault secrets you prefer not to use password secrets for this connection. If not selected:
           • Select Use Oracle-managed encryption key to leave all encryption key management to Oracle.
           • Select Use customer-managed encryption key to select a specific encryption key stored in your OCI Vault to encrypt your connection credentials.
       • Network connectivity
         • Shared endpoint, to share an endpoint with the assigned deployment. You must allow connectivity from the deployment's ingress IP.
         • Dedicated endpoint, for network traffic through a dedicated endpoint in the assigned subnet in your VCN. You must allow connectivity from this connection's ingress IPs.

           Note:

           • If a dedicated connection remains unassigned for seven days, then the service converts it to a shared connection.
           • Learn more about Oracle GoldenGate connectivity.
       • Security attributes: Add security attributes to control access to this connection using Zero Trust Packet Routing (ZPR).
       • Tags: Add tags to organize your resources.
4. Click Create.

If you encounter the following error when using Amazon S3 connections, then open a support ticket, share the details and error message.

ERROR 2024-03-04 11:42:31.000505 [TaskEngine_2(FileFinalizeTask)] - Verify S3 bucket
      [ggstest] failed.com.amazonaws.SdkClientException: Unable to execute HTTP request: s3.us-east-2.amazonaws.com 

You can then use the following steps as a temporary workaround.

Workaround:

1. Connect to Cloud Shell.
2. Create a new Amazon S3 connection using the following CLI sample:

   oci goldengate connection create-amazon-s3-connection --routing-method SHARED_SERVICE_ENDPOINT --display-name <connection_name> --compartment-id <compartment_ocid> --technology-type AMAZON_S3 --access-key-id <aws_access_key> --secret-access-key <aws_secret> --connection-region <amazon_s3_bucket_region>

3. Assign the connection to your deployment.
4. Add and run a Replicat for Amazon S3.

Alternatively, if you prefer not to use public access, configure your Amazon S3 connection's buckets to use AWS VPC Endpoints. For OCI GoldenGate to access your S3 bucket using VPC Endpoints, you must also configure an IPsec VPN between your VCN and the AWS VPC.

To set the endpoint for Amazon S3, add the gg.eventhandler.s3.url property to Replicat Properties File, and provide the endpoint for the private connection.