Tovanix
Tovanix

オブジェクトストレージの使い方

このガイドでは、Tovanix のオブジェクトストレージの有効化と使い方を説明します:

  • S3 互換で、送信方向のトラフィックに追加料金はかかりません。アカウント単位のサブスクリプションで、月額料金に一定のストレージ容量とリクエスト回数が含まれ、超過分は日ごとに残高から精算されます
  • バケットの作成時にロケーションとストレージクラスを選び、システムがバケット名に自動でプレフィックスを付けてグローバルに一意にします
  • バケットごとに読み取り専用または読み書きのアクセスキーを複数発行でき、Secret は一度だけ表示され、新しいキーは同期にしばらくかかります
  • コンソールでアップロードとダウンロードができ、大きなファイルは自動でマルチパートアップロードされます。公開アクセス、CORS、ライフサイクル、移行、ロックも設定できます
  • 期限の当日から読み取り専用になり、発行済みのキーは失効します。期限切れから 7 日経っても更新されない場合は、データが空にされて削除されます

概要と料金

オブジェクトストレージは S3 互換で、バケットごとに独立したアクセスキーを発行でき、既存の S3 SDK やツールをそのまま接続できます。送信方向のトラフィックに追加料金はかかりません。「クラウドサービス → バケット」で購入期間(1・3・6・12 か月)を選び、「今すぐ有効化」を押します。アカウント単位のサブスクリプションで、有効化後は複数のバケットを作成できます。

  • 月額料金には一定のストレージ容量と毎月のリクエスト回数が含まれ、バケットの数には上限があります。超過分はストレージ容量とリクエスト回数(クラス A、クラス B に分かれます)に応じて課金されます。具体的な数値は有効化ページの表示に従います。
  • 利用量は 1 日に 1 回(UTC の日単位で)集計されます。「今月の超過料金(見込み)」は集計済みの利用量から見積もったもので、月額料金は含みません。
  • 超過分は日ごとにアカウント残高から精算されるため、残高がマイナスになることがあります。マイナスになるとお知らせが届くので、残高を十分に保ってください。

バケットを作成する

「バケット」ページで「バケットを作成」を押します。名前に使えるのは英小文字、数字、ハイフンだけで、システムが自動でプレフィックスを付けてグローバルに一意にしますが、表示されるのは常にご自身が付けた名前です。ロケーションは「自動」(システムが近い場所を選択)を選ぶことも、リージョンを指定することもできます。ストレージクラスは「標準」または「低頻度アクセス」から選べます。

バケットの一覧には、各バケットの使用量、ロケーション、ストレージクラスが表示されます。名前を押すと詳細が開き、詳細ページは「オブジェクト」「アクセスキー」「メトリクス」「設定」の 4 つのタブに分かれています。

アクセスキー

  • バケットの「アクセスキー」タブで「キーを発行」を押し、権限を「読み書き」または「読み取り専用」から選びます。発行したキーはこのバケットだけにアクセスでき、どの S3 SDK やツールにも設定できます。1 つのバケットに複数のキーを発行できます。
  • Secret Access Key は発行時に一度だけ表示され、閉じると二度と確認できません。すぐにコピーして保存してください。「設定としてコピー」を押すこともできます。
  • 新しいキーがストレージノードに同期されるまでしばらくかかり、ページにおよその秒数が表示されます。その間の呼び出しは 401 を返しますが、キーの入力ミスではないので、少し待ってから再度お試しください。
  • バケットの「設定」の「一般」には、接続に必要な S3 エンドポイントとバケットの完全な名前があります。使わなくなったキーは「失効」を押してください。接続方法とコード例はオブジェクトストレージ API ドキュメント(/docs/objstore)をご覧ください。

コンソールでファイルを管理する

バケットの「オブジェクト」タブでは、「新規フォルダ」を作成したり、ファイルを「アップロード」したり、「フォルダーをアップロード」したりでき、ダウンロード、リンクのコピー、削除、名前のプレフィックスでの絞り込みもできます。大きなファイルは自動でマルチパートアップロードされ、ファイルパスは最長 1024 バイトです。複数のファイルやフォルダーにチェックを入れて、まとめて削除できます。

初めてバケットを開くときは一時的なアクセス認証情報を準備するため、30 秒ほどかかり、完了すると自動で続きます。「メトリクス」タブにはこのバケットの利用量が表示され、データは 1 日に 1 回更新されるので、新しく作ったバケットのデータは翌日から表示されます。

バケットの設定

バケット詳細の「設定」タブは、次の項目に分かれています:

  • 一般 — バケットの完全な名前、S3 エンドポイント、ロケーション、ストレージクラス、作成日時を確認できます。
  • 公開アクセス — 有効にすると、バケット内のすべてのオブジェクトを誰でも公開で読み取れるようになります。「公開開発 URL」はテスト用にとどめ、本番では「カスタムドメイン」を紐付けてください。カスタムドメインに使えるのは、お客様名義で DNS をホスティングしているドメインだけです。
  • CORS — Web ページからこのバケットを直接読み書きする(フロントエンドからの直接アップロードや直接読み取り)場合は、CORS の設定が必要です。オリジンにワイルドカード * は指定できません。
  • ライフサイクル — プレフィックスと日数を条件に、オブジェクトの自動削除、低頻度アクセスへの移行、未完了のマルチパートアップロードの削除を行います。どのバケットにも、未完了のマルチパートを削除するルールを 1 つ追加しておくことをおすすめします。
  • 移行 — ほかで使っている S3 バケットから、アクセスに応じて少しずつデータを移します。このバケットにまだないファイルが読み取られると、ソースバケットからリアルタイムに取得して保存するので、停止する必要はありません。ソースバケットの名前、リージョン、アクセスキーの入力が必要で、権限は読み取り専用で十分です。プラットフォームはこのキーをソースバケットの読み取りにのみ使い、保存しません。移行したデータはこのバケットのストレージを使い、リクエスト回数にも数えられます。移行を停止しても、すでに移したファイルはこのバケットに残ります。
  • ロック — 保持期間中、プレフィックスに一致するファイルは削除も上書きもできず、ご自身でもプラットフォームのサポートでも削除できません。その間も通常どおり課金されます。日数で設定し、最長の日数はページの表示に従います。無期限のロックはありません。
  • 未完了のアップロード — 大きなファイルのアップロードが中断されると、アップロード済みのパートが残ります。これらはストレージとして課金されますが、ファイル一覧には表示されません。ここで確認でき、24 時間以上前のパートを削除できます。
  • 危険な操作 — 「バケットを空にする」はバケット内のファイルをすべて削除し、元に戻せません。バケットを削除する前には必ず空にする必要があり、削除するとそのバケットのキーはすべて一緒に失効します。

更新と有効期限

  • 「バケット」ページで「更新」を押し、期間を選んで支払います。現在、自動更新はなく、期限前にプラットフォームからお知らせが届きます。
  • 期限の当日からバケットは読み取り専用になります。閲覧、ダウンロード、削除、空にする操作は引き続きできますが、アップロード、設定の変更、バケットの新規作成、新しいキーの発行はできません。
  • 期限が切れると発行済みのアクセスキーは失効し、更新後に改めて発行する必要があります。

期限切れから 7 日経っても更新されない場合、プラットフォームがバケットのデータを空にして削除し、元に戻せません。削除後にお知らせが届きます。残したいデータは、それまでにダウンロードするか更新してください。

よくある問題の切り分け

  • 新しく発行したキーで呼び出すと 401 が返る — 新しいキーがまだストレージノードに同期中 — ページの案内に従って少し待ってから再度お試しください。キーを何度も作り直さないでください。
  • 請求にストレージ料金があるのに、バケットにはそれほどファイルがない — 中断されたアップロードのパートが残っており、ファイル一覧には表示されない — 「設定 → 未完了のアップロード」で確認して削除してください。
  • バケットの削除に失敗する — バケットにまだファイルがある、またはロック期間中のファイルがある — 先に「バケットを空にする」を行ってください。ロックがあると表示された場合は、「設定 → ロック」でルールを確認してください。保持期間中のファイルは、期間が終わるまで削除できません。
  • バケットを開くと、一時的なアクセス認証情報を準備中と表示される — 初めて開くときは一時的な認証情報の準備が必要 — 30 秒ほどで完了し、自動で続きます。ページを更新する必要はありません。
  • バケット数の上限に達したと表示される — お持ちのバケットの数が上限に達した — 使わなくなったバケットを削除してから作成してください。
  • アカウント残高がマイナスになった — 含まれる量を超えた分が日ごとに残高から精算されている — 入金して残高を補ってください。「バケット」ページで今月の超過料金の見込みを確認できます。

よくある質問

ファイルをダウンロードすると、トラフィック料金が追加でかかりますか?

かかりません。送信方向のトラフィックに追加料金はかかりません。料金は月額料金と、含まれる量を超えたストレージ容量とリクエスト回数です。

期限が切れるとデータはすぐに削除されますか?

されません。期限の当日からバケットは読み取り専用になり、ダウンロードや整理はできます。期限切れから 7 日経っても更新されない場合に、はじめて空にして削除され、元に戻せません。

Secret Access Key を失くした場合は?

発行時に一度だけ表示されるもので、失くすと取り戻せません。古いキーを失効させ、新しいキーを発行してください。

関連ページ: ヘルプセンター · ガイドとよくある質問 · S3 互換のオブジェクトストレージ · オブジェクトストレージ API

読み込み中…