5.4.2. 查询参数（68 参数）

amazonS3Client (common)

自动线 对 registry 中的 com.amazonaws.services.s3.AmazonS3 的引用。

S3Client

amazonS3Presigner (common)

Autowired An S3 Presigner for Request，它们主要用于 createDownloadLink 操作。

S3Presigner

autoCreateBucket (common)

设置 S3 存储桶 bucketName 的自动记录。如果启用了 moveAfterRead 选项，它将创建 destinationBucket（如果尚未存在）。

false

布尔值

overrideEndpoint (common)

设置覆盖端点的需求。这个选项必须与 uriEndpointOverride 选项结合使用。

false

布尔值

pojoRequest (common)

如果我们想要将 POJO 请求用作正文或非其要求。

false

布尔值

policy (common)

此队列的策略在 com.amazonaws.services.s3.AmazonS3#setBucketPolicy（）方法中设置。

字符串

proxyHost (common)

在实例化 SQS 客户端时定义代理主机。

字符串

proxyPort (common)

指定要在客户端定义中使用的代理端口。

整数

proxyProtocol (common)

在实例化 S3 客户端时定义代理协议。

枚举值：

HTTPS

协议

region (common)

S3 客户端需要在其中工作的区域。使用此参数时，配置将预期区域的小写名称（例如 ap-east-1），您需要使用名称 Region.EU_WEST_1.id（）。

字符串

trustAllCertificates (common)

如果要在覆盖端点时信任所有证书。

false

布尔值

uriEndpointOverride (common)

设置覆盖 uri 端点。这个选项必须与 overrideEndpoint 选项一同使用。

字符串

useDefaultCredentialsProvider (common)

设置 S3 客户端是否应该通过默认凭证供应商加载凭证，或者希望传递静态凭证。

false

布尔值

customerAlgorithm (common (advanced))

定义启用了 CustomerKey 时要使用的客户算法。

字符串

customerKeyId (common (advanced))

在启用了 CustomerKey 时定义要使用的客户密钥 ID。

字符串

customerKeyMD5 (common (advanced))

在启用了 customerKey 时定义要使用的客户密钥 MD5。

字符串

bridgeErrorHandler (consumer)

允许将消费者桥接到 Camel 路由 Error Handler，这意味着在消费者尝试获取传入的消息时发生任何异常，或像这样一样处理，消息现在将被作为消息进行处理，并由路由 Error Handler 处理。默认情况下，使用者将使用 org.apache.camel.spi.ExceptionHandler 处理异常，该处理程序将记录在 WARN 或 ERROR 级别并忽略。

false

布尔值

deleteAfterRead (consumer)

在检索了对象后，从 S3 中删除对象。只有提交 Exchange 时才会执行删除。如果进行回滚，则对象不会被删除。如果此选项为 false，则同一对象将会反复检索，并再次在轮询上再次进行。因此，您需要在路由中使用 Idempotent Consumer EIP 来过滤重复的。您可以使用 AWS2S3Constants#BUCKET_NAME 和 AWS2S3Constants#KEY 标头进行过滤，或者只有 AWS2S3Constants#KEY 标头进行过滤。

true

布尔值

delimiter (consumer)

在 com.amazonaws.services.s3.model.ListObjectsRequest 中使用的分隔符，仅使用我们感兴趣的对象。

字符串

destinationBucket (consumer)

定义在 moveAfterRead 设为 true 时对象必须移动的目标存储桶。

字符串

destinationBucketPrefix (consumer)

在对象必须移动并将 moveAfterRead 设置为 true 时，定义要使用的目的地存储桶前缀。

字符串

destinationBucketSuffix (consumer)

定义在对象必须移动并将 moveAfterRead 设置为 true 时要使用的目的地存储桶后缀。

字符串

doneFileName (consumer)

如果提供，Camel 仅会在文件存在时消耗文件。

字符串

fileName (consumer)

从具有所给文件名的存储桶中获取对象。

字符串

ignoreBody (consumer)

若为 true，则整个 S3 对象正文将被完全忽略，如果将 S3 对象设置为 false，则将放置在正文中。把它设置为 true，将覆盖 includeBody 选项定义的任何行为。

false

布尔值

includeBody (consumer)

若为 true，则使用 S3Object 交换，并放入正文和关闭中。如果为 false，则 S3Object 流将原始数据放在正文中，标题将使用 S3 对象元数据来设置。这个选项与 autocloseBody 选项相关。如果设置 includeBody 为 true，因为 S3Object 流也会被使用，那么在 includeBody false 时，它将被关闭，然后是调用者以关闭 S3Object 流。但是，当 includeBody 为 false 时，将 autocloseBody 设置为 true，它将计划在交换完成后自动关闭 S3Object 流。

true

布尔值

includeFolders (consumer)

若为 true，则使用文件夹/目录。如果为 false，将忽略它们，不会为它们创建 Exchanges。

true

布尔值

maxConnections (consumer)

设置 S3 客户端配置中的 maxConnections 参数。

60

int

maxMessagesPerPoll (consumer)

获取在每次轮询时轮询的最大消息数量。获取在每次轮询时轮询的最大消息数量。默认值为 10。使用 0 或负数值将其设置为无限。

10

int

moveAfterRead (consumer)

在检索后，将对象从 S3 存储桶移到不同的存储桶。要完成此操作，必须设置 destinationBucket 选项。只有在 Exchange 被提交时，才会执行复制存储桶操作。如果进行回滚，则对象不会被移动。

false

布尔值

前缀 （使用者）

com.amazonaws.services.s3.model.ListObjectsRequest 中使用的前缀，仅用于消耗我们感兴趣的对象。

字符串

sendEmptyMessageWhenIdle (consumer)

如果轮询消费者没有轮询任何文件，您可以启用这个选项来发送空消息（无正文）。

false

布尔值

autocloseBody (consumer (advanced))

如果这个选项为 true，并且 includeBody 为 false，则在交换完成后会调用 S3Object.close（）方法。这个选项与 includeBody 选项相关。如果将 includeBody 设为 false，则会自动关闭Body 为 false，则最多可看到调用者关闭 S3Object 流。将 autocloseBody 设置为 true，将自动关闭 S3Object 流。

true

布尔值

exceptionHandler (consumer (advanced))

要让消费者使用自定义 ExceptionHandler。请注意，如果选项 bridgeErrorHandler 已启用，则不会使用这个选项。默认情况下，消费者处理异常，该消费者在 WARN 或 ERROR 级别上记录并忽略。

ExceptionHandler

exchangePattern (consumer (advanced))

在消费者创建交换时设置交换模式。

枚举值：

ExchangePattern

pollStrategy (consumer (advanced))

可插入的 org.apache.camel.PollingConsumerPollingStrategy 可让您提供自定义实施来控制错误处理，在创建 Exchange 被创建并在 Camel 中路由前通常会发生。

PollingConsumerPollStrategy

batchMessageNumber (producer)

以流上传模式生成批处理的消息数量。

10

int

batchSize (producer)

流传输上传模式的批处理大小（以字节为单位）。

1000000

int

deleteAfterWrite (producer)

上传 S3 文件后删除文件对象。

false

布尔值

keyName (producer)

通过 endpoint 参数设置 bucket 中元素的键名称。

字符串

lazyStartProducer (producer)

制作者是否应该启动 lazy（在第一个消息上）。通过启动 lazy，您可以使用它来允许 CamelContext 和路由在启动期间启动，否则在启动期间出现问题，并导致路由启动失败。通过将这个启动延迟到 lazy 后，可以在通过 Camel 的路由错误处理程序路由消息期间处理启动失败。注意在处理第一个消息时，创建并启动制作者可能花费较少的时间，从而延长处理的总处理时间。

false

布尔值

multiPartUpload (producer)

如果是 true，则 camel 将使用多部分格式上传该文件，部分大小由 partSize 选项决定。

false

布尔值

namingStrategy (producer)

在流传输上传模式中使用的命名策略。

枚举值：

渐进

AWSS3NamingStrategyEnum

operation (producer)

当用户不想只进行上传时，要执行的操作。

枚举值：

AWS2S3Operations

partSize (producer)

设置在多部分上传中使用的 partSize，默认大小为 25M。

26214400

long

restartingPolicy (producer)

在流传输上传模式中使用的重启策略。

枚举值：

覆盖

AWSS3RestartingPolicyEnum

storageClass (producer)

要在 com.amazonaws.services.s3.model.PutObjectRequest 请求中设置的存储类。

字符串

streamingUploadMode (producer)

当流模式为 true 时，将会在流中上传到存储桶。

false

布尔值

streamingUploadTimeout (producer)

当流传输上传模式为 true 时，这个选项会将超时设置为完成上传。

long

awsKMSKeyId (producer (advanced))

在启用 KMS 时，定义要使用的 KMS 密钥 ID。

字符串

useAwsKMS (producer (advanced))

定义是否必须使用 KMS。

false

布尔值

useCustomerKey (producer (advanced))

定义是否必须使用客户密钥。

false

布尔值

backoffErrorThreshold (scheduler)

后续错误轮询次数（因为一些错误），在 backoffMultipler 应启动前应该发生。

int

backoffIdleThreshold (scheduler)

在 backoffMultipler 应启动前应进行的后续空闲轮询数量。

int

backoffMultiplier (scheduler)

如果一行中有多个后续的空闲/错误，则计划轮询消费者 backoff。倍数是，在下一次实际尝试再次发生前跳过的轮询数。当使用这个选项时，还必须配置 backoffIdleThreshold 和/或 backoffErrorThreshold。

int

delay (scheduler)

下一个轮询前毫秒。

500

long

greedy (scheduler)

如果启用了 greedy，则 ScheduledPollConsumer 将立即再次运行，如果上一运行轮询了 1 或更多消息。

false

布尔值

initialDelay (scheduler)

在第一次轮询开始前毫秒。

1000

long

repeatCount (scheduler)

指定最大触发数量的限制。因此，如果您将其设置为 1，调度程序将仅触发一次。如果将其设置为 5，它将仅触发五次。值为零或负表示永久触发。

0

long

runLoggingLevel (scheduler)

使用者在轮询时记录 start/complete 日志行。此选项允许您为其配置日志级别。

枚举值：

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

允许配置要用于使用者的自定义/共享线程池。默认情况下，每个消费者都有自己的单一线程线程池。

ScheduledExecutorService

调度程序 (scheduler)

使用来自 camel-spring 或 camel-quartz 组件中的 cron 调度程序。使用值 spring 或 quartz 在调度程序中构建。

none

对象

schedulerProperties (scheduler)

要在使用自定义调度程序或任何基于 Spring 的调度程序时配置额外的属性。

map

startScheduler (scheduler)

调度程序是否应自动启动。

true

布尔值

timeUnit (scheduler)

初始延迟和延迟选项的时间单位。

枚举值：

MILLISECONDS

TimeUnit

useFixedDelay (scheduler)

控制是否使用固定延迟或固定率。详情请参阅 JDK 中的 ScheduledExecutorService。

true

布尔值

accesskey （安全性）

Amazon AWS 访问密钥.

字符串

secretKey (security)

Amazon AWS Secret 密钥。

字符串