Skip to main content

Amazon S3

Pick up or drop files in an S3 bucket.

Data & cloud↓ Inbound↑ Outbound
Type codeS3
Camel componentcamel-aws2-s3
Formats carried
HL7 v2FHIR R4JSONXMLCSVExcel (XLSX)Fixed-width textPDF
Terms used on this page

IAM - Identity and Access Management - AWS accounts and access keys

See the Glossary for every term.

Never use the root account's keys

Use the access key of an IAM user created for the engine, never the AWS root account.

What Test connection proves

It confirms the bucket exists and answers. The access key itself is not checked yet (see Stage 2). If the bucket is in a different region, the test says so.

Worked example​

Order drop bucket (S3) · Inbound · Excel (XLSX) · Test passes on any engine: No - placeholder values

Placeholder bucket - replace with the partner's bucket, region and access key.

Values entered by Fill example
{
"direction": "Inbound",
"format": "Excel (XLSX)",
"settings": {
"bucket": "xellabs-demo-orders",
"region": "us-east-1",
"prefix": "incoming/",
"accessKeyId": "YOUR-ACCESS-KEY-ID"
}
}
Placeholder values

The addresses above are placeholders on example.com. Replace them with your partner's real details before running Test connection.

This is what the console's Fill example button enters. Secrets are never part of an example. Every setting is explained below.

Settings​

Required fields are marked Yes. Fields marked 🔒 (secretAccessKey) are stored encrypted and never sent back to the browser - the console only shows Set / Not set. A field marked inbound only or outbound only appears just for that direction.

SettingTypeRequiredDefaultWhat to enter
bucket
Bucket
textYes—Required: the bucket name, e.g. lab-orders-prod.
region
Region
textYesus-east-1Required: the bucket's AWS region, e.g. ap-south-1.
prefix
Folder (key prefix)
textNo—Optional folder inside the bucket, e.g. orders/incoming/.
accessKeyId
Access key ID
textYes—Required: the IAM access key id, e.g. AKIA... (never the root account).
secretAccessKey
Secret access key
passwordNo—🔒 secret. Required: its secret. Stored encrypted.

What "Test connection" checks​

The bucket exists and answers. The access key is checked in Stage 2.

Test connection is read-only and says how far it got: verified, reached, checked or failed. See Testing a connection, and Troubleshooting if it fails.