フォルダについて

Cloud Storage にはデータを整理するさまざまな方法があり、フォルダはこのプロセスで重要な役割を果たしています。利用可能なフォルダの種類を理解しておくと、特定のニーズに最も適したフォルダを選択できます。

このページでは、Cloud Storage のさまざまなフォルダの種類について概説します。特に、階層型名前空間が有効になっているときに、バケット内でフォルダがどのように機能するのかを中心に説明します。

フォルダの種類

Cloud Storage には、主に次の 3 種類のフォルダがあります。

• シミュレートされたフォルダ: 一般的な Cloud Storage バケットでは、オブジェクトはフラットな名前空間に整理されます。Google Cloud コンソールと Google Cloud CLI を使用して、フォルダをファイルツリーのように表示し、バケット内のデータの整理を行うことができます。シミュレートされたフォルダの詳細については、シミュレートされたフォルダをご覧ください。

• フォルダ: 階層名前空間が有効になっているバケットでは、オブジェクトや他のフォルダを含む実際のフォルダを作成できます。フォルダ名の変更やフォルダの一覧表示などの操作も可能です。階層構造とフォルダ管理オペレーションにより、ファイル指向のワークロードとデータ集約型ワークロードのパフォーマンス、一貫性、管理性が向上します。

• マネージド フォルダ: マネージド フォルダを使用すると、オブジェクトにきめ細かいアクセス制御を適用し、データのセキュリティと制御を強化できます。バケットでは、階層型名前空間を有効にしているかどうかにかかわらず、マネージド フォルダを使用できます。マネージド フォルダの詳細については、マネージド フォルダをご覧ください。

フォルダの概要

フォルダは、階層型名前空間が有効になっているバケットのリソースとして存在します。フォルダ内のオブジェクトをファイル システムのような構造で整理できます。Cloud Storage には、フォルダの作成、削除、名前変更、一覧表示、メタデータの取得などのオペレーションを可能にするフォルダ管理用の API が用意されています。

フォルダのメタデータ

フォルダのメタデータには、フォルダに関する構造化情報が含まれています。フォルダのメタデータの詳細については、Cloud Storage JSON API リファレンス ドキュメントで Folder リソースの説明をご覧ください。

フォルダのメタデータの主なコンポーネントは次のとおりです。

• bucket: フォルダが存在するバケットの名前。例: my-bucket。
• id: バケット内のフォルダの固有識別子。例: hns-bucket/dir1/。
• kind: リソースタイプ。フォルダの場合、この値は常に storage#folder です。
• name: フォルダの名前。例: dir1/。
• selfLink: Cloud Storage API でフォルダを参照する URL。
• timeCreated: フォルダ作成時のタイムスタンプ。例: 2023-05-05T16:32:08.878000+00:00。
• updated: リソース最終更新時のタイムスタンプ。例: 2024-05-06T16:32:08.878000+00:00。

考慮事項

フォルダを作成する際は、次の点に注意してください。

• オブジェクト名とフォルダ名: 階層型名前空間が有効になっているバケットでは、すべての有効なオブジェクト名がサポートされます。先頭または末尾にスラッシュ（/）が付いている名前や、連続したスラッシュが含まれている名前もサポートされます。オブジェクト名の各スラッシュ（/）はフォルダを表します。次の表に、オブジェクト名とフォルダ階層内の対応する場所の関係を示します。

  オブジェクト名	フォルダ階層内の場所
  foo.txt	すべてのバケットにはルートフォルダがあります。オブジェクト foo.txt は、バケットのルートフォルダの下に存在します。
  dir1/foo.txt	オブジェクト foo.txt は、dir1/ という名前の最上位フォルダ内にあります。最上位フォルダはルートフォルダとは異なります。
  dir1/	オブジェクト名の末尾のスラッシュ（dir1/）は、オブジェクトがフォルダ内にあることを示します。この例では、オブジェクト名 dir1/ は親フォルダ名 dir1/ と同じです。
  dir1//foo.txt	オブジェクト foo.txt は、dir1/ の子フォルダである dir1// という名前のセカンド レベル フォルダにあります。

• フォルダの最大階層数: 階層型名前空間が有効になっているバケットでは、フォルダの最大階層数は 50 です。そのため、オブジェクト名に含めることができるスラッシュ（/）は 50 個以下にする必要があります。

• フォルダ名の最大サイズ: 512 バイト（UTF-8 エンコード）。

• フォルダの自動作成: 新しいオブジェクトを作成すると、オブジェクトのパスで指定されたフォルダが自動的に作成されます。たとえば、dir1/foo.txt というオブジェクトを作成するときに、フォルダ dir1/ がまだ存在しない場合は自動的に作成されます。

次のステップ

• フォルダの作成と管理。
• フォルダの名前を変更する。
• フォルダ管理を最適化する。