AWS S3模块

Adobe Workfront Fusion AWS S3模块允许您对S3存储桶执行操作。

访问要求

您必须具有以下权限才能使用本文中的功能:

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证

先决条件

要使用AWS S3模块,您必须拥有Amazon Web Service帐户。

AWS S3 API信息

AWS S3连接器使用以下对象:

基本URL
https://s3.{{parameter.region}}.amazonaws.com
API标记
v1.5.21

将AWS连接到Workfront Fusion connect-aws-to-workfront-fusion

要将AWS S3连接到Workfront Fusion,您必须将您的AWS帐户连接到Workfront Fusion。 为此,您首先需要在AWS IAM中创建API用户。

  1. 登录到您的AWS IAM帐户。

  2. 导航到​ 身份和访问管理 > 访问管理 > 用户

  3. 单击​ 添加用户

  4. 输入新用户的名称并在访问类型部分中选择​ 编程访问 ​选项。

  5. 单击​ 直接附加现有策略,然后在搜索栏中搜索​ AmazonS3FullAccess。 出现时单击它,然后单击​ 下一步

  6. 继续其他对话框屏幕,然后单击​ 创建用户

  7. 复制提供的​ 访问密钥ID ​和​ 访问密钥

  8. 转到Workfront Fusion并打开AWS S3模块的​ 创建连接 ​对话框。

  9. 从步骤7到相应的字段输入访问密钥ID和访问密钥,然后单击​ 继续 ​建立连接。

已建立连接。 您可以继续设置模块。

AWS S3模块及其字段

配置AWS S3模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他AWS S3字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。

操作

创建存储桶

Connection
有关将AWS帐户连接到Workfront Fusion的说明,请参阅本文中的将AWS连接到Workfront Fusion
名称
输入新存储段的名称。
区域
选择您的区域端点。 有关详细信息,请参阅AWS文档中有关区域端点的讨论。

获取文件

从存储桶下载文件。

Connection
有关将AWS帐户连接到Workfront Fusion的说明,请参阅本文中的将AWS连接到Workfront Fusion
区域
选择您的区域端点。 有关详细信息,请参阅AWS文档中有关区域端点的讨论。
Bucket
选择要从中下载文件的存储桶。
路径
输入文件的路径。 示例: /photos/2019/February/image023.jpg

上载文件

Connection
有关将AWS帐户连接到Workfront Fusion的说明,请参阅本文中的将AWS连接到Workfront Fusion
区域
选择您的区域端点。 有关详细信息,请参阅AWS文档中有关区域端点的讨论。
文件夹(可选)
指定要上载文件的目标文件夹。
Source file
从上一个模块中选择源文件,或映射源文件的名称和数据。
Headers(可选)
插入请求标头。 在AWS S3文档中找到可用的标头 — PUT对象

进行API调用

有关Amazon S3 API的详细讨论,请参阅Amazon S3 REST API简介

Connection
有关将AWS帐户连接到Workfront Fusion的说明,请参阅本文中的将AWS连接到Workfront Fusion
区域
选择您的区域端点。 有关详细信息,请参阅AWS文档中有关区域端点的讨论。
URL
url输入主机URL。 路径必须相对于 https://s3.<selected-region>.amazonaws.com/
方法

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法。

Headers

添加请求标头。 您可以使用以下常用请求标头。 有关更多请求标头,请参阅AWS S3 API文档

Workfront Fusion 自动添加授权标头。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 layout-auto
标题名称 描述
Content-Length 根据RFC 2616的消息长度(不带标头)。 加载XML的PUT和操作(如日志记录和ACL)需要此标头。
Content-Type 资源的内容类型(如果请求内容位于正文中)。 示例: text/plain
Content-MD5 根据RFC 1864对消息的128位MD5摘要(不包括标头)进行Base64编码。 此标头可用作消息完整性检查,以验证数据是否与最初发送的数据相同。 虽然这是可选的,但我们建议使用Content-MD5机制作为端到端完整性检查。 有关REST请求身份验证的详细信息,请在 Amazon Simple Storage Service开发人员指南 中转到REST身份验证
日期 请求者的当前日期和时间。 示例: Wed, 01 Mar 2006 12:00:00 GMT。 指定Authorization 标头时,必须指定x-amz-dateDate 标头。
Expect

当您的应用程序使用100-continue时,它会在收到确认后才发送请求正文。 如果根据标头拒绝消息,则不会发送消息正文。 仅当您发送正文时,才能使用此标头。

有效值: 100-continue

主机

对于路径样式请求,值为s3.amazonaws.com。 对于虚拟样式请求,值为BucketName.s3.amazonaws.com。 有关详细信息,请参阅 Amazon Simple Storage Service开发人员指南 中的虚拟托管

HTTP 1.1需要此标头(大多数工具包会自动添加此标头);HTTP/1.0请求可以选择此标头。

x-amz-content-sha256 使用签名版本4对请求进行身份验证时,此标头提供请求有效负载的哈希。 以块形式上传对象时,将值设置为STREAMING-AWS4-HMAC-SHA256-PAYLOAD以指示签名仅涵盖标头并且没有有效负载。 有关详细信息,请参阅授权标头的签名计算:在多个块(分块上传)中传输有效负载(AWS签名版本4)
x-amz-date 请求者的当前日期和时间。 示例: Wed, 01 Mar 2006 12:00:00 GMT。 指定Authorization 标头时,必须指定x-amz-dateDate 标头。 如果同时指定两者,则优先使用为x-amz-date标头指定的值。
x-amz-security-token

此标头可用于以下方案:

  • 为Amazon DevPay操作提供安全令牌。 使用Amazon DevPay的每个请求都需要两个x-amz-security-token标头:一个用于产品令牌,另一个用于用户令牌。 当Amazon S3收到经过身份验证的请求时,它将计算的签名与提供的签名进行比较。 用于计算签名的多值标头格式不正确可能会导致身份验证问题。
  • 使用临时安全凭据时提供安全令牌。 使用从IAM获得的临时安全凭据发出请求时,必须使用此标头提供安全令牌。 要了解有关临时安全凭据的更多信息,请转到发出请求。

使用Amazon DevPay的请求和使用临时安全凭据签名的请求需要此标头。

查询字符串
添加所需的查询字符串,如参数或表单字段。
Body

以标准JSON对象的形式添加API调用的正文内容。

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

搜索

列出文件

从指定位置返回文件列表。

Connection
有关将AWS帐户连接到Workfront Fusion的说明,请参阅本文中的将AWS连接到Workfront Fusion
区域
选择您的区域端点。 有关详细信息,请参阅AWS文档中有关区域端点的讨论。
Bucket
选择要搜索文件的Amazon S3存储段。
前缀(可选)
要在其中查找文件的文件夹的路径,例如 workfrontfusion/work.

列出文件夹

从指定位置返回文件夹列表。

Connection
有关将AWS帐户连接到Workfront Fusion的说明,请参阅本文中的将AWS连接到Workfront Fusion
区域
选择您的区域端点。 有关详细信息,请参阅AWS文档中有关区域端点的讨论。
Bucket
选择要搜索文件夹的Amazon S3存储段。
前缀(可选)
要查找文件夹的文件夹路径,例如 workfrontfusion/work.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43