The Folder resource represents a folder in a Cloud Storage bucket with hierarchical namespace enabled.

To try out the methods for this resource, see Methods.

Resource representations

  "kind": "storage#folder"
  "id": string,
  "selfLink": string,
  "name": string,
  "bucket": string,
  "createTime": datetime,
  "updateTime": datetime,
  "metageneration": long
Property name Value Description Notes
kind string The kind of item this is. For folders, this is always storage#folder.
id string The ID of the folder, which is composed of the bucket name and folder name, expressed as a path. For example, example-bucket/example-folder1/example-folder2/.
name string The name of the folder, expressed as a path. For example, example-folder1/example-folder2/.
bucket string The name of the bucket that contains the folder.
createTime datetime The time at which the folder was created, in RFC 3339 format.
updateTime datetime The time at which the folder's metadata was last updated, in RFC 3339 format.
metageneration long The metadata generation of the folder.


Delete a folder.
Get the metadata of a folder.
Create a folder.
Retrieves a list of folders matching the criteria.
Rename a folder.

For information about status and error codes returned by these APIs, see the reference page.

Try it for yourself

If you're new to Google Cloud, create an account to evaluate how Cloud Storage performs in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Try Cloud Storage free