Estensione Amazon S3

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Versione: 1.1.2

Gestisci i file in un bucket Amazon S3. Con questa estensione puoi elencare, scaricare ed eliminare i file. Puoi anche generare un URL firmato per scaricare un file.

Ogni istanza configurata di questa estensione funziona con un bucket specifico. Per più bucket, utilizza un'istanza configurata di questa estensione per ogni bucket.

Prerequisiti

Prima di utilizzare l'estensione da un proxy API utilizzando il criterio ExtensionCallout, devi:

• Recuperare l'ID chiave di accesso e la chiave di accesso segreta per il bucket Amazon S3 con cui lavorerai.

  Per configurare questa estensione, avrai bisogno di questi dati, oltre al nome del bucket AWS e alla regione AWS, per configurare questa estensione.

Informazioni su Amazon S3

Amazon Simple Storage Service (Amazon S3) è un servizio di archiviazione di oggetti.

Azioni

deleteFile

Elimina il file specificato da un bucket S3.

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "name-of-file-to-delete"
}
]]>
</Input>

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "names.tmp"
}
]]>
</Input>

Parametri di richiesta

Risposta

Nessuno.

Proprietà di risposta

Nessuno.

downloadFile

Scarica il file specificato da un bucket S3.

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "filename"
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "product-sheet.pdf"
}
]]>
</Input>
<Output>downloaded.file</Output>

Parametri di richiesta

Risposta

JSON con una proprietà content contenente i contenuti del file.

{
  "content":"Hello World!"
}

Proprietà di risposta

generateSignedURL

Genera un URL firmato per scaricare il file specificato da un bucket S3.

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "filename",
  "expiresIn": duration-in-seconds
}
]]>
</Input>
<Output>flow-variable</Output>

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "product-info.pdf",
  "expiresIn": 3600
}
]]>
</Input>
<Output>download.url</Output>

Parametri di richiesta

Risposta

JSON con una proprietà stringa url contenente l'URL generato.

{
  "url":"https://fake.s3.amazonaws.com/hello_world.txt?AWSAccessKeyId=123&Expires=1542753572&Signature=ABC"
}

Proprietà di risposta

listFiles

Richiama l'esecuzione di una funzione AWS Lambda.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>

Devi specificare parsed="false" nell'elemento <Output> se vuoi che la variabile contenga il JSON non elaborato. In caso contrario, la variabile non è utilizzabile.

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">listFilesOutput</Output>

Parametri di richiesta

Nessuno.

Risposta

Un array di nomi di file S3.

["hello_world.txt"]

Proprietà di risposta

Nessuno.

Riferimento per la configurazione

Utilizza le seguenti informazioni quando configuri ed esegui il deployment di questa estensione per l'utilizzo nei proxy API. Per i passaggi per configurare un'estensione utilizzando la console Apigee, vedi Aggiungere e configurare un'estensione.

Proprietà comuni delle estensioni

Per ogni estensione sono presenti le seguenti proprietà.

Proprietà per questo pacchetto di estensioni

Specifica i valori per le seguenti proprietà di configurazione specifiche per questa estensione.