v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-138134216.7 KB
folders

Creates a new folder. Only applicable to buckets with hierarchical namespace enabled.

post/b/{bucket}/folders

Path parameters

bucketstring required

Name of the bucket in which the folder resides.

Query parameters

recursiveboolean

If true, any parent folder which doesn't exist will be created automatically.

Request body

bucketstring

The name of the bucket containing this folder.

idstring

The ID of the folder, including the bucket name, folder name.

kindstring

The kind of item this is. For folders, this is always storage#folder.

metagenerationstring int64

The version of the metadata for this folder. Used for preconditions and for detecting changes in metadata.

namestring

The name of the folder. Required if not specified by URL parameter.

selfLinkstring

The link to this folder.

createTimestring date-time

The creation time of the folder in RFC 3339 format.

updateTimestring date-time

The modification time of the folder metadata in RFC 3339 format.

Response

Successful response