6.3. 组件选项


AWS S3 Storage Service 组件支持 50 个选项,如下所列。

Name描述默认值类型

amazonS3Client (common)

对 registry 中的 com.amazonaws.services.s3.AmazonS3 的 Autowired Reference。

 

S3Client

amazonS3Presigner (common)

Autowired 一个用于请求的 S3 Presigner,主要在 createDownloadLink 操作中使用。

 

S3Presigner

autoCreateBucket (common)

设置 S3 存储桶自动创建的 bucketName。如果启用了 moveAfterRead 选项,则也会应用它,如果尚未存在 moveAfterRead 选项,它将创建 destinationBucket。

false

布尔值

configuration (common)

组件配置。

 

AWS2S3Configuration

overrideEndpoint (common)

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

false

布尔值

pojoRequest (common)

如果您想要将 POJO 请求用作正文。

false

布尔值

policy (common)

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

 

字符串

proxyHost (common)

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

 

字符串

proxyPort (common)

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

 

整数

proxyProtocol (common)

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

Enum 值:

  • HTTP
  • HTTPS

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 时要使用的 Customer key 的 id。

 

字符串

customerKeyMD5 (common (advanced))

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

 

字符串

bridgeErrorHandler (consumer)

允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 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 对象正文将完全忽略,如果设为 false,则 S3 对象将放入正文中。把它设置为 true,将覆盖 includeBody 选项定义的任何行为。

false

布尔值

includeBody (consumer)

如果为 true,则 S3Object Exchange 将被使用并放入正文和关闭中。如果为 false,S3Object 流将原始放在正文中,标头将使用 S3 对象元数据设置。这个选项与 autocloseBody 选项密切相关。如果将 includeBody 设为 true,因为 S3Object 流将被消耗,然后也会关闭它,而在 includeBody false 时,它将是关闭 S3Object 流的调用者。但是,当 includeBody 为 false 时,将 autocloseBody 设置为 true,它将在交换完成时自动关闭 S3Object 流。

true

布尔值

includeFolders (consumer)

如果为 true,将消费的文件夹/目录。如果是 false,则忽略它们,且不会为那些交换创建。

true

布尔值

moveAfterRead (consumer)

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

false

布尔值

prefix (consumer)

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

 

字符串

autocloseBody (consumer (advanced))

如果此选项为 true,且 includeBody 为 false,则在交换完成时调用 S3Object.close() 方法。此选项与 includeBody 选项密切相关。如果将 includeBody 设为 false,autocloseBody 设为 false,它将是关闭 S3Object 流的调用者。将 autocloseBody 设置为 true,将自动关闭 S3Object 流。

true

布尔值

batchMessageNumber (producer)

在流传输上传模式中制作批处理的消息数量。

10

int

batchSize (producer)

流上传模式的批处理大小(以字节为单位)。

1000000

int

deleteAfterWrite (producer)

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

false

布尔值

KeyName (producer)

通过端点参数在存储桶中设置元素的密钥名称。

 

字符串

lazyStartProducer (producer)

生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。

false

布尔值

multiPartUpload (producer)

如果为 true,则 camel 将上传带有多部分格式的文件,由 partSize 选项决定部分大小。

false

布尔值

namingStrategy (producer)

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

Enum 值:

  • progressive
  • random

progressive

AWSS3NamingStrategyEnum

operation (producer)

当用户不希望只进行上传时,要执行的操作。

Enum 值:

  • copyObject
  • listObjects
  • deleteObject
  • deleteBucket
  • listBuckets
  • getObject
  • getObjectRange
  • createDownloadLink
 

AWS2S3Operations

partSize (producer)

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

26214400

long

restartingPolicy (producer)

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

Enum 值:

  • override
  • lastPart

override

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

布尔值

autowiredEnabled (advanced)

是否启用自动关闭。这用于自动关闭选项(选项必须标记为 autowired),方法是在 registry 中查找查找是否有单个匹配类型实例,然后在组件上配置。这可以用于自动配置 JDBC 数据源、JMS 连接工厂、AWS 客户端等。

true

布尔值

accessKey (security)

Amazon AWS 访问密钥.

 

字符串

secretKey (security)

Amazon AWS Secret 密钥。

 

字符串

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.