Расширение Amazon S3

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация

Версия: 1.1.1

Управление файлами в сегменте Amazon S3. С помощью этого расширения можно просматривать, скачивать и удалять файлы. Вы также можете создать подписанный URL для скачивания файла.

Каждый настроенный экземпляр этого расширения работает с определенной корзиной. Если у вас несколько сегментов, используйте для каждого из них настроенный экземпляр этого расширения.

Требования

Прежде чем использовать расширение из прокси-сервера API с помощью правила ExtensionCallout, необходимо:

• Получите идентификатор ключа доступа и секретный ключ доступа для сегмента Amazon S3, с которым вы будете работать.

  Они, а также название сегмента AWS и регион AWS понадобятся вам, чтобы настроить это расширение.

Об Amazon S3

Amazon Simple Storage Service (Amazon S3) – это сервис хранения объектов.

Действия

deleteFile

Удаляет указанный файл из корзины S3.

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

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

Параметры запроса

Ответ

Нет.

Свойства ответа

Нет.

downloadFile

Скачивает указанный файл из сегмента 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>

Параметры запроса

Ответ

JSON с ресурсом content, содержащим контент файла.

{
  "content":"Hello World!"
}

Свойства ответа

generateSignedURL

Создает подписанный URL для скачивания указанного файла из сегмента 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>

Параметры запроса

Ответ

JSON со строковым свойством url, содержащим сгенерированный URL.

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

Свойства ответа

listFiles

Вызывает выполнение функции AWS Lambda.

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

Если вы хотите, чтобы переменная содержала исходный код JSON, необходимо указать parsed="false" в элементе <Output>. В противном случае переменная не будет работать.

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

Параметры запроса

Нет.

Ответ

Массив названий файлов S3.

["hello_world.txt"]

Свойства ответа

Нет.

Справочник по конфигурации

При настройке и развертывании этого расширения для использования в прокси API следуйте приведенным ниже инструкциям. Инструкции по настройке расширения с помощью консоли Apigee приведены в разделе Добавление и настройка расширения.

Общие свойства расширений

Следующие свойства присутствуют для каждого расширения.

Свойства пакета расширения

Укажите значения для следующих свойств конфигурации, относящихся к этому расширению.