This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch CAMEL-25737-sqs-visibility-extender
in repository https://gitbox.apache.org/repos/asf/camel.git

commit 877987b2dc643bf6f661fb39edbeee8ea4dd14c8
Author: Claus Ibsen <[email protected]>
AuthorDate: Sun Nov 22 19:54:07 2026 +0100

    CAMEL-25737: camel-aws2-sqs - extendMessageVisibility requires a 
visibilityTimeout of at least 2 seconds
    
    The visibility timeout extender runs every max(1, visibilityTimeout / 2) 
whole
    seconds and extends a message once 80% of its visibility timeout has passed.
    With visibilityTimeout=1 each extension came when the message was already
    visible again, so another consumer received it while it was processed; with 0
    or a negative value the extender was silently not created.
    
    The endpoint now fails to be created when extendMessageVisibility is enabled
    with a visibilityTimeout below 2 seconds, and the consumer logs a warning 
when
    it is below 10 seconds, as the extension then has only 1 to 2 seconds left.
    
    Co-Authored-By: Claude Opus 5.5 <[email protected]>
    Signed-off-by: Claus Ibsen <[email protected]>
---
 .../apache/camel/catalog/components/aws2-sqs.json  |  8 +++----
 .../camel/catalog/docs/aws2-sqs-component.adoc     |  6 +++++
 .../apache/camel/component/aws2/sqs/aws2-sqs.json  |  8 +++----
 .../src/main/docs/aws2-sqs-component.adoc          |  6 +++++
 .../camel/component/aws2/sqs/Sqs2Component.java    |  6 +++++
 .../component/aws2/sqs/Sqs2Configuration.java      |  8 ++++---
 .../camel/component/aws2/sqs/Sqs2Consumer.java     |  7 ++++++
 .../aws2/sqs/SqsComponentConfigurationTest.java    | 26 ++++++++++++++++++++++
 .../aws2/sqs/dst/SqsVisibilityDstTest.java         |  2 +-
 .../camel/component/aws2/sqs/dst/SqsWorld.java     |  3 +--
 .../ROOT/pages/camel-4x-upgrade-guide-4_24.adoc    | 12 ++++++++++
 .../dsl/Aws2SqsComponentBuilderFactory.java        | 10 ++++++---
 .../endpoint/dsl/Sqs2EndpointBuilderFactory.java   | 20 ++++++++++++-----
 13 files changed, 99 insertions(+), 23 deletions(-)

diff --git 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json
 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json
index d104a1f161fc..ca9e9d118b8b 100644
--- 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json
+++ 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/aws2-sqs.json
@@ -39,13 +39,13 @@
     "defaultVisibilityTimeout": { "index": 12, "kind": "property", 
"displayName": "Default Visibility Timeout", "group": "consumer", "label": 
"consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The visibility timeout 
(in seconds) of the queue. When the endpoint starts, [...]
     "deleteAfterRead": { "index": 13, "kind": "property", "displayName": 
"Delete After Read", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Delete the message from 
SQS when the exchange completes successfully" },
     "deleteIfFiltered": { "index": 14, "kind": "property", "displayName": 
"Delete If Filtered", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Whether to send the 
DeleteMessage to the SQS queue if the exchange has property [...]
-    "extendMessageVisibility": { "index": 15, "kind": "property", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extending [...]
+    "extendMessageVisibility": { "index": 15, "kind": "property", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extending [...]
     "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "property", 
"displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", 
"label": "consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The length of time, in 
seconds, for which Amazon SQS can reuse a [...]
     "kmsMasterKeyId": { "index": 17, "kind": "property", "displayName": "Kms 
Master Key Id", "group": "consumer", "label": "consumer", "required": false, 
"type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The ID of an AWS-managed customer master key 
(CMK) for Amazon SQS or a custom CMK." },
     "messageAttributeNames": { "index": 18, "kind": "property", "displayName": 
"Message Attribute Names", "group": "consumer", "label": "consumer", 
"required": false, "type": "string", "javaType": "java.lang.String", 
"deprecated": false, "autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "A list of message attribute names to receive 
when consuming. Multiple names can be  [...]
     "serverSideEncryptionEnabled": { "index": 19, "kind": "property", 
"displayName": "Server Side Encryption Enabled", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Define if Server Side Encryption is enabled or 
not on t [...]
     "sortAttributeName": { "index": 20, "kind": "property", "displayName": 
"Sort Attribute Name", "group": "consumer", "label": "consumer", "required": 
false, "type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The name of the message attribute used for 
sorting the messages. When specified, the messag [...]
-    "visibilityTimeout": { "index": 21, "kind": "property", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve r [...]
+    "visibilityTimeout": { "index": 21, "kind": "property", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve r [...]
     "waitTimeSeconds": { "index": 22, "kind": "property", "displayName": "Wait 
Time Seconds", "group": "consumer", "label": "consumer", "required": false, 
"type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Duration in seconds (0 to 20) that the 
ReceiveMessage action call will wait until a message i [...]
     "batchSeparator": { "index": 23, "kind": "property", "displayName": "Batch 
Separator", "group": "producer", "label": "producer", "required": false, 
"type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": ",", "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Set the separator when passing a String to 
send batch message operation" },
     "delaySeconds": { "index": 24, "kind": "property", "displayName": "Delay 
Seconds", "group": "producer", "label": "producer", "required": false, "type": 
"integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": 
false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Delay sending messages for a number of 
seconds." },
@@ -115,7 +115,7 @@
     "defaultVisibilityTimeout": { "index": 12, "kind": "parameter", 
"displayName": "Default Visibility Timeout", "group": "consumer", "label": 
"consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The visibility timeout 
(in seconds) of the queue. When the endpoint starts [...]
     "deleteAfterRead": { "index": 13, "kind": "parameter", "displayName": 
"Delete After Read", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Delete the message from 
SQS when the exchange completes successfully" },
     "deleteIfFiltered": { "index": 14, "kind": "parameter", "displayName": 
"Delete If Filtered", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Whether to send the 
DeleteMessage to the SQS queue if the exchange has propert [...]
-    "extendMessageVisibility": { "index": 15, "kind": "parameter", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extendin [...]
+    "extendMessageVisibility": { "index": 15, "kind": "parameter", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extendin [...]
     "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "parameter", 
"displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", 
"label": "consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The length of time, in 
seconds, for which Amazon SQS can reuse  [...]
     "kmsMasterKeyId": { "index": 17, "kind": "parameter", "displayName": "Kms 
Master Key Id", "group": "consumer", "label": "consumer", "required": false, 
"type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The ID of an AWS-managed customer master key 
(CMK) for Amazon SQS or a custom CMK." },
     "maxMessagesPerPoll": { "index": 18, "kind": "parameter", "displayName": 
"Max Messages Per Poll", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "int", "deprecated": false, "autowired": 
false, "secret": false, "defaultValue": 10, "description": "The maximum number 
of messages to receive in each poll. A receive request returns at most 10 
messages, so a value above 10 is split into several receive requests of at most 
10 messages each, and 0  [...]
@@ -123,7 +123,7 @@
     "sendEmptyMessageWhenIdle": { "index": 20, "kind": "parameter", 
"displayName": "Send Empty Message When Idle", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "description": "If the polling consumer did not poll any files, you can 
enable this option to send an empty message (no body) instead." },
     "serverSideEncryptionEnabled": { "index": 21, "kind": "parameter", 
"displayName": "Server Side Encryption Enabled", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Define if Server Side Encryption is enabled or 
not on  [...]
     "sortAttributeName": { "index": 22, "kind": "parameter", "displayName": 
"Sort Attribute Name", "group": "consumer", "label": "consumer", "required": 
false, "type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The name of the message attribute used for 
sorting the messages. When specified, the messa [...]
-    "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve  [...]
+    "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve  [...]
     "waitTimeSeconds": { "index": 24, "kind": "parameter", "displayName": 
"Wait Time Seconds", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Duration in seconds (0 to 20) that the 
ReceiveMessage action call will wait until a message  [...]
     "bridgeErrorHandler": { "index": 25, "kind": "parameter", "displayName": 
"Bridge Error Handler", "group": "consumer (advanced)", "label": 
"consumer,advanced", "required": false, "type": "boolean", "javaType": 
"boolean", "deprecated": false, "autowired": false, "secret": false, 
"defaultValue": false, "description": "Allows for bridging the consumer to the 
Camel routing Error Handler, which mean any exceptions (if possible) occurred 
while the Camel consumer is trying to pickup incoming [...]
     "exceptionHandler": { "index": 26, "kind": "parameter", "displayName": 
"Exception Handler", "group": "consumer (advanced)", "label": 
"consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.spi.ExceptionHandler", "optionalPrefix": "consumer.", 
"deprecated": false, "autowired": false, "secret": false, "description": "To 
let the consumer use a custom ExceptionHandler. Notice if the option 
bridgeErrorHandler is enabled then this option is not in use. By de [...]
diff --git 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc
 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc
index cd3fc132b2e0..bebae6dcb613 100644
--- 
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc
+++ 
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/aws2-sqs-component.adoc
@@ -72,6 +72,12 @@ the route is slow, the last messages of a poll can become 
visible again before t
 them a second time. Enable `extendMessageVisibility` together with 
`visibilityTimeout`, which keeps every message of
 the poll invisible until it is processed, or use a visibility timeout that 
covers the processing of a whole poll.
 
+With `extendMessageVisibility`, the visibility of a message is extended when 
80% of its visibility timeout has passed,
+by a task that runs every half of the visibility timeout, in whole seconds. A 
`visibilityTimeout` below 2 seconds is
+rejected when the endpoint is created, as the extension would always come too 
late, and a value below 10 seconds is
+logged as a warning when the consumer starts, as it leaves only 1 to 2 seconds 
for the extension. Use a
+`visibilityTimeout` of 10 seconds or more.
+
 With a FIFO queue, a poll can receive several messages of the same message 
group. A message that fails is not deleted,
 but the next messages of its group in the same poll are still routed and 
deleted, so the failed message is delivered
 again after them. Set `maxMessagesPerPoll=1` if the messages of a group must 
keep their order when one of them fails.
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json
 
b/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json
index d104a1f161fc..ca9e9d118b8b 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json
+++ 
b/components/camel-aws/camel-aws2-sqs/src/generated/resources/META-INF/org/apache/camel/component/aws2/sqs/aws2-sqs.json
@@ -39,13 +39,13 @@
     "defaultVisibilityTimeout": { "index": 12, "kind": "property", 
"displayName": "Default Visibility Timeout", "group": "consumer", "label": 
"consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The visibility timeout 
(in seconds) of the queue. When the endpoint starts, [...]
     "deleteAfterRead": { "index": 13, "kind": "property", "displayName": 
"Delete After Read", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Delete the message from 
SQS when the exchange completes successfully" },
     "deleteIfFiltered": { "index": 14, "kind": "property", "displayName": 
"Delete If Filtered", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Whether to send the 
DeleteMessage to the SQS queue if the exchange has property [...]
-    "extendMessageVisibility": { "index": 15, "kind": "property", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extending [...]
+    "extendMessageVisibility": { "index": 15, "kind": "property", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extending [...]
     "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "property", 
"displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", 
"label": "consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The length of time, in 
seconds, for which Amazon SQS can reuse a [...]
     "kmsMasterKeyId": { "index": 17, "kind": "property", "displayName": "Kms 
Master Key Id", "group": "consumer", "label": "consumer", "required": false, 
"type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The ID of an AWS-managed customer master key 
(CMK) for Amazon SQS or a custom CMK." },
     "messageAttributeNames": { "index": 18, "kind": "property", "displayName": 
"Message Attribute Names", "group": "consumer", "label": "consumer", 
"required": false, "type": "string", "javaType": "java.lang.String", 
"deprecated": false, "autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "A list of message attribute names to receive 
when consuming. Multiple names can be  [...]
     "serverSideEncryptionEnabled": { "index": 19, "kind": "property", 
"displayName": "Server Side Encryption Enabled", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Define if Server Side Encryption is enabled or 
not on t [...]
     "sortAttributeName": { "index": 20, "kind": "property", "displayName": 
"Sort Attribute Name", "group": "consumer", "label": "consumer", "required": 
false, "type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The name of the message attribute used for 
sorting the messages. When specified, the messag [...]
-    "visibilityTimeout": { "index": 21, "kind": "property", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve r [...]
+    "visibilityTimeout": { "index": 21, "kind": "property", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve r [...]
     "waitTimeSeconds": { "index": 22, "kind": "property", "displayName": "Wait 
Time Seconds", "group": "consumer", "label": "consumer", "required": false, 
"type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Duration in seconds (0 to 20) that the 
ReceiveMessage action call will wait until a message i [...]
     "batchSeparator": { "index": 23, "kind": "property", "displayName": "Batch 
Separator", "group": "producer", "label": "producer", "required": false, 
"type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": ",", "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Set the separator when passing a String to 
send batch message operation" },
     "delaySeconds": { "index": 24, "kind": "property", "displayName": "Delay 
Seconds", "group": "producer", "label": "producer", "required": false, "type": 
"integer", "javaType": "java.lang.Integer", "deprecated": false, "autowired": 
false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Delay sending messages for a number of 
seconds." },
@@ -115,7 +115,7 @@
     "defaultVisibilityTimeout": { "index": 12, "kind": "parameter", 
"displayName": "Default Visibility Timeout", "group": "consumer", "label": 
"consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The visibility timeout 
(in seconds) of the queue. When the endpoint starts [...]
     "deleteAfterRead": { "index": 13, "kind": "parameter", "displayName": 
"Delete After Read", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Delete the message from 
SQS when the exchange completes successfully" },
     "deleteIfFiltered": { "index": 14, "kind": "parameter", "displayName": 
"Delete If Filtered", "group": "consumer", "label": "consumer", "required": 
false, "type": "boolean", "javaType": "boolean", "deprecated": false, 
"autowired": false, "secret": false, "defaultValue": true, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "Whether to send the 
DeleteMessage to the SQS queue if the exchange has propert [...]
-    "extendMessageVisibility": { "index": 15, "kind": "parameter", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extendin [...]
+    "extendMessageVisibility": { "index": 15, "kind": "parameter", 
"displayName": "Extend Message Visibility", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "If enabled, then a scheduled background task 
will keep extendin [...]
     "kmsDataKeyReusePeriodSeconds": { "index": 16, "kind": "parameter", 
"displayName": "Kms Data Key Reuse Period Seconds", "group": "consumer", 
"label": "consumer", "required": false, "type": "integer", "javaType": 
"java.lang.Integer", "deprecated": false, "autowired": false, "secret": false, 
"configurationClass": "org.apache.camel.component.aws2.sqs.Sqs2Configuration", 
"configurationField": "configuration", "description": "The length of time, in 
seconds, for which Amazon SQS can reuse  [...]
     "kmsMasterKeyId": { "index": 17, "kind": "parameter", "displayName": "Kms 
Master Key Id", "group": "consumer", "label": "consumer", "required": false, 
"type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The ID of an AWS-managed customer master key 
(CMK) for Amazon SQS or a custom CMK." },
     "maxMessagesPerPoll": { "index": 18, "kind": "parameter", "displayName": 
"Max Messages Per Poll", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "int", "deprecated": false, "autowired": 
false, "secret": false, "defaultValue": 10, "description": "The maximum number 
of messages to receive in each poll. A receive request returns at most 10 
messages, so a value above 10 is split into several receive requests of at most 
10 messages each, and 0  [...]
@@ -123,7 +123,7 @@
     "sendEmptyMessageWhenIdle": { "index": 20, "kind": "parameter", 
"displayName": "Send Empty Message When Idle", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "description": "If the polling consumer did not poll any files, you can 
enable this option to send an empty message (no body) instead." },
     "serverSideEncryptionEnabled": { "index": 21, "kind": "parameter", 
"displayName": "Server Side Encryption Enabled", "group": "consumer", "label": 
"consumer", "required": false, "type": "boolean", "javaType": "boolean", 
"deprecated": false, "autowired": false, "secret": false, "defaultValue": 
false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Define if Server Side Encryption is enabled or 
not on  [...]
     "sortAttributeName": { "index": 22, "kind": "parameter", "displayName": 
"Sort Attribute Name", "group": "consumer", "label": "consumer", "required": 
false, "type": "string", "javaType": "java.lang.String", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The name of the message attribute used for 
sorting the messages. When specified, the messa [...]
-    "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve  [...]
+    "visibilityTimeout": { "index": 23, "kind": "parameter", "displayName": 
"Visibility Timeout", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "The duration (in seconds) that the received 
messages are hidden from subsequent retrieve  [...]
     "waitTimeSeconds": { "index": 24, "kind": "parameter", "displayName": 
"Wait Time Seconds", "group": "consumer", "label": "consumer", "required": 
false, "type": "integer", "javaType": "java.lang.Integer", "deprecated": false, 
"autowired": false, "secret": false, "configurationClass": 
"org.apache.camel.component.aws2.sqs.Sqs2Configuration", "configurationField": 
"configuration", "description": "Duration in seconds (0 to 20) that the 
ReceiveMessage action call will wait until a message  [...]
     "bridgeErrorHandler": { "index": 25, "kind": "parameter", "displayName": 
"Bridge Error Handler", "group": "consumer (advanced)", "label": 
"consumer,advanced", "required": false, "type": "boolean", "javaType": 
"boolean", "deprecated": false, "autowired": false, "secret": false, 
"defaultValue": false, "description": "Allows for bridging the consumer to the 
Camel routing Error Handler, which mean any exceptions (if possible) occurred 
while the Camel consumer is trying to pickup incoming [...]
     "exceptionHandler": { "index": 26, "kind": "parameter", "displayName": 
"Exception Handler", "group": "consumer (advanced)", "label": 
"consumer,advanced", "required": false, "type": "object", "javaType": 
"org.apache.camel.spi.ExceptionHandler", "optionalPrefix": "consumer.", 
"deprecated": false, "autowired": false, "secret": false, "description": "To 
let the consumer use a custom ExceptionHandler. Notice if the option 
bridgeErrorHandler is enabled then this option is not in use. By de [...]
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc 
b/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc
index cd3fc132b2e0..bebae6dcb613 100644
--- a/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc
+++ b/components/camel-aws/camel-aws2-sqs/src/main/docs/aws2-sqs-component.adoc
@@ -72,6 +72,12 @@ the route is slow, the last messages of a poll can become 
visible again before t
 them a second time. Enable `extendMessageVisibility` together with 
`visibilityTimeout`, which keeps every message of
 the poll invisible until it is processed, or use a visibility timeout that 
covers the processing of a whole poll.
 
+With `extendMessageVisibility`, the visibility of a message is extended when 
80% of its visibility timeout has passed,
+by a task that runs every half of the visibility timeout, in whole seconds. A 
`visibilityTimeout` below 2 seconds is
+rejected when the endpoint is created, as the extension would always come too 
late, and a value below 10 seconds is
+logged as a warning when the consumer starts, as it leaves only 1 to 2 seconds 
for the extension. Use a
+`visibilityTimeout` of 10 seconds or more.
+
 With a FIFO queue, a poll can receive several messages of the same message 
group. A message that fails is not deleted,
 but the next messages of its group in the same poll are still routed and 
deleted, so the failed message is delivered
 again after them. Set `maxMessagesPerPoll=1` if the messages of a group must 
keep their order when one of them fails.
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java
 
b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java
index d4bb634052a4..123b8444386e 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java
+++ 
b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Component.java
@@ -79,6 +79,12 @@ public class Sqs2Component extends HealthCheckComponent {
             throw new IllegalArgumentException(
                     "Extending message visibility (extendMessageVisibility) 
requires visibilityTimeout to be set on the Endpoint.");
         }
+        // the extender runs every visibilityTimeout / 2 whole seconds, so 
with less than 2 seconds it is always late
+        if (configuration.isExtendMessageVisibility() && 
configuration.getVisibilityTimeout() < 2) {
+            throw new IllegalArgumentException(
+                    "Extending message visibility (extendMessageVisibility) 
requires visibilityTimeout to be at least 2 seconds, was: "
+                                               + 
configuration.getVisibilityTimeout());
+        }
         return sqsEndpoint;
     }
 
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java
 
b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java
index 5eb209771067..83f8442a3587 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java
+++ 
b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Configuration.java
@@ -230,7 +230,8 @@ public class Sqs2Configuration implements Cloneable, 
AwsCommonConfiguration {
      * The duration (in seconds) that the received messages are hidden from 
subsequent retrieve requests after being
      * retrieved by a ReceiveMessage request. It is sent with each 
ReceiveMessage request and does not change the queue:
      * use defaultVisibilityTimeout to set the visibility timeout attribute of 
the queue. extendMessageVisibility
-     * extends the visibility of a message by this duration.
+     * extends the visibility of a message by this duration, and requires at 
least 2 seconds; 10 seconds or more is
+     * recommended.
      */
     public void setVisibilityTimeout(Integer visibilityTimeout) {
         this.visibilityTimeout = visibilityTimeout;
@@ -343,8 +344,9 @@ public class Sqs2Configuration implements Cloneable, 
AwsCommonConfiguration {
 
     /**
      * If enabled, then a scheduled background task will keep extending the 
message visibility on SQS. This is needed if
-     * it takes a long time to process the message. If set to true 
visibilityTimeout must be set. See details at Amazon
-     * docs.
+     * it takes a long time to process the message. If set to true 
visibilityTimeout must be set to at least 2 seconds;
+     * 10 seconds or more is recommended, as the visibility is extended when 
80% of the visibility timeout has passed,
+     * which leaves only 1 to 2 seconds with a shorter timeout. See details at 
Amazon docs.
      */
     public void setExtendMessageVisibility(boolean extendMessageVisibility) {
         this.extendMessageVisibility = extendMessageVisibility;
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java
 
b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java
index fdde6c3a05a8..4a5fbfdb3381 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java
+++ 
b/components/camel-aws/camel-aws2-sqs/src/main/java/org/apache/camel/component/aws2/sqs/Sqs2Consumer.java
@@ -405,6 +405,13 @@ public class Sqs2Consumer extends 
ScheduledBatchPollingConsumer {
             Integer visibilityTimeout = 
getConfiguration().getVisibilityTimeout();
 
             if (ObjectHelper.isNotEmpty(visibilityTimeout) && 
visibilityTimeout > 0) {
+                if (visibilityTimeout < 10) {
+                    LOG.warn(
+                            "The visibilityTimeout of {} seconds leaves the 
extendMessageVisibility task only 1 to 2 seconds"
+                             + " to extend the visibility of a message before 
it becomes visible again."
+                             + " A visibilityTimeout of 10 seconds or more is 
recommended.",
+                            visibilityTimeout);
+                }
                 int delay = Math.max(1, visibilityTimeout / 2);
                 this.timeoutExtender = new TimeoutExtender(visibilityTimeout, 
delay);
 
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java
 
b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java
index a68426ee7d48..f083e742ba30 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java
+++ 
b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/SqsComponentConfigurationTest.java
@@ -19,6 +19,8 @@ package org.apache.camel.component.aws2.sqs;
 import org.apache.camel.Endpoint;
 import org.apache.camel.test.junit6.CamelTestSupport;
 import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.ValueSource;
 import software.amazon.awssdk.core.Protocol;
 import software.amazon.awssdk.regions.Region;
 
@@ -249,6 +251,30 @@ public class SqsComponentConfigurationTest extends 
CamelTestSupport {
         });
     }
 
+    // The visibility timeout extender runs every visibilityTimeout / 2 whole 
seconds, so with less than 2 seconds it
+    // always comes too late (CAMEL-25737)
+    @ParameterizedTest
+    @ValueSource(ints = { -1, 0, 1 })
+    public void 
createEndpointWithExtendMessageVisibilityAndShortVisibilityTimeoutThrowsException(int
 visibilityTimeout) {
+        Sqs2Component component = context.getComponent("aws2-sqs", 
Sqs2Component.class);
+        IllegalArgumentException e = 
assertThrows(IllegalArgumentException.class, () -> {
+            
component.createEndpoint("aws2-sqs://MyQueue?accessKey=xxx&secretKey=yyy&extendMessageVisibility=true"
+                                     + "&visibilityTimeout=" + 
visibilityTimeout);
+        });
+        assertTrue(e.getMessage().contains("at least 2 seconds"), 
e.getMessage());
+    }
+
+    @Test
+    public void 
createEndpointWithExtendMessageVisibilityAndTwoSecondsVisibilityTimeout() 
throws Exception {
+        AmazonSQSClientMock mock = new AmazonSQSClientMock();
+
+        context.getRegistry().bind("amazonSQSClient", mock);
+        Sqs2Component component = context.getComponent("aws2-sqs", 
Sqs2Component.class);
+        assertNotNull(component
+                .createEndpoint(
+                        
"aws2-sqs://MyQueue?amazonSQSClient=#amazonSQSClient&accessKey=xxx&secretKey=yyy&visibilityTimeout=2&extendMessageVisibility=true"));
+    }
+
     @Test
     public void 
createEndpointWithExtendMessageVisibilityTrueAndVisibilityTimeoutSet() throws 
Exception {
         AmazonSQSClientMock mock = new AmazonSQSClientMock();
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java
 
b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java
index 3919ab3b0b1f..cd899458ca3d 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java
+++ 
b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsVisibilityDstTest.java
@@ -25,7 +25,7 @@ import org.apache.camel.test.dst.DstTest;
  * short polling and faults of the SQS calls: a message the consumer holds 
must not be delivered again. Regression test
  * for CAMEL-25700 (apache/camel#27985): before that fix 1397 of 5000 seeds 
fail. The world was written by Claus Ibsen
  * for CAMEL-25738. A failing seed is replayed with {@code -Ddst.seed=<seed>}; 
{@code -Ddst.seeds=5000} runs more seeds;
- * {@code -Ddst.sqs.visibilityTimeouts=1} shows CAMEL-25737.
+ * {@code -Ddst.sqs.visibilityTimeouts=2,3} runs only the short visibility 
timeouts.
  */
 @DstInstrument("org.apache.camel.component.aws2.sqs")
 class SqsVisibilityDstTest {
diff --git 
a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java
 
b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java
index c5f9f17e7015..dbf66053b91c 100644
--- 
a/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java
+++ 
b/components/camel-aws/camel-aws2-sqs/src/test/java/org/apache/camel/component/aws2/sqs/dst/SqsWorld.java
@@ -102,8 +102,7 @@ final class SqsWorld {
         this.redelivery = redelivery;
         this.ledger = new DstLedger(dst);
         this.sqs = new FakeSqs(dst, ledger, this::received, 
extensionFaulted::addAll);
-        // 1 s is left out by default: the extender is always late with 1 s 
(CAMEL-25737, open);
-        // -Ddst.sqs.visibilityTimeouts=1,2,3,5,10 puts it back
+        // 1 s is rejected when the endpoint is created: the extender would 
always be late (CAMEL-25737)
         this.visibilityTimeout = 
dst.pick(Arrays.stream(System.getProperty("dst.sqs.visibilityTimeouts", 
"2,3,5,10")
                 .split(",")).map(String::trim).map(Integer::valueOf).toList());
         this.maxMessagesPerPoll = dst.pick(List.of(1, 2, 5, 10));
diff --git 
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc 
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
index 5ead09afc66d..f9d72e86a9c9 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc
@@ -11069,3 +11069,15 @@ unset, and the producer uses its `indexName` option.
 
 A route that relied on the `embeddings` index must set the 
`CamelPineconeIndexName` header to `embeddings`,
 or configure `indexName=embeddings` on the endpoint.
+
+=== camel-aws2-sqs - extendMessageVisibility requires a visibilityTimeout of 
at least 2 seconds
+
+An `aws2-sqs` endpoint with `extendMessageVisibility=true` now fails to be 
created when `visibilityTimeout` is below 2
+seconds. The task that extends the visibility runs every half of the 
visibility timeout, in whole seconds, and extends a
+message once 80% of its visibility timeout has passed. With a 
`visibilityTimeout` of 1 second, each extension came when
+the message was already visible again, so another consumer received it while 
the first one still processed it. With 0
+or a negative value, `extendMessageVisibility` was silently ignored.
+
+The consumer also logs a warning at startup when `visibilityTimeout` is below 
10 seconds, as the extension then has only 1
+to 2 seconds before the message becomes visible again. Use a 
`visibilityTimeout` of 10 seconds or more with
+`extendMessageVisibility`.
diff --git 
a/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java
 
b/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java
index 6e532cffb7ba..2b27d723ab99 100644
--- 
a/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java
+++ 
b/dsl/camel-componentdsl/src/generated/java/org/apache/camel/builder/component/dsl/Aws2SqsComponentBuilderFactory.java
@@ -323,8 +323,11 @@ public interface Aws2SqsComponentBuilderFactory {
         /**
          * If enabled, then a scheduled background task will keep extending the
          * message visibility on SQS. This is needed if it takes a long time to
-         * process the message. If set to true visibilityTimeout must be set.
-         * See details at Amazon docs.
+         * process the message. If set to true visibilityTimeout must be set to
+         * at least 2 seconds; 10 seconds or more is recommended, as the
+         * visibility is extended when 80% of the visibility timeout has 
passed,
+         * which leaves only 1 to 2 seconds with a shorter timeout. See details
+         * at Amazon docs.
          * 
          * The option is a: &lt;code&gt;boolean&lt;/code&gt; type.
          * 
@@ -433,7 +436,8 @@ public interface Aws2SqsComponentBuilderFactory {
          * and does not change the queue: use defaultVisibilityTimeout to set
          * the visibility timeout attribute of the queue.
          * extendMessageVisibility extends the visibility of a message by this
-         * duration.
+         * duration, and requires at least 2 seconds; 10 seconds or more is
+         * recommended.
          * 
          * The option is a: &lt;code&gt;java.lang.Integer&lt;/code&gt; type.
          * 
diff --git 
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java
 
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java
index 8ab6d23f2dc0..89f94652719c 100644
--- 
a/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java
+++ 
b/dsl/camel-endpointdsl/src/generated/java/org/apache/camel/builder/endpoint/dsl/Sqs2EndpointBuilderFactory.java
@@ -393,8 +393,11 @@ public interface Sqs2EndpointBuilderFactory {
         /**
          * If enabled, then a scheduled background task will keep extending the
          * message visibility on SQS. This is needed if it takes a long time to
-         * process the message. If set to true visibilityTimeout must be set.
-         * See details at Amazon docs.
+         * process the message. If set to true visibilityTimeout must be set to
+         * at least 2 seconds; 10 seconds or more is recommended, as the
+         * visibility is extended when 80% of the visibility timeout has 
passed,
+         * which leaves only 1 to 2 seconds with a shorter timeout. See details
+         * at Amazon docs.
          * 
          * The option is a: <code>boolean</code> type.
          * 
@@ -411,8 +414,11 @@ public interface Sqs2EndpointBuilderFactory {
         /**
          * If enabled, then a scheduled background task will keep extending the
          * message visibility on SQS. This is needed if it takes a long time to
-         * process the message. If set to true visibilityTimeout must be set.
-         * See details at Amazon docs.
+         * process the message. If set to true visibilityTimeout must be set to
+         * at least 2 seconds; 10 seconds or more is recommended, as the
+         * visibility is extended when 80% of the visibility timeout has 
passed,
+         * which leaves only 1 to 2 seconds with a shorter timeout. See details
+         * at Amazon docs.
          * 
          * The option will be converted to a <code>boolean</code> type.
          * 
@@ -623,7 +629,8 @@ public interface Sqs2EndpointBuilderFactory {
          * and does not change the queue: use defaultVisibilityTimeout to set
          * the visibility timeout attribute of the queue.
          * extendMessageVisibility extends the visibility of a message by this
-         * duration.
+         * duration, and requires at least 2 seconds; 10 seconds or more is
+         * recommended.
          * 
          * The option is a: <code>java.lang.Integer</code> type.
          * 
@@ -643,7 +650,8 @@ public interface Sqs2EndpointBuilderFactory {
          * and does not change the queue: use defaultVisibilityTimeout to set
          * the visibility timeout attribute of the queue.
          * extendMessageVisibility extends the visibility of a message by this
-         * duration.
+         * duration, and requires at least 2 seconds; 10 seconds or more is
+         * recommended.
          * 
          * The option will be converted to a <code>java.lang.Integer</code>
          * type.

Reply via email to