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/
. |
|
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