Amazon S3-Erweiterung

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Version: 2.0.1

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 funktioniert mit einem bestimmten Bucket. Verwenden Sie für mehrere Buckets eine konfigurierte Instanz dieser Erweiterung für jeden Bucket.

Vorbereitung

Bevor Sie die Erweiterung über einen API-Proxy mit der ExtensionCallout-Richtlinie verwenden, müssen Sie Folgendes tun:

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

Sie benötigen diese zusammen mit dem AWS-Bucket-Namen 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.

Antwortattribute

Keine.

downloadFile

Lädt die angegebene Datei aus einem S3-Bucket herunter.

<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!"
}

Antwortattribute

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

Antwortattribute

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 Element <Output> angeben, wenn die Variable das Roh-JSON enthalten soll. Andernfalls ist die Variable nicht verwendbar.

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

Anfrageparameter

Keine.

Antwort

Ein Array von S3-Dateinamen.

["hello_world.txt"]

Antwortattribute

Keine.

Konfigurationsreferenz

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

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