翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

事前定義されたステップを使用する

ワークフローを作成する場合、このトピックで説明した以下の定義済みステップのいずれかを追加することを選択できます。独自のカスタムファイル処理ステップを追加することもできます。詳細については、「カスタムのファイル処理ステップを使用してください。」を参照してください。

ファイルをコピーする

ファイルのコピーステップでは、アップロードされたファイルのコピーを新しい Amazon S3 ロケーションに作成します。現在、ファイルコピーステップは Amazon S3 でのみ使用できます。

次のファイルコピーステップでは、ファイルをfile-test宛先バケットのtestフォルダにコピーします。

ファイルのコピーステップがワークフローの最初のステップでない場合は、[ファイルロケーション] を指定できます。ファイルの場所を指定することで、前のステップで使用したファイルまたはアップロードされた元のファイルのいずれかをコピーできます。この機能を使用すると、ファイルのアーカイブや記録の保持のためにソースファイルをそのまま保持したまま、元のファイルの複数のコピーを作成できます。例については、タグ付けと削除のワークフローの例を参照してください。

バケットとキーの詳細を提供する

ファイルのコピーステップのバケット名とキーを指定する必要があります。キーには、パス名またはファイル名を指定できます。キーがパス名またはファイル名のどちらとして扱われるかは、キーの末尾にスラッシュ (/) を付けるかどうかで決まります。

最後の文字が「/」の場合、ファイルはフォルダにコピーされ、その名前は変わりません。最後の文字が英数字の場合、アップロードしたファイルの名前が path 値に変更されます。その名前のファイルがすでに存在する場合、動作は[既存を上書き] フィールドの設定によって異なります。

たとえば、キー値が test/ であれば、アップロードされたファイルは test フォルダにコピーされます。キーの値が test/today で、「Overwrite existing」が選択されている場合、アップロードしたファイルはすべて test フォルダー内の today という名前のファイルにコピーされ、後続のファイルはそれぞれ前のファイルが上書きされます。

ファイルのコピーステップでは名前付き変数を使用します。

ファイルのコピーステップでは、変数を使用してファイルをユーザー固有のフォルダーに動的にコピーできます。現在、${transfer:UserName}または${transfer:UploadDate}を変数として使用して、ファイルをアップロードしている特定のユーザーの宛先に、または現在の日付に基づいてファイルをコピーできます。

次の例では、ユーザーrichard-roeがファイルをアップロードすると、そのファイルはfile-test2/richard-roe/processed/フォルダーにコピーされます。ユーザーmary-majorがファイルをアップロードすると、そのファイルはfile-test2/mary-major/processed/フォルダーにコピーされます。

同様に、${transfer:UploadDate}を変数として使って、現在の日付にちなんだ名前のコピー先にファイルをコピーすることができます。次の例では、コピー先を 2022 年 2 月 1 日の${transfer:UploadDate}/processedに設定すると、アップロードされたファイルはfile-test2/2022-02-01/processed/フォルダーにコピーされます。

これらの変数は両方を組み合わせて使用することもできます。例:

IAM コピーステップのアクセス許可

コピーステップを成功させるには、ワークフローの実行ロールに次の権限が含まれていることを確認してください。

{
            "Sid": "ListBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": [
                "arn:aws:s3:::destination-bucket-name"
            ]
        },
        {
            "Sid": "HomeDirObjectAccess",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:DeleteObjectVersion",
                "s3:DeleteObject",
                "s3:GetObjectVersion"
            ],
            "Resource": "arn:aws:s3:::destination-bucket-name/*"
        }

ファイルを復号化します。

AWS ストレージブログには、 PGPおよび を使用してファイルの暗号化と復号、ファイルの暗号化と復号 AWS Transfer Familyを行う方法について説明します。

ワークフローでPGP復号を使用する

Transfer Family には、Pretty Good Privacy (PGP) 復号のサポートが組み込まれています。SFTP、、FTPSまたは FTP Amazon Simple Storage Service (Amazon S3) または Amazon PGP Amazon Elastic File System ) にアップロードされたファイルでは、復号を使用できますEFS。

PGP 復号を使用するには、ファイルの復号に使用されるPGPプライベートキーを作成して保存する必要があります。その後、ユーザーは、Transfer Family サーバーにファイルをアップロードする前に、対応する暗号化キーを使用してファイルをPGP暗号化できます。暗号化されたファイルを受信したら、ワークフローでそれらのファイルを復号化できます。詳細なチュートリアルについては、「ファイルを復号するためのマネージドワークフローの設定」を参照してください。

復号ステップを追加する

復号ステップは、ワークフローEFSの一部として Amazon S3 または Amazon にアップロードされた暗号化されたファイルを復号します。復号化の設定の詳細については、ワークフローでPGP復号を使用する を参照してください。

ワークフローの復号化ステップを作成するときは、復号化されたファイルの保存先を指定する必要があります。また、宛先にファイルがすでに存在する場合、既存のファイルを上書きするかどうかも選択する必要があります。Amazon CloudWatch Logs を使用して、復号ワークフローの結果をモニタリングし、各ファイルの監査ログをリアルタイムで取得できます。

ステップの [Decrypt ファイル] タイプを選択すると、[パラメータの設定] ページが表示されます。PGP 復号化パラメータの設定セクションの値を入力します。

利用可能なオプションは以下の通りである：

次のスクリーンショットは、ファイルの復号化ステップで選択できるオプションの例を示しています。

IAM 復号ステップのアクセス許可

復号化ステップを成功させるには、ワークフローの実行ロールに次の権限が含まれていることを確認してください。

{
            "Sid": "ListBucket",
            "Effect": "Allow",
            "Action": "s3:ListBucket",
            "Resource": [
                "arn:aws:s3:::destination-bucket-name"
            ]
        },
        {
            "Sid": "HomeDirObjectAccess",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObject",
                "s3:DeleteObjectVersion",
                "s3:DeleteObject",
                "s3:GetObjectVersion"
            ],
            "Resource": "arn:aws:s3:::destination-bucket-name/*"
        },
        {
            "Sid": "Decrypt",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue",
            ],
            "Resource": "arn:aws:secretsmanager:region:account-id:secret:aws/transfer/*"
        }

タグファイル

受信ファイルにタグを付けてさらに下流処理を行うには、タグステップを使用します。受信ファイルに割り当てるタグの値を入力します。現在、タグオペレーションは Transfer Family サーバーストレージに Amazon S3 を使用している場合にのみサポートされます。

次のタグステップ例では、scan_outcomeとcleanをそれぞれタグキーと値として割り当てます。

タグステップを成功させるには、ワークフローの実行ロールに次の権限が含まれていることを確認してください。

{
            "Sid": "Tag",
            "Effect": "Allow",
            "Action": [
                "s3:PutObjectTagging",
                "s3:PutObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::DOC-EXAMPLE-BUCKET/*"
            ]
}

ファイルを削除する

処理済みのファイルを前のワークフローステップから削除したり、最初にアップロードしたファイルを削除したりするには、ファイル削除ステップを使用します。

削除ステップを正常に実行するには、ワークフローの実行ロールに次の権限が含まれていることを確認してください。

{
            "Sid": "Delete",
            "Effect": "Allow",
            "Action": [
                "s3:DeleteObjectVersion",
                "s3:DeleteObject"
            ],
            "Resource": "arn:aws:secretsmanager:region:account-ID:secret:aws/transfer/*"
        }

ワークフローの名前付き変数

コピーと復号化のステップでは、変数を使用してアクションを動的に実行できます。現在、 は、次の名前付き変数 AWS Transfer Family をサポートしています。

タグ付けと削除のワークフローの例

次の例は、データ分析プラットフォームなどのダウンストリームアプリケーションで処理する必要がある受信ファイルにタグを付けるワークフローを示しています。受信ファイルにタグを付けた後、ワークフローはストレージコストを節約するために最初にアップロードされたファイルを削除します。

Console

例:タグ付けして移動するワークフロー

1. で AWS Transfer Family コンソールを開きますhttps://console.aws.amazon.com/transfer/。

2. ナビゲーションペインで [Workflows] (ワークフロー) を選択します。

3. [Workflows] (ワークフロー) ページで [Create workflow] (ワークフローの作成) を選択します。

4. 「ワークフローの作成」ページで、説明を入力します。この説明は [Workflows] (ワークフロー) ページに表示されます。

5. 最初のステップ (コピー) を追加します。

   1. [ノミナルステップ] セクションで [ステップを追加] を選択します。

   2. 「ファイルのコピー」を選択し、「次へ」を選択します。

   3. ステップ名を入力し、宛先バケットとkey prefix スを選択します。

      

   4. [Next] (次へ) を選択してからステップの詳細を見直します。

   5. 「ステップの作成」を選択してステップを追加し、次に進みます。

6. 2 番目のステップ (タグ) を追加します。

   1. [ノミナルステップ] セクションで [ステップを追加] を選択します。

   2. 「ファイルのタグ付け」を選択し、「次へ」を選択します。

   3. ステップ名を入力します。

   4. [ファイルロケーション] で、[前の手順で作成したファイルにタグを付ける] を選択します。

   5. [Key] (キー) と [Value] (値) を入力します。

      

   6. [Next] (次へ) を選択してからステップの詳細を見直します。

   7. 「ステップの作成」を選択してステップを追加し、次に進みます。

7. 3 番目のステップ (削除) を追加します。

   1. [ノミナルステップ] セクションで [ステップを追加] を選択します。

   2. 「ファイルの削除」を選択し、「次へ」を選択します。

      

   3. ステップ名を入力します。

   4. [ファイルロケーション] で [元のソースファイルを削除] を選択します。

   5. [Next] (次へ) を選択してからステップの詳細を見直します。

   6. 「ステップの作成」を選択してステップを追加し、次に進みます。

8. ワークフロー設定を確認し、し、「ワークフローの作成」を選択します。

CLI

例:タグ付けして移動するワークフロー

1. 以下のコードをファイルに保存します；例えば、tagAndMoveWorkflow.json。user input placeholder を、ユーザー自身の情報に置き換えます。

   [
      {
          "Type": "COPY",
          "CopyStepDetails": {
             "Name": "CopyStep",
             "DestinationFileLocation": {
                "S3FileLocation": {
                   "Bucket": "DOC-EXAMPLE-BUCKET",
                   "Key": "test/"
                }
             }
          }
      },
      {
          "Type": "TAG",
          "TagStepDetails": {
             "Name": "TagStep",
             "Tags": [
                {
                   "Key": "name",
                   "Value": "demo"
                }
             ],
             "SourceFileLocation": "${previous.file}"
          }
      },
      {
         "Type": "DELETE",
         "DeleteStepDetails":{
            "Name":"DeleteStep",
            "SourceFileLocation": "${original.file}"
         }
     }
   ]

   最初のステップでは、アップロードしたファイルを新しい Amazon S3 ロケーションにコピーします。2 番目のステップでは、新しいロケーションにコピーされたファイル (previous.file) にタグ (キーと値のペア) を追加します。最後に、3 番目のステップで元のファイル (original.file) を削除します。

2. 保存したファイルからワークフローを作成します。user input placeholder を、ユーザー自身の情報に置き換えます。

   aws transfer create-workflow --description "short-description" --steps file://path-to-file --region region-ID

   例:

   aws transfer create-workflow --description "copy-tag-delete workflow" --steps file://tagAndMoveWorkflow.json --region us-east-1

   注記

   ファイルを使用してパラメータを読み込む方法について詳しくは、「ファイルからパラメータをロードする方法」を参照してください。

3. 既存のサーバーを更新します。

   注記

   この手順では、すでに Transfer Family サーバーがあり、それにワークフローを関連付けることを前提としています。そうでない場合は、「SFTP、FTPS、またはFTPサーバーエンドポイントの設定」を参照してください。user input placeholder を、ユーザー自身の情報に置き換えます。

   aws transfer update-server --server-id server-ID --region region-ID 
     --workflow-details '{"OnUpload":[{ "WorkflowId": "workflow-ID","ExecutionRole": "execution-role-ARN"}]}'

   例:

   aws transfer update-server --server-id s-1234567890abcdef0 --region us-east-2 
     --workflow-details '{"OnUpload":[{ "WorkflowId": "w-abcdef01234567890","ExecutionRole": "arn:aws:iam::111111111111:role/nikki-wolf-execution-role"}]}'