Moduli AWS S3

I moduli S3 di Adobe Workfront Fusion AWS consentono di eseguire operazioni sui bucket S3.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront

Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront.

Workfront Ultimate

Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion.

Licenze Adobe Workfront

Standard

Work o successiva

Licenza di Adobe Workfront Fusion

Basata sulle operazioni: nessun requisito di licenza Workfront Fusion

Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration

Prodotto Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.

Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.

Prerequisiti

Per utilizzare i moduli AWS S3, è necessario disporre di un account Amazon Web Service.

Informazioni sull’API di AWS S3

Il connettore AWS S3 utilizza quanto segue:

URL di base
code language-none
https://s3.{{parameters.region}}.amazonaws.com
Tag API
v1.5.21

Connettere AWS a Workfront Fusion connect-aws-to-workfront-fusion

Per connettere AWS S3 a Workfront Fusion è necessario connettere l’account AWS a Workfront Fusion. A tale scopo, è innanzitutto necessario creare un utente API in AWS IAM.

  1. Accedi al tuo account AWS IAM.

  2. Passa a Gestione identità e accessi > Gestione accessi > Utenti.

  3. Fare clic su Aggiungi utente.

  4. Immettere il nome del nuovo utente e selezionare l’opzione Accesso a livello di codice nella sezione Tipo di accesso.

  5. Fai clic su Allega direttamente i criteri esistenti, quindi cerca AmazonS3FullAccess nella barra di ricerca. Fare clic su di esso quando viene visualizzato, quindi fare clic su Avanti.

  6. Passare alle altre finestre di dialogo, quindi fare clic su Crea utente.

  7. Copia l’ID chiave di accesso e la Chiave di accesso segreta forniti.

  8. Passare a Workfront Fusion e aprire la finestra di dialogo Crea connessione del modulo AWS S3.

  9. Immetti l’ID chiave di accesso e la Chiave di accesso segreta dal passaggio 7 ai rispettivi campi e fai clic su Continua per stabilire la connessione.

La connessione è stata stabilita. Puoi procedere con la configurazione del modulo.

Moduli AWS S3 e relativi campi

Quando configuri i moduli AWS S3, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati altri campi di AWS S3, a seconda di fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.

Pulsante di attivazione/disattivazione Mappa

Azioni

Crea bucket

Questo modulo di azione crea un bucket in AWS.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Nome
Immetti il nome del nuovo bucket.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.

Ottieni file

Questo modulo di azione scarica un file da un bucket.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Bucket
Seleziona il bucket da cui desideri scaricare il file.
Percorso
Immettere il percorso del file. Esempio: /photos/2019/February/image023.jpg.

Effettuare una chiamata API

Questo modulo di azione effettua una chiamata personalizzata all’API AWS S3.

Per informazioni dettagliate sull’API Amazon S3, vedere Amazon S3 REST Introduzione all’API.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
URL
Immetti un URL host. Il percorso deve essere relativo a https://s3.<selected-region>.amazonaws.com/.
Metodo
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere HTTP metodi di richiesta in Adobe Workfront Fusion.
Intestazioni

Aggiungi un’intestazione di richiesta. Per ogni intestazione che si desidera aggiungere, fare clic su Aggiungi elemento e immettere l'intestazione. Puoi utilizzare le seguenti intestazioni di richiesta comuni. Per ulteriori intestazioni di richiesta fare riferimento alla documentazione API AWS S3.

Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.

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
Nome intestazione Descrizione
Content-Length Lunghezza del messaggio (senza intestazioni) in base alla RFC 2616. Questa intestazione è necessaria per PUTs e le operazioni di caricamento di XML, ad esempio log e ACL.
Content-Type Il tipo di contenuto della risorsa, nel caso in cui il contenuto della richiesta sia nel corpo. Esempio: text/plain.
Content-MD5 Il digest MD5 a 128 bit codificato in base a base64 del messaggio (senza le intestazioni) in base alla RFC 1864. Questa intestazione può essere utilizzata come controllo di integrità del messaggio per verificare che i dati siano gli stessi dati inviati originariamente. Sebbene sia opzionale, si consiglia di utilizzare il meccanismo Content-MD5 come controllo di integrità end-to-end. Per ulteriori informazioni sull'autenticazione delle richieste REST, vedere Firma e autenticazione delle richieste REST nella documentazione di AWS.
Date Data e ora correnti in base al richiedente. Esempio: Wed, 01 Mar 2006 12:00:00 GMT. Quando si specifica l'intestazione Authorization , è necessario specificare l'intestazione x-amz-date o Date .
expected

Quando l'applicazione utilizza 100-continue, non invia il corpo della richiesta finché non riceve una conferma. Se il messaggio viene rifiutato in base alle intestazioni, il corpo del messaggio non viene inviato. Questa intestazione può essere utilizzata solo se invii un corpo.

Valori validi: 100-continue

Host

Per le richieste di tipo percorso, il valore è s3.amazonaws.com. Per le richieste in stile virtuale, il valore è BucketName.s3.amazonaws.com. Per ulteriori informazioni, vedi Hosting virtuale nella documentazione di AWS.

Questa intestazione è obbligatoria per HTTP 1.1 (la maggior parte dei toolkit aggiunge questa intestazione automaticamente); facoltativa per le richieste HTTP/1.0.

x-amz-content-sha256 Quando si utilizza la firma versione 4 per autenticare la richiesta, questa intestazione fornisce un hash del payload della richiesta. Quando si carica un oggetto in blocchi, impostare il valore su STREAMING-AWS4-HMAC-SHA256-PAYLOAD per indicare che la firma copre solo le intestazioni e che non è presente alcun payload. Per ulteriori informazioni, consulta Calcoli della firma per l'intestazione di autorizzazione nella documentazione di AWS.
x-amz-date Data e ora correnti in base al richiedente. Esempio: Wed, 01 Mar 2006 12:00:00 GMT. Quando si specifica l'intestazione Authorization , è necessario specificare l'intestazione x-amz-date o Date . Se si specificano entrambi, il valore specificato per l'intestazione x-amz-date ha la precedenza.
x-amz-security-token

Questa intestazione può essere utilizzata nei seguenti scenari:

  • Fornire token di sicurezza per le operazioni Amazon DevPay. Ogni richiesta che utilizza Amazon DevPay richiede due intestazioni x-amz-security-token: una per il token di prodotto e una per il token utente. Quando Amazon S3 riceve una richiesta autenticata, confronta la firma calcolata con la firma fornita. Le intestazioni con più valori formattate in modo non corretto utilizzate per calcolare una firma possono causare problemi di autenticazione.
  • Fornisci un token di sicurezza quando utilizzi credenziali di sicurezza temporanee. Quando effettui richieste utilizzando le credenziali di sicurezza temporanee ottenute da IAM, devi fornire un token di sicurezza utilizzando questa intestazione. Per ulteriori informazioni sulle credenziali di sicurezza temporanee, vedere Creazione di richieste.

Questa intestazione è necessaria per le richieste che utilizzano Amazon DevPay e per le richieste firmate utilizzando credenziali di sicurezza temporanee.

Stringa di query
Aggiungi le stringhe di query desiderate, ad esempio parametri o campi modulo.
Corpo

Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.

Carica file

Questo modulo di azione carica un file in un bucket AWS S3.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Cartella
Specificare la cartella di destinazione in cui si desidera caricare un file.
File di origine
Seleziona un file di origine da un modulo precedente oppure mappa il nome e i dati del file di origine.
Headers (facoltativo)

Per ogni intestazione da aggiungere, fare clic su Aggiungi elemento e immettere la chiave e il valore dell'intestazione.

Per le intestazioni disponibili, vedi PutObject nella documentazione di AWS.

Ricerche

File di elenco

Restituisce un elenco di file da una posizione specificata.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Bucket
Selezionare il bucket Amazon S3 in cui cercare i file.
Prefix
Immetti il percorso di una cartella in cui cercare i file, ad esempio workfrontfusion/work.

Cartelle elenco

Restituisce un elenco di cartelle da una posizione specificata.

Connessione
Per istruzioni sulla connessione dell’account AWS a Workfront Fusion, consulta Connettere AWS a Workfront Fusion in questo articolo.
Region
Seleziona l’endpoint regionale. Per ulteriori informazioni, consulta endpoint regionali nella documentazione di AWS.
Bucket
Selezionare il bucket Amazon S3 in cui si desidera cercare le cartelle.
Prefix (facoltativo)
Percorso di una cartella in cui cercare le cartelle, ad esempio workfrontfusion/work.
recommendation-more-help
workfront-fusion-help-workfront-fusion