GetS3ObjectMetadata 2025.5.31.15¶

捆绑包¶

org.apache.nifi | nifi-aws-nar

描述¶

检查 S3 中是否存在某个对象并在不尝试下载的情况下提取其元数据。该处理器可用作工作流中的路由器，用于在继续进行数据处理之前，先检查 S3 中是否存在某个对象。

标签¶

AWS、Amazon、Archive、Exists、S3

输入要求¶

REQUIRED

支持敏感的动态属性¶

false

属性¶

属性	描述
AWS 凭据提供商服务	用于获取 AWS 凭据提供商的控制器服务
桶	要与之交互的 S3 桶
通信超时	超时之前为与 AWS 建立连接或从 AWS 接收数据而等待的时间。
端点替换 URL	要使用的端点 URL 而不是 AWS 默认端点，包括架构、主机、端口和路径。AWS 库会根据 AWS 区域选择端点 URL，但此属性会替换所选端点 URL，允许与其他与 S3 兼容的端点一起使用。
FullControl 用户列表	以逗号分隔的 Amazon 用户 ID 或电子邮件地址列表，用于指定谁应该拥有对象的完全控制权
元数据属性包含模式	一种正则表达式模式，用于确定哪些对象的元数据项应作为 FlowFileattributes 包含进来。此模式仅适用于“found”关系，不会用于筛选“failure”关系中的错误属性。
元数据目标	确定元数据在找到时被写入的位置。
对象键	要使用的 S3 对象键。这类似于传统文件系统的文件名。
所有者	供对象所有者使用的 Amazon ID
读取 ACL 用户列表	以逗号分隔的 Amazon 用户 ID 或电子邮件地址列表，用于指定谁应有权读取对象的访问控制列表
读取权限用户列表	以逗号分隔的 Amazon 用户 ID 或电子邮件地址列表，用于指定谁应该拥有对象的读取权限
区域	要连接的 AWS 区域。
SSL Context Service	指定可选的 SSL Context Service，如果提供该服务，将用于创建连接
签名器替换	默认情况下，AWS S3 库使用签名版本 4，但此属性允许您指定版本 2 签名器以支持较早的 S3 兼容服务，甚至可以插入自己的自定义签名器实现。
版本	要检索元数据的对象的版本
custom-signer-class-name	自定义签名器类的完全限定类名。签名器必须实现 com.amazonaws.auth.Signer 接口。
custom-signer-module-location	以逗号分隔的文件和/或目录路径列表，这些文件和/或目录包含自定义签名器的 JAR 文件及其依赖关系（如果有）。
proxy-configuration-service	指定代理配置控制器服务来代理网络请求。

关系¶

名称	描述
failure	如果处理器无法处理给定的 FlowFile，则会将其路由到此关系。
found	在存储桶中通过提供的键找到了一个对象
not found	在提供的键的桶中未找到任何对象

另请参阅¶