コンテナを作成します。オブジェクトストレージにオブジェクトをアップロードするには1つ以上のコンテナが必要です。暗号化設定を行うとアップロードしたオブジェクトを自動的に暗号化して保存します。
| 分類 | 項目 | 説明 |
|---|---|---|
| コンテナ作成 | 名前 | コンテナ名は英字256文字、日本語85文字に制限されます。 |
| コンテナアクセスポリシー | PRIVATE：許可されたユーザーのみコンテナ内部のオブジェクトにアクセスできます。 | |
| PUBLIC：公開URLから誰でもコンテナ内部のオブジェクトにアクセスできます。 | ||
| ストレージクラス | Standard：基本クラスです。 | |
| 暗号化設定 | 暗号化 | オブジェクト暗号化を使用するかどうかを選択します。 |
| 対称鍵ID | Secure Key Managerサービスで管理する対称鍵IDを入力します。 |
暗号化コンテナにアップロードするオブジェクトはNHN CloudのSecure Key Managerサービスで管理する対称鍵を使用して暗号化されます。したがって暗号化コンテナを作成するには、あらかじめSecure Key Managerサービスで対称鍵を作成する必要があります。
暗号化コンテナに適用されるポリシーは次のとおりです。
[注意] Secure Key Managerサービスで暗号化コンテナに設定した対称鍵を削除した場合、暗号化されたオブジェクトを復号できません。対称鍵を誤って削除しないように注意して管理する必要があります。
選択したコンテナを削除します。コンテナを削除する前にコンテナが空になっているかを確認する必要があります。コンテナ内にオブジェクトが残っている場合は削除できません。
選択したコンテナの基本情報を確認し、設定を管理します。
コンテナの基本情報と暗号化情報を確認し、アクセスポリシー、静的Webサイト、オリジン間リソース共有などの設定を変更できます。
アクセスポリシーを設定します。
| 項目 | 説明 |
|---|---|
| インデックス文書 | 静的Webサイトのインデックス文書オブジェクトを入力します。オブジェクトがフォルダ内にある場合、フォルダパスを含めて入力する必要があります。 最大1024バイト、英字、数字、一部特殊文字( -、_、.、/)のみ入力できます。 |
| エラー文書 | 静的Webサイトのエラー文書オブジェクトのサフィックス(suffix)を入力します。エラー文書サフィックスにはフォルダパスを含められません。 最大1024バイト、英字、数字、一部特殊文字( -、_、.、/)のみ入力できます。 |
コンテナのアクセスポリシーをPUBLICに設定してインデックス文書とエラー文書を入力すると、コンテナで静的Webサイトをホスティングできます。静的WebサイトURLはコンテナリストでURLコピーボタンをクリックして取得できます。
静的Webサイトのインデックス文書、エラー文書として使用するオブジェクトは、1つ以上の英字、数字または一部特殊文字(-, _, ., /)で構成された名前で、ファイル拡張子がhtmlのハイパーテキスト形式でなけれなりません。条件を満たさない場合、設定できなかったり静的Webサイトが動作しない場合があります。
静的Webサイトのエラー文書名は{レスポンスコード}{サフィックス}形式です。例えばエラー文書をerror.htmlに設定した場合、404エラーが発生した時に表示されるエラー文書の名前は404error.htmlになります。各エラー状況に合わせてエラー文書をアップロードして使用できます。エラー文書を定義していない場合や、レスポンスコードに合ったエラー文書オブジェクトがない場合はWebブラウザの基本エラー文書が表示されます。
ブラウザでObject Storage APIを直接呼び出すには、オリジン間リソース共有設定が必要です。オリジン間リソース共有項目の変更ボタンをクリックすると、許可するソースURLを登録できます。 URLにはプロトコル(https://またはhttp://)が含まれている必要があります。*を登録するとすべてのソースを許可できます。
コンテナに保存されるオブジェクトのライフサイクルとバージョン管理ポリシーを照会し、変更できます。
| 分類 | 項目 | 説明 |
|---|---|---|
| オブジェクトのライフサイクル | オブジェクトのライフサイクルを日単位で入力します。空欄にするとライフサイクル設定が解除されます。 | |
| オブジェクト バージョン管理ポリシー |
バージョン管理ポリシー | バージョン管理ポリシーを使用するかどうかを選択します。 |
| アーカイブコンテナ | オブジェクトの以前のバージョンを保管するコンテナを入力します。 | |
| アーカイビングオブジェクト ライフサイクル |
オブジェクトの以前のバージョンのライフサイクルを日単位で入力します。空欄にするとライフサイクル設定が解除されます。 |
アップロードしたオブジェクトの基本ライフサイクルを設定できます。設定されたライフサイクルが終了したオブジェクトは自動的に削除されます。
[参考] オブジェクトライフサイクル設定後にアップロードしたオブジェクトにのみ適用されます。
オブジェクトバージョン管理設定からオブジェクトの以前のバージョンを保管できます。オブジェクトをアップデートまたは削除する時、以前のバージョンが指定されたアーカイブコンテナに保管されます。以前のバージョンのライフサイクルを設定した場合、ライフサイクルを超過した以前のバージョンは自動的に削除されます。
[注意] アーカイブコンテナを原本コンテナより先に削除すると、原本コンテナのオブジェクトをアップデートまたは削除する時にエラーが発生します。すでに削除している場合はアーカイブコンテナを新たに作成するか原本コンテナのバージョン管理ポリシーを解除して解決できます。
複製設定を行ってコンテナのオブジェクトを他のリージョンのコンテナに複製できます。複製設定は災害復旧(disaster recovery)のための機能で、原本リージョンのオブジェクトを対象リージョンに同じように複製し、管理します。複製はバックグラウンドで一定周期ごとに行われます。
| 分類 | 項目 | 説明 |
|---|---|---|
| 複製設定 | 複製 | 複製機能を使用するかどうかを選択します。 |
| 対象リージョン | 現在利用中のリージョン以外の複製する対象リージョンを選択します。 | |
| 複製コンテナ | 複製対象コンテナを入力します。 |
複製ポリシーは次のとおりです。
フォルダを作成します。フォルダはコンテナのオブジェクトをグループにまとめるための仮想の単位です。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 - {オブジェクト名の長さ} - 15GBを超えるマルチパートオブジェクトはコピーできません。
選択したオブジェクトを削除します。マルチパートオブジェクトを削除するとセグメントオブジェクトも一緒に削除されます。
検索ウィンドウにプレフィックスを入力して検索ボタンを押すと、入力したプレフィックスで始まるコンテナ、フォルダ、オブジェクトを検索できます。コンテナリストではコンテナを、オブジェクトリストではフォルダとオブジェクトを検索します。
Amazon S3互換APIを使用するための認証情報を発行できます。S3 API認証情報は有効期限がなく、ユーザーごとにプロジェクトあたり最大3個まで発行できます。
[注意] S3 API認証情報キーが漏洩すると、誰でも漏洩したキーを利用してオブジェクトにアクセスできます。キーが漏洩した場合は漏洩した認証情報を削除して、新しく発行して使用することを推奨します。