Some or all of the information on this page might not apply to Trusted Cloud by S3NS.

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