PutGCSObject

PutGCSObject Processor

类型全限定名：cn.org.acal.lynxus.processors.gcp.storage.PutGCSObject

所属 Bundle：cn.org.acal.lynxus:lynxus-gcp-nar:2.11.8

描述

将 FlowFile 的内容作为对象写入 Google Cloud Storage 中。

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称	默认值	可选值	描述
GCP Credentials Provider Service		控制器服务 API： `GCPCredentialsService` cn.org.acal.lynxus-lynxus-gcp-services-api-nar-2.11.8	用于获取 Google Cloud Platform 凭据的Controller Service。
Project ID			谷歌云项目 ID 支持表达式语言：是（仅使用环境/系统变量求值）
Bucket	`${gcs.bucket}`		对象的存储桶。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Key	`${filename}`		对象的名称。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Resource Transfer Source	`FLOWFILE_CONTENT`	FlowFile Content — 传入 FlowFile 的内容提供传输源 File Resource Service — 文件资源服务提供传输源	待传输内容的来源
File Resource Service		控制器服务 API： `FileResourceService` cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8	文件资源服务提供对要传输的本地资源的访问
Content Type	`${mime.type}`		文件的内容类型，即文本/纯文本支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
CRC32C Checksum			用于服务器端验证的文件的 CRC32C 校验和（以 Base64、大端顺序编码）。支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Object ACL		All Authenticated Users — 授予存储桶或对象所有者 OWNER 权限，并授予所有经过身份验证的 Google 账户持有者 READER 和 WRITER 权限。移除所有其他权限。 Authenticated Read — 授予存储桶或对象所有者 OWNER 权限，并授予所有经过身份验证的 Google 账户持有者 READER 权限。移除所有其他权限。 Bucket Owner Full Control — 授予对象所有者和存储桶所有者 OWNER 权限。移除所有其他权限。 Bucket Owner Read Only — 授予对象所有者 OWNER 权限，并授予存储桶所有者 READER 权限。移除所有其他权限。 Private — 授予存储桶或对象所有者对该存储桶或对象的 OWNER 权限，并移除所有其他访问权限。 Project Private — 根据项目团队成员的角色授予权限。团队中的任何人都具有 READER 权限。项目所有者和项目编辑者具有 OWNER 权限。这是新创建存储桶的默认 ACL。除非该存储桶的默认对象 ACL 已被更改，否则这也是新创建对象的默认 ACL。 Public Read Only — 授予存储桶或对象所有者 OWNER 权限，并授予所有用户（无论是经过身份验证的还是匿名的）READER 权限。当你将其应用于某个对象时，互联网上的任何人都可以在不进行身份验证的情况下读取该对象。	附加到上传对象的访问控制。不提供此项将恢复为存储桶默认值。
Server Side Encryption Key			用于对象的服务器端加密的 AES256 加密密钥（以 base64 编码）。敏感属性：是支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值）
Overwrite Object	`true`	true false	如果为 false，则仅当对象不存在时上传到 GCS 才会成功。
Content Disposition Type		Inline — 指示应在浏览器中加载并呈现该对象。 Attachment — 指示该对象应被保存（使用「另存为...」对话框），而不是直接在浏览器中打开	要附加到对象的 RFC-6266 内容处置的类型
GZIP 压缩已启用	`true`	true false	向 GCS Blob Writer 指示是否需要在传输过程中进行 GZIP 压缩。False 表示不进行 gzip 压缩，在许多情况下可以提高性能。
存储 API URL			覆盖默认存储 URL。配置替代的存储 API URL 同时也会覆盖请求中的HTTP Host 头，如 Google 文档中关于私有服务连接的说明所述。支持表达式语言：是（仅使用环境/系统变量求值）
Number of Retries	`6`		在路由到失败关系之前应进行多少次重试。
Proxy Configuration Service		控制器服务 API： `ProxyConfigurationService` cn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8	指定代理配置 Controller Service 来代理网络请求。

动态属性

动态属性允许用户自定义属性的名称与值。

名称	值	描述
要添加到 GCS 对象的用户定义元数据字段的名称	要添加到 GCS 对象的用户定义元数据字段的值	允许将用户定义的元数据作为键/值对添加到 GCS 对象

关系 (Relationships)

名称	描述	自动终止
`failure`	如果 Google Cloud Storage 操作失败，FlowFiles 将路由到此关系。	否
`success`	成功执行 Google Cloud Storage 操作后，FlowFiles 将路由到此关系。	否

读取的 FlowFile 属性

名称	描述
`filename`	使用 FlowFile 的文件名作为 GCS 对象的文件名
`mime.type`	使用 FlowFile 的 MIME 类型作为 GCS 对象的内容类型

写入的 FlowFile 属性

名称	描述
`gcs.bucket`	对象的存储桶。
`gcs.key`	对象的名称。
`gcs.size`	对象的大小。
`gcs.cache.control`	对象的数据缓存控制。
`gcs.component.count`	组成对象的组件数量。
`gcs.content.disposition`	对象的数据内容处置。
`gcs.content.encoding`	对象的内容编码。
`gcs.content.language`	对象的内容语言。
`mime.type`	对象的 MIME/Content-Type
`gcs.crc32c`	对象数据的 CRC32C 校验和，以 base64 大端序编码。
`gcs.create.time`	对象的创建时间（毫秒）
`gcs.update.time`	对象的最后修改时间（毫秒）
`gcs.encryption.algorithm`	用于加密对象的算法。
`gcs.encryption.sha256`	用于加密对象的密钥的 SHA256 哈希值
`gcs.etag`	对象的 HTTP 1.1 实体标签。
`gcs.generated.id`	服务为对象生成的标识
`gcs.generation`	对象的数据代。
`gcs.md5`	对象数据的 MD5 哈希值，以 base64 编码。
`gcs.media.link`	对象的媒体下载链接。
`gcs.metageneration`	对象的元代。
`gcs.owner`	对象的所有者（上传者）。
`gcs.owner.type`	对象上传者的 ACL 实体类型。
`gcs.uri`	对象的 URI 字符串。

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

输入要求

该组件要求有传入连接。