Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用预定义的步骤

创建工作流程时，可以选择添加本主题中讨论的以下预定义步骤之一。您还可选择添加自己的自定义文件处理步骤。有关更多信息，请参阅 使用自定义文件处理步骤。

复制文件

复制文件步骤会在新的 Amazon S3 位置创建已上传文件的副本。目前，您只能在 Amazon S3 上使用复制文件步骤。

以下复制文件步骤将文件复制到 file-test 目标存储桶中的 test 文件夹。

如果复制文件步骤不是工作流程的第一步，则可以指定文件位置。通过指定文件位置，您可以复制上一步中使用的文件或上传的原始文件。您可以使用此功能制作原始文件的多个副本，同时保持源文件完好无损，便于文件存档和记录保留。有关示例，请参阅标记和删除工作流程示例。

提供存储桶和密钥的详细信息

您必须提供存储桶名称和复制文件步骤的目标密钥。密钥可以是路径名或文件名。将密钥视为路径名还是文件名取决于密钥是否以正斜杠 (/) 字符结尾。

如果最后一个字符是 /，则您的文件将被复制到此文件夹，并且其名称不会更改。如果最后一个字符是字母数字，则您上传的文件将被重命名为键值。在这种情况下，如果已存在具有该名称的文件，则相关行为将取决于“覆盖现有文件”字段的设置。

例如，如果您的键值是 test/，则您上传的文件将被复制到 test 文件夹。如果您的密钥值为 test/today，（并且选择了覆盖现有文件），则您上传的每个文件都将复制到该 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/*"
        }

解密文件

Amazon 存储博客上有一篇文章描述了如何加密和解密文件，使用 PGP 加密和解密文件以及。 Amazon Transfer Family

在工作流程中使用 PGP 解密

Transfer Family 内置了对 Prety Good Privacy (PGP) 解密的支持。您可以对通过 SFTP、FTPS 或 FTP 上传到 Amazon Simple Storage Service (Amazon S3) 或 Amazon Elastic File System (Amazon EFS) 的文件使用 PGP 解密。

要使用 PGP 解密，必须创建并存储用于解密文件的 PGP 私钥。然后，您的用户可以使用相应的 PGP 加密密钥对文件进行加密，然后再将文件上传到您的 Transfer Family 服务器。收到加密文件后，可以在工作流程中解密这些文件。有关详细教程，请参阅设置用于解密文件的托管工作流程。

添加解密步骤

解密步骤对作为工作流程一部分上传到 Amazon S3 或 Amazon EFS 的加密文件进行解密。有关配置解密的详细信息，请参阅 在工作流程中使用 PGP 解密。

在为工作流程创建解密步骤时，必须指定解密文件的目的地。如果目标位置已存在文件，则还必须选择是否覆盖现有文件。您可以使用 Ama CloudWatch zon Logs 监控解密工作流程结果并实时获取每个文件的审核日志。

为步骤选择解密文件类型后，将出现“配置参数”页面。填写“配置 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/*"
        }

标记文件

要标记传入文件以进行进一步的下游处理，请使用标记步骤。输入要分配给传入文件的标签值。当前，只有当您使用 Amazon S3 作为 Transfer Family 服务器存储时，才支持标签操作。

以下示例标签步骤将 scan_outcome 和 clean 分别指定为标签键和值。

若要使标记步骤成功，请确保您的工作流程的执行角色包含以下权限。

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

delete-file

要从上一个工作流程步骤中删除已处理的文件或删除最初上传的文件，请使用删除文件步骤。

若要使删除步骤成功，请确保您的工作流程的执行角色包含以下权限。

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

工作流程的命名变量

对于复制和解密步骤，您可以使用变量来动态执行操作。目前， Amazon Transfer Family 支持以下命名变量。

标记和删除工作流程示例

以下示例说明了一个工作流程，该工作流程用于标记需要由下游应用程序（例如数据分析平台）处理的传入文件。标记传入文件后，工作流程会删除最初上传的文件以节省存储成本。

Console

标记和移动工作流程示例

1. 打开 Amazon Transfer Family 控制台，网址为 https://console.aws.amazon.com/transfer/。

2. 在左侧导航窗格中，选择 工作流。

3. 在 工作流页面，选择 创建工作流。

4. 在创建工作流页面，输入描述。此描述显示在“工作流程”页面上。

5. 添加第一步（复制）。

   1. 在标称步骤部分中，选择添加步骤。

   2. 选择复制文件，然后选择 下一步。

   3. 输入步骤名称，然后选择目标存储桶和密钥前缀。

      

   4. 选择“下一步”，然后查看该步骤的详细信息。

   5. 选择“创建步骤”以添加该步骤并继续。

6. 添加第二步（标记）。

   1. 在标称步骤部分中，选择添加步骤。

   2. 选择您的标签文件，然后选择 下一步。

   3. 输入步骤名称。

   4. 在“文件位置”中，选择“标记上一步创建的文件”。

   5. 输入键和值。

      

   6. 选择“下一步”，然后查看该步骤的详细信息。

   7. 选择“创建步骤”以添加该步骤并继续。

7. 添加第三步（删除）。

   1. 在标称步骤部分中，选择添加步骤。

   2. 选择 删除文件，然后选择 下一步。

      

   3. 输入步骤名称。

   4. 在“文件位置”中，选择“删除原始源文件”。

   5. 选择“下一步”，然后查看该步骤的详细信息。

   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 位置。第二步将标签（键值对）添加到复制到新位置的文件 (previous.file)。最后，第三步删除原始文件 (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"}]}'