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 の種類を選択します。

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 クラウドでその bucket を管理できる人は変わりません。この設定は、実行中のアプリがファイルへのアクセスをどのように提供できるかを制御するものであり、ワークスペース権限は 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 文字 以内である必要があります。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 名 と object key を使って識別します。object key は、bucket 内でファイルがどこにあるかを示します。たとえば、images/profile/avatar.png は、images/profile folder 内に保存された画像の object key になる場合があります。

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

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

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

現在の制限

Limit	Current value
アプリごとの buckets 数	10
アップロードされる各ファイルのサイズ	100 MB

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

FAQ

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

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

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