Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie vordefinierte Schritte

Wenn Sie einen Workflow erstellen, können Sie wählen, ob Sie einen der folgenden vordefinierten Schritte hinzufügen möchten, die in diesem Thema behandelt werden. Sie können sich auch dafür entscheiden, Ihre eigenen benutzerdefinierten Schritte zur Dateiverarbeitung hinzuzufügen. Weitere Informationen finden Sie unter Verwenden Sie benutzerdefinierte Schritte zur Dateiverarbeitung.

Datei kopieren

Bei einem Schritt zum Kopieren der Datei wird eine Kopie der hochgeladenen Datei an einem neuen Amazon S3-Speicherort erstellt. Derzeit können Sie einen Schritt zum Kopieren einer Datei nur mit Amazon S3 verwenden.

Der folgende Schritt zum Kopieren der Datei kopiert Dateien in den test Ordner inamzn-s3-demo-destination-bucket.

Wenn der Schritt „Datei kopieren“ nicht der erste Schritt Ihres Workflows ist, können Sie den Speicherort der Datei angeben. Indem Sie den Speicherort der Datei angeben, können Sie entweder die Datei kopieren, die im vorherigen Schritt verwendet wurde, oder die Originaldatei, die hochgeladen wurde. Sie können diese Funktion verwenden, um mehrere Kopien der Originaldatei zu erstellen und gleichzeitig die Quelldatei für die Dateiarchivierung und Aufbewahrung von Aufzeichnungen intakt zu halten. Ein Beispiel finden Sie unter Beispiel für einen Arbeitsablauf zum Taggen und Löschen.

Geben Sie den Bucket und die wichtigsten Details an

Sie müssen den Bucket-Namen und einen Schlüssel für das Ziel des Schritts zum Kopieren der Datei angeben. Der Schlüssel kann entweder ein Pfadname oder ein Dateiname sein. Ob der Schlüssel als Pfadname oder Dateiname behandelt wird, hängt davon ab, ob Sie den Schlüssel mit einem Schrägstrich (/) beenden.

Wenn das letzte Zeichen ein Zeichen ist/, wird Ihre Datei in den Ordner kopiert, und ihr Name ändert sich nicht. Wenn das letzte Zeichen alphanumerisch ist, wird Ihre hochgeladene Datei in den Schlüsselwert umbenannt. Wenn in diesem Fall bereits eine Datei mit diesem Namen existiert, hängt das Verhalten von der Einstellung für das Feld Bestehende überschreiben ab.

Wenn Ihr Schlüsselwert beispielsweise lautettest/, werden Ihre hochgeladenen Dateien in den test Ordner kopiert. Wenn Ihr Schlüsselwert lautet (und Bestehende überschreiben ausgewählt ist)test/today, wird jede Datei, die Sie hochladen, today in eine Datei mit dem Namen des test Ordners kopiert, und jede nachfolgende Datei überschreibt die vorherige.

Verwenden Sie eine benannte Variable in einem Schritt zum Kopieren einer Datei

In einem Schritt zum Kopieren einer Datei können Sie eine Variable verwenden, um Ihre Dateien dynamisch in benutzerspezifische Ordner zu kopieren. Derzeit können Sie ${transfer:UserName} oder ${transfer:UploadDate} als Variable verwenden, um Dateien für den jeweiligen Benutzer, der Dateien hochlädt, oder basierend auf dem aktuellen Datum an einen Zielort zu kopieren.

Wenn der Benutzer im folgenden Beispiel eine Datei richard-roe hochlädt, wird sie in den amzn-s3-demo-destination-bucket/richard-roe/processed/ Ordner kopiert. Wenn der Benutzer eine Datei mary-major hochlädt, wird sie in den amzn-s3-demo-destination-bucket/mary-major/processed/ Ordner kopiert.

Ebenso können Sie es ${transfer:UploadDate} als Variable verwenden, um Dateien an einen Zielort zu kopieren, der nach dem aktuellen Datum benannt ist. Wenn Sie im folgenden Beispiel das Ziel ${transfer:UploadDate}/processed auf den 1. Februar 2022 festlegen, werden die hochgeladenen Dateien in den amzn-s3-demo-destination-bucket/2022-02-01/processed/ Ordner kopiert.

Sie können diese beiden Variablen auch zusammen verwenden und so ihre Funktionen kombinieren. Beispielsweise könnten Sie das Zielschlüsselpräfix auf setzenfolder/${transfer:UserName}/${transfer:UploadDate}/, wodurch beispielsweise folder/marymajor/2023-01-05/ verschachtelte Ordner erstellt würden.

IAM-Berechtigungen für den Kopierschritt

Damit ein Kopierschritt erfolgreich ist, stellen Sie sicher, dass die Ausführungsrolle für Ihren Workflow die folgenden Berechtigungen enthält.

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

Entschlüsseln Sie die Datei

Der AWS Storage-Blog enthält einen Beitrag, in dem beschrieben wird, wie Sie mithilfe von Transfer Family Managed-Workflows einfach Dateien entschlüsseln, Dateien mit PGP verschlüsseln und entschlüsseln können, ohne Code zu schreiben. AWS Transfer Family

Unterstützte symmetrische Verschlüsselungsalgorithmen

Für die PGP-Entschlüsselung unterstützt Transfer Family symmetrische Verschlüsselungsalgorithmen, die zum Verschlüsseln der tatsächlichen Dateidaten in PGP-Dateien verwendet werden.

Verwenden Sie die PGP-Entschlüsselung in Ihrem Arbeitsablauf

Transfer Family bietet integrierte Unterstützung für die PGP-Entschlüsselung (Pretty Good Privacy). Sie können die PGP-Entschlüsselung für Dateien verwenden, die über SFTP, FTPS oder FTP auf Amazon Simple Storage Service (Amazon S3) oder Amazon Elastic File System (Amazon EFS) hochgeladen werden.

Um die PGP-Entschlüsselung zu verwenden, müssen Sie die privaten PGP-Schlüssel erstellen und speichern, die für die Entschlüsselung Ihrer Dateien verwendet werden. Ihre Benutzer können dann Dateien mit den entsprechenden PGP-Verschlüsselungsschlüsseln verschlüsseln, bevor sie die Dateien auf Ihren Transfer Family-Server hochladen. Nachdem Sie die verschlüsselten Dateien erhalten haben, können Sie diese Dateien in Ihrem Workflow entschlüsseln. Ein detailliertes Tutorial finden Sie unter Einen verwalteten Workflow für die Entschlüsselung einer Datei einrichten.

Hinweise zu unterstützten PGP-Algorithmen und Empfehlungen finden Sie unter. PGP-Verschlüsselungs- und Entschlüsselungsalgorithmen

Fügen Sie einen Entschlüsselungsschritt hinzu

Ein Entschlüsselungsschritt entschlüsselt eine verschlüsselte Datei, die im Rahmen Ihres Workflows auf Amazon S3 oder Amazon EFS hochgeladen wurde. Einzelheiten zur Konfiguration der Entschlüsselung finden Sie unter. Verwenden Sie die PGP-Entschlüsselung in Ihrem Arbeitsablauf

Wenn Sie den Entschlüsselungsschritt für einen Workflow erstellen, müssen Sie das Ziel für die entschlüsselten Dateien angeben. Sie müssen auch auswählen, ob vorhandene Dateien überschrieben werden sollen, wenn am Zielort bereits eine Datei vorhanden ist. Mithilfe von Amazon CloudWatch Logs können Sie die Ergebnisse des Entschlüsselungsworkflows überwachen und Prüfprotokolle für jede Datei in Echtzeit abrufen.

Nachdem Sie den Dateityp Entschlüsseln für Ihren Schritt ausgewählt haben, wird die Seite „Parameter konfigurieren“ angezeigt. Geben Sie die Werte für den Abschnitt PGP-Entschlüsselungsparameter konfigurieren ein.

Die verfügbaren Optionen lauten wie folgt:

Der folgende Screenshot zeigt ein Beispiel für die Optionen, die Sie für den Schritt zum Entschlüsseln der Datei wählen könnten.

IAM-Berechtigungen für den Entschlüsselungsschritt

Damit ein Entschlüsselungsschritt erfolgreich ist, stellen Sie sicher, dass die Ausführungsrolle für Ihren Workflow die folgenden Berechtigungen enthält.

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

Datei taggen

Verwenden Sie einen Tag-Schritt, um eingehende Dateien für die weitere Verarbeitung zu kennzeichnen. Geben Sie den Wert des Tags ein, das Sie den eingehenden Dateien zuweisen möchten. Derzeit wird der Tag-Vorgang nur unterstützt, wenn Sie Amazon S3 für Ihren Transfer Family-Serverspeicher verwenden.

Im folgenden Beispiel für einen Tag-Schritt wird der Tag-Schlüssel bzw. der Tag-Wert zugewiesenscan_outcome. clean

Damit ein Tag-Schritt erfolgreich ausgeführt werden kann, stellen Sie sicher, dass die Ausführungsrolle für Ihren Workflow die folgenden Berechtigungen enthält.

{
            "Sid": "Tag",
            "Effect": "Allow",
            "Action": [
                "s3:PutObjectTagging",
                "s3:PutObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
}

Datei löschen

Um eine verarbeitete Datei aus einem vorherigen Workflow-Schritt oder die ursprünglich hochgeladene Datei zu löschen, verwenden Sie einen Schritt zum Löschen von Dateien.

Damit ein Löschschritt erfolgreich ausgeführt werden kann, stellen Sie sicher, dass die Ausführungsrolle für Ihren Workflow die folgenden Berechtigungen enthält.

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

Benannte Variablen für Workflows

Für Kopier- und Entschlüsselungsschritte können Sie eine Variable verwenden, um Aktionen dynamisch auszuführen. AWS Transfer Family Unterstützt derzeit die folgenden benannten Variablen.

Beispiel für einen Arbeitsablauf zum Taggen und Löschen

Das folgende Beispiel veranschaulicht einen Workflow, der eingehende Dateien kennzeichnet, die von einer nachgelagerten Anwendung, z. B. einer Datenanalyseplattform, verarbeitet werden müssen. Nach dem Taggen der eingehenden Datei löscht der Workflow dann die ursprünglich hochgeladene Datei, um Speicherkosten zu sparen.

Console

Beispiel für einen Arbeitsablauf zum Taggen und Verschieben

1. Öffnen Sie die AWS Transfer Family Konsole unter https://console.aws.amazon.com/transfer/.

2. Wählen Sie im linken Navigationsbereich Workflows aus.

3. Wählen Sie auf der Seite Workflows die Option Workflow erstellen aus.

4. Geben Sie auf der Seite „Workflow erstellen“ eine Beschreibung ein. Diese Beschreibung wird auf der Workflow-Seite angezeigt.

5. Fügen Sie den ersten Schritt hinzu (Kopie).

   1. Wählen Sie im Abschnitt Nennschritte die Option Schritt hinzufügen aus.

   2. Wählen Sie „Datei kopieren“ und dann „Weiter“.

   3. Geben Sie einen Schrittnamen ein und wählen Sie dann einen Ziel-Bucket und ein Schlüsselpräfix aus.

      

   4. Wählen Sie Weiter und überprüfen Sie dann die Details für den Schritt.

   5. Wähle Schritt erstellen, um den Schritt hinzuzufügen und fortzufahren.

6. Fügen Sie den zweiten Schritt (Tag) hinzu.

   1. Wählen Sie im Abschnitt Nennschritte die Option Schritt hinzufügen aus.

   2. Wählen Sie „Datei taggen“ und dann „Weiter“.

   3. Geben Sie einen Schrittnamen ein.

   4. Wählen Sie unter Dateispeicherort die im vorherigen Schritt erstellte Datei taggen aus.

   5. Geben Sie einen Schlüssel und einen Wert ein.

      

   6. Wählen Sie Weiter und überprüfen Sie dann die Details für den Schritt.

   7. Wähle Schritt erstellen, um den Schritt hinzuzufügen und fortzufahren.

7. Fügen Sie den dritten Schritt hinzu (Löschen).

   1. Wählen Sie im Abschnitt Nennschritte die Option Schritt hinzufügen aus.

   2. Wählen Sie „Datei löschen“ und dann „Weiter“.

      

   3. Geben Sie einen Schrittnamen ein.

   4. Wählen Sie unter Dateispeicherort die Option Ursprüngliche Quelldatei löschen aus.

   5. Wählen Sie Weiter und überprüfen Sie dann die Details für den Schritt.

   6. Wähle Schritt erstellen, um den Schritt hinzuzufügen und fortzufahren.

8. Überprüfen Sie die Workflow-Konfiguration und wählen Sie dann Workflow erstellen aus.

CLI

Beispiel für einen Workflow zum Taggen und Verschieben

1. Speichern Sie den folgenden Code in einer Datei, tagAndMoveWorkflow.json z. B. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

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

   Im ersten Schritt wird die hochgeladene Datei an einen neuen Amazon S3-Speicherort kopiert. Im zweiten Schritt wird der Datei (), die an den neuen Speicherort kopiert wurde, ein Tag (Schlüssel-Wert-Paarprevious.file) hinzugefügt. Und schließlich löscht der dritte Schritt die Originaldatei (). original.file

2. Erstellen Sie einen Workflow aus der gespeicherten Datei. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

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

   Beispiel:

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

   Anmerkung

   Weitere Informationen zur Verwendung von Dateien zum Laden von Parametern finden Sie unter So laden Sie Parameter aus einer Datei.

3. Aktualisieren Sie einen vorhandenen Server.

   Anmerkung

   Bei diesem Schritt wird davon ausgegangen, dass Sie bereits über einen Transfer Family-Server verfügen und diesem einen Workflow zuordnen möchten. Falls nicht, siehe Konfiguration eines SFTP-, FTPS- oder FTP-Serverendpunkts. Ersetzen Sie jeden user input placeholder durch Ihre Informationen.

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

   Beispiel:

   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"}]}'