PutGoogleDrive Processor
描述
将 FlowFile 的内容作为文件写入 Google Drive 中。
标签
属性
| 名称 | 默认值 | 可选值 | 描述 |
|---|---|---|---|
| GCP Credentials Provider Service | | 控制器服务 API：GCPCredentialsServicecn.org.acal.lynxus-lynxus-gcp-services-api-nar-2.11.8 | 用于获取 Google Cloud Platform 凭据的Controller Service。 |
| Folder ID | | 共享文件夹的 ID。请参阅其他详细信息以设置对 Google 云端硬盘的访问并获取文件夹 ID。 支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值） | |
| Filename | ${filename} | 要上传到指定 Google 云端硬盘文件夹的文件的名称。 支持表达式语言：是（使用 FlowFile 属性与环境/系统变量求值） | |
| Conflict Resolution Strategy | fail |
| 指示当指定的 Google 云端硬盘文件夹中已存在同名文件时会发生什么情况。 |
| Chunked Upload Threshold | 100 MB | 一次上传内容的最大大小。 大于此阈值的 FlowFile 会分块上传。 | |
| Chunked Upload Size | 10 MB | 定义分块大小。当 FlowFile 的大小超过 'Chunked Upload Threshold' 时，内容将以较小的分块上传。允许的最小分块大小为 256 KB，最大分块大小为 1 GB。 | |
| Google Drive API Scope | DRIVE_SCOPES |
| 指定访问 Google Drive 时请求的 OAuth2 范围。'Drive Scopes' 使用特定于 Drive 的范围，推荐用于大多数设置，包括具有域范围委派的服务账户。'Cloud Platform' 使用更广泛的 cloud-platform 范围，在使用具有服务账户模拟的工作负载身份联合时需要此范围。 |
| Proxy Configuration Service | | 控制器服务 API：ProxyConfigurationServicecn.org.acal.lynxus-lynxus-standard-services-api-nar-2.11.8 | 指定代理配置 Controller Service 来代理网络请求。 |
| Connect Timeout | 20 sec | 连接 Google 云端硬盘服务的最长等待时间。 支持表达式语言：是（仅使用环境/系统变量求值） | |
| Read Timeout | 60 sec | Google 云端硬盘服务响应的最长等待时间。 支持表达式语言：是（仅使用环境/系统变量求值） |
关系 (Relationships)
| 名称 | 描述 | 自动终止 |
|---|---|---|
failure | 由于某种原因无法写入 Google 云端硬盘的文件将传输到此关系。 | 否 |
success | 已成功写入 Google 云端硬盘的文件将传输至此关系。 | 否 |
读取的 FlowFile 属性
| 名称 | 描述 |
|---|---|
filename | 使用 FlowFile 的文件名作为 Google Drive 对象的文件名。 |
写入的 FlowFile 属性
| 名称 | 描述 |
|---|---|
drive.id | 文件的 ID |
filename | 文件的名称 |
mime.type | 文件的 MIME 类型 |
drive.size | 文件的大小。当文件大小不可用时设置为 0（例如外部存储的文件）。 |
drive.size.available | 指示文件大小是否已知/可用 |
drive.timestamp | 文件的最后修改时间或创建时间（取较大者）。这是因为文件上传到 Google Drive 时会保留原始修改日期。'创建时间'取上传发生的时间。但上传的文件之后仍可被修改。 |
drive.created.time | 文件的创建时间 |
drive.modified.time | 文件的最后修改时间 |
error.code | Google Drive 返回的错误代码 |
error.message | Google Drive 返回的错误消息 |
状态管理
该组件不存储状态。
受限 (Restricted)
该组件不受限。
输入要求
该组件要求有传入连接。
详细说明
PutGoogleDrive
从 Lynxus 访问 Google Drive
该 Processor 使用 Google Cloud 凭据进行认证，以访问 Google Drive。 为这些 Processor 准备 Google Cloud 和 Google Drive 账户需要以下步骤：
- 在 Google Cloud 中启用 Google Drive API
- 按照 https://developers.google.com/workspace/guides/enable-apis 的说明，搜索 'Google Drive API'。
- 授予 Google Drive 文件夹的访问权限
- 在 Google Cloud Console 中，进入 IAM & Admin -> Service Accounts。
- 记下将要使用的服务账号的邮箱。
- 在 Google Drive 中找到将作为基础文件夹使用的文件夹。
- 右键点击文件夹 -> Share。
- 输入服务账号的邮箱。
- 找到 Folder ID
- 在 Google Drive 中找到要列出的文件夹并进入。浏览器中的
URL 末尾会包含 ID。例如，如果 URL 是
https://drive.google.com/drive/folders/1trTraPVCnX5_TNwO8d9P_bz278xWOmGm， 那么 Folder ID 就是1trTraPVCnX5_TNwO8d9P_bz278xWOmGm
- 在 Google Drive 中找到要列出的文件夹并进入。浏览器中的
URL 末尾会包含 ID。例如，如果 URL 是
- 在 'Folder ID' 属性中设置 Folder ID