S3
Загрузка, скачивание, список и управление объектами в Amazon S3
Amazon S3 (Simple Storage Service — объектное хранилище AWS) — бакеты и объекты в облаке. Блок загружает, скачивает, перечисляет, удаляет и копирует объекты.
С S3 в Pailot вы можете:
- Загружать файл или текст в бакет
- Получать объект по S3 URI (предподписанный URL)
- Списывать содержимое бакета с префиксом и постраничным выводом
- Удалять объект и копировать между бакетами
Нужны ключи AWS (Amazon Web Services). Блок ставят на холст как отдельный шаг или прикрепляют к агенту.
Загрузить файл в бакет AWS S3.
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ доступа AWS |
region | string | Да | Регион AWS (например us-east-1) |
bucketName | string | Да | Имя бакета S3 |
objectKey | string | Да | Ключ объекта в S3 (например folder/filename.ext) |
file | file | Нет | Файл для загрузки |
content | string | Нет | Текст для загрузки вместо файла |
contentType | string | Нет | Заголовок Content-Type (если не задан — по файлу) |
acl | string | Нет | Список доступа (например private, public-read) |
| Параметр | Тип | Описание |
|---|
url | string | URL загруженного объекта |
metadata | object | Метаданные загрузки: ETag и location |
Получить объект из бакета AWS S3.
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ доступа AWS |
s3Uri | string | Да | URL объекта S3 |
| Параметр | Тип | Описание |
|---|
url | string | Предподписанный URL для скачивания |
metadata | object | Метаданные файла: тип, размер, имя, дата изменения |
Список объектов в бакете AWS S3.
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ доступа AWS |
region | string | Да | Регион AWS (например us-east-1) |
bucketName | string | Да | Имя бакета S3 |
prefix | string | Нет | Префикс для фильтра (например folder/) |
maxKeys | number | Нет | Максимум объектов (по умолчанию 1000) |
continuationToken | string | Нет | Токен следующей страницы |
| Параметр | Тип | Описание |
|---|
objects | array | Список объектов S3 |
↳ key | string | Ключ объекта |
↳ size | number | Размер в байтах |
↳ lastModified | string | Время последнего изменения |
↳ etag | string | ETag (Entity Tag — контрольная сумма объекта) |
metadata | object | Метаданные списка, включая постраничный вывод |
Удалить объект из бакета AWS S3.
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ доступа AWS |
region | string | Да | Регион AWS (например us-east-1) |
bucketName | string | Да | Имя бакета S3 |
objectKey | string | Да | Ключ объекта для удаления |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Объект успешно удалён |
metadata | object | Метаданные удаления |
Скопировать объект внутри бакета или между бакетами AWS S3.
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | ID ключа доступа AWS |
secretAccessKey | string | Да | Секретный ключ доступа AWS |
region | string | Да | Регион AWS (например us-east-1) |
sourceBucket | string | Да | Исходный бакет |
sourceKey | string | Да | Ключ исходного объекта |
destinationBucket | string | Да | Бакет назначения |
destinationKey | string | Да | Ключ объекта назначения |
acl | string | Нет | Список доступа копии (например private, public-read) |
| Параметр | Тип | Описание |
|---|
url | string | URL скопированного объекта |
metadata | object | Метаданные копирования |
