7.3. 组件选项
AWS Simple Queue Service(SQS)组件支持 43 选项,如下所示。
Name | 描述 | 默认 | 类型 |
---|---|---|---|
amazonAWSHost (common) | Amazon AWS 云的主机名。 | amazonaws.com | 字符串 |
amazonSQSClient (common) | Autowired 以使用 AmazonSQS 作为客户端。 | SqsClient | |
autoCreateQueue (common) | 设置队列的自动创建. | false | 布尔值 |
configuration (common) | AWS SQS 默认配置。 | Sqs2Configuration | |
overrideEndpoint (common) | 设置覆盖端点的需求。这个选项必须与 uriEndpointOverride 选项结合使用。 | false | 布尔值 |
protocol (common) | 用于与 SQS 通信的底层协议。 | https | 字符串 |
proxyProtocol (common) | 在实例化 SQS 客户端时定义代理协议。 枚举值:
| HTTPS | 协议 |
queueOwnerAWSAccountId (common) | 当您需要使用不同的帐户拥有者时,请指定队列拥有者 aws 帐户 id。 | 字符串 | |
region (common) | SQS 客户端需要工作的区域。使用此参数时,配置将预期区域的小写名称(例如 ap-east-1),您需要使用名称 Region.EU_WEST_1.id()。 | 字符串 | |
trustAllCertificates (common) | 如果要在覆盖端点时信任所有证书。 | false | 布尔值 |
uriEndpointOverride (common) | 设置覆盖 uri 端点。这个选项必须与 overrideEndpoint 选项一同使用。 | 字符串 | |
useDefaultCredentialsProvider (common) | 设置 SQS 客户端是否应该加载 AWS infra 实例上的凭证,或者希望传递静态凭证。 | false | 布尔值 |
attributeNames (consumer) | 要在消耗时接收的属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由 Error Handler,这意味着在消费者尝试获取传入的消息时发生任何异常,或像这样一样处理,消息现在将被作为消息进行处理,并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 处理异常,该处理程序将记录在 WARN 或 ERROR 级别并忽略。 | false | 布尔值 |
concurrentConsumers (consumer) | 允许您使用多个线程来轮询 sqs 队列以提高吞吐量。 | 1 | int |
defaultVisibilityTimeout (consumer) | 默认可见超时(以秒为单位)。 | 整数 | |
deleteAfterRead (consumer) | 阅读后,从 SQS 删除消息。 | true | 布尔值 |
deleteIfFiltered (consumer) | 如果交换具有键 Sqs2Constants#SQS_DELETE_FILTERED(CamelAwsSqsDeleteFiltered)的 属性,则是否将 DeleteMessage 发送到 SQS 队列。 | true | 布尔值 |
extendMessageVisibility (consumer) | 如果启用,则调度的后台任务将保留扩展 SQS 上消息可见性。如果处理消息需要很长时间,则需要这个操作。如果设为 true defaultVisibilityTimeout,则必须设置。 | false | 布尔值 |
kmsDataKeyReusePeriodSeconds (consumer) | Amazon SQS 可以重复使用数据密钥来加密或解密消息的时间长度(以秒为单位)。代表秒的整数,在 60 秒(1 分钟)和 86,400 秒(24 小时)之间。默认:300(5 分钟)。 | 整数 | |
kmsMasterKeyId (consumer) | Amazon SQS 或自定义 CMK 的 AWS 管理客户主密钥(CMK)的 ID。 | 字符串 | |
messageAttributeNames (consumer) | 要在消耗时接收的消息属性名称列表。可以使用逗号分隔多个名称。 | 字符串 | |
serverSideEncryptionEnabled (consumer) | 定义是否在队列中启用或不启用服务器加密。 | false | 布尔值 |
visibilityTimeout (consumer) | 在由 ReceiveMessage 请求在 com.amazonaws.services.sqs.model.SetQueueAttributesRequest 中检索后,接收的消息从后续检索请求中隐藏的时间(以秒为单位)。这只在它与 defaultVisibilityTimeout 不同时才有意义。它永久更改队列可见性超时属性。 | 整数 | |
waitTimeSeconds (consumer) | ReceiveMessage action 调用将等待持续持续一个消息以包含在响应中的持续时间(以秒为单位)(0 到 20)。 | 整数 | |
batchSeparator (producer) | 在传递字符串时设置分隔符,以发送批处理消息操作。 | , | 字符串 |
delaySeconds (producer) | 延迟发送消息的秒数。 | 整数 | |
lazyStartProducer (producer) | 制作者是否应该启动 lazy(在第一个消息上)。通过启动 lazy,您可以使用它来允许 CamelContext 和路由在启动期间启动,否则在启动期间出现问题,并导致路由启动失败。通过将这个启动延迟到 lazy 后,可以在通过 Camel 的路由错误处理程序路由消息期间处理启动失败。注意在处理第一个消息时,创建并启动制作者可能花费较少的时间,从而延长处理的总处理时间。 | false | 布尔值 |
messageDeduplicationIdStrategy (producer) | 仅限 FIFO 队列。在消息上设置 messageDeduplicationId 的策略。可以是以下选项之一: useExchangeId,使用ContentBasedDeduplication。对于 useContentBasedDeduplication 选项,消息中不会设置 messageDeduplicationId。 枚举值:
| useExchangeId | 字符串 |
messageGroupIdStrategy (producer) | 仅限 FIFO 队列。在消息上设置 messageGroupId 的策略。可以是以下选项之一: useConstant、useExchangeId、使用PropertyValue。对于 usePropertyValue 选项,将使用属性 CamelAwsMessageGroupId。 枚举值:
| 字符串 | |
operation (producer) | 当用户不想仅发送消息时,要执行的操作。 枚举值:
| Sqs2Operations | |
autowiredEnabled (advanced) | 是否启用自动。这用于自动自动自动选项(选项必须标记为 autowired),方法是在 registry 中查找是否有匹配的类型实例,然后在组件上进行配置。这可用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。 | true | 布尔值 |
delayQueue (advanced) | 定义要将 delaySeconds 选项应用到队列或单一消息。 | false | 布尔值 |
queueUrl (advanced) | 明确定义 queueUrl。所有其他参数(将影响 queueUrl)将被忽略。为了测试目的,可使用此参数连接到 SQS 的模拟实施。 | 字符串 | |
proxyHost (proxy) | 在实例化 SQS 客户端时定义代理主机。 | 字符串 | |
proxyPort (proxy) | 在实例化 SQS 客户端时定义代理端口。 | 整数 | |
maximumMessageSize (queue) | SQS 消息可包含此队列的 maximumMessageSize(以字节为单位)。 | 整数 | |
messageRetentionPeriod (queue) | messageRetentionPeriod(以秒为单位)由 SQS 保留此队列的消息。 | 整数 | |
policy (queue) | 此队列的策略。它默认可从 classpath 加载,但您可以使用 classpath:、file: 或 http: 作为前缀来从不同的系统加载资源。 | 字符串 | |
receiveMessageWaitTimeSeconds (queue) | 如果您没有在请求中指定 WaitTimeSeconds,则队列属性 ReceiveMessageWaitTimeSeconds 用于确定要等待的时长。 | 整数 | |
redrivePolicy (queue) | 指定向 DeadLetter 队列发送消息的策略。请参阅 Amazon 文档。 | 字符串 | |
accesskey (安全性) | Amazon AWS 访问密钥. | 字符串 | |
secretKey (security) | Amazon AWS Secret 密钥。 | 字符串 |