フォルダの作成と管理

このページでは、階層型名前空間が有効になっているバケットでフォルダの作成、一覧表示、アップロード、削除、メタデータの取得を行う方法について説明します。

始める前に

バケットで階層型名前空間が有効になっていることを確認します。バケットで階層型名前空間を有効にする詳細な手順については、階層型名前空間を有効にしてバケットを作成するをご覧ください。

フォルダを作成

このセクションでは、フォルダの作成方法について説明します。

コンソール

  1. Google Cloud コンソールで Cloud Storage の [バケット] ページに移動します。

    [バケット] に移動

  2. バケットリストで、フォルダを作成するバケットの名前をクリックします。
  3. [バケットの詳細] ページで、[フォルダを作成] をクリックして空のフォルダを作成します。
  4. [名前] フィールドに、フォルダの名前を入力します。命名に関する考慮事項については、考慮事項をご覧ください。
  5. [作成] をクリックします。

    新しく作成したフォルダが [フォルダ ブラウザ] ペインに表示されます。

コマンドライン

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. 開発環境で、gcloud storage folders create コマンドを実行します。

    gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME

    ここで

    • BUCKET_NAME はバケットの名前です。例: my-bucket。
    • FOLDER_NAME は、作成するフォルダの名前です。例: my-folder/フォルダ名の詳細については、フォルダの概要ドキュメントをご覧ください。
    • --recursive は、フォルダと一緒に、存在しないすべての親フォルダを自動的に作成するフラグです。親フォルダがすでに存在する場合、この設定は省略可能です。

    リクエストが成功すると、コマンドから次のメッセージが返されます。

    Completed 1/1

    3. クライアント ライブラリ

    C++

    詳細については、Cloud Storage C++ API のリファレンス ドキュメントをご覧ください。

    Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。

    namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& bucket_name, std::string const& folder_id) {
  auto const parent = std::string{"projects/_/buckets/"} + bucket_name;
  auto folder = client.CreateFolder(
      parent, google::storage::control::v2::Folder{}, folder_id);
  if (!folder) throw std::move(folder).status();

  std::cout << "Created folder: " << folder->name() << "\n";
}

    C#

    詳細については、Cloud Storage C# API のリファレンス ドキュメントをご覧ください。

    Cloud Storage に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、クライアント ライブラリの認証情報を設定するをご覧ください。

    using Google.Cloud.Storage.Control.V2;
using System;

public class StorageControlCreateFolderSample
{
    public Folder StorageControlCreateFolder(string bucketName = "your-unique-bucket-name",
        string folderName = "your_folder_name")
    {
        StorageControlClient storageControl = StorageControlClient.Create();

        var request = new CreateFolderRequest
        {
            // Set project to "_" to signify globally scoped bucket
            Parent =