davsclaus opened a new pull request, #3152:
URL: https://github.com/apache/camel-kamelets/pull/3152
_Claude Code on behalf of Claus Ibsen_
A batch of Kamelets rewritten to the documentation standard proposed in
#3140, `docs/modules/ROOT/pages/documenting.adoc`, like #3141–#3151.
This batch has 14 AWS Kamelets and 5 partial pages:
- `aws-ddb-sink` and `aws-ddb-streams-source`;
- `aws-lambda-sink` and `aws-ec2-sink`;
- `aws-redshift-sink` and `aws-redshift-source`;
- `aws-secrets-manager-sink` and `aws-timestream-query-sink`;
- `aws-translate-action`, `aws-polly-sink` and `aws-comprehend-sink`;
- `aws-bedrock-text-sink`, `aws-bedrock-agent-sink` and
`aws-bedrock-agent-runtime-sink`.
The AWS options use the same words as in #3148 and `aws-s3-source`.
## How they were checked
| Kamelets | Checked |
|---|---|
| DynamoDB, DynamoDB Streams, Lambda, EC2, Secrets Manager, Comprehend,
Bedrock text | Run against an AWS emulator, most on Camel 4.23.0 and
4.24.0-SNAPSHOT. |
| Redshift | Run against PostgreSQL, which speaks the same protocol. |
| Timestream, Translate, Polly, the two Bedrock agent Kamelets | Checked
against the template and the component. |
## Facts that were missing or wrong before
- **`aws-ddb-sink`:**
- the body is JSON text, one field per attribute, and the description says
how each kind of value is stored;
- the operation comes from the option or the `operation` header, not from
the body, although its partial page said the body;
- a missing key fails the message.
- **`aws-ddb-streams-source`:**
- sends each change as JSON text, with the event name;
- `streamIteratorType` now lists the two values the component accepts.
- **`aws-lambda-sink`:** calls the function synchronously. A function error
does not fail the message; it sets `CamelAwsLambdaFunctionError`.
- **`aws-redshift-*`:**
- they log in with a database user and password, not AWS credentials,
which their partial pages described;
- the `query` example of the source was an INSERT.
- **`aws-secrets-manager-sink`:** the body becomes the secret, and a name
that already exists fails.
- **`aws-bedrock-text-sink`:** the body is the model's own JSON format, and
what comes back depends on the model.
- **`aws-bedrock-agent-sink`:** `dataSourceId` is needed by all three
operations.
## Left out, and found on the way
- **`aws-sts-assume-role-action` is not in this PR, because it does not
start** (4.23 and 4.24): `Unknown parameters=[{useSessionCredentials=false}]`.
The `aws2-sts` component has no such option; this has been broken since
6935281a4. It will be described with its fix.
- **`aws-ddb-sink` on Camel 4.23 silently ignores an `operation` field in
the body.** A body meant as a DeleteItem replaced the item instead. In one
route, headers left over from an earlier DynamoDB call can make a second call
write the old item again.
- **`aws-ec2-sink` on Camel 4.23:** an `instanceIds` header given as text is
ignored, and the status of all instances comes back.
- **Endpoint override:** `aws-lambda-sink`, `aws-secrets-manager-sink` and
`aws-translate-action` have none, so a local emulator can only be used through
component properties.
- **Outdated enums:**
- `aws-bedrock-text-sink` and `aws-bedrock-agent-runtime-sink` `modelId`
list only old models (no Claude 3.5 or later, Nova, Llama or Mistral), and
their `region` lists few regions;
- `aws-translate-action` allows 25 language codes and no `auto`;
- several region enums miss newer regions.
- **Commonly needed component options these Kamelets do not expose:**
- DynamoDB reads (GetItem, Query, Scan);
- asynchronous Lambda calls;
- updating an existing secret;
- Bedrock `converse` and guardrails;
- a proxy.
These are for a follow-up.
## Notes for review
- No template, type, default or required list was changed. The one new
`enum` is on `aws-ddb-streams-source` `streamIteratorType`: `FROM_LATEST` and
`FROM_START`, the component's values. The `dataTypes` blocks are `headers`
only, with no `default`.
- `KameletsCatalogTest.testSupportedHeaders`: `aws-ddb-sink` 2 → 3.
- This PR is based on `main`; if #3140 merges first, I will rebase it and
regenerate the index.
`./mvnw clean install` from the root passes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]