Amazon S3-Erweiterung

Sie sehen die Dokumentation zu Apigee Edge.
Sehen Sie sich die Apigee X-Dokumentation an. info

Version: 1.1.0

Dateien in einem Amazon S3-Bucket verwalten Mit dieser Erweiterung können Sie Dateien auflisten, herunterladen und löschen. Sie können auch eine signierte URL zum Herunterladen einer Datei generieren.

Jede konfigurierte Instanz dieser Erweiterung arbeitet mit einem bestimmten Bucket. Verwenden Sie bei mehreren Buckets eine konfigurierte Instanz dieser Erweiterung für jeden Bucket.

Vorbereitung

Bevor Sie die Erweiterung über einen API-Proxy mithilfe der ExtensionCallout-Richtlinie verwenden können, müssen Sie:

• Rufen Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel für den Amazon S3-Bucket ab, mit dem Sie arbeiten werden.

  Sie benötigen diese zusammen mit dem Namen des AWS-Buckets und der AWS-Region, um diese Erweiterung zu konfigurieren.

Amazon S3

Amazon Simple Storage Service (Amazon S3) ist ein Objektspeicherdienst.

Aktionen

deleteFile

Löscht die angegebene Datei aus einem S3-Bucket.

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

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

Anfrageparameter

Antwort

Keine.

Antworteigenschaften

Keine.

downloadFile

Die angegebene Datei wird aus einem S3-Bucket heruntergeladen.

<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>

Anfrageparameter

Antwort

JSON mit einem content-Attribut, das den Inhalt der Datei enthält.

{
  "content":"Hello World!"
}

Antworteigenschaften

generateSignedURL

Generiert eine signierte URL zum Herunterladen der angegebenen Datei aus einem S3-Bucket.

<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>

Anfrageparameter

Antwort

JSON mit einem url-Stringattribut, das die generierte URL enthält.

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

Antworteigenschaften

listFiles

Ruft die Ausführung einer AWS Lambda-Funktion auf.

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

Sie müssen parsed="false" für das <Output>-Element angeben, wenn Sie Variable für die JSON-Rohdaten. Andernfalls kann die Variable nicht verwendet werden.

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

Anfrageparameter

Keine.

Antwort

Ein Array mit S3-Dateinamen.

["hello_world.txt"]

Antworteigenschaften

Keine.

Konfigurationsreferenz

Beachten Sie Folgendes, wenn Sie diese Erweiterung für die Verwendung in API-Proxys konfigurieren und bereitstellen. Eine schrittweise Anleitung zum Konfigurieren einer Erweiterung mit der Apigee-Konsole finden Sie unter Erweiterung hinzufügen und konfigurieren.

Gemeinsame Erweiterungseigenschaften

Für jede Erweiterung sind die folgenden Eigenschaften vorhanden.

Eigenschaften für dieses Erweiterungspaket

Geben Sie Werte für die folgenden Konfigurationseigenschaften an, die für diese Erweiterung spezifisch sind.