Хранилище приложения

Перед использованием Хранилище приложения подключите проект к 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, не загружая сначала никаких файлов.

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

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

Назовите folder, затем выберите Create.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сохраните имя bucket и 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. Удалите ненужные большие файлы, затем обновите данные и снова проверьте доступное пространство.

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