Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizza passaggi predefiniti

Quando crei un flusso di lavoro, puoi scegliere di aggiungere uno dei seguenti passaggi predefiniti descritti in questo argomento. Puoi anche scegliere di aggiungere fasi personalizzate di elaborazione dei file. Per ulteriori informazioni, consulta Utilizza passaggi di elaborazione dei file personalizzati.

Copia il file

Una fase di copia del file crea una copia del file caricato in una nuova posizione Amazon S3. Attualmente, puoi utilizzare una fase di copia del file solo con Amazon S3.

La seguente fase di copia del file copia i file nella test cartella nel bucket di file-test destinazione.

Se la fase di copia del file non è la prima fase del flusso di lavoro, puoi specificare la posizione del file. Specificando la posizione del file, è possibile copiare il file utilizzato nel passaggio precedente o il file originale caricato. È possibile utilizzare questa funzione per creare più copie del file originale mantenendo intatto il file sorgente per l'archiviazione dei file e la conservazione dei record. Per vedere un esempio, consulta Esempio di flusso di lavoro di etichettatura ed eliminazione.

Fornisci il bucket e i dettagli chiave

È necessario fornire il nome del bucket e una chiave per la destinazione della fase di copia del file. La chiave può essere un nome di percorso o un nome di file. Il fatto che la chiave venga considerata come un nome di percorso o un nome di file dipende dal fatto che terminiate la chiave con il carattere forward slash (/).

Se il carattere finale è/, il file viene copiato nella cartella e il suo nome non cambia. Se il carattere finale è alfanumerico, il file caricato viene rinominato con il valore chiave. In questo caso, se esiste già un file con quel nome, il comportamento dipende dall'impostazione del campo Sovrascrivi esistente.

Ad esempio, se il valore chiave ètest/, i file caricati vengono copiati nella cartella. test Se il valore della chiave ètest/today, (e l'opzione Sovrascrivi esistente è selezionata) ogni file caricato viene copiato in un file denominato today nella test cartella e ogni file successivo sovrascrive quello precedente.

Utilizzate una variabile denominata in una fase di copia del file

In una fase di copia del file, è possibile utilizzare una variabile per copiare dinamicamente i file in cartelle specifiche dell'utente. Attualmente, puoi utilizzare ${transfer:UserName} or ${transfer:UploadDate} come variabile per copiare i file in una posizione di destinazione per un determinato utente che sta caricando i file o in base alla data corrente.

Nell'esempio seguente, se l'utente richard-roe carica un file, questo viene copiato nella cartella. file-test2/richard-roe/processed/ Se l'utente mary-major carica un file, questo viene copiato nella cartella. file-test2/mary-major/processed/

Allo stesso modo, è possibile utilizzarlo ${transfer:UploadDate} come variabile per copiare i file in una posizione di destinazione denominata in base alla data corrente. Nell'esempio seguente, se impostate la destinazione ${transfer:UploadDate}/processed sul 1° febbraio 2022, i file caricati vengono copiati nella file-test2/2022-02-01/processed/ cartella.

È inoltre possibile utilizzare entrambe queste variabili insieme, combinandone le funzionalità. Per esempio:

IAMautorizzazioni per la fase di copia

Per consentire il completamento di una fase di copia, assicurati che il ruolo di esecuzione per il tuo flusso di lavoro contenga le seguenti autorizzazioni.

{
            "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/*"
        }

Decrittografa il file

Il blog AWS sullo storage ha pubblicato un post che descrive come crittografare e decrittografare i file, crittografare e decrittografare i file con e. PGP AWS Transfer Family

PGPUsa la decrittografia nel tuo flusso di lavoro

Transfer Family ha il supporto integrato per la decrittografia Pretty Good Privacy (PGP). Puoi utilizzare la PGP decrittografia su file caricati su o su SFTP Amazon Simple Storage Service (FTPAmazon S3) o Amazon Elastic File System (Amazon). FTPS EFS

Per utilizzare la PGP decrittografia, devi creare e archiviare le chiavi PGP private che verranno utilizzate per la decrittografia dei file. I tuoi utenti possono quindi crittografare i file utilizzando le chiavi di PGP crittografia corrispondenti prima di caricare i file sul server Transfer Family. Dopo aver ricevuto i file crittografati, puoi decrittografarli nel tuo flusso di lavoro. Per un tutorial dettagliato, consulta Configurazione di un flusso di lavoro gestito per la decrittografia di un file.

Aggiungi una fase di decrittografia

Una fase di decrittografia decrittografa un file crittografato che è stato caricato su Amazon S3 o Amazon EFS come parte del tuo flusso di lavoro. Per dettagli sulla configurazione della decrittografia, consulta. PGPUsa la decrittografia nel tuo flusso di lavoro

Quando si crea la fase di decrittografia per un flusso di lavoro, è necessario specificare la destinazione dei file decrittografati. È inoltre necessario selezionare se sovrascrivere i file esistenti se un file esiste già nella posizione di destinazione. Puoi monitorare i risultati del flusso di lavoro di decrittografia e ottenere log di controllo per ogni file in tempo reale utilizzando Amazon Logs. CloudWatch

Dopo aver scelto il tipo di file Decrypt per il passaggio, viene visualizzata la pagina Configura parametri. Inserisci i valori per la sezione Configura i parametri di PGP decrittografia.

Le opzioni disponibili sono le seguenti:

La schermata seguente mostra un esempio delle opzioni che è possibile scegliere per la fase di decrittografia del file.

IAMautorizzazioni per la fase di decrittografia

Per consentire il completamento di una fase di decrittografia, assicurati che il ruolo di esecuzione per il tuo flusso di lavoro contenga le seguenti autorizzazioni.

{
            "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/*"
        }

Tag: file

Per etichettare i file in arrivo per un'ulteriore elaborazione a valle, utilizzate un passaggio di tag. Immettete il valore del tag che desiderate assegnare ai file in arrivo. Attualmente, l'operazione di tag è supportata solo se utilizzi Amazon S3 per lo storage del server Transfer Family.

Il seguente esempio di tag step assegna scan_outcome e clean come tag, rispettivamente, la chiave e il valore.

Per consentire il corretto funzionamento di un passaggio di tag, assicuratevi che il ruolo di esecuzione per il flusso di lavoro contenga le seguenti autorizzazioni.

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

Eliminare il file

Per eliminare un file elaborato da una fase precedente del flusso di lavoro o per eliminare il file originariamente caricato, utilizzate un passaggio di eliminazione del file.

Per consentire il completamento di un passaggio di eliminazione, assicurati che il ruolo di esecuzione per il flusso di lavoro contenga le seguenti autorizzazioni.

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

Variabili denominate per i flussi di lavoro

Per le fasi di copia e decrittografia, puoi utilizzare una variabile per eseguire azioni in modo dinamico. Attualmente, AWS Transfer Family supporta le seguenti variabili denominate.

Esempio di flusso di lavoro di etichettatura ed eliminazione

L'esempio seguente illustra un flusso di lavoro che contrassegna i file in entrata che devono essere elaborati da un'applicazione a valle, ad esempio una piattaforma di analisi dei dati. Dopo aver taggato il file in arrivo, il flusso di lavoro elimina quindi il file originariamente caricato per risparmiare sui costi di archiviazione.

Console

Esempio di flusso di lavoro con tag e spostamento

1. Apri la AWS Transfer Family console all'indirizzo https://console.aws.amazon.com/transfer/.

2. Nel riquadro di navigazione a sinistra, scegli Flussi di lavoro.

3. Nella pagina Flussi di lavoro, scegli Crea flusso di lavoro.

4. Nella pagina Crea flusso di lavoro, inserisci una descrizione. Questa descrizione viene visualizzata nella pagina Flussi di lavoro.

5. Aggiungi il primo passaggio (copia).

   1. Nella sezione Passaggi nominali, scegli Aggiungi passaggio.

   2. Scegli Copia file, quindi scegli Avanti.

   3. Inserisci un nome per la fase, quindi seleziona un bucket di destinazione e un key prefix.

      

   4. Scegli Avanti, quindi esamina i dettagli del passaggio.

   5. Scegli Crea passaggio per aggiungere il passaggio e continuare.

6. Aggiungi il secondo passaggio (tag).

   1. Nella sezione Passaggi nominali, scegli Aggiungi passaggio.

   2. Scegli Tag file, quindi scegli Avanti.

   3. Inserisci un nome per la fase.

   4. In Posizione del file, seleziona Etichetta il file creato nel passaggio precedente.

   5. Inserisci una Key (chiave) e un Value (valore).

      

   6. Scegli Avanti, quindi esamina i dettagli del passaggio.

   7. Scegli Crea passaggio per aggiungere il passaggio e continuare.

7. Aggiungi il terzo passaggio (elimina).

   1. Nella sezione Passaggi nominali, scegli Aggiungi passaggio.

   2. Scegli Elimina file, quindi scegli Avanti.

      

   3. Inserisci un nome per la fase.

   4. Per Posizione del file, seleziona Elimina il file sorgente originale.

   5. Scegli Avanti, quindi esamina i dettagli del passaggio.

   6. Scegli Crea passaggio per aggiungere il passaggio e continuare.

8. Rivedi la configurazione del flusso di lavoro, quindi scegli Crea flusso di lavoro.

CLI

Esempio di workflow di tag e spostamento

1. Salva il codice seguente in un file; ad esempio,tagAndMoveWorkflow.json. Sostituisci ogni user input placeholder con le tue informazioni.

   [
      {
          "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}"
         }
     }
   ]

   Il primo passaggio copia il file caricato in una nuova posizione Amazon S3. Il secondo passaggio aggiunge un tag (coppia chiave-valore) al file (previous.file) che è stato copiato nella nuova posizione. Infine, il terzo passaggio elimina il file originale (). original.file

2. Crea un flusso di lavoro dal file salvato. Sostituisci ogni user input placeholder con le tue informazioni.

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

   Per esempio:

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

   Nota

   Per maggiori dettagli sull'utilizzo dei file per caricare i parametri, vedete Come caricare i parametri da un file.

3. Aggiorna un server esistente.

   Nota

   Questo passaggio presuppone che tu disponga già di un server Transfer Family e desideri associarvi un flusso di lavoro. In caso contrario, vediConfigurazione di un endpoint SFTPFTPS, o server FTP. Sostituisci ogni user input placeholder con le tue informazioni.

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

   Per esempio:

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