S3
Загрузка, скачивание, список и управление файлами S3
Amazon S3 — это высокомасштабируемый, безопасный и надежный сервис облачного хранения данных, предоставляемый Amazon Web Services. Он предназначен для хранения и извлечения любого объема данных из любой точки мира через интернет, что делает его одним из наиболее широко используемых решений облачного хранения для бизнеса любого размера.
С помощью Amazon S3 вы можете:
- Хранить неограниченные данные: Загружать файлы любого размера и типа с практически неограниченной емкостью хранения
- Получать доступ из любой точки мира: Извлекать ваши файлы из любой точки мира с низкой задержкой доступа
- Обеспечивать долговечность данных: Пользоваться долговечностью 99,999999999% (11 девяток) с автоматической репликацией данных
- Контролировать доступ: Управлять разрешениями и контролем доступа с детализированными политиками безопасности
- Масштабироваться автоматически: Обрабатывать различные рабочие нагрузки без ручного вмешательства или планирования емкости
- Интегрироваться бесшовно: Легко подключаться к другим сервисам AWS и сторонним приложениям
- Оптимизировать затраты: Выбирать из нескольких классов хранения для оптимизации затрат на основе паттернов доступа
В AACFlow интеграция S3 позволяет вашим агентам получать и получать доступ к файлам, хранящимся в ваших корзинах Amazon S3, с использованием безопасных предварительно подписанных URL. Это позволяет реализовать мощные сценарии автоматизации, такие как обработка документов, анализ хранимых данных, получение конфигурационных файлов и доступ к медиаконтенту в рамках ваших рабочих процессов. Ваши агенты могут безопасно получать файлы из S3, не раскрывая ваши учетные данные AWS, что упрощает включение облачных активов в ваши процессы автоматизации. Эта интеграция устраняет разрыв между вашим облачным хранилищем и AI-рабочими процессами, обеспечивая беспрепятственный доступ к вашим хранимым данным при сохранении лучших практик безопасности через надежные механизмы аутентификации AWS.
Интегрируйте S3 в рабочий процесс. Загружайте файлы, скачивайте объекты, просматривайте содержимое корзины, удаляйте объекты и копируйте объекты между корзинами. Требуется AWS access key и secret access key.
Загрузить файл в корзину AWS S3
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | Ваш AWS Access Key ID |
secretAccessKey | string | Да | Ваш AWS Secret Access Key |
region | string | Да | Регион AWS (например, us-east-1) |
bucketName | string | Да | Название корзины S3 (например, my-bucket) |
objectKey | string | Да | Ключ/путь объекта в S3 (например, folder/filename.ext) |
file | file | Нет | Файл для загрузки |
content | string | Нет | Текстовое содержимое для загрузки (альтернатива файлу) |
contentType | string | Нет | Заголовок Content-Type (автоматически определяется из файла, если не указан) |
acl | string | Нет | Список контроля доступа (например, private, public-read) |
| Параметр | Тип | Описание |
|---|
url | string | URL загруженного объекта S3 |
uri | string | URI S3 загруженного объекта (s3://bucket/key) |
metadata | object | Метаданные загрузки, включая ETag и местоположение |
Получить объект из корзины AWS S3
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | Ваш AWS Access Key ID |
secretAccessKey | string | Да | Ваш AWS Secret Access Key |
region | string | Нет | Опциональное переопределение региона, когда URL не включает регион (например, us-east-1, eu-west-1) |
s3Uri | string | Да | URL объекта S3 (например, https://bucket.s3.region.amazonaws.com/path/to/file) |
| Параметр | Тип | Описание |
|---|
url | string | Предварительно подписанный URL для скачивания объекта S3 |
file | file | Скачанный файл, сохраненный в файлах выполнения |
metadata | object | Метаданные файла, включая тип, размер, имя и дату последнего изменения |
Список объектов в корзине AWS S3
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | Ваш AWS Access Key ID |
secretAccessKey | string | Да | Ваш AWS Secret Access Key |
region | string | Да | Регион AWS (например, us-east-1) |
bucketName | string | Да | Название корзины S3 (например, my-bucket) |
prefix | string | Нет | Префикс для фильтрации объектов (например, folder/, images/2024/) |
maxKeys | number | Нет | Максимальное количество объектов для возврата (по умолчанию: 1000) |
continuationToken | string | Нет | Токен для пагинации из предыдущего ответа списка |
| Параметр | Тип | Описание |
|---|
objects | array | Список объектов S3 |
↳ key | string | Ключ объекта |
↳ size | number | Размер объекта в байтах |
↳ lastModified | string | Метка времени последнего изменения |
↳ etag | string | Тег сущности |
metadata | object | Метаданные списка, включая информацию о пагинации |
Удалить объект из корзины AWS S3
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | Ваш AWS Access Key ID |
secretAccessKey | string | Да | Ваш AWS Secret Access Key |
region | string | Да | Регион AWS (например, us-east-1) |
bucketName | string | Да | Название корзины S3 (например, my-bucket) |
objectKey | string | Да | Ключ/путь объекта для удаления (например, folder/file.txt) |
| Параметр | Тип | Описание |
|---|
deleted | boolean | Был ли объект успешно удален |
metadata | object | Метаданные удаления |
Копировать объект внутри или между корзинами AWS S3
| Параметр | Тип | Обязательный | Описание |
|---|
accessKeyId | string | Да | Ваш AWS Access Key ID |
secretAccessKey | string | Да | Ваш AWS Secret Access Key |
region | string | Да | Регион AWS (например, us-east-1) |
sourceBucket | string | Да | Название исходной корзины (например, my-bucket) |
sourceKey | string | Да | Ключ/путь исходного объекта (например, folder/file.txt) |
destinationBucket | string | Да | Название целевой корзины (например, my-other-bucket) |
destinationKey | string | Да | Ключ/путь целевого объекта (например, backup/file.txt) |
acl | string | Нет | Список контроля доступа для скопированного объекта (например, private, public-read) |
| Параметр | Тип | Описание |
|---|
url | string | URL скопированного объекта S3 |
uri | string | URI S3 скопированного объекта (s3://bucket/key) |
metadata | object | Метаданные операции копирования |
