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

Перед использованием Хранилище приложения подключите проект к Atoms Cloud. Если он не подключен, попросите Agent подключить Atoms Cloud или перейдите по ссылке Atoms Cloud.

Понимание Хранилище приложения в Atoms Cloud

Хранилище приложения хранит файлы, которые вашему проекту нужно сохранять и к которым нужен доступ. Оно отделено от структурированных данных, хранящихся в вашей База данных, файлов, загруженных в Chat, и файлов, из которых состоит код вашего проекта.

Ключевые термины

• Bucket: Основной контейнер, используемый для хранения и группировки связанных файлов. Bucket можно представить как область хранения для одной категории файлов. Каждый bucket имеет тип Public или Private, который определяет, кто может получать доступ к файлам внутри него.
• Folder: Необязательный способ организации файлов внутри bucket. Folder работают как папки на вашем компьютере и помогают упростить управление большими коллекциями файлов.
• Object: Отдельный файл, хранящийся в bucket или folder, например изображение, документ, видео или другой загруженный файл.
• Object key: Уникальный путь, используемый для определения места хранения файла внутри bucket. Например, images/profile/avatar.png может быть object key для изображения, хранящегося в папке images/profile.

Выберите Public или Private

Выберите тип bucket перед его созданием:

Тип bucket	Используйте для
Private	Конфиденциальные, привязанные к аккаунту или загруженные пользователями файлы.
Public	Неконфиденциальные файлы, которые намеренно безопасно делать общедоступными.

Используйте Private для конфиденциальных или пользовательских файлов. Если вы столкнулись с ошибкой доступа, не меняйте bucket на Public только для того, чтобы сделать файл доступным. Вместо этого убедитесь, что ваше приложение проверяет, есть ли у человека, запрашивающего файл, разрешение на доступ к нему.

Откройте Хранилище приложения в Atoms Cloud

1. Откройте свой проект на настольном устройстве.
2. На той же панели инструментов рабочего пространства, где находится Просмотр приложений , выберите Atoms Cloud.
3. Выберите Хранилище приложения на боковой панели Atoms Cloud.

Разрешения в Хранилище приложения

Хранилище приложения использует вашу роль в рабочем пространстве. И Editors, и владельцы рабочего пространства могут управлять хранилищем для проектов, которые они могут открыть. Люди, не являющиеся участниками рабочего пространства, не могут открывать Хранилище приложения проекта или управлять им.

Настройка Public или Private у bucket не меняет, кто может управлять им в Atoms Cloud. Эта настройка определяет, как запущенное приложение может предоставлять доступ к файлам; разрешения рабочего пространства определяют, кто может управлять хранилищем из рабочего пространства Atoms Cloud.

Создайте bucket

Приложение может иметь до 10 buckets. Создавайте отдельные buckets, когда разным группам файлов нужны разные настройки доступа или когда их следует хранить отдельно для более удобной организации.

1. На странице Хранилище приложения выберите Create Bucket.
2. В разделе Bucket Name введите уникальное имя для bucket. Имя должно:
   • содержать 3–63 символа;
   • содержать только строчные буквы, цифры и дефисы; и
   • начинаться и заканчиваться буквой или цифрой.
3. В разделе Bucket Type выберите Private или Public. По умолчанию выбрано Public, поэтому перед продолжением обязательно выберите нужный вам уровень доступа.
4. Выберите Create.

Новый bucket появится на странице Хранилище приложения со своим именем, типом и датой создания. Выберите bucket, чтобы открыть его и просмотреть его содержимое.

Выберите Create Bucket в Хранилище приложения.

Имена bucket нельзя изменить после создания, поэтому выберите понятное имя, которое не потребуется менять позже. Если в вашем приложении уже есть 10 buckets, Create Bucket больше не будет доступно.

Загрузка и организация файлов

Внутри bucket вы можете загружать файлы напрямую или создать пустую folder, не загружая сначала никаких файлов.

Создайте новую папку

1. Откройте bucket или folder, где вы хотите создать новую папку.
2. Выберите Add Folder.
3. Введите имя папки, затем выберите Create. Имена папок могут содержать буквы, цифры, точки (.), дефисы (-) и символы подчеркивания (_), а также быть не длиннее 100 characters. Имена папок нельзя изменить после создания.

Назовите папку, затем выберите Create.

Загрузите файлы

1. Откройте bucket или folder, где вы хотите хранить файлы.
2. Выберите Upload, затем выберите один или несколько файлов на вашем устройстве. Размер каждого файла может быть до 100 MB.
3. Дождитесь завершения загрузки, затем убедитесь, что файлы появились в списке.

Список файлов показывает Name, Type, Size, дату Last Modified и доступные Actions для каждого элемента. Если вам нужно перезагрузить содержимое текущей папки, выберите кнопку refresh.

Загрузите файлы в выбранный bucket или folder.

Предпросмотр и управление файлами

Выберите файл, чтобы открыть File Details. Поддерживаемые изображения и видео можно просматривать в панели. Для других типов файлов отображаются доступные сведения, и их все равно можно скачать. Если все кредиты израсходованы, File Details показывает состояние исчерпания кредитов, а Download для одного файла направляет вас на Обновить вместо скачивания.

Управление одним файлом

Откройте ... в столбце Actions файла, затем выберите:

• Download, чтобы сохранить локальную копию, когда доступны кредиты. Если все кредиты израсходованы, это действие вместо этого направит вас на Обновить.
• Rename, чтобы изменить имя файла. Новое имя может содержать буквы, цифры, точки, дефисы и символы подчеркивания.
• Delete, чтобы удалить файл после подтверждения.

Используйте меню действий файла, чтобы скачать, переименовать или удалить его.

Управление несколькими файлами

1. Установите флажок рядом с каждым файлом. Папки не включаются в пакетное выделение.
2. Выберите Download, чтобы скачать выбранные файлы вместе, или выберите Delete.
3. При удалении проверьте количество выбранных файлов и подтвердите Delete.

Удаление нельзя отменить из Хранилище приложения. Перед переименованием или удалением файла проверьте, использует ли приложение его object key. После этого обновите все сохраненные ссылки, чтобы приложение не продолжало запрашивать старый key.

Используйте сохраненный файл в своем приложении

Ваше приложение определяет каждый сохраненный файл с помощью его bucket name и object key. Object key показывает, где файл находится внутри bucket. Например, images/profile/avatar.png может быть object key для изображения, хранящегося в папке images/profile.

Сохраните bucket name и object key в базе данных вашего приложения, чтобы приложение могло позже найти файл. Когда вашему приложению нужно отобразить или скачать файл, оно может использовать эти данные, чтобы запросить URL доступа.

URL доступа могут быть временными. Не сохраняйте их как постоянные данные приложения, не прописывайте их жестко в приложении и не делитесь ими в Chat, скриншотах, логах или сообщениях в поддержку. Вместо этого сохраняйте object key и запрашивайте новый URL доступа, когда к файлу нужно получить доступ.

Не храните API-ключи, пароли или другие учетные данные в Хранилище приложения. Храните приватные учетные данные времени выполнения в Ключи and secrets. Только владелец рабочего пространства может управлять там приватными учетными данными времени выполнения. Если вы Editor, попросите владельца рабочего пространства добавить или обновить учетные данные.

Текущие ограничения

Ограничение	Текущее значение
Buckets на приложение	10
Размер каждого загружаемого файла	100 MB

Актуальную информацию об использовании и емкости Cloud смотрите в Cloud & AI Wallet.

FAQ

Мое дисковое пространство заполнено. Как освободить место в хранилище?

1. Проверьте текущее использование хранилища и определите самые большие чаты, проекты или файлы.
2. Скачайте или создайте резервную копию всего, что может понадобиться вам позже.
3. Удаляйте только те элементы, которые вам больше не нужны. Если при удалении чата появляется возможность удалить связанные данные на диске, выбирайте ее только после подтверждения, что эти данные можно отбросить.
4. Удалите ненужные большие файлы, затем обновите данные и снова проверьте доступное место.

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