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

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

Версия: 2.0.1

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

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

Предпосылки

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

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

Они вам понадобятся, а также имя контейнера AWS и регион AWS, для настройки этого расширения.

О Amazon S3

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

Действия

удалитьФайл

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

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

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

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

Ответ

Никто.

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

Никто.

скачатьФайл

Загружает указанный файл из контейнера 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!"
}

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

сгенерироватьSignedURL

Генерирует подписанный 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"
}

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

списокФайлы

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

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

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

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

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

Никто.

Ответ

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

["hello_world.txt"]

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

Никто.

Ссылка на конфигурацию

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

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

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

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

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