AWS S3 モジュール

Adobe Workfront Fusion AWS S3 モジュールを使用すると、S3 バケットに対して操作を実行できます。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
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 を Workfront Fusion に接続 connect-aws-to-workfront-fusion

AWS S3 を Workfront Fusion に接続するには、AWS アカウントを Workfront Fusion に接続する必要があります。これを行うには、まず AWS IAM で API ユーザーを作成します。

  1. AWS IAM アカウントにログインします。

  2. ID とアクセスの管理アクセス管理ユーザー ​に移動します。

  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 に接続を参照してください。
Name
新しいバケットの名前を入力します。
Region
地域のエンドポイントを選択します。詳しくは、AWS ドキュメント内の地域エンドポイントの説明を参照してください。

ファイルを取得

バケットからファイルをダウンロードします。

Connection
AWS アカウントを Workfront Fusion に接続する方法については、この記事内のAWS を Workfront Fusion に接続を参照してください。
Region
地域のエンドポイントを選択します。詳しくは、AWS ドキュメント内の地域エンドポイントの説明を参照してください。
Bucket
ファイルのダウンロード元のバケットを選択します。
Path
ファイルにパスを入力します。例:/photos/2019/February/image023.jpg

ファイルをアップロード

Connection
AWS アカウントを Workfront Fusion に接続する手順については、この記事内のAWS を Workfront Fusion に接続を参照してください。
Region
地域のエンドポイントを選択します。詳しくは、AWS ドキュメント内地域エンドポイントの説明を参照してください。
Folder(オプション)
ファイルのアップロード先であるターゲットフォルダーを指定します。
Source file
以前のモジュールで使用したソースファイルを選択するか、ソースファイルの名前とデータをマッピングします。
Headers(オプション)
リクエストヘッダーを挿入します。使用可能なヘッダーについては、AWS S3 ドキュメントの PUT オブジェクトを参照してください。

API 呼び出しを実行

Amazon S3 API の詳細な説明については、Amazon S3 REST API の概要を参照してください。

Connection
AWS アカウントを Workfront Fusion に接続する手順については、この記事内のAWS を Workfront Fusion に接続を参照してください。
Region
地域のエンドポイントを選択します。詳しくは、AWS ドキュメント内の地域エンドポイントの説明を参照してください。
URL
URL でホスト URL を入力します。パスは https://s3.<selected-region>.amazonaws.com/ を基準として指定する必要があります。
Method

API 呼び出しを設定する必要がある HTTP リクエストメソッドを選択します。詳細情報は、Adobe Workfront Fusion の HTTP リクエストメソッドを参照してください。

Headers

リクエストヘッダーを追加します。次の共通のリクエストヘッダーを使用できます。リクエストヘッダーについて詳細は、AWS S3API ドキュメントを参照してください。

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 に従ったメッセージの長さ(ヘッダーなし)。このヘッダーは、PUT や、XML を読み込む操作(ログや ACL など)に必要です。
Content-Type リソースのコンテンツタイプ(リクエストコンテンツが本文にある場合)。例:text/plain
Content-MD5 RFC 1864 に従って、base64 エンコードされた 128 ビットの MD5 ダイジェスト(ヘッダーなし)。このヘッダーをメッセージの整合性チェックとして使用し、データが最初に送信されたのと同じデータであることを検証できます。これはオプションですが、Content-MD5 メカニズムをエンドツーエンドの整合性チェックとして使用することをお勧めします。REST リクエスト認証について詳しくは、Amazonシンプルストレージサービス開発者ガイドREST 認証を参照してください。
Date リクエスターに応じた現在の日時。例:Wed, 01 Mar 2006 12:00:00 GMTAuthorization ヘッダーを指定する場合は、x-amz-date ヘッダーまたは Date ヘッダーを指定する必要があります。
Expect

アプリケーションで 100-continue を使用する場合、確認を受け取るまでリクエスト本文は送信されません。ヘッダーに基づいてメッセージを拒否した場合、メッセージの本文は送信されません。このヘッダーは、本文を送信する場合にのみ使用できます。

有効な値:100-continue

Host

パススタイルのリクエストの場合、値は s3.amazonaws.com です。仮想スタイルのリクエストの場合、値は BucketName.s3.amazonaws.com です。詳細情報については、Amazonシンプルストレージサービス開発者ガイド仮想ホスティングを参照してください。

このヘッダーは 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 GMTAuthorization ヘッダーを指定する場合は、x-amz-date ヘッダーまたは Date ヘッダーを指定する必要があります。両方を指定した場合は、x-amz-date ヘッダーの値が優先されます。
x-amz-security-token

このヘッダーは、次のシナリオで使用できます。

  • Amazon DevPay操作のためにセキュリティトークンを提供します。Amazon DevPayを使用する各リクエストには、製品トークン用とユーザートークン用の 2 つのx-amz-security-tokenヘッダーが必要です。Amazon S3 が認証済みリクエストを受け取ると、計算済みの署名と提供された署名を比較します。署名の計算に使用されている複数値ヘッダーの形式が適切でない場合、認証の問題が発生する可能性があります。
  • 一時的なセキュリティ資格情報を使用する場合は、セキュリティトークンを提供します。IAM から取得した一時的なセキュリティ認証情報を使用してリクエストを行う際には、このヘッダーを使用してセキュリティトークンを提供する必要があります。一時的なセキュリティ認証情報の詳細については、「リクエストの実行」を参照してください。

このヘッダーは、Amazon DevPay を使用するリクエストおよび一時的なセキュリティ認証情報を使用して署名されたリクエストに必要です。

Query String
パラメーターやフォームフィールドなど、必要なクエリ文字列を追加します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

検索

ファイルをリストする

指定された場所からファイルのリストを返します。

Connection
AWS アカウントを Workfront Fusion に接続する方法については、この記事のAWS を Workfront Fusion に接続を参照してください。
Region
地域のエンドポイントを選択します。詳しくは、AWS ドキュメントで地域エンドポイントについての説明を参照してください。
Bucket
ファイルを検索する Amazon S3 バケットを選択します。
Prefix(オプション)
ファイルを検索するフォルダーのパス(例: workfrontfusion/work.

フォルダーをリストする

指定された場所からフォルダーのリストを返します。

Connection
AWS アカウントを Workfront Fusion に接続する方法については、この記事のAWS を Workfront Fusion に接続を参照してください。
Region
地域のエンドポイントを選択します。詳しくは、AWS ドキュメントで地域エンドポイントについての説明を参照してください。
Bucket
フォルダーを検索する Amazon S3 バケットを選択します。
Prefix(オプション)
フォルダーを検索するフォルダーのパス(例: workfrontfusion/work.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43