Storage > Object Storage > コンソール使用ガイド

コンテナ

コンテナ作成

コンテナを作成します。オブジェクトストレージにオブジェクトをアップロードするには1つ以上のコンテナが必要です。

項目 説明
名前 コンテナ名は英字256文字、日本語85文字に制限されます。
コンテナアクセスポリシー PRIVATE:許可されたユーザーのみコンテナ内部のオブジェクトにアクセスできます。
PUBLIC:公開URLから誰でもコンテナ内部のオブジェクトにアクセスできます。
ストレージクラス Standard:基本クラスです。

コンテナ削除

選択したコンテナを削除します。コンテナを削除する前にコンテナが空になっているかを確認する必要があります。コンテナ内にオブジェクトが残っている場合は削除できません。

コンテナ詳細情報

選択したコンテナの詳細情報を照会します。コンテナの基本情報と設定などの情報を確認できます。

コンテナ設定

選択したコンテナの設定を変更します。

分類 項目 説明
基本設定 コンテナアクセスポリシー PRIVATE:許可されたユーザーのみコンテナ内部のオブジェクトにアクセスできます。
PUBLIC:公開URLから誰でもコンテナ内部のオブジェクトにアクセスできます。
オブジェクトのライフサイクル オブジェクトのライフサイクルを日単位で入力します。空欄にするとライフサイクル設定が解除されます。
オブジェクトライフサイクルを設定したコンテナにアップロードしたオブジェクトは、設定したライフサイクルが経過すると自動的に削除されます。
オブジェクト
バージョン管理ポリシー
バージョン管理ポリシー バージョン管理ポリシーを使用に設定すると、コンテナに保存されたオブジェクトをアップデートする時、指定したコンテナに以前のバージョンを保管できます。
アーカイブコンテナ オブジェクトの以前のバージョンを保管するコンテナを入力します。
アーカイビングオブジェクト
ライフサイクル
オブジェクトの以前のバージョンのライフサイクルを日単位で入力します。空欄にするとライフサイクル設定が解除されます。
ライフサイクルが設定された後に保管されたオブジェクトの以前のバージョンは、設定されたライフサイクルが経過すると自動的に削除されます。
静的Webサイト設定 インデックス文書 静的Webサイトのインデックス文書オブジェクトを入力します。オブジェクトがフォルダ内にある場合、フォルダパスを含めて入力する必要があります。
最大1024バイト、英数字、一部の特殊文字(-, _, ., /)のみ入力できます。
エラー文書 静的Webサイトのエラー文書オブジェクトのサフィックス(suffix)を入力します。エラー文書のサフィックスにはフォルダパスを含められません。
最大1024バイト、英数字、一部の特殊文字(-, _, ., /)のみ入力できます。

[注意] バージョン管理ポリシーを設定している場合、アーカイブコンテナを原本コンテナより先に削除してはいけません。原本コンテナのオブジェクトをアップデートまたは削除する時、アーカイブコンテナに以前のバージョンを保存することができず、エラーが発生します。アーカイブコンテナを先に削除してエラーが発生する場合は、アーカイブコンテナを新たに作成するか、原本コンテナのバージョン管理ポリシーを解除して問題を解決できます。


[参考] コンテナのアクセスポリシーを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でオブジェクトのハイパーリンクを作成したり、オブジェクトを直接ダウンロードできます。

ハイパーリンク例
  • Webページ作成
  • # cat > index.html
    <html>
    <body> hello world!
    <a href="https://api-storage.cloud.toast.com/v1/{account}/{container}/{object}">Download</a>
    </body>
    </html>
    
  • Python3のhttpモジュールを利用してWebサーバー実行
  • # python -m http.server
    Serving HTTP on :: port 8000 (http://[::]:8000/) ...
    
  • Webブラウザでhttp://localhost:8000に接続した後、Downloadを押して正常にファイルがダウンロードできるかを確認

オブジェクトのコピー

オブジェクトをコピーして新しいオブジェクトを作成します。コピーするオブジェクトがあるコンテナに新しい名前のオブジェクトを作ったり、他のコンテナにオブジェクトをコピーできます。

[参考] 入力することができるパスの最大長さはオブジェクト名によって変わります。コピーするパスにオブジェクト名を加えた長さが1024バイト以下である必要があります。 {パスの最大長さ} = 1024 - {オブジェクト名の長さ} - 1

オブジェクトの削除

選択したオブジェクトを削除します。

プレフィックス検索

検索ウィンドウにプレフィックスを入力して検索ボタンを押すと、入力したプレフィックスで始まるコンテナ、フォルダ、オブジェクトを検索できます。コンテナリストではコンテナを、オブジェクトリストではフォルダとオブジェクトを検索します。

TOP