実行中のアプリで使用される画像、動画、ドキュメント、ユーザーのアップロードを含むファイルを保存、整理、管理するには、App ストレージを使用します。

App ストレージ を使用する前に、プロジェクトを Atoms クラウド に接続してください。接続されていない場合は、エージェントに Atoms クラウドの接続を依頼するか、Atoms クラウドを参照してください。

Atoms クラウドの App ストレージを理解する

App ストレージ は、プロジェクトが保持してアクセスする必要があるファイルを保存します。これは、データベースに保存される構造化データ、Chat にアップロードされたファイル、およびプロジェクトのコードを構成するファイルとは別です。

主要な用語

• Bucket: 関連するファイルを保存してグループ化するために使用されるメインのコンテナです。bucket は、1 つのカテゴリのファイル用の保存領域のようなものと考えることができます。各 bucket は Public または Private のいずれかに設定され、その中のファイルに誰がアクセスできるかを制御します。
• Folder: bucket 内でファイルを整理するための任意の方法です。folder はコンピューター上のフォルダーのように機能し、大量のファイルのコレクションをより管理しやすくするのに役立ちます。
• Object: 画像、ドキュメント、動画、その他のアップロードされたファイルなど、bucket または folder に保存される個々のファイルです。
• Object key: bucket 内でファイルが保存されている場所を識別するために使用される一意のパスです。たとえば、images/profile/avatar.png は、images/profile フォルダー内に保存された画像の object key になります。

Public または Private を選択する

bucket を作成する前に、そのタイプを選択してください。

Bucket type	用途
Private	機密性の高い、アカウント固有、またはユーザーがアップロードしたファイル。
Public	意図的に公開しても安全な、機密性のないファイル。

機密性の高いファイルやユーザー固有のファイルには Private を使用してください。 アクセスエラーが発生しても、ファイルにアクセスできるようにするためだけに bucket を Public に変更しないでください。代わりに、ファイルを要求している人にアクセス権があることをアプリで確認してください。

Atoms クラウドで App ストレージを開く

1. デスクトップ端末でプロジェクトを開きます。
2. App ビューアー がある同じワークスペースのツールバーで、Atoms クラウド を選択します。
3. Atoms クラウドのサイドバーで App ストレージ を選択します。

App ストレージの権限

App ストレージはワークスペースのロールを使用します。Editors と workspace owners はどちらも、開くことができるプロジェクトのストレージを管理できます。ワークスペースのメンバーではない人は、プロジェクトの App ストレージを開いたり管理したりできません。

bucket の Public または Private の設定によって、Atoms クラウドでそれを管理できる人は変わりません。この設定は、実行中のアプリがファイルへのアクセスをどのように提供できるかを制御するものであり、Atoms クラウドのワークスペースからストレージを管理できる人はワークスペース権限によって制御されます。

bucket を作成する

1 つのアプリには最大 10 buckets を設定できます。異なるグループのファイルで異なるアクセス設定が必要な場合や、整理しやすくするために分けて保持したい場合は、別々の bucket を作成してください。

1. App ストレージ ページで、Create Bucket を選択します。
2. Bucket Name で、bucket の一意の名前を入力します。名前は次の条件を満たす必要があります:
   • 3～63 文字であること。
   • 小文字、数字、ハイフンのみを使用すること。
   • 文字または数字で始まり、文字または数字で終わること。
3. Bucket Type で、Private または Public を選択します。デフォルトでは Public が選択されているため、続行する前に希望するアクセスレベルを選んでいることを確認してください。
4. Create を選択します。

新しい bucket は、その名前、タイプ、作成日とともに App ストレージ ページに表示されます。bucket を選択すると開いて内容を確認できます。

App ストレージで Create Bucket を選択します。

bucket 名は作成後に変更できません ので、後で変更する必要がない明確な名前を選んでください。アプリにすでに 10 個の bucket がある場合、Create Bucket は利用できなくなります。

ファイルをアップロードして整理する

bucket 内では、ファイルを直接アップロードすることも、先にファイルをアップロードせずに空の folder を作成することもできます。

新しい folder を作成する

1. 新しい folder を作成したい bucket または folder を開きます。
2. Add Folder を選択します。
3. folder 名を入力し、Create を選択します。folder 名には文字、数字、ドット (.)、ハイフン (-)、アンダースコア (_) を使用でき、最大 100 characters までです。folder 名は作成後に変更できません。

folder に名前を付けてから、Create を選択します。

ファイルをアップロードする

1. ファイルを保存したい bucket または folder を開きます。
2. Upload を選択し、デバイスから 1 つ以上のファイルを選びます。各ファイルは最大 100 MB です。
3. アップロードが完了するまで待ち、ファイルが一覧に表示されることを確認します。

ファイル一覧には、各項目の Name、Type、Size、Last Modified 日時、および利用可能な Actions が表示されます。現在の folder の内容を再読み込みする必要がある場合は、refresh ボタンを選択します。

選択した bucket または folder にファイルをアップロードします。

ファイルをプレビューして管理する

ファイルを選択すると File Details が開きます。対応している画像と動画はパネルでプレビューできます。その他のファイルタイプでは利用可能な詳細が表示され、引き続きダウンロードもできます。すべてのクレジットを使い切っている場合、File Details にはクレジット枯渇状態が表示され、単一ファイルの Download はダウンロードではなく アップグレード に移動します。

1 つのファイルを管理する

ファイルの Actions 列で ... を開き、次のいずれかを選択します。

• Download は、クレジットが利用可能な場合にローカルコピーを保存します。すべてのクレジットを使い切っている場合、この操作は代わりに アップグレード に移動します。
• Rename は、ファイル名を変更します。新しい名前には文字、数字、ドット、ハイフン、アンダースコアを使用できます。
• Delete は、確認後にファイルを削除します。

ファイルのアクションメニューを使用して、ダウンロード、名前変更、または削除します。

複数のファイルを管理する

1. 各ファイルの横にあるチェックボックスを選択します。folder は一括選択に含まれません。
2. 選択したファイルをまとめてダウンロードするには Download を選択し、削除するには Delete を選択します。
3. 削除する場合は、選択したファイル数を確認して Delete を確定します。

削除は App ストレージから元に戻せません。 ファイルの名前を変更または削除する前に、アプリがその object key をまだ使用しているか確認してください。その後、アプリが古い key を引き続き要求しないよう、保存されている参照を更新してください。

保存されたファイルをアプリで使用する

アプリは、保存された各ファイルを bucket name と object key を使って識別します。object key は、bucket 内のどこにファイルがあるかを示します。たとえば、images/profile/avatar.png は、images/profile フォルダー内に保存された画像の object key になります。

アプリが後でファイルを見つけられるように、bucket name と object key をアプリのデータベースに保存してください。アプリがファイルを表示またはダウンロードする必要があるときは、これらの情報を使ってアクセス URL をリクエストできます。

アクセス URL は一時的な場合があります。 これらを永続的なアプリデータとして保存したり、アプリにハードコードしたり、Chat、スクリーンショット、ログ、サポートメッセージで共有したりしないでください。代わりに、object key を保存し、ファイルにアクセスする必要があるときに新しいアクセス URL をリクエストしてください。

API キー、パスワード、その他の認証情報を App ストレージに保存しないでください。非公開のランタイム認証情報は Keys and secrets に保存してください。そこで非公開のランタイム認証情報を管理できるのはワークスペースオーナーのみです。あなたが Editor の場合は、ワークスペースオーナーに認証情報の追加または更新を依頼してください。

現在の制限

制限	現在の値
アプリごとの buckets 数	10
アップロードされる各ファイルのサイズ	100 MB

現在の Cloud の使用量と容量に関する情報については、Cloud & AI Wallet を参照してください。

よくある質問

ディスク容量がいっぱいです。ストレージを空けるにはどうすればよいですか？

1. 現在のストレージ使用量を確認し、最も大きい chats、projects、または files を特定します。
2. 後で必要になる可能性があるものはダウンロードまたはバックアップします。
3. 不要になった項目だけを削除します。chat を削除する際に関連するディスクデータを削除するオプションが表示された場合は、そのデータを破棄してよいことを確認してから選択してください。
4. 不要な大きなファイルを削除し、更新して利用可能な空き容量を再確認します。

削除は永続的である場合があり、削除されたファイルを参照しているプロジェクトに影響する可能性があります。クリーンアップ後も使用量が減らない場合は、ストレージのスクリーンショット、利用プラン、影響を受けているアカウントまたはワークスペースを添えてサポートに連絡してください。承認されたチャネルを通じて要求されない限り、ファイルの内容は送信しないでください。