Folder

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
`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/`.
`selfLink`	`string`	The canonical URL of the folder. For example, `https://www.googleapis.com/storage/v1/b/example-bucket/folders/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.

Methods

delete: Delete a folder.
get: Get the metadata of a folder.
insert: Create a folder.
list: Retrieves a list of folders matching the criteria.
rename: 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