Sử dụng Lưu trữ App để lưu trữ, sắp xếp và quản lý các tệp được app đang chạy của bạn sử dụng, bao gồm hình ảnh, video, tài liệu và các tệp do người dùng tải lên.

Trước khi sử dụng Lưu trữ App, hãy kết nối dự án với Atoms Cloud. Nếu chưa được kết nối, hãy yêu cầu Agent kết nối Atoms Cloud hoặc làm theo Atoms Cloud.

Tìm hiểu Lưu trữ App trong Atoms Cloud

Lưu trữ App lưu trữ các tệp mà dự án của bạn cần giữ lại và truy cập. Nó tách biệt với dữ liệu có cấu trúc được lưu trong Cơ sở dữ liệu của bạn, các tệp được tải lên trong Chat, và các tệp tạo nên mã của dự án.

Các thuật ngữ chính

• Bucket: Vùng chứa chính dùng để lưu trữ và nhóm các tệp liên quan. Bạn có thể hình dung bucket như một khu vực lưu trữ cho một danh mục tệp. Mỗi bucket được đặt là Public hoặc Private, điều này kiểm soát ai có thể truy cập các tệp bên trong.
• Folder: Cách tùy chọn để sắp xếp các tệp trong một bucket. Folder hoạt động giống như các thư mục trên máy tính của bạn và có thể giúp việc quản lý các bộ sưu tập tệp lớn trở nên dễ dàng hơn.
• Object: Một tệp riêng lẻ được lưu trong bucket hoặc folder, chẳng hạn như hình ảnh, tài liệu, video hoặc tệp đã tải lên khác.
• Object key: Đường dẫn duy nhất dùng để xác định nơi một tệp được lưu bên trong bucket. Ví dụ: images/profile/avatar.png có thể là object key cho một hình ảnh được lưu trong folder images/profile.

Chọn Public hoặc Private

Chọn loại bucket trước khi tạo:

Loại bucket	Dùng cho
Private	Các tệp nhạy cảm, dành riêng cho tài khoản hoặc do người dùng tải lên.
Public	Các tệp không nhạy cảm được chủ ý cho phép hiển thị công khai một cách an toàn.

Dùng Private cho các tệp nhạy cảm hoặc dành riêng cho người dùng. Nếu bạn gặp lỗi truy cập, đừng đổi bucket sang Public chỉ để làm cho tệp có thể truy cập được. Thay vào đó, hãy đảm bảo app của bạn kiểm tra rằng người yêu cầu tệp có quyền truy cập tệp đó.

Mở Lưu trữ App trong Atoms Cloud

1. Mở dự án của bạn trên thiết bị desktop.
2. Trong thanh công cụ của không gian làm việc nơi có Trình xem App , hãy chọn Atoms Cloud.
3. Chọn Lưu trữ App trong thanh bên của Atoms Cloud.

Quyền trong Lưu trữ App

Lưu trữ App sử dụng vai trò trong không gian làm việc của bạn. Cả Editors và workspace owners đều có thể quản lý lưu trữ cho các dự án mà họ có thể mở. Những người không phải là thành viên của không gian làm việc không thể mở hoặc quản lý Lưu trữ App của dự án.

Thiết lập Public hoặc Private của bucket không thay đổi ai có thể quản lý bucket đó trong Atoms Cloud. Thiết lập đó kiểm soát cách app đang chạy có thể cung cấp quyền truy cập vào các tệp; quyền của không gian làm việc kiểm soát ai có thể quản lý lưu trữ từ không gian làm việc Atoms Cloud.

Tạo bucket

Một app có thể có tối đa 10 buckets. Hãy tạo các bucket riêng biệt khi các nhóm tệp khác nhau cần các thiết lập truy cập khác nhau hoặc nên được tách riêng để dễ sắp xếp hơn.

1. Trên trang Lưu trữ App, chọn Create Bucket.
2. Trong Bucket Name, nhập tên duy nhất cho bucket. Tên phải:
   • chứa từ 3–63 ký tự;
   • chỉ dùng chữ thường, số và dấu gạch nối; và
   • bắt đầu và kết thúc bằng một chữ cái hoặc số.
3. Trong Bucket Type, chọn Private hoặc Public. Public được chọn mặc định, vì vậy hãy đảm bảo bạn chọn mức truy cập mong muốn trước khi tiếp tục.
4. Chọn Create.

Bucket mới xuất hiện trên trang Lưu trữ App cùng với tên, loại và ngày tạo. Chọn bucket để mở và xem nội dung của nó.

Chọn Create Bucket trong Lưu trữ App.

Tên bucket không thể thay đổi sau khi tạo, vì vậy hãy chọn một tên rõ ràng mà bạn sẽ không cần đổi sau này. Nếu app của bạn đã có 10 bucket, Create Bucket sẽ không còn khả dụng.

Tải lên và sắp xếp tệp

Bên trong một bucket, bạn có thể tải tệp lên trực tiếp hoặc tạo một folder trống mà không cần tải lên tệp nào trước.

Tạo folder mới

1. Mở bucket hoặc folder nơi bạn muốn tạo folder mới.
2. Chọn Add Folder.
3. Nhập tên cho folder, sau đó chọn Create. Tên folder có thể chứa chữ cái, số, dấu chấm (.), dấu gạch nối (-) và dấu gạch dưới (_), và không được vượt quá 100 ký tự. Tên folder không thể thay đổi sau khi tạo.

Đặt tên folder, sau đó chọn Create.

Tải tệp lên

1. Mở bucket hoặc folder nơi bạn muốn lưu các tệp.
2. Chọn Upload, sau đó chọn một hoặc nhiều tệp từ thiết bị của bạn. Mỗi tệp có thể có dung lượng tối đa 100 MB.
3. Chờ quá trình tải lên hoàn tất, sau đó kiểm tra xem các tệp có xuất hiện trong danh sách hay không.

Danh sách tệp hiển thị Name, Type, Size, ngày Last Modified và Actions khả dụng của từng mục. Nếu bạn cần tải lại nội dung của folder hiện tại, hãy chọn nút refresh.

Tải tệp lên bucket hoặc folder đã chọn.

Xem trước và quản lý tệp

Chọn một tệp để mở File Details. Hình ảnh và video được hỗ trợ có thể được xem trước trong bảng điều khiển. Các loại tệp khác hiển thị thông tin chi tiết hiện có và vẫn có thể được tải xuống. Nếu tất cả tín dụng đã được sử dụng, File Details sẽ hiển thị trạng thái hết tín dụng, và Download cho từng tệp sẽ đưa bạn đến Nâng cấp thay vì tải xuống.

Quản lý một tệp

Mở ... trong cột Actions của tệp, sau đó chọn:

• Download để lưu một bản sao cục bộ khi còn tín dụng. Nếu tất cả tín dụng đã được sử dụng, thao tác này sẽ đưa bạn đến Nâng cấp thay thế.
• Rename để thay đổi tên tệp. Tên mới có thể dùng chữ cái, số, dấu chấm, dấu gạch nối và dấu gạch dưới.
• Delete để xóa tệp sau khi xác nhận.

Dùng menu thao tác của tệp để tải xuống, đổi tên hoặc xóa tệp đó.

Quản lý nhiều tệp

1. Chọn hộp kiểm bên cạnh từng tệp. Folder không được bao gồm trong lựa chọn hàng loạt.
2. Chọn Download để tải các tệp đã chọn xuống cùng nhau, hoặc chọn Delete.
3. Nếu xóa, hãy xem lại số lượng tệp đã chọn và xác nhận Delete.

Việc xóa không thể hoàn tác từ Lưu trữ App. Trước khi đổi tên hoặc xóa một tệp, hãy kiểm tra xem app có còn sử dụng object key của tệp đó hay không. Sau đó, cập nhật mọi tham chiếu đã lưu để app không tiếp tục yêu cầu key cũ.

Sử dụng tệp đã lưu trong app của bạn

App của bạn xác định từng tệp đã lưu bằng bucket name và object key của nó. Object key cho biết vị trí của tệp bên trong bucket. Ví dụ: images/profile/avatar.png có thể là object key cho một hình ảnh được lưu trong folder images/profile.

Lưu bucket name và object key trong cơ sở dữ liệu của app để app có thể định vị tệp sau này. Khi app của bạn cần hiển thị hoặc tải xuống tệp, app có thể dùng các thông tin này để yêu cầu một URL truy cập.

URL truy cập có thể là tạm thời. Đừng lưu chúng làm dữ liệu app vĩnh viễn, hardcode chúng vào app của bạn, hoặc chia sẻ chúng trong Chat, ảnh chụp màn hình, nhật ký hoặc tin nhắn hỗ trợ. Thay vào đó, hãy lưu object key và yêu cầu một URL truy cập mới khi cần truy cập tệp.

Không lưu API key, mật khẩu hoặc thông tin xác thực khác trong Lưu trữ App. Hãy lưu thông tin xác thực runtime riêng tư trong Khóa and secrets. Chỉ chủ sở hữu không gian làm việc mới có thể quản lý thông tin xác thực runtime riêng tư ở đó. Nếu bạn là Editor, hãy yêu cầu chủ sở hữu không gian làm việc thêm hoặc cập nhật thông tin xác thực.

Giới hạn hiện tại

Giới hạn	Giá trị hiện tại
Số bucket trên mỗi app	10
Dung lượng của mỗi tệp được tải lên	100 MB

Để biết thông tin hiện tại về mức sử dụng và dung lượng Cloud, xem Cloud & AI Wallet.

Câu hỏi thường gặp

Dung lượng ổ đĩa của tôi đã đầy. Làm thế nào để giải phóng bộ nhớ?

1. Kiểm tra mức sử dụng bộ nhớ hiện tại và xác định các chat, dự án hoặc tệp lớn nhất.
2. Tải xuống hoặc sao lưu mọi thứ mà bạn có thể cần sau này.
3. Chỉ xóa những mục bạn không còn cần nữa. Nếu việc xóa một chat hiển thị tùy chọn xóa dữ liệu ổ đĩa liên quan, chỉ chọn tùy chọn đó sau khi xác nhận rằng dữ liệu có thể bị loại bỏ.
4. Xóa các tệp lớn không cần thiết, sau đó làm mới và kiểm tra lại dung lượng còn trống.

Việc xóa có thể là vĩnh viễn và có thể ảnh hưởng đến dự án đang tham chiếu đến tệp đã bị xóa. Nếu mức sử dụng không giảm sau khi dọn dẹp, hãy liên hệ bộ phận Hỗ trợ kèm ảnh chụp màn hình bộ nhớ, gói của bạn và tài khoản hoặc không gian làm việc bị ảnh hưởng. Không gửi nội dung tệp trừ khi được yêu cầu qua một kênh đã được phê duyệt.