コンテナを作成します。オブジェクトストレージにオブジェクトをアップロードするには1つ以上のコンテナが必要です。
| 項目 | 説明 |
|---|---|
| 名前 | コンテナ名は英字256文字、日本語85文字に制限されます。 |
| コンテナアクセスポリシー | PRIVATE：許可されたユーザーのみコンテナ内部のオブジェクトにアクセスできます。 |
| PUBLIC：公開URLから誰でもコンテナ内部のオブジェクトにアクセスできます。 | |
| ストレージクラス | Standard：基本クラスです。 |
選択したコンテナを削除します。コンテナを削除する前にコンテナが空になっているかを確認する必要があります。コンテナ内にオブジェクトが残っている場合は削除できません。
選択したコンテナの詳細情報を照会します。コンテナの基本情報と設定などの情報を確認できます。
選択したコンテナの設定を変更します。
| 分類 | 項目 | 説明 |
|---|---|---|
| 基本設定 | コンテナアクセスポリシー | PRIVATEと PUBLICのいずれかのコンテナアクセスポリシーを選択します。 |
| オブジェクトのライフサイクル | オブジェクトのライフサイクルを日単位で入力します。空欄にするとライフサイクル設定が解除されます。 | |
| オブジェクト バージョン管理ポリシー |
バージョン管理ポリシー | バージョン管理ポリシーを使用するかどうかを選択します。 |
| アーカイブコンテナ | オブジェクトの以前のバージョンを保管するコンテナを入力します。 | |
| アーカイビングオブジェクト ライフサイクル |
オブジェクトの以前のバージョンのライフサイクルを日単位で入力します。空欄にするとライフサイクル設定が解除されます。 | |
| 複製設定 | 複製 | 複製機能を使用するかどうかを選択します。 |
| 対象リージョン | 現在利用中のリージョン以外の複製する対象リージョンを選択します。 | |
| 複製コンテナ | 複製対象コンテナを入力します。 | |
| 静的Webサイト設定 | インデックス文書 | 静的Webサイトのインデックス文書オブジェクトを入力します。オブジェクトがフォルダ内にある場合、フォルダパスを含めて入力する必要があります。 最大1024バイト、英数字、一部の特殊文字( -, _, ., /)のみ入力できます。 |
| エラー文書 | 静的Webサイトのエラー文書オブジェクトのサフィックス(suffix)を入力します。エラー文書のサフィックスにはフォルダパスを含められません。 最大1024バイト、英数字、一部の特殊文字( -, _, ., /)のみ入力できます。 |
アクセスポリシーでアクセスを制限できます。 * PRIVATE：許可されたユーザーのみコンテナ内部のオブジェクトにアクセスできます。 * PUBLIC：公開URLを通じて誰でもコンテナ内部のオブジェクトにアクセスできます。
オブジェクトライフサイクルを設定すると、コンテナ内のオブジェクトは入力したライフサイクルが終わった後に自動的に削除されます。
[参考] オブジェクトライフサイクルを設定した後にアップロードしたオブジェクトにのみ適用されます。
オブジェクトバージョン管理設定を行って、オブジェクトの以前のバージョンを保管できます。以前のバージョンはオブジェクトをアップデートするときにアーカイブコンテナに保管され、設定から以前のバージョンの寿命を入力できます。 設定したライフサイクルを超えた以前のバージョンは自動的に削除されます。
[注意] アーカイブコンテナをソースコンテナより先に削除すると、ソースコンテナのオブジェクトアップデートまたは削除時にエラーが発生します。すでに削除している場合はアーカイブコンテナを新たに作成するか、ソースコンテナのバージョン管理ポリシーを解除して解決できます。
複製設定を行うと、コンテナのオブジェクトを別のリージョンのコンテナに複製できます。複製設定は災害復旧(disaster recovery)のための機能で、ソースリージョンのオブジェクトを対象リージョンに同じように複製して管理します。複製はバックグラウンドで一定のサイクルで行われます。
複製ポリシーは次のとおりです。
コンテナのアクセスポリシーをPUBLICに設定し、インデックス文書とエラー文書を入力すると、コンテナで静的Webサイトをホスティングできます。静的WebサイトURLはコンテナリストでURLコピーボタンをクリックして取得できます。
静的Webサイトのインデックス文書、エラー文書に使用するオブジェクトは、1つ以上の英字、数字または一部特殊文字(-, _, ., /)で構成された名前でなければならず、拡張子がhtmlのハイパーテキスト形式でなければいけません。この条件を満たさない場合は、設定できなかったり、静的Webサイトが動作しない可能性があります。
静的Webサイトのレスポンス文書名は
{エラーコード}{サフィックス}です。例えばエラー文書をerror.htmlに設定している場合、404エラーが発生した時に表示されるエラー文書の名前は404error.htmlになります。各エラーの状況に合わせてエラー文書をアップロードして使用できます。エラー文書を定義していい場合や、レスポンスコードに合ったエラー文書オブジェクトがない場合はWebブラウザの基本エラー文書が表示されます。
フォルダを作成します。フォルダはコンテナのオブジェクトをグループにまとめるための仮想の単位です。WindowsのフォルダやLinuxのディレクトリと同じように階層構造でオブジェクトを管理できるようにします。フォルダ名は英字256文字、日本語85文字に制限されます。
[参考] オブジェクトストレージのフォルダはファイルシステムが提供するディレクトリとは概念が異なります。便宜のために提供する疑似(pseudo)フォルダです。フォルダを作成すると、実際には
{フォルダ-名前}/という空のオブジェクトが作成されます。フォルダ内のオブジェクトは{フォルダ-名前}/{オブジェクト-名前}形式の名前を持ちます。オブジェクトコピー機能を利用して新しいフォルダにオブジェクトをコピーすると、{フォルダ-名前}/形式の空のオブジェクトではなく、{フォルダ-名前}/{オブジェクト-名前}形式のオブジェクトが作成されます。したがって、このコピーされたオブジェクトを削除する場合、フォルダまで削除されたように表示されます。あらかじめ作ったフォルダにコピーする時はフォルダのオブジェクトを削除してもフォルダが残っています。
フォルダを削除します。フォルダを削除する前にフォルダが空になっているか確認する必要があります。フォルダ内にオブジェクトが残っている場合は削除できません。
すべてのオブジェクトはコンテナ内にアップロードする必要があります。オブジェクト1つの最大容量は5GBに制限されます。
[参考] Webコンソールでは5GBを超えるファイルはアップロードできません。アップロードするオブジェクトの容量が5GBを超える場合は、
splitなどのコマンドラインツールを使用して分割するか、ユーザーアプリケーションで5GB以下のサイズに分割してアップロードするようにプログラミングする必要があります。詳細な使用方法はAPIガイドのマルチパートアップロードを参考にしてください。
選択したオブジェクトをダウンロードします。コンテナを作る時、コンテナアクセスポリシーをPRIVATEに設定している場合、許可されたユーザーのみオブジェクトにアクセスできます。PUBLICに設定していると、リストでURLコピーボタンを押してオブジェクトの公開URLを確認できます。このURLでオブジェクトのハイパーリンクを作成したり、オブジェクトを直接ダウンロードできます。
# cat > index.html
<html>
<body> hello world!
<a href="https://api-storage.cloud.toast.com/v1/{account}/{container}/{object}">Download</a>
</body>
</html>
# python -m http.server
Serving HTTP on :: port 8000 (http://[::]:8000/) ...
オブジェクトをコピーして新しいオブジェクトを作成します。コピーするオブジェクトがあるコンテナに新しい名前のオブジェクトを作ったり、他のコンテナにオブジェクトをコピーできます。
[参考] 入力することができるパスの最大長さはオブジェクト名によって変わります。コピーするパスにオブジェクト名を加えた長さが1024バイト以下である必要があります。
{パスの最大長さ} = 1024 - {オブジェクト名の長さ} - 1
選択したオブジェクトを削除します。マルチパートオブジェクトを削除するとセグメントオブジェクトも一緒に削除されます。
検索ウィンドウにプレフィックスを入力して検索ボタンを押すと、入力したプレフィックスで始まるコンテナ、フォルダ、オブジェクトを検索できます。コンテナリストではコンテナを、オブジェクトリストではフォルダとオブジェクトを検索します。
Amazon S3互換APIを使用するための認証情報を発行できます。S3 API認証情報は有効期限がなく、ユーザーごとにプロジェクトあたり最大3個まで発行できます。
[注意] S3 API認証情報キーが漏洩すると、誰でも漏洩したキーを利用してオブジェクトにアクセスできます。キーが漏洩した場合は漏洩した認証情報を削除して、新しく発行して使用することを推奨します。